holivia 0.8.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a26d0c9d308b30ee2ecf2834ecb8f0dce84eb6b7ba0e561f31c0e53fa4804ccf
-  data.tar.gz: 62d2c94d7d97c14d7b25d89b64cb4344795451997cecee800d54bea575b9a25f
+  metadata.gz: 649b14e43fe74902dab26504ac1eb2ec403d3f7de0357283fb16393cd95e4d84
+  data.tar.gz: da1363943075ffbab5fa664434666202bc5654785a2e83083e6894c52d270baa
 SHA512:
-  metadata.gz: 69c8e4423d087b1fbdb94927524a97889a7afd67daa28c5db3553b67a0b2171c24fd2198f06f6003556ef08353b15d54aede4dd7f818ef9f25d5514057e837e8
-  data.tar.gz: 4123d6b7749b3942c29c214d7b22b5286e73434037fb6ce6fb4a3b40a9aa5497df7b8bc645e13c3cdeb13a1680201505aa4e971ea3027c10fd90f4780c714dd2
+  metadata.gz: 497030e934ea60e03348f922f809811ef2f1d1172cd90c9a1b96533a26461d82a2dc6e2938cacf9a4e982ba30de93004edfb9e3f2ac79b9abc27247517312d2c
+  data.tar.gz: c36fa00ac0e7d9979ab1502a08143795b6ee7b97d3bafee411778d018c5ba96c34074a728cba00d4a44463de43bc96dc2724a6bc32065ea595da049079da491e

data/.agents/skills/add-holivia-cli-endpoint/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: add-holivia-cli-endpoint
+description: Add, extend, or review Holivia Ruby CLI commands that expose API endpoints while preserving the repository's routing, option parsing, HTTP, JSON output, help, and Minitest conventions. Use when implementing a new top-level CLI resource, adding an action or CRUD endpoint to an existing resource, exposing filters or request fields, adding multipart uploads, or checking an endpoint implementation for architectural consistency.
+---
+
+# Add a Holivia CLI Endpoint
+
+Read `../../../ai-skills/add-holivia-cli-endpoint.md` completely before taking any task action. Treat that file as the canonical workflow and follow it for the rest of the task.
+
+If the file cannot be read, stop and report that the canonical guide is unavailable instead of reconstructing its instructions from memory.

data/.agents/skills/add-holivia-cli-endpoint/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Add Holivia CLI Endpoint"
+  short_description: "Add API endpoints using the existing CLI design"
+  default_prompt: "Use $add-holivia-cli-endpoint to add this API endpoint consistently to the Holivia CLI."

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [0.10.0] - 2026-07-17
+
+- Add repeatable `--topic-id` support to replace or clear topics assigned to selfcare content
+- Add CLI endpoint development skill documentation
+
+## [0.9.0] - 2026-07-11
+
+- Add `holivia highlight` commands for HR home highlight CRUD, publishing, schema discovery, and cover/document uploads
+- Add `holivia enterprise` lookup commands for backoffice enterprise discovery
+- Add `holivia crisis` CRUD commands for backoffice crisis management
+- Add `holivia collective-intervention` CRUD commands for backoffice collective intervention management
+
 ## [0.8.1] - 2026-07-08
 
 - Add provider filtering and write support to `holivia intervention` commands

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, HR intervention catalog items, and appointment diagnostics.
+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.
 
 Coding agents can use [`SKILL.md`](SKILL.md) as a downloadable usage guide for operating this CLI safely.
 
@@ -148,6 +148,18 @@ Create and update commands also accept JSON from standard input:
 printf '{"title":"Breathing exercise","locale":"fr"}' | holivia selfcare create
 ```
 
+Replace the topics assigned to an existing content by repeating `--topic-id`:
+
+```bash
+holivia selfcare update 123 --topic-id topic-id-1 --topic-id topic-id-2
+```
+
+Pass an empty `topic_ids` array through stdin to remove every assigned topic. Omitting topic IDs leaves existing assignments unchanged:
+
+```bash
+printf '{"topic_ids":[]}' | holivia selfcare update 123
+```
+
 List objectives:
 
 ```bash
