x_aeon_agents 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b574fe3b6c21e4cbae12dca8cbf3388aa789014a64288bad4e34f576b4966f3
-  data.tar.gz: 5e5f82866ab3a64765e42432085cd1d377b469c0fd7c59bd0a27e8cb1c5d0bee
+  metadata.gz: 3ad694c34995a4a2ae110fbc5d9692b4fecd0ced12fd9307042d100d9eb21fef
+  data.tar.gz: 1b1ae0dfcfb2c133219969af207b216d60c42d2de08d45d05daadbab7a602041
 SHA512:
-  metadata.gz: 1856c8f3d29c2cee16b838069604048965d23ea8dce516da639e22d25e4dc1732299fd9819ce22972a0ae72fe81c5b9a9ef29e276daa178b5a84ae7d7c8c06c2
-  data.tar.gz: 1038e588d96bc6e72be99dba5087c70d8f8309e7a6fccdc26ddedfb3bd23a78ff441bc4aacba3cbd02932eef28412380ac163f23c3d41d9de7d05ea8cc286d1d
+  metadata.gz: d5aab40193178b7db1c9e8414fe0da5036c23fe526538a9e30fa24802b187309824cb402cbd938fd62398b6a7230e9f95e80784f904e3ff00a2ef872b65fb228
+  data.tar.gz: cc5e14027141ed92f1e1e19866c360b252f055e6ed1962870cfcc4a9da34f8a9e7c1ff32f16415717661e08c4830ebfd6e76e0f9d1daf45422d09c29e56c8fa7

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [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

@@ -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/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
@@ -390,6 +393,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 = '1.3.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: 1.3.0
 platform: ruby
 authors:
 - Muriel Salvan