x_aeon_agents 1.3.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ad694c34995a4a2ae110fbc5d9692b4fecd0ced12fd9307042d100d9eb21fef
-  data.tar.gz: 1b1ae0dfcfb2c133219969af207b216d60c42d2de08d45d05daadbab7a602041
+  metadata.gz: d77d17ba04574e6333764ed8b79b7a6849eab364906e9abe133f5a572dc5b744
+  data.tar.gz: c1c2a6b72b2665e3731ea1b046e038bf22abd05d3d2a6ab42906f1d589836bf9
 SHA512:
-  metadata.gz: d5aab40193178b7db1c9e8414fe0da5036c23fe526538a9e30fa24802b187309824cb402cbd938fd62398b6a7230e9f95e80784f904e3ff00a2ef872b65fb228
-  data.tar.gz: cc5e14027141ed92f1e1e19866c360b252f055e6ed1962870cfcc4a9da34f8a9e7c1ff32f16415717661e08c4830ebfd6e76e0f9d1daf45422d09c29e56c8fa7
+  metadata.gz: 9d1c0802bfea9ba76f6c43cdf788fdff2416b24bd1aff6bd4542122b27f2be234a2f45bac2f31d66c0b6db4e34c4d437674e6093627175f2d020b834edf766b1
+  data.tar.gz: 7cc7ea9f8bbe8629436f7ed2c5c701cac4383b70c9c7d972ede756c28cac8d93ae145b0b9ae4876e95691afb18890c4455e5ac08231e860899da499ba9822c47

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [v2.0.1](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.0.0...v2.0.1) (2026-10-19 17:15:42)
+
+### Patches
+
+* [Isolate tests to make sure local Dir.home does not affect them](https://github.com/Muriel-Salvan/x_aeon_agents/commit/b6d2f6a7d4368052b2cd73486e61c22ec29de205)
+
+# [v2.0.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v1.3.0...v2.0.0) (2026-10-15 22:46:39)
+
+### Breaking changes
+
+* [Make PR base ref configurable for requirement and issue implementation](https://github.com/Muriel-Salvan/x_aeon_agents/commit/8a16c8f4c3c7705239a763248a4e2fb0e2150c01)
+
 # [v1.3.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v1.2.0...v1.3.0) (2026-10-13 14:54:19)
 
 ### Features

data/README.md

@@ -195,7 +195,7 @@ Each of these secrets can alternatively be retrieved by custom code declared in
 - 📝 **AI commit messages** — analyze staged changes and generate a meaningful message, with flexible staging strategies (`all`, `if_empty`, `none`)
 - 🚀 **Automated Pull Request creation** — push the branch to GitHub and open a PR against a configurable base ref with an AI-written description
 - 🐛 **GitHub issue implementation** — turn an issue (and its comments) into working code, committing changes and opening a PR automatically
-- 🛠️ **Arbitrary requirement implementation** — pass free-form requirements to a Developer agent that plans, codes and tests the changes, optionally committing and opening a PR
+- 🛠️ **Arbitrary requirement implementation** — pass free-form requirements to a Developer agent that plans, codes and tests the changes, optionally committing and opening a PR against a configurable base ref
 - 📚 **README generation** — build a full README from the codebase with 10 toggleable sections (about, quick start, requirements, features, public API, documentation, how-it-works, development, contributing, license)
 - 🔍 **Git diff interpretation** — summarize the working-tree changes and the intent behind them relative to any base ref
 - 💬 **One-shot prompts** — send a single prompt to the AI agent and print the response

data/TODO.md

@@ -1,8 +1,6 @@
-* Don't put .x_aeon_agents dir in the project dir: it confuses the LLMs.
 * Don't use project skills and rules: it adds noise to the LLMs that scan the files and code base. Use only global objects from dedicated config dirs.
 * Add desktop notification when user input is needed.
 * Test with other models.
-* Provide a unified CLI with Thor and actions to not pollute the user CLI environment too much.
 * Implement non-debug logs with progress bars (one char per message received).
 * Cache the cli auth call for performace between several agents of the same run.
 * Make the WSL CLI tool a Ruby script to avoid paths and slashes issues.
@@ -20,7 +18,6 @@
   * 1 task for creating PR
   Goal would be to reduce the amount of skills or rules each task needs, so that it gets focused on what it needs to do given previous context.
   Each task could even be performed by different models, and in parallel
-* Write a proper README file.
 * Use templates to better guide the format of commit comments and PR descriptions.
 * Extract the generate_skills executable into a generic Rubygem that generates skills following agents best practices
 * Add a conventions skill that explains conventions used:
@@ -40,9 +37,5 @@
   * Models are good at performing small tasks, not huge workflows. We need workflows orchestrators handling context and memory.
 * Check anthropic's skill-creator skill: https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md
 * Check security warnings that we got from installation and fix them.
-* Move the Cline Ruby connector into a Rubygem.
 * Split helpers in Utils / Git/Github/Generators/Skills...
-* Rename in x_aeon_agents because it's not about skills only anymore.
-* Yank old Rubygems.
 * Migrate comments to YARD.
-* Check useless methods, require and gems after separating the code properly.

data/lib/x_aeon_agents/agents/developer_agent.rb

@@ -16,12 +16,13 @@ module XAeonAgents
       # Constructor
       #
       # @param commit [Boolean] Should we commit files at every step?
-      # @param pull_request [Boolean] Should we create a Github Pull Request with this implementation?
+      # @param pr_base_ref [String, nil] The git ref (branch name) of the base of the Github Pull Request to
+      #   create with this implementation, or nil to not create any Pull Request
       # @param agent_params [Hash{Symbol => Object}] Extra agent parameters
-      def initialize(commit: false, pull_request: false, **agent_params)
+      def initialize(commit: false, pr_base_ref: nil, **agent_params)
         super(name: 'Developer', **agent_params)
         @commit = commit
-        @pull_request = pull_request
+        @pr_base_ref = pr_base_ref
       end
 
       # Execute the agent to generate some output artifacts based on some input artifacts.
@@ -34,7 +35,8 @@ module XAeonAgents
         task(:setup_requirements, name: 'Setup requirements', intent: 'Initialize requirements from the current commit') do
           @artifacts.merge!(
             requirements:,
-            base_sha: Helpers.git.gcommit('HEAD').sha
+            base_sha: Helpers.git.gcommit('HEAD').sha,
+            pr_base_ref: @pr_base_ref
           )
         end
 
@@ -208,7 +210,7 @@ module XAeonAgents
         )
         logger.info "Documenter changes: #{Helpers.git.status_info.changed.keys.join(', ')}"
 
-        if @commit || @pull_request
+        if @commit || @pr_base_ref
           task(
             new_agent(
               CommitterAgent,
@@ -220,7 +222,7 @@ module XAeonAgents
           )
         end
 
-        if @pull_request
+        if @pr_base_ref
           task(
             new_agent(
               PullRequestCreatorAgent,

data/lib/x_aeon_agents/agents/issue_implementer_agent.rb

@@ -14,12 +14,13 @@ module XAeonAgents
       # Constructor
       #
       # @param commit [Boolean] Whether to commit changes automatically
-      # @param pull_request [Boolean] Whether to create a pull request automatically
+      # @param pr_base_ref [String, nil] The git ref (branch name) of the base of the Pull Request to create,
+      #   or nil to not create any Pull Request
       # @param agent_params [Hash{Symbol => Object}] Extra agent parameters
-      def initialize(commit: false, pull_request: false, **agent_params)
+      def initialize(commit: false, pr_base_ref: nil, **agent_params)
         super(name: 'Issue implementer', **agent_params)
         @commit = commit
-        @pull_request = pull_request
+        @pr_base_ref = pr_base_ref
       end
 
       # Execute the agent to implement a GitHub issue.
@@ -35,7 +36,7 @@ module XAeonAgents
         issue = Helpers.github.issue(Helpers.github_repo, github_issue_number)
         issue_comments = Helpers.github.issue_comments(Helpers.github_repo, github_issue_number)
         task(
-          new_agent(DeveloperAgent, commit: @commit, pull_request: @pull_request),
+          new_agent(DeveloperAgent, commit: @commit, pr_base_ref: @pr_base_ref),
           requirements: build_requirements(issue, issue_comments),
           intent: 'Develop the gathered requirements'
         )

data/lib/x_aeon_agents/agents/pull_request_creator_agent.rb

@@ -9,7 +9,7 @@ module XAeonAgents
       # @return [Hash{Symbol => Object}] Set of input artifacts description, per artifact name
       def input_artifacts_contracts
         {
-          base_sha: 'The git ref of the base of the feature branch',
+          pr_base_ref: 'The git ref (branch name) of the base to create the Pull Request against',
           requirements: {
             description: 'The initial requirements',
             optional: true
@@ -28,10 +28,10 @@ module XAeonAgents
 
       # Execute the agent to generate some output artifacts based on some input artifacts.
       #
-      # @param base_sha [String] The git reference of the base of the branch.
+      # @param pr_base_ref [String] The git ref (branch name) used as base of the Pull Request.
       # @param requirements [String, nil] The initial requirements, or nil if none.
       # @return [Hash{Symbol => Object}] Output artifacts content
-      def run(base_sha:, requirements: nil)
+      def run(pr_base_ref:, requirements: nil)
         super
         raise 'Unable to find the Github repository' unless Helpers.github_repo
 
@@ -56,7 +56,7 @@ module XAeonAgents
         if @artifacts[:existing_pr_url].nil?
           # Create new PR
           git_diff_interpreter_agent = new_agent(GitDiffInterpreterAgent)
-          task(git_diff_interpreter_agent, intent: 'Analyze changes in the whole branch', git_ref_base: base_sha)
+          task(git_diff_interpreter_agent, intent: 'Analyze changes in the whole branch', git_ref_base: pr_base_ref)
           task(:create_pr, name: 'Create Pull Request', intent: "Create a Pull Request for the branch #{head_branch} on repo #{repo_name}") do
             sections = [@artifacts[:change_intent].strip]
             sections << <<~EO_SECTION if requirements
@@ -135,7 +135,7 @@ module XAeonAgents
             EO_SECTION
             new_pr = Helpers.github.create_pull_request(
               repo_name,
-              base_sha,
+              pr_base_ref,
               head_branch,
               @artifacts[:one_line_summary].strip,
               sections.map(&:strip).join("\n\n")

data/lib/x_aeon_agents/agents/review_resolver_agent.rb

@@ -100,7 +100,14 @@ module XAeonAgents
             @artifacts[:plan] = 'No implementation plan'
             @artifacts[:files_diffs] = 'No changes'
           else
-            task(new_agent(DeveloperAgent, commit: true, pull_request: true), intent: 'Develop new requirements devise from review comments')
+            task(
+              new_agent(
+                DeveloperAgent,
+                commit: true,
+                pr_base_ref: Helpers.github.pull_request(Helpers.github_repo, @artifacts[:pr_number]).base.ref
+              ),
+              intent: 'Develop new requirements devise from review comments'
+            )
           end
 
           @artifacts[:open_comments_to_agents].each.with_index do |comment, comment_idx|

data/lib/x_aeon_agents/cli.rb

@@ -103,7 +103,7 @@ module XAeonAgents
     # Push changes on Github and create a Pull Request.
     def create_pr
       agent_kwargs = {
-        base_sha: options[:base]
+        pr_base_ref: options[:base]
       }
       agent_kwargs[:requirements] = options[:requirements] if options[:requirements]
       Agents::PullRequestCreatorAgent.new(session_id: options[:session_id]).run(**agent_kwargs)
@@ -210,21 +210,25 @@ module XAeonAgents
     long_desc <<~LONGDESC
       Reads the content (and comments) of a GitHub issue and delegates the
       implementation to the Developer agent.  The agent commits changes and
-      opens a Pull Request automatically.
+      opens a Pull Request against the base given with the --pr-base option
+      (defaults to main).
 
       Examples:
 
         $   xaa implement-issue 15
 
+        $   xaa implement-issue 15 --pr-base master
+
         $   xaa implement-issue 15 --session-id my-session
     LONGDESC
+    option :pr_base, type: :string, default: 'main', desc: 'Base git ref of the GitHub Pull Request to create'
     # Implements a GitHub issue using AI.
     #
     # @param github_issue_number [Integer] The GitHub issue number to implement
     def implement_issue(github_issue_number)
       Agents::IssueImplementerAgent.new(
         commit: true,
-        pull_request: true,
+        pr_base_ref: options[:pr_base],
         session_id: options[:session_id]
       ).run(github_issue_number: Integer(github_issue_number))
     end
@@ -238,21 +242,24 @@ module XAeonAgents
       Pass free-form requirements to the Developer agent, which will analyze
       the codebase and produce the requested changes.
 
+      The --pr-base option gives the base ref of the Pull Request to create:
+      omit the option to not create any Pull Request.
+
       Examples:
 
         $   xaa implement "Add authentication middleware"
 
-        $   xaa implement "Refactor the database layer" --commit --pr --session-id my-session
+        $   xaa implement "Refactor the database layer" --commit --pr-base main --session-id my-session
     LONGDESC
     option :commit, type: :boolean, default: false, desc: 'Commit files at every step'
-    option :pr, type: :boolean, default: false, desc: 'Create a GitHub Pull Request for the changes'
+    option :pr_base, type: :string, default: nil, desc: 'Base git ref of the GitHub Pull Request to create (omit for no Pull Request)'
     # Implements arbitrary requirements using AI.
     #
     # @param requirements [String] Free-form requirements describing the desired changes
     def implement(requirements)
       Agents::DeveloperAgent.new(
         commit: options[:commit],
-        pull_request: options[:pr],
+        pr_base_ref: options[:pr_base],
         session_id: options[:session_id]
       ).run(requirements:)
     end

data/lib/x_aeon_agents/version.rb

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

metadata

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