x_aeon_agents 2.5.2 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9335b5b614f216f907d1d037d55e638c38f198c4b751315a5e6d72cc77a2fffb
-  data.tar.gz: 378fd87405123a74a699df2201a2285e457447821d64a012440309a441e708ce
+  metadata.gz: 6323f2cbc9b16f49f9df7835a4b9f3e81fa86595fca7a604d5ddde5e0fa2cecb
+  data.tar.gz: a363a91843357a43eea6902010740310d321871f9569ae33a0c0ec21118ff213
 SHA512:
-  metadata.gz: c5aaecd754792a6f841eb8ebf419ef98226c2198db25fb29310046936a217def99801778662cdc819253935e41ffa8c8727b5eced18081939a4d9bbd8ba0fe72
-  data.tar.gz: b9aa3a1dfa88b1cde256eedf95ab4649a77b69a0bd58fd9d19bb9d1f97490538f314bbe2d61a6ebda298d5eae1b42838bbe943f5c14068f9d95956acadd37b8d
+  metadata.gz: c958b88bb43ecb651a80394ce8b91c05fed473847b284caaa23e5130c0806b170a5d7d2a2efeb053656209d548c435ca3be8a91dab23011477bf20a5c662894b
+  data.tar.gz: aa676eb64ed126cfde789621476e410f170bcb3a47b0bbcda07e573b029e03ca852ea0acf99cd5d0c5277cb10fa5765df1fd1b8bcfd7f7b5d8f774d240697303

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+# [v2.6.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.5.3...v2.6.0) (2026-11-06 19:39:17)
+
+## Global changes
+### Patches
+
+* [feat(agents): scope repository file access in agent prompts](https://github.com/Muriel-Salvan/x_aeon_agents/commit/703f1a0b672018fd11f8ae266054c330d887e4e7)
+
+## Changes for agents
+### Features
+
+* [feat(agents): scope repository file access in agent prompts](https://github.com/Muriel-Salvan/x_aeon_agents/commit/703f1a0b672018fd11f8ae266054c330d887e4e7)
+
+# [v2.5.3](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.5.2...v2.5.3) (2026-11-06 18:10:39)
+
+### Patches
+
+* [test(specs): cover PR author crediting and README section headers](https://github.com/Muriel-Salvan/x_aeon_agents/commit/f4a4ce6adc39b644e3d77377e8728b44eaa3394a)
+
 # [v2.5.2](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.5.1...v2.5.2) (2026-11-06 17:41:01)
 
 ## Global changes

data/TODO.md

@@ -1,5 +1,3 @@
-* Add the repository to be worked on in the prompts, and with the constraint that it should not edit files outside of this repo:
-  - - "Your git repository root is the current working directory. Use __relative__ paths only, and always prefix commands with `git rev-parse --show-toplevel` verification; never use `/workspace` absolute paths (that is a *different* checkout of the base branch)."
 * Improve prompts:
   - "Never create files (`ARTIFACT_*`, `/tmp/*`) to hold artifacts. Put the fenced ` ```json output_artifact=… ` block in your final message and end the turn with __no tool call__. If `ARTIFACT_PLAN_MODIFICATIONS` has nothing to report, say so in plain text."
 * Improve Tester prompt:

data/lib/x_aeon_agents/agents/coder_agent.rb

@@ -24,6 +24,8 @@ module XAeonAgents
             Given the user's prompt, you should use the tools available to you to answer user's question.
           EO_OBJECTIVE
           system_instructions: <<~EO_INSTRUCTIONS,
+            #{Helpers.repository_access_system_instructions}
+
             Always gather all the necessary context before starting to work on a task.
             For example, if you are generating a unit test or new code, make sure you understand the requirement, the naming conventions, frameworks and libraries used and aligned in the current codebase, and the environment and commands used to run and test the code etc.
             Always validate the new unit test at the end including running the code if possible for live feedback.
@@ -59,6 +61,7 @@ module XAeonAgents
               emit independent read_files, search_codebase, and run_commands calls together in one response;
               emit multiple editor calls together when editing different files or non-overlapping regions.
             - Always verify the files you have edited or created at the end of the task to ensure they are completed and working as expected.
+            - #{Helpers.repository_access_constraint(writable: true)}
 
             REMEMBER, be helpful and proactive!
             Don't ask for permission to do something when you can do it!

data/lib/x_aeon_agents/agents/documenter_agent.rb

@@ -22,6 +22,22 @@ module XAeonAgents
         super(
           name: 'Documenter',
           objective: 'Ensure documentation reflects the current product behavior and usage after a new development.',
+          system_instructions: <<~EO_INSTRUCTIONS,
+            #{Helpers.repository_access_system_instructions}
+
+            Always gather all the necessary context before starting to work on a task.
+            For example, make sure you understand the current behavior of the product by exploring the code, the tests, the existing documentation and the configuration files, so that the documentation you write reflects the current state of the project.
+            Begin by analyzing the user's input and gathering any necessary additional context.
+            Then, present your plan at the start of your response along with tool calls before proceeding with the task.
+            It's OK for this section to be quite long.
+
+            Review each question carefully and answer it with detailed, accurate information.
+
+            If you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.
+
+            When you have completed the task, please provide a summary of what you did and any relevant information that the user should know.
+            This will help ensure that the user understands the changes made and can easily follow up if they have any questions or need further assistance.
+          EO_INSTRUCTIONS
           constraints: <<~EO_CONSTRAINTS,
             - Only update documentation files.
             - Do NOT change any code or test.
@@ -29,6 +45,7 @@ module XAeonAgents
             - NEVER explain that something was removed, renamed, or fixed.
             - Documentation describes the CURRENT STATE only.
             - Documentation is NOT a changelog.
+            - #{Helpers.repository_access_constraint(writable: true)}
           EO_CONSTRAINTS
           **agent_params
         )

data/lib/x_aeon_agents/agents/feedback_analyst_agent.rb

@@ -43,11 +43,21 @@ module XAeonAgents
           name: 'Feedback analyst',
           role: 'You are a feedback analyst agent, analyzing feedback from a Pull Request and devising new requirements to address this feedback.',
           objective: 'Extract requirements from Pull Request comments',
+          system_instructions: <<~EO_INSTRUCTIONS,
+            #{Helpers.repository_access_system_instructions}
+
+            Always gather all the necessary context before starting to work on a task: read the Pull Request description, files diffs and conversations, and explore the repository's code when needed.
+            Begin by analyzing the user's input and gathering any necessary additional context.
+            Review each question carefully and answer it with detailed, accurate information.
+            If you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.
+            Do not indicate that you will perform an action without actually doing it.
+          EO_INSTRUCTIONS
           constraints: <<~EO_CONSTRAINTS,
             - You are in read-only mode.
             - Do NOT modify or write any file.
             - Focus only on agent-directed comments (/agent) for requirement extraction.
             - Output clear, actionable requirements or "No requirements" if none exist.
+            - #{Helpers.repository_access_constraint}
           EO_CONSTRAINTS
           **agent_params
         )

data/lib/x_aeon_agents/agents/plan_generator_agent.rb

@@ -32,11 +32,21 @@ module XAeonAgents
           name: 'Plan generator',
           role: 'You are an implementation plan generator agent',
           objective: 'Produce a full and detailed implementation plan that can be used to implement some requirements.',
+          system_instructions: <<~EO_INSTRUCTIONS,
+            #{Helpers.repository_access_system_instructions}
+
+            Always gather all the necessary context before starting to work on a task: read the relevant code, tests, documentation and configuration files of the repository.
+            Begin by analyzing the user's input and gathering any necessary additional context.
+            Review each question carefully and answer it with detailed, accurate information.
+            If you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.
+            Do not indicate that you will perform an action without actually doing it.
+          EO_INSTRUCTIONS
           constraints: <<~EO_CONSTRAINTS,
             - You are in read-only mode.
             - Do NOT modify or write any file.
             - You may only analyze and propose plans.
             - Do NOT execute the plan yourself.
+            - #{Helpers.repository_access_constraint}
           EO_CONSTRAINTS
           **agent_params
         )

data/lib/x_aeon_agents/agents/readme/about_analyzer_agent.rb

@@ -39,12 +39,20 @@ module XAeonAgents
               - The 1-line description of the project, using Markdown.
               - A high-level overview (about section) of the project in Markdown format, compatible with Github flavor.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifacts content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact contents: only provide the content as required.
               - Only focus on the specific scope of the required documentation required.
                 Other agents will generate other sections of the README.
                 Do not try to document other parts.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/contributing_agent.rb

@@ -29,6 +29,13 @@ module XAeonAgents
               Focus on giving community specific guidelines (issues, pull requests, CI, fork...).
               Use emphasis, bullet points, useful links to the project resources and small emojis to better format your section.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
@@ -37,6 +44,7 @@ module XAeonAgents
                 Do not try to document other parts.
               - Do not describe the technical setup or prequisites, as they are already covered by other sections.
               - Do not cover how to develop in this project: it is already covered in other sections.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/development_agent.rb

@@ -36,6 +36,13 @@ module XAeonAgents
               - package the project deliverables,
               - perform common development tasks.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
@@ -44,6 +51,7 @@ module XAeonAgents
                 Do not try to document other parts.
               - Do not cover the end-user main requirements and prerequisites: they are already covered in other sections.
               - Do not cover the contribution workflow (pull requests, CI, issues...): this is already covered in other sections.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/documentation_agent.rb

@@ -27,12 +27,20 @@ module XAeonAgents
               Explore the project's documentation files and resources to identify all available documentation.
               Generate a "Documentation" section in Markdown format, compatible with Github flavor, providing links to documentation resources.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
               - Only focus on the specific scope of the required documentation required.
                 Other agents will generate other sections of the README.
                 Do not try to document other parts.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/features_agent.rb

@@ -29,12 +29,20 @@ module XAeonAgents
               Use emphasis, bullet points and small emojis to illustrate in a readable way the list of features.
               Don't provide an overall description of the project: another section is already doing it.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
               - Only focus on the specific scope of the required documentation required.
                 Other agents will generate other sections of the README.
                 Do not try to document other parts.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/how_it_works_agent.rb

@@ -30,6 +30,13 @@ module XAeonAgents
               You can use SocratiCode if it is available to get a better understanding of this project.
               You can use Mermaid graphs to also illustrate the way this project works.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
@@ -37,6 +44,7 @@ module XAeonAgents
                 Other agents will generate other sections of the README.
                 Do not try to document other parts.
               - Do not provide long paragraphs: focus on readability by splitting long paragraphs into several short ones.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/license_agent.rb

@@ -27,12 +27,20 @@ module XAeonAgents
               Analyze the project's LICENSE file to identify the license type and terms.
               Generate a "License" section in Markdown format, compatible with Github flavor, describing the project license.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
               - Only focus on the specific scope of the required documentation required.
                 Other agents will generate other sections of the README.
                 Do not try to document other parts.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/public_api_agent.rb

@@ -27,6 +27,13 @@ module XAeonAgents
               Analyze the project's codebase to identify all public APIs, classes, methods, and interfaces exposed to users.
               Generate a "Public API" section in Markdown format, compatible with Github flavor, documenting the public API surface.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
@@ -34,6 +41,7 @@ module XAeonAgents
                 Other agents will generate other sections of the README.
                 Do not try to document other parts.
               - Only document public API entry points: executables and library public methods belonging to yarn `Public API` group.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/quick_start_agent.rb

@@ -33,6 +33,13 @@ module XAeonAgents
               - If this project defines a web app, explain how to install this web app, run it and access it using a web browser.
               This section should be concise: don't cover all features, just simple install and startup guides for the main happy paths.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
@@ -40,6 +47,7 @@ module XAeonAgents
                 Other agents will generate other sections of the README.
                 Do not try to document other parts.
               - This section is not meant for developers: don't describe how to develop, test, document, package or contribute to this project.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/readme/requirements_agent.rb

@@ -27,12 +27,20 @@ module XAeonAgents
               Analyze the project's dependencies, runtime environment, and prerequisites.
               Generate a "Requirements" section in Markdown format, compatible with Github flavor, listing all prerequisites needed to use or run the project.
             EO_OBJECTIVE
+            system_instructions: <<~EO_INSTRUCTIONS,
+              #{Helpers.repository_access_system_instructions}
+
+              Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
+              If you need more information, use one of the available tools instead of making assumptions.
+              Do not indicate that you will perform an action without actually doing it.
+            EO_INSTRUCTIONS
             constraints: <<~EO_CONSTRAINTS,
               - The required output artifact content should only contain the required content, without additional header or title.
               - Do not explain or describe the artifact content: only provide the content as required.
               - Only focus on the specific scope of the required documentation required.
                 Other agents will generate other sections of the README.
                 Do not try to document other parts.
+              - #{Helpers.repository_access_constraint}
             EO_CONSTRAINTS
             **agent_params
           )

