x_aeon_agents 1.2.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b574fe3b6c21e4cbae12dca8cbf3388aa789014a64288bad4e34f576b4966f3
-  data.tar.gz: 5e5f82866ab3a64765e42432085cd1d377b469c0fd7c59bd0a27e8cb1c5d0bee
+  metadata.gz: e3d6851438a928d374ce8f950e86122553eeb9f27e5e2f9c2dd149fa51f52fe7
+  data.tar.gz: 8a6bfdb35ae71c18033e6a8eb9111567e3dc7d3b900d7e66bf6e76411763c0e3
 SHA512:
-  metadata.gz: 1856c8f3d29c2cee16b838069604048965d23ea8dce516da639e22d25e4dc1732299fd9819ce22972a0ae72fe81c5b9a9ef29e276daa178b5a84ae7d7c8c06c2
-  data.tar.gz: 1038e588d96bc6e72be99dba5087c70d8f8309e7a6fccdc26ddedfb3bd23a78ff441bc4aacba3cbd02932eef28412380ac163f23c3d41d9de7d05ea8cc286d1d
+  metadata.gz: df4b5684cf386d5886638caf8e1ea316f8e87d09f52ea744872af01fc238d356ce0b16412715ab9826797d17d299f7e983b1769b9101822df74f1a1f56f9cb7d
+  data.tar.gz: 75b83097f7230170cd275a6253ec00f8245ebe0b8984099990c821b7ef0a2d1a4796639f39a21fc69074dda1b61b35cf4d75d1d1b1e917d7bb07df4bb0bdbda0

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [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
+
+* [feat: add --no-interactive flag and interactive config option](https://github.com/Muriel-Salvan/x_aeon_agents/commit/51db8e5a1723e5c89311131ac73ed7ede23a9d21)
+
 # [v1.2.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v1.1.1...v1.2.0) (2026-09-11 17:57:31)
 
 ### 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
@@ -204,7 +204,7 @@ Each of these secrets can alternatively be retrieved by custom code declared in
 - 🌿 **Task bootstrapping** — create a feature branch, set up a git worktree, push it upstream and open it in the editor, with `setup_project` and `on_open_worktree` hooks
 - 🧩 **Composable agent framework** — orchestrating agents (planner ➜ coder ➜ tester ➜ committer ➜ documenter ➜ PR creator) built on `ai-agents`/`composable_agents`, backed by a Cline/OpenRouter provider via RubyLLM
 - ⚙️ **Extensible config DSL** — optional `.x_aeon_agents.rb` file with secrets handling, per-agent model tuning (`configure_agent`) and a project test command
-- 💾 **Session persistence & debugging** — global `--session-id` to resume AI conversations and a `--debug` flag for verbose logging
+- 💾 **Session persistence & debugging** — global `--session-id` to resume AI conversations, a `--debug` flag for verbose logging and a `--no-interactive` flag to skip interactive review prompts
 - 📦 **Reusable Ruby library** — require the gem and trigger agents programmatically (e.g. `Agents::CommitterAgent.new.run`)
 
 ## Public API
@@ -266,13 +266,14 @@ Files are looked up in the following locations and evaluated from the lowest pri
 3. The path given by the `X_AEON_AGENTS_CONFIG` environment variable, if set — overrides both
 
 > [!NOTE]
-> All existing files are evaluated in this order (not just the first one found), and explicit CLI flags (`--debug`) still override everything. The file is evaluated in a cleanroom: only the DSL methods below are exposed at its top level, but regular Ruby code works inside the blocks given to those methods.
+> All existing files are evaluated in this order (not just the first one found), and explicit CLI flags (`--debug`, `--interactive`) still override everything. The file is evaluated in a cleanroom: only the DSL methods below are exposed at its top level, but regular Ruby code works inside the blocks given to those methods.
 
 #### Possible methods
 
 | Method | Description |
 | --- | --- |
 | `debug(value)` | Enable debug logging |
+| `interactive(value)` | Enable interactive content reviews (defaults to `true`) |
 | `data_dir 'dir'` | Data directory where X-Aeon Agents stores its data |
 | `cline_api_key { ... }` / `openrouter_api_key { ... }` / `github_token { ... }` | Define the code retrieving a secret |
 | `setup_project { ... }` | Steps to install the project's dependencies in a fresh worktree |
@@ -286,6 +287,12 @@ Files are looked up in the following locations and evaluated from the lowest pri
   debug true
   ```
 
+- **`interactive(value)`** — set the interactive mode: when disabled, content reviews (commit comments, implementation plans…) are accepted as-is, without opening any file nor prompting the user. Defaults to `true`:
+
+  ```ruby
+  interactive false
+  ```
+
 - **`data_dir(path)`** — set the data directory where X-Aeon Agents stores its data (sessions, etc.). Defaults to `.x_aeon_agents`:
 
   ```ruby
@@ -357,6 +364,7 @@ Public methods:
 - `data_dir` / `data_dir=` — data directory (`.x_aeon_agents` by default). [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#data_dir-class_method)
 - `default_cline_cli_args` / `default_cline_cli_args=` — default Cline CLI arguments. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#default_cline_cli_args-class_method)
 - `debug` / `debug=` — enable debug logging. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#debug-class_method)
+- `interactive` / `interactive=` — enable interactive content reviews (defaults to true). [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#interactive-class_method)
 - `config_paths` — candidate paths of the optional `.x_aeon_agents.rb` config file. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#config_paths-class_method)
 - `logger` — the shared logger instance. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#logger-class_method)
 
@@ -440,7 +448,7 @@ The documented public methods (browseable on RubyDoc.info):
 
 - The [`xaa`](https://github.com/Muriel-Salvan/x_aeon_agents/blob/main/bin/xaa) executable boots [Zeitwerk](https://github.com/fxn/zeitwerk) auto-loading and calls `XAeonAgents::Cli.start(ARGV)`.
 - The CLI ([`lib/x_aeon_agents/cli.rb`](https://github.com/Muriel-Salvan/x_aeon_agents/blob/main/lib/x_aeon_agents/cli.rb)) is a [Thor](https://github.com/rails/thor) application: every sub-command (`commit`, `create-pr`, `review-comments`, `implement-issue`, `generate-readme`…) maps **1:1** to an agent class.
-- On startup it loads the optional `.x_aeon_agents.rb` config (home directory, then project directory) so project-level settings override global ones, and explicit CLI flags (`--session-id`, `--debug`) override both.
+- On startup it loads the optional `.x_aeon_agents.rb` config (home directory, then project directory) so project-level settings override global ones, and explicit CLI flags (`--session-id`, `--debug`, `--interactive`) override both.
 
 ### Agents as composable workflows 🧩
 

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

@@ -8,6 +8,9 @@ module XAeonAgents
     # Defaults to nil so the absence of the flag can be told apart from an
     # explicit --no-debug (which lets the config file or ENV take precedence).
     class_option :debug, type: :boolean, default: nil, desc: 'Enable debug mode'
+    # Defaults to nil so the absence of the flag can be told apart from an
+    # explicit --no-interactive (which lets the config file take precedence).
+    class_option :interactive, type: :boolean, default: nil, desc: 'Enable interactive prompts with the user'
 
     # --------------------------------------------------------------------------- #
     # review-comments: Address Pull Request review comments
@@ -100,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)
@@ -207,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
@@ -235,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
@@ -390,6 +400,7 @@ module XAeonAgents
         super
         Config.load
         Config.debug = options[:debug] unless options[:debug].nil?
+        Config.interactive = options[:interactive] unless options[:interactive].nil?
       end
     end
   end

data/lib/x_aeon_agents/config.rb

@@ -98,6 +98,19 @@ module XAeonAgents
         @debug ||= ENV['X_AEON_AGENTS_DEBUG'] == '1'
       end
 
+      # @return [Boolean] The interactive mode, controlling whether content reviews prompt the user
+      attr_writer :interactive
+
+      # Get the interactive mode.
+      # Defaults to true when never explicitly set, and honors an explicit false.
+      #
+      # @return [Boolean] The interactive mode
+      def interactive
+        return true if @interactive.nil?
+
+        @interactive
+      end
+
       # Candidate absolute paths of the configuration file, ordered by increasing
       # priority (lowest first): user home directory, current directory, then the
       # path given by the X_AEON_AGENTS_CONFIG environment variable if set.

data/lib/x_aeon_agents/config_dsl.rb

@@ -15,6 +15,16 @@ module XAeonAgents
 
     expose :debug
 
+    # Set the interactive mode, controlling whether content reviews prompt the user.
+    #
+    # Parameters::
+    # * *value* (Boolean): The interactive mode to set
+    def interactive(value)
+      Config.interactive = value
+    end
+
+    expose :interactive
+
     # Set the data directory used by X-Aeon Agents to store its data.
     #
     # Parameters::

data/lib/x_aeon_agents/helpers.rb

@@ -140,6 +140,10 @@ module XAeonAgents
 
       # Allow user to review and edit content before using it
       #
+      # When the interactive mode is disabled (Config.interactive), no review file
+      # is written, nothing is opened and no user input is asked: the given content
+      # is accepted as-is and an empty user prompt is returned.
+      #
       # @param reviews_dir [String] Directory that can be used to store files to be reviewed
       # @param name [String] Name used for the temporary file
       # @param description [String] Description shown to the user
@@ -147,8 +151,8 @@ module XAeonAgents
       # @param promptable [Boolean] Indicates if user can issue a prompt as an answer
       # @param content [String] Initial content to present
       # @return [Array<String>] 2 values are returned:
-      #   - [String] Content after user review (same as content if editable is false)
-      #   - [String] User prompt
+      #   - [String] Content after user review (same as content if editable is false or the interactive mode is disabled)
+      #   - [String] User prompt (empty when the interactive mode is disabled)
       def review_content(
         reviews_dir: "#{Config.data_dir}/reviews",
         name: 'content.txt',
@@ -157,6 +161,10 @@ module XAeonAgents
         promptable: false,
         content: ''
       )
+        # When the interactive mode is disabled, accept the content as-is without
+        # writing any review file nor asking anything to the user.
+        return [content, ''] unless Config.interactive
+
         content_file = "#{reviews_dir}/#{Time.now.utc.strftime('%F-%H-%M-%S')}-#{name}"
         FileUtils.mkdir_p File.dirname(content_file)
         File.write(content_file, content)

data/lib/x_aeon_agents/version.rb

@@ -2,5 +2,5 @@ module XAeonAgents
   # @!group Global API
 
   # Gem version
-  VERSION = '1.2.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.2.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Muriel Salvan