@@ -166,6 +178,54 @@ Show video diagnostics for an appointment:
 holivia appointment video-diagnostics 42
 ```
 
+Find an enterprise id:
+
+```bash
+holivia enterprise lookup --query acme
+```
+
+List crises for an enterprise:
+
+```bash
+holivia crisis index --enterprise-id 123 --status reported
+```
+
+Create a crisis:
+
+```bash
+holivia crisis create \
+  --enterprise-id 123 \
+  --title "Critical site situation" \
+  --description "A manager reported an urgent situation." \
+  --contact-json '{"first_name":"Marie","last_name":"Dupont","phone":"+33612345678","email":"marie.dupont@example.com","job_title":"DRH"}'
+```
+
+Resolve it:
+
+```bash
+holivia crisis update 42 --status resolved
+```
+
+List collective interventions for an enterprise:
+
+```bash
+holivia collective-intervention index --enterprise-id 123 --status submitted
+```
+
+Create a collective intervention:
+
+```bash
+holivia collective-intervention create \
+  --enterprise-id 123 \
+  --intervention-item-id 456 \
+  --title "Manager workshop for Paris" \
+  --description "Collective support for a management team." \
+  --location "12 rue de la Paix, 75002 Paris" \
+  --scheduled-starts-at "2026-08-01T09:00:00Z" \
+  --scheduled-ends-at "2026-08-01T11:00:00Z" \
+  --contact-json '{"first_name":"Marie","last_name":"Dupont","phone":"+33612345678","email":"marie.dupont@example.com","job_title":"DRH"}'
+```
+
 List communication library items:
 
 ```bash
@@ -231,6 +291,45 @@ Publish it:
 holivia intervention publish 123
 ```
 
+Discover HR home highlight enum values and locales:
+
+```bash
+holivia highlight schema
+```
+
+List HR home highlights:
+
+```bash
+holivia highlight index --locale fr --state published --highlight-type feature
+```
+
+Create an HR home highlight that points to a URL:
+
+```bash
+holivia highlight create \
+  --locale fr \
+  --highlight-type feature \
+  --title "New manager toolkit" \
+  --resource-url https://example.com/toolkit \
+  --cover-image cover.png
+```
+
+Or create one with a document target:
+
+```bash
+holivia highlight create \
+  --locale fr \
+  --title "Benefits guide" \
+  --document benefits-guide.pdf \
+  --cover-image cover.png
+```
+
+Publish it:
+
+```bash
+holivia highlight publish 123
+```
+
 ## Files And Uploads
 
 Selfcare create and update commands can upload images with `--image <path>`.
@@ -251,6 +350,10 @@ Communication item create and update commands upload the required document with
 
 Intervention item create and update commands can upload or replace the cover image with `--cover-image <path>`.
 
+HR home highlight create and update commands require `--cover-image <path>` and exactly one target: either `--resource-url <url>` or `--document <path>`.
+
+Crisis and collective intervention create and update commands accept nested contacts as repeated `--contact-json <json>` flags or through piped JSON with a `contacts_attributes` array.
+
 ## 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, HR intervention catalog items, and appointment video diagnostics.
+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.
 
 ## Preconditions
 
@@ -19,7 +19,8 @@ Use `holivia` in examples below. If working from a checkout before installation,
 - 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.
+- 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.
 - 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
@@ -139,6 +140,14 @@ holivia intervention schema
 
 Use the schema response for intervention types, providers, modalities, audiences, durations, categories, states, and locales.
 
+For HR home highlight work, discover the live schema first:
+
+```bash
+holivia highlight schema
+```
+
+Use the schema response for highlight types, states, and locales.
+
 ## Selfcare Content
 
 List contents:
@@ -170,6 +179,14 @@ Update a content:
 holivia selfcare update 123 --title "Updated title" --state published
 ```
 
