x_aeon_agents 1.3.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ad694c34995a4a2ae110fbc5d9692b4fecd0ced12fd9307042d100d9eb21fef
-  data.tar.gz: 1b1ae0dfcfb2c133219969af207b216d60c42d2de08d45d05daadbab7a602041
+  metadata.gz: e3d6851438a928d374ce8f950e86122553eeb9f27e5e2f9c2dd149fa51f52fe7
+  data.tar.gz: 8a6bfdb35ae71c18033e6a8eb9111567e3dc7d3b900d7e66bf6e76411763c0e3
 SHA512:
-  metadata.gz: d5aab40193178b7db1c9e8414fe0da5036c23fe526538a9e30fa24802b187309824cb402cbd938fd62398b6a7230e9f95e80784f904e3ff00a2ef872b65fb228
-  data.tar.gz: cc5e14027141ed92f1e1e19866c360b252f055e6ed1962870cfcc4a9da34f8a9e7c1ff32f16415717661e08c4830ebfd6e76e0f9d1daf45422d09c29e56c8fa7
+  metadata.gz: df4b5684cf386d5886638caf8e1ea316f8e87d09f52ea744872af01fc238d356ce0b16412715ab9826797d17d299f7e983b1769b9101822df74f1a1f56f9cb7d
+  data.tar.gz: 75b83097f7230170cd275a6253ec00f8245ebe0b8984099990c821b7ef0a2d1a4796639f39a21fc69074dda1b61b35cf4d75d1d1b1e917d7bb07df4bb0bdbda0

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [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/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.0'
 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.0
 platform: ruby
 authors:
 - Muriel Salvan