data/lib/x_aeon_agents/agents/tester_agent.rb

@@ -42,6 +42,26 @@ module XAeonAgents
             Fix any regression that has been induced by new features or fixes, while keeping the initial requirements and implementation plan in mind.
             If the decisions taken in the implementation plan prevent you from fixing regressions, modify the implementation plan and report those modifications to the user.
           EO_OBJECTIVE
+          system_instructions: <<~EO_INSTRUCTIONS,
+            #{Helpers.repository_access_system_instructions}
+
+            Always gather all the necessary context before starting to work on a task.
+            For example, make sure you understand the regressions to fix, the naming conventions, frameworks and libraries used and aligned in the current codebase, and the environment and commands used to run and test the code etc.
+            Always run the whole tests suite using the tests command provided, and validate your fixes with live feedback until all tests pass.
+            Begin by analyzing the user's input and gathering any necessary additional context.
+            Then, present your plan at the start of your response along with tool calls before proceeding with the task.
+            It's OK for this section to be quite long.
+
+            Review each question carefully and answer it with detailed, accurate information.
+
+            If you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.
+
+            When you have completed the task, please provide a summary of what you did and any relevant information that the user should know, including the final summary line of the tests suite.
+            This will help ensure that the user understands the changes made and can easily follow up if they have any questions or need further assistance.
+          EO_INSTRUCTIONS
+          constraints: <<~EO_CONSTRAINTS,
+            - #{Helpers.repository_access_constraint(writable: true)}
+          EO_CONSTRAINTS
           **agent_params
         )
       end

data/lib/x_aeon_agents/helpers.rb

@@ -149,6 +149,25 @@ module XAeonAgents
         end
       end
 
+      # Get the system instructions telling agents in which repository they are working.
+      # This instruction is format-agnostic: it does not include any formatting (bullet, header...) so that it can be
+      # included in any system instructions section.
+      #
+      # @return [String] The system instructions about the current repository
+      def repository_access_system_instructions
+        "The current repository in which you are working is `#{Dir.pwd}`."
+      end
+
+      # Get the constraint restricting the files agents are allowed to access.
+      # This constraint is format-agnostic: it does not include any formatting (bullet, header...) so that it can be
+      # included in any constraints section.
+      #
+      # @param writable [Boolean] True if the agent is allowed to write files, false if it is read-only
+      # @return [String] The constraint restricting the agents' file accesses to the current repository
+      def repository_access_constraint(writable: false)
+        "You should only #{writable ? 'read and write' : 'read'} files that are part of the current repository: `#{Dir.pwd}`"
+      end
+
       # Allow user to review and edit content before using it
       #
       # When the interactive mode is disabled (Config.interactive), no review file

data/lib/x_aeon_agents/version.rb

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

metadata

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