+Replace the topics assigned to an existing content by repeating `--topic-id`:
+
+```bash
+holivia selfcare update 123 --topic-id topic-id-1 --topic-id topic-id-2
+```
+
+Pass `{"topic_ids":[]}` through stdin to clear all topic assignments. Omit topic IDs to leave assignments unchanged.
+
 Upload or replace an image:
 
 ```bash
@@ -278,6 +295,102 @@ holivia objective show 123
 
 Objective translated fields are returned in the default locale, currently `fr`.
 
+## Enterprises
+
+Find an enterprise id:
+
+```bash
+holivia enterprise lookup --query acme
+```
+
+Filter enterprise lookup:
+
+```bash
+holivia enterprise index --headquarter-id 10 --user-id 20 --page 1 --per-page 25
+```
+
+## Crises
+
+List crises:
+
+```bash
+holivia crisis index --enterprise-id 123 --status reported
+```
+
+Show one crisis:
+
+```bash
+holivia crisis show 42
+```
+
+Create a crisis:
+
+```bash
+holivia crisis create \
+  --enterprise-id 123 \
+  --title "Critical site situation" \
+  --description "A manager reported an urgent situation." \
+  --contact-json '{"first_name":"Marie","last_name":"Dupont","phone":"+33612345678","email":"marie.dupont@example.com","job_title":"DRH"}'
+```
+
+Update crisis status:
+
+```bash
+holivia crisis update 42 --status resolved
+```
+
+Delete a crisis:
+
+```bash
+holivia crisis delete 42
+```
+
+Status values are `reported`, `in_progress`, and `resolved`.
+
+## Collective Interventions
+
+List collective interventions:
+
+```bash
+holivia collective-intervention index --enterprise-id 123 --status submitted
+```
+
+Show one collective intervention:
+
+```bash
+holivia collective-intervention show 42
+```
+
+Create a collective intervention:
+
+```bash
+holivia collective-intervention create \
+  --enterprise-id 123 \
+  --intervention-item-id 456 \
+  --title "Manager workshop for Paris" \
+  --description "Collective support for a management team." \
+  --location "12 rue de la Paix, 75002 Paris" \
+  --scheduled-starts-at "2026-08-01T09:00:00Z" \
+  --scheduled-ends-at "2026-08-01T11:00:00Z" \
+  --contact-json '{"first_name":"Marie","last_name":"Dupont","phone":"+33612345678","email":"marie.dupont@example.com","job_title":"DRH"}'
+```
+
+Schedule or complete a collective intervention:
+
+```bash
+holivia collective-intervention update 42 --status scheduled
+holivia collective-intervention update 42 --status completed
+```
+
+Delete a collective intervention:
+
+```bash
+holivia collective-intervention delete 42
+```
+
+Status values are `submitted`, `scheduled`, `in_progress`, `completed`, and `canceled`.
+Use piped JSON instead of `--contact-json` when the payload has multiple contacts or long text.
+
 ## Intervention Items
 
 List intervention catalog items:
@@ -347,6 +460,66 @@ Delete one localized item:
 holivia intervention delete 123
 ```
 
+## HR Home Highlights
+
+List HR home highlights:
+
+```bash
+holivia highlight index --locale fr --state published
+```
+
+Filter by highlight metadata:
+
+```bash
+holivia highlight index --query toolkit --locale fr --highlight-type feature --state published
+```
+
+Show one highlight:
+
+```bash
+holivia highlight show 123
+```
+
+Create a highlight that points to a URL:
+
+```bash
+holivia highlight create \
+  --locale fr \
+  --highlight-type feature \
+  --title "Manager toolkit" \
+  --resource-url https://example.com/toolkit \
+  --cover-image cover.png
+```
+
+Create a highlight that points to an uploaded document:
+
+```bash
+holivia highlight create \
+  --locale fr \
+  --title "Benefits guide" \
+  --document benefits-guide.pdf \
+  --cover-image cover.png
+```
+
+Create or update from JSON for metadata-only changes:
+
+```bash
+printf '{"locale":"fr","title":"Manager toolkit","resource_url":"https://example.com/toolkit"}' | holivia highlight create
+```
+
+Publish or unpublish one localized highlight:
+
+```bash
+holivia highlight publish 123
+holivia highlight unpublish 123
+```
+
+Delete one localized highlight:
+
+```bash
+holivia highlight delete 123
+```
+
 ## Selfcare Objective Associations
 
 List associations:
