holivia 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f07b97ef1cc9f170029aa93f37499e2ad93c8ff46909561df85e6be804eb1a54
-  data.tar.gz: 46c12d1102eabf769d43aae2291cce6ca79279d8ff9d27219b7d04b5c5caee8c
+  metadata.gz: 83d3ab262bb3fc4381d4ca420e6186ef577ce8e40db802b0658209e2ea0599b5
+  data.tar.gz: 36813fba6ea7c7cdb25d6b5cbfc97905226959e956fa02a146c9d60a54357898
 SHA512:
-  metadata.gz: caff35c64ab1b37ec0e3b0c3b06bbbc0e3b5d2515043f0260e27c174809e8d7943efc15b5e703008c59d819ad1051af671440a352f0a0757815c903daa2efd3f
-  data.tar.gz: 4631d47b8f8f4fd8d35abeec06f9f79a128f3ff966c750b61acced9433224c1f0a810c79b054511de73a9c09e817e6026a9b3602258cb0c9e79d40cc01450337
+  metadata.gz: 36d0c89c7d469290018d121ada800c8bf4da4fcc6af6918930c5907c283786b5aded11979050a0f6ef9fb19c127bdebb789e3b014eb09c842c568eb404421f05
+  data.tar.gz: 8e9086a2a046deec0170ec502391c8cda726963933d8597159aa98ce498e21d88a0e6aebe059606ae07387cad8655be6f88449ed3035cee1d6a161dfff316044

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.5.0] - 2026-05-06
+
+- Add `--state` flag on `selfcare create` and `selfcare update` for AASM-driven lifecycle transitions
+- Add top-level `holivia objective` commands (`index`, `show`) for the read-only Objective resource
+- Add `holivia selfcare objective` CRUD (`index`, `show`, `create`, `update`, `delete`) for the selfcare↔objective join, with `delete` printing `{deleted: true, id: <id>}` on 204
+- Update compose example and help text to document inline `objectives` array on compose/update payloads
+- Update help text to surface the `states` and `objective_tiers` keys returned by `selfcare schema`
+
 ## [0.4.0] - 2026-04-28
 
 - Add `--image FILE` flag on `selfcare create` and `selfcare update` for multipart image uploads

data/examples/compose.json

@@ -5,6 +5,11 @@
   "goal": "Comprendre et réduire le stress",
   "content_type": "video_type",
   "locale": "fr",
