x_aeon_agents 2.0.3 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b67cf75df4c815c149f95a620890b4ce9f40f66d3acbc0d2fe2cf7cc2b13dda2
-  data.tar.gz: 8c0c2bfd55c721dd5b1d7f0058e562aea9282468e4c80e2b09bbe5669384282c
+  metadata.gz: 8b1e7041fddfc65c38861e98fbfc8fda9ea487cb11559f4303632536ca36b6f1
+  data.tar.gz: 20e83d9866bd6c2bbb373cfa264341b37e3c19e88d23192fef88eda253bf273f
 SHA512:
-  metadata.gz: f1850231c29ca7b7be041751e50dff42caae4990bc2310bcba12d0037d003f724d97dbbfe2ef269cd2e031e41ff8b04ef22e53e9ee5adcedae0e25dda6cab4e0
-  data.tar.gz: e3447fab7001c38a7a4ec44d78922f62ab370ea828b181493476cee7558cce62e1c7af0259ce402f672f07e70bb348385bcce9e41ca7312c59962432d487d763
+  metadata.gz: a7b20717c0585a4e4ee6e95f818c22e0c7ebafc98d302c3af4beb1899fb0406dbac3f5ec59050523702cb0a7e26946072ecebb171e6f9fee5c5aee26adcbe2d1
+  data.tar.gz: 318d0c1d1dbdd6d3e2dfef4626f1e1c227b491db5536eeda6cad082398036d1d25f757c350e54f8defcffe388eedfe922c4d64a7dbb2815ca2e53b27d3f28577

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+# [v2.1.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.0.4...v2.1.0) (2026-10-22 13:25:41)
+
+## Global changes
+### Patches
+
+* [feat(skill-installer): add global skills installation support](https://github.com/Muriel-Salvan/x_aeon_agents/commit/165088bc2cbd077cb3ccd781c51d9a590cef0b80)
+
+## Changes for skill-installer
+### Features
+
+* [feat(skill-installer): add global skills installation support](https://github.com/Muriel-Salvan/x_aeon_agents/commit/165088bc2cbd077cb3ccd781c51d9a590cef0b80)
+
+# [v2.0.4](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.0.3...v2.0.4) (2026-10-22 11:31:50)
+
+### Patches
+
+* [refactor(agents): enrich tester plan_modifications contract with type metadata](https://github.com/Muriel-Salvan/x_aeon_agents/commit/2dabb5da11150c89d62d93b631b917c5ca330b49)
+
 # [v2.0.3](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.0.2...v2.0.3) (2026-10-21 16:35:35)
 
 ## Global changes

data/lib/x_aeon_agents/agents/skill_installer_agent.rb

@@ -10,7 +10,13 @@ module XAeonAgents
       #
       # @return [Hash{Symbol => Object}] Set of input artifacts description, per artifact name
       def input_artifacts_contracts
-        { agent: 'Agent name to be used to install skills' }
+        {
+          agent: 'Agent name to be used to install skills',
+          global: {
+            description: 'Install skills globally instead of in the project',
+            optional: true
+          }
+        }
       end
 
       # Constructor
@@ -22,9 +28,10 @@ module XAeonAgents
 
       # Execute the agent to install skills from the .skills manifest.
       #
-      # @param agent [String] Agent name to be used to install skills
+      # @param agent [String, Symbol] Agent name to be used to install skills
+      # @param global [Boolean] Install skills globally (in the user home directory) instead of in the project
       # @return [Hash{Symbol => Object}] Output artifacts content
-      def run(agent: 'cline')
+      def run(agent: 'cline', global: false)
         super
         agent_name = agent.to_sym
         original_no_color = ENV.fetch('NO_COLOR', nil)
@@ -39,7 +46,8 @@ module XAeonAgents
           install_skills_recursive(
             repo_desc[4..].strip,
             skills_desc[12..].split(',').map(&:strip),
-            agent_name
+            agent_name,
+            global:
           )
         end
 
@@ -49,22 +57,34 @@ module XAeonAgents
 
       private
 
+      # Directory in which skills are installed for the given agent.
+      #
+      # @param _agent [Symbol] Agent to use
+      # @param global [Boolean] Whether skills are installed globally
+      # @return [String] Skills directory path
+      def skills_dir_for(_agent, global)
+        # TODO: Adapt to other kinds of agents, or get the directory from skillkit itself.
+        if global
+          File.join(Dir.home, '.cline', 'skills')
+        else
+          File.join(Dir.pwd, '.cline', 'skills')
+        end
+      end
+
       # Install skills using skillkit, including dependencies recursively.
       #
       # @param repo [String] Repository
       # @param skills [Array<String>] Skills to install
       # @param agent [Symbol] Agent to use
-      def install_skills_recursive(repo, skills, agent)
+      # @param global [Boolean] Whether skills are installed globally
+      def install_skills_recursive(repo, skills, agent, global: false)
         return if skills.empty?
 
-        agents_config = {
-          cline: { skills_dir: '.cline/skills' }
-        }
-        skills_dir = agents_config[agent][:skills_dir]
+        skills_dir = skills_dir_for(agent, global)
 
         task(:install_skills, name: 'Install skills', intent: "Install skills #{repo} / #{skills.join(',')}") do
-          Helpers.run_cmd("skillkit install #{repo} --yes --skills=#{skills.join(',')} --agent=#{agent}")
-          fix_skills_metadata(skills, agent)
+          Helpers.run_cmd("skillkit install #{repo} --yes --skills=#{skills.join(',')} --agent=#{agent}#{' --global' if global}")
+          fix_skills_metadata(skills, skills_dir)
 
           # Resolve dependencies
           deps_per_repo = {}
@@ -82,20 +102,17 @@ module XAeonAgents
             end
           end
 
-          deps_per_repo.each { |dep_repo, dep_skills| install_skills_recursive(dep_repo, dep_skills, agent) }
+          deps_per_repo.each { |dep_repo, dep_skills| install_skills_recursive(dep_repo, dep_skills, agent, global:) }
         end
       end
 
       # Fix the .skillkit.json subpath property after skillkit install.
       #
       # @param skills [Array<String>] Installed skills
-      # @param agent [Symbol] Agent used
-      def fix_skills_metadata(skills, agent)
+      # @param skills_dir [String] Directory in which skills are installed
+      def fix_skills_metadata(skills, skills_dir)
         require 'json'
 
-        agents_config = { cline: { skills_dir: '.cline/skills' } }
-        skills_dir = agents_config[agent][:skills_dir]
-
         skills.each do |skill_name|
           json_file = "#{skills_dir}/#{skill_name}/.skillkit.json"
           json = JSON.parse(File.read(json_file))

data/lib/x_aeon_agents/agents/tester_agent.rb

@@ -23,7 +23,12 @@ module XAeonAgents
       #
       # @return [Hash{Symbol => Object}] Set of output artifacts description, per artifact name
       def output_artifacts_contracts
-        super.merge(plan_modifications: 'The modification or divergence you considered from the implementation plan')
+        super.merge(
+          plan_modifications: {
+            description: 'The modification or divergence you considered from the implementation plan',
+            type: :markdown
+          }
+        )
       end
 
       # Constructor

data/lib/x_aeon_agents/cli.rb

@@ -333,13 +333,16 @@ module XAeonAgents
         $   xaa install-skills
 
         $   xaa install-skills --agent cline
+
+        $   xaa install-skills --global
     LONGDESC
     option :agent, type: :string, default: 'cline', desc: 'Agent name to be used to install skills'
+    option :global, type: :boolean, default: false, desc: 'Install skills globally instead of in the project'
     # Installs skills and their dependencies from the .skills manifest.
     def install_skills
-      Agents::SkillInstallerAgent.new(session_id: options[:session_id]).run(
-        agent: options[:agent].to_sym
-      )
+      kwargs = { agent: options[:agent].to_sym }
+      kwargs[:global] = true if options[:global]
+      Agents::SkillInstallerAgent.new(session_id: options[:session_id]).run(**kwargs)
     end
 
     # --------------------------------------------------------------------------- #

data/lib/x_aeon_agents/version.rb

@@ -2,5 +2,5 @@ module XAeonAgents
   # @!group Global API
 
   # Gem version
-  VERSION = '2.0.3'
+  VERSION = '2.1.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: x_aeon_agents
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.1.0
 platform: ruby
 authors:
 - Muriel Salvan