@@ -412,6 +585,8 @@ 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.
+- Run `holivia highlight schema` before highlight create/update work.
+- Run `holivia enterprise lookup --query <name>` when you need an `enterprise_id`.
 - 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/ai-skills/add-holivia-cli-endpoint.md

@@ -0,0 +1,124 @@
+# Add a Holivia CLI Endpoint
+
+Keep endpoint commands thin and consistent with the nearest existing resource. Implement the API contract at the command layer; reuse the shared client for transport, authentication, retries, response parsing, and API errors.
+
+## Inspect Before Editing
+
+1. Read `CLAUDE.md` and check the worktree for user changes.
+2. Establish the endpoint contract from the request or authoritative API material: HTTP verb, exact path, path parameters, query parameters, body keys and types, file fields, response shape, and required CLI name. Do not invent missing contract details.
+3. Read these architecture files:
+   - `lib/holivia/cli.rb` for top-level registration.
+   - `lib/holivia/commands/base.rb` for the shared client, JSON output, and piped JSON.
+   - `lib/holivia/client.rb` for supported HTTP methods and request behavior.
+   - `lib/holivia/cli/help.rb` for user-facing discovery.
+   - `test/holivia/test_cli.rb` for routing and help expectations.
+4. Choose the closest command and test pair as the implementation model:
+   - Read-only collection/member: `objective.rb` or `enterprise.rb`.
+   - Single member action: `appointment.rb`.
+   - CRUD with filters and nested JSON: `crisis.rb`.
+   - CRUD, schema, transitions, and uploads: `communication_item.rb`, `intervention_item.rb`, or `hr_home_highlight.rb`.
+   - Nested CLI namespace: `selfcare_objective.rb`, routed by `selfcare.rb`.
+5. Prefer extending the selected pattern over introducing an abstraction for one endpoint. Refactor shared behavior only when the task requires it or repetition has become material.
+
+## Place the Endpoint
+
+For a new top-level resource:
+
+1. Add `lib/holivia/commands/<resource>.rb` with `# frozen_string_literal: true` and `require_relative "base"`.
+2. Define `Holivia::Commands::<Resource> < Base` and an exact `BASE_PATH`, normally under `/api/v1/backoffice`.
+3. Add `.route(args)`: shift the subcommand, dispatch with a `case`, pass the remaining array to the instance method, and warn plus `exit 1` for unknown commands.
+4. Require the command in `lib/holivia/cli.rb` and route its public top-level name in `CLI.start`.
+5. Add aliases only when the product vocabulary requires them; test each intentional alias.
+
+For an endpoint belonging to an existing resource, add a subcommand and instance method to that command class. For a nested namespace, route through its parent command rather than adding another top-level command.
+
+Use kebab-case for multiword CLI tokens, snake_case for Ruby filenames, constants, API paths, and request keys, and PascalCase for command classes. Follow existing public vocabulary when it differs from the API resource name.
+
+## Implement Command Behavior
+
+Use these mappings:
+
+- Collection read: `client.get(BASE_PATH, params: params)`.
+- Member read: `client.get("#{BASE_PATH}/#{id}")`.
+- Create: `client.post(BASE_PATH, body: options)`.
+- Update: `client.patch("#{BASE_PATH}/#{id}", body: options)`.
+- Member action: call the contract's verb on `"#{BASE_PATH}/#{id}/<action>"`.
+- Delete: call `client.delete`, then print `output(deleted: true, id: id.to_i)` when the server has no useful body.
+- Schema/discovery: `client.get("#{BASE_PATH}/schema")`.
+
+Do not instantiate Faraday directly in a command. Do not add authentication headers, retry logic, response parsing, or `ApiError` rescue there; `Client` and `exe/holivia` already own those concerns. Extend `Client` and its tests only if the API requires an unsupported HTTP capability.
+
+Always pass successful API responses to `output`, which preserves pretty-printed JSON as the CLI's machine-readable interface. Do not reshape a response unless the endpoint contract explicitly calls for it.
+
+### Parse arguments
+
+- Accept positional member IDs first with `id = args.shift`.
+- Abort missing IDs with the full command usage, for example `abort "Usage: holivia widget show <id>" unless id`.
+- Use `OptionParser` and set a complete `opts.banner`.
+- Map `--kebab-case` flags to snake_case symbol keys.
+- Apply `Integer` converters to numeric identifiers, pagination, counts, and durations. Preserve strings such as UUIDs, codes, timestamps, states, and locales.
+- Collect repeatable array flags by appending to an initialized array. Parse explicitly JSON-valued flags with `JSON.parse(..., symbolize_names: true)` when the resulting object is part of a symbol-keyed body.
+- Keep collection filters in `params`; keep create/update values in `options`.
+- For create and update, merge `piped_json` after flags with `options.merge(piped_json)`. This intentionally makes stdin JSON win on duplicate keys.
+- Abort an empty create/update body with `No options provided. Use --help for usage.`
+- Let the server validate domain rules and enums unless the repository already performs that validation. Expose a schema endpoint when the API provides one.
+
+Extract a shared private `add_write_options` method when create and update accept the same fields. Keep action helpers such as `transition(args, event)` private when several subcommands share the same shape.
+
+### Handle uploads
+
+Convert file paths to `Faraday::Multipart::FilePart` in a private body builder. Duplicate the options hash before replacing paths so the parser result is not mutated unexpectedly. Use a frozen extension-to-MIME map and fall back to `application/octet-stream`. Reuse the existing multipart-enabled `Client`; do not set the content type manually.
+
+Test every supported MIME mapping, the fallback, and each file field's conversion. Do not add client-side size or presence validation unless requested; API validation remains authoritative.
+
+## Update Discovery Surfaces
+
+Add the command, its arguments, and a concise description to the appropriate section of `lib/holivia/cli/help.rb`. Add or adjust the help assertions in `test/holivia/test_cli.rb`.
+
+Update `README.md` and the root operational `SKILL.md` only when the endpoint changes the documented primary workflow or should be available to agents operating the released CLI. Do not bump the gem version or edit release notes unless the user requests release preparation.
+
+## Test at the Command Boundary
+
+Create or update `test/holivia/commands/test_<resource>.rb`. Follow the nearest test file rather than introducing a new framework.
+
+1. Require `test_helper`, the command file, and `tmpdir` when used.
+2. Stub `$stdin` as a TTY in setup for commands that call `piped_json`; restore it in teardown.
+3. Stub `Holivia::Client.new` with a small object and restore the original method in `ensure`.
+4. Assert the exact HTTP method, endpoint path, query params or body, and representative JSON output.
+5. Cover every added behavior that applies:
+   - routing and unknown subcommand failure;
+   - filters and OptionParser type conversion;
+   - missing member ID;
+   - create/update with flags;
+   - piped JSON and its precedence when relevant;
+   - empty write rejection;
+   - member actions;
+   - delete confirmation;
+   - multipart parts and MIME detection;
+   - aliases;
+   - help visibility and top-level routing for a new resource.
+
+Keep these tests at the CLI-to-client boundary. Do not make network requests. Add `Client` tests only when changing transport behavior.
+
+## Verify and Review
+
+Run the narrow test first:
+
+```bash
+bundle exec ruby -Itest test/holivia/commands/test_<resource>.rb
+```
+
+Then run the repository checks:
+
+```bash
+bundle exec rake
+```
+
+Before finishing, inspect the diff and confirm:
+
+- Every endpoint path and verb matches the contract exactly.
+- Routing, requires, help text, and tests expose the same command spelling.
+- Query keys, body keys, and OptionParser types match the API.
+- Writes support stdin JSON consistently, unless the command is intentionally file-only or action-only.
+- Successful output is JSON and failures retain the shared executable behavior.
+- No unrelated refactor, version bump, credential, or generated package entered the change.