+  "state": "published",
+  "objectives": [
+    { "objective_id": 18, "tier": "main" },
+    { "objective_id": 19, "tier": "secondary" }
+  ],
   "formats": [
     {
       "format_type": "video",

data/lib/holivia/cli/help.rb

@@ -25,9 +25,12 @@ module Holivia
           holivia selfcare index                 List all selfcare contents
           holivia selfcare show <id>             Show a selfcare content by id
           holivia selfcare create [options]      Create a selfcare content
-          holivia selfcare update <id> [options] Update 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 compose               Create a full content tree atomically (no audio)
-          holivia selfcare schema                Show allowed values for content_types, format_types, item_types
+          holivia selfcare schema                Show allowed values for content_types, format_types,
+                                                 item_types, states, objective_tiers
 
         Content Formats:
           holivia selfcare format create [options]      Add a format to a selfcare content
@@ -41,6 +44,22 @@ module Holivia
           holivia selfcare item create [options]        Add an item to a slide
           holivia selfcare item update <id> [options]   Update a slide item
 
+        Objectives:
+          holivia objective index [--page N --per-page N --code CODE]  List objectives
+          holivia objective show <id>                                  Show one objective
+          Translated fields are returned in the default locale (fr).
+
+        Selfcare Content Objectives:
+          holivia selfcare objective index [--page N --per-page N --selfcare-content-id ID --objective-id ID]
+                                                List a selfcare content's associated objectives
+          holivia selfcare objective show <id>          Show one selfcare content objective
+          holivia selfcare objective create --selfcare-content-id ID --objective-id ID [--tier main|secondary]
+                                                Associate an objective to a selfcare content (tier defaults to main)
+          holivia selfcare objective update <id> --tier main|secondary  Change the tier
+          holivia selfcare objective delete <id>        Dissociate an objective from a selfcare content
+          Inline alternative: include "objectives": [{ "objective_id": ID, "tier": "main" }, ...] in the
+          JSON payload of compose/update. On update, [] clears the list; omitting the key leaves it untouched.
+
         Data Model:
           SelfcareContent → ContentFormat (format_type: text, audio, video)
             → Slide (title, duration) → SlideItem (one of: RichTextItem, VideoItem,

data/lib/holivia/cli.rb

@@ -8,16 +8,18 @@ require_relative "commands/format"
 require_relative "commands/slide"
 require_relative "commands/env"
 require_relative "commands/item"
+require_relative "commands/objective"
 
 module Holivia
   class CLI
-    def self.start(args)
+    def self.start(args) # rubocop:disable Metrics/CyclomaticComplexity
       command = args.shift
       case command
       when "login" then Commands::Auth.new.login(args)
       when "logout" then Commands::Auth.new.logout
       when "env" then Commands::Env.route(args)
       when "selfcare" then Commands::Selfcare.route(args)
+      when "objective" then Commands::Objective.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/objective.rb

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

data/lib/holivia/commands/selfcare.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "base"
+require_relative "selfcare_objective"
 
 module Holivia
   module Commands
@@ -27,6 +28,7 @@ module Holivia
         when "format"  then Format.route(args)
         when "slide"   then Slide.route(args)
         when "item"    then Item.route(args)
+        when "objective" then SelfcareObjective.route(args)
         else warn "Unknown selfcare command: #{subcommand}"
              exit 1
         end
@@ -53,6 +55,7 @@ module Holivia
           opts.on("--duration DURATION", Integer) { |v| options[:duration] = v }
           opts.on("--description DESC") { |v| options[:description] = v }
           opts.on("--image FILE") { |v| options[:image] = v }
+          opts.on("--state STATE") { |v| options[:state] = v }
         end.parse!(args)
         options = options.merge(piped_json)
 
@@ -73,6 +76,7 @@ module Holivia
           opts.on("--duration DURATION", Integer) { |v| options[:duration] = v }
           opts.on("--description DESC") { |v| options[:description] = v }
           opts.on("--image FILE") { |v| options[:image] = v }
+          opts.on("--state STATE") { |v| options[:state] = v }
         end.parse!(args)
         options = options.merge(piped_json)
 

data/lib/holivia/commands/selfcare_objective.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class SelfcareObjective < Base
+      BASE_PATH = "/api/v1/backoffice/selfcare_content_objectives"
+
+      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 selfcare objective command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = [])
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare objective index [options]"
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+          opts.on("--selfcare-content-id ID", Integer) { |v| params[:selfcare_content_id] = v }
+          opts.on("--objective-id ID", Integer) { |v| params[:objective_id] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia selfcare objective show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare objective create [options]"
+          opts.on("--selfcare-content-id ID", Integer) { |v| options[:selfcare_content_id] = v }
+          opts.on("--objective-id ID", Integer) { |v| options[:objective_id] = v }
+          opts.on("--tier TIER") { |v| options[:tier] = v }
+        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: options))
+      end
+
+      def update(args = [])
+        id = args.shift
+        abort "Usage: holivia selfcare objective update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare objective update <id> [options]"
+          opts.on("--tier TIER") { |v| options[:tier] = v }
+        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: options))
+      end
+
+      def delete(args = [])
+        id = args.shift
+        abort "Usage: holivia selfcare objective delete <id>" unless id
+
+        client.delete("#{BASE_PATH}/#{id}")
+        output(deleted: true, id: id.to_i)
+      end
+    end
+  end
+end

data/lib/holivia/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Holivia
@@ -66,7 +66,9 @@ files:
 - lib/holivia/commands/env.rb
 - lib/holivia/commands/format.rb
 - lib/holivia/commands/item.rb
+- lib/holivia/commands/objective.rb
 - lib/holivia/commands/selfcare.rb
+- lib/holivia/commands/selfcare_objective.rb
 - lib/holivia/commands/slide.rb
 - lib/holivia/config_error.rb
 - lib/holivia/configuration.rb