data/lib/holivia/cli/help.rb

@@ -27,7 +27,8 @@ module Holivia
           holivia selfcare create [options]      Create a selfcare content
                                                  (--state draft|ongoing_translation|translation_to_be_reviewed|
                                                   translation_reviewed|published)
-          holivia selfcare update <id> [options] Update a selfcare content (same --state values)
+          holivia selfcare update <id> [options] Update a selfcare content (same --state values;
+                                                 repeat --topic-id ID to replace assigned topics)
           holivia selfcare compose               Create a full content tree atomically (no audio)
           holivia selfcare schema                Show allowed values for content_types, format_types,
                                                  item_types, states, objective_tiers
@@ -49,6 +50,11 @@ module Holivia
           holivia objective show <id>                                  Show one objective
           Translated fields are returned in the default locale (fr).
 
+        Enterprises:
+          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
+
         Communication Items:
           holivia communication index [--page N --per-page N --query TEXT --locale LOCALE --document-type TYPE]
                                                 List communication library items
@@ -73,6 +79,36 @@ module Holivia
           holivia intervention unpublish <id>   Unpublish one intervention item
           holivia intervention delete <id>      Delete one localized intervention item
 
+        HR Home Highlights:
+          holivia highlight index [--page N --per-page N --query TEXT --locale LOCALE
+                                   --highlight-type TYPE --state STATE]
+                                                List HR home highlights
+          holivia highlight schema              Show allowed highlight_types, states, and locales
+          holivia highlight show <id>           Show one HR home highlight
+          holivia highlight create [options]    Create one localized HR home highlight
+          holivia highlight update <id> [options] Update one localized HR home highlight
+          holivia highlight publish <id>        Publish one HR home highlight
+          holivia highlight unpublish <id>      Unpublish one HR home highlight
+          holivia highlight delete <id>         Delete one localized HR home highlight
+
+        Crises:
+          holivia crisis index [--enterprise-id ID --status STATUS --page N --per-page N]
+                                                List crises
+          holivia crisis show <id>              Show one crisis
+          holivia crisis create [options]       Create a crisis
+          holivia crisis update <id> [options]  Update a crisis
+          holivia crisis delete <id>            Delete a crisis
+          Status values: reported, in_progress, resolved.
+
+        Collective Interventions:
+          holivia collective-intervention index [--enterprise-id ID --status STATUS --page N --per-page N]
+                                                List collective interventions
+          holivia collective-intervention show <id>       Show one collective intervention
+          holivia collective-intervention create [options] Create a collective intervention
+          holivia collective-intervention update <id> [options] Update a collective intervention
+          holivia collective-intervention delete <id>     Delete a collective intervention
+          Status values: submitted, scheduled, in_progress, completed, canceled.
+
         Appointments:
           holivia appointment video-diagnostics <id>  Show video diagnostics for an appointment
 
@@ -116,6 +152,9 @@ module Holivia
           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.
+          Highlight uploads use required --cover-image <path> and either --resource-url URL or --document <path>.
+          Crisis and collective intervention contacts can be passed as repeated --contact-json JSON flags,
+          or as "contacts_attributes": [...] in piped JSON.
           Compose is JSON-only — to attach an image to a composed tree, PATCH the returned id:
             holivia selfcare update <id> --image <path>
 
@@ -130,6 +169,8 @@ module Holivia
           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.
+          Run holivia highlight schema before creating or updating HR home highlights
+          to discover current highlight types, states, and locales.
 
         Version:
           holivia version                        Print version

data/lib/holivia/cli.rb

@@ -12,10 +12,14 @@ require_relative "commands/objective"
 require_relative "commands/appointment"
 require_relative "commands/communication_item"
 require_relative "commands/intervention_item"
+require_relative "commands/hr_home_highlight"
+require_relative "commands/enterprise"
+require_relative "commands/crisis"
+require_relative "commands/collective_intervention"
 
 module Holivia
   class CLI
-    def self.start(args) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/MethodLength
+    def self.start(args) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength
       command = args.shift
       case command
       when "login" then Commands::Auth.new.login(args)
@@ -26,6 +30,10 @@ module Holivia
       when "appointment" then Commands::Appointment.route(args)
       when "communication" then Commands::CommunicationItem.route(args)
       when "intervention" then Commands::InterventionItem.route(args)
+      when "highlight" then Commands::HrHomeHighlight.route(args)
+      when "enterprise" then Commands::Enterprise.route(args)
+      when "crisis" then Commands::Crisis.route(args)
+      when "collective-intervention", "collective_intervention", "collective" then Commands::CollectiveIntervention.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/collective_intervention.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class CollectiveIntervention < Base
+      BASE_PATH = "/api/v1/backoffice/collective_interventions"
+
+      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 "update" then new.update(args)
+        when "delete" then new.delete(args)
+        else warn "Unknown collective intervention command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = [])
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia collective-intervention 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 collective-intervention show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = parse_write_options(args, "Usage: holivia collective-intervention create [options]")
+        abort "No options provided. Use --help for usage." if options.empty?
+
+        output(client.post(BASE_PATH, body: options))
+      end
+
+      def update(args = [])
+        id = args.shift
+        abort "Usage: holivia collective-intervention update <id> [options]" unless id
+
+        options = parse_write_options(args, "Usage: holivia collective-intervention update <id> [options]")
+        abort "No options provided. Use --help for usage." if options.empty?
+
+        output(client.patch("#{BASE_PATH}/#{id}", body: options))
+      end
+
+      def delete(args = [])
+        id = args.shift
+        abort "Usage: holivia collective-intervention delete <id>" unless id
+
+        client.delete("#{BASE_PATH}/#{id}")
+        output(deleted: true, id: id.to_i)
+      end
+
+      private
+
+      def parse_write_options(args, banner) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = banner
+          opts.on("--enterprise-id ID", Integer) { |v| options[:enterprise_id] = v }
+          opts.on("--intervention-item-id ID", Integer) { |v| options[:intervention_item_id] = v }
+          opts.on("--title TITLE") { |v| options[:title] = v }
+          opts.on("--description DESC") { |v| options[:description] = v }
+          opts.on("--location LOCATION") { |v| options[:location] = v }
+          opts.on("--scheduled-starts-at TIME") { |v| options[:scheduled_starts_at] = v }
+          opts.on("--scheduled-ends-at TIME") { |v| options[:scheduled_ends_at] = v }
+          opts.on("--status STATUS") { |v| options[:status] = v }
+          opts.on("--contact-json JSON") { |v| append_contact(options, v) }
+        end.parse!(args)
+        options.merge(piped_json)
+      end
+
+      def append_contact(options, json)
+        options[:contacts_attributes] ||= []
+        options[:contacts_attributes] << JSON.parse(json, symbolize_names: true)
+      end
+    end
+  end
+end

data/lib/holivia/commands/crisis.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Crisis < Base
+      BASE_PATH = "/api/v1/backoffice/crises"
+
+      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 "update" then new.update(args)
+        when "delete" then new.delete(args)
+        else warn "Unknown crisis command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = [])
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia crisis 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 crisis show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = parse_write_options(args, "Usage: holivia crisis create [options]")
+        abort "No options provided. Use --help for usage." if options.empty?
+
+        output(client.post(BASE_PATH, body: options))
+      end
+
+      def update(args = [])
+        id = args.shift
+        abort "Usage: holivia crisis update <id> [options]" unless id
+
+        options = parse_write_options(args, "Usage: holivia crisis update <id> [options]")
+        abort "No options provided. Use --help for usage." if options.empty?
+
+        output(client.patch("#{BASE_PATH}/#{id}", body: options))
+      end
+
+      def delete(args = [])
+        id = args.shift
+        abort "Usage: holivia crisis delete <id>" unless id
+
+        client.delete("#{BASE_PATH}/#{id}")
+        output(deleted: true, id: id.to_i)
+      end
+
+      private
+
+      def parse_write_options(args, banner)
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = banner
+          opts.on("--enterprise-id ID", Integer) { |v| options[:enterprise_id] = v }
+          opts.on("--title TITLE") { |v| options[:title] = v }
+          opts.on("--description DESC") { |v| options[:description] = v }
+          opts.on("--status STATUS") { |v| options[:status] = v }
+          opts.on("--contact-json JSON") { |v| append_contact(options, v) }
+        end.parse!(args)
+        options.merge(piped_json)
+      end
+
+      def append_contact(options, json)
+        options[:contacts_attributes] ||= []
+        options[:contacts_attributes] << JSON.parse(json, symbolize_names: true)
+      end
+    end
+  end
+end

data/lib/holivia/commands/enterprise.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Enterprise < Base
+      BASE_PATH = "/api/v1/backoffice/enterprises"
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "index", "lookup", "search" then new.index(args)
+        else warn "Unknown enterprise command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = []) # rubocop:disable Metrics/AbcSize
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia enterprise index [options]"
+          opts.on("--query TEXT") { |v| params[:query] = v }
+          opts.on("--headquarter-id ID", Integer) { |v| params[:headquarter_id] = v }
+          opts.on("--user-id ID", Integer) { |v| params[:user_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
+    end
+  end
+end

data/lib/holivia/commands/hr_home_highlight.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class HrHomeHighlight < Base # rubocop:disable Metrics/ClassLength
+      BASE_PATH = "/api/v1/backoffice/hr_home_highlights"
+      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 highlight command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = []) # rubocop:disable Metrics/AbcSize
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia highlight 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("--highlight-type TYPE") { |v| params[:highlight_type] = v }
+          opts.on("--state STATE") { |v| params[:state] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia highlight show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia highlight 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 highlight update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia highlight 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 highlight 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("--translation-group-id UUID") { |v| options[:translation_group_id] = v }
+        opts.on("--locale LOCALE") { |v| options[:locale] = v }
+        opts.on("--highlight-type TYPE") { |v| options[:highlight_type] = v }
+        opts.on("--title TITLE") { |v| options[:title] = v }
+        opts.on("--resource-url URL") { |v| options[:resource_url] = 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 highlight #{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/selfcare.rb

@@ -77,6 +77,7 @@ module Holivia
           opts.on("--description DESC") { |v| options[:description] = v }
           opts.on("--image FILE") { |v| options[:image] = v }
           opts.on("--state STATE") { |v| options[:state] = v }
+          opts.on("--topic-id ID") { |v| (options[:topic_ids] ||= []) << v }
         end.parse!(args)
         options = options.merge(piped_json)
 

data/lib/holivia/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Holivia
@@ -45,6 +45,8 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".agents/skills/add-holivia-cli-endpoint/SKILL.md"
+- ".agents/skills/add-holivia-cli-endpoint/agents/openai.yaml"
 - ".rubocop.yml"
 - CHANGELOG.md
 - CLAUDE.md
@@ -53,6 +55,7 @@ files:
 - README.md
 - Rakefile
 - SKILL.md
+- ai-skills/add-holivia-cli-endpoint.md
 - example_content.xml
 - examples/compose.json
 - exe/holivia
@@ -65,9 +68,13 @@ files:
 - lib/holivia/commands/appointment.rb
 - lib/holivia/commands/auth.rb
 - lib/holivia/commands/base.rb
+- lib/holivia/commands/collective_intervention.rb
 - lib/holivia/commands/communication_item.rb
+- lib/holivia/commands/crisis.rb
+- lib/holivia/commands/enterprise.rb
 - lib/holivia/commands/env.rb
 - lib/holivia/commands/format.rb
+- lib/holivia/commands/hr_home_highlight.rb
 - lib/holivia/commands/intervention_item.rb
 - lib/holivia/commands/item.rb
 - lib/holivia/commands/objective.rb