ai-cr 3.1.1__py3-none-any.whl → 3.2.0__py3-none-any.whl

{ai_cr-3.1.1.dist-info → ai_cr-3.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ai-cr
-Version: 3.1.1
+Version: 3.2.0
 Summary: AI code review tool that works with any language model provider. It detects issues in GitHub pull requests or local changes—instantly, reliably, and without vendor lock-in.
 License: MIT
 Keywords: static code analysis,code review,code quality,ai,coding,assistant,llm,github,automation,devops,developer tools,github actions,workflows,git
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Requires-Dist: GitPython (>=3.1.44,<4.0.0)
-Requires-Dist: ai-microcore (==4.2.1)
+Requires-Dist: ai-microcore (==4.3.0)
 Requires-Dist: anthropic (>=0.57.1,<0.58.0)
 Requires-Dist: ghapi (>=1.0.6,<1.1.0)
 Requires-Dist: google-generativeai (>=0.8.5,<0.9.0)
@@ -37,10 +37,22 @@ Description-Content-Type: text/markdown
 </p>
 
 **Gito** is an open-source **AI code reviewer** that works with any language model provider.
-It detects issues in GitHub pull requests or local changes—instantly, reliably, and without vendor lock-in.
+It detects issues in GitHub pull requests or local codebase changes—instantly, reliably, and without vendor lock-in.
 
 Get consistent, thorough code reviews in seconds—no waiting for human availability.
 
+## 📋 Table of Contents
+- [Why Gito?](#-why-gito)
+- [Perfect For](#-perfect-for)
+- [Quickstart](#-quickstart)
+  - [1. Review Pull Requests via GitHub Actions](#1-review-pull-requests-via-github-actions)
+  - [2. Running Code Analysis Locally](#2-running-code-analysis-locally)
+- [Configuration](#-configuration)
+- [Documentation](#-documentation)
+- [Development Setup](#-development-setup)
+- [Contributing](#-contributing)
+- [License](#-license)
+
 ## ✨ Why Gito?
 
 - [⚡] **Lightning Fast:** Get detailed code reviews in seconds, not days — powered by parallelized LLM processing  
@@ -106,7 +118,7 @@ jobs:
           code-review-report.json
 ```
 
-> ⚠️ Make sure to add `LLM_API_KEY` to your repository’s GitHub secrets.
+> ⚠️ Make sure to add `LLM_API_KEY` to your repository's GitHub secrets.
 
 💪 Done!  
 PRs to your repository will now receive AI code reviews automatically. ✨  
@@ -180,6 +192,14 @@ See default configuration [here](https://github.com/Nayjest/Gito/blob/main/gito/
 
 More details can be found in [📖 Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
 
+## 📚 Documentation
+
+- [Command Line Reference](https://github.com/Nayjest/Gito/blob/main/documentation/command_line_reference.md)
+- [Configuration Cookbook](https://github.com/Nayjest/Gito/blob/main/documentation/config_cookbook.md)
+- [GitHub Setup Guide](https://github.com/Nayjest/Gito/blob/main/documentation/github_setup.md)
+- [Troubleshooting](https://github.com/Nayjest/Gito/blob/main/documentation/troubleshooting.md)
+
+
 ## 💻 Development Setup
 
 Install dependencies:

{ai_cr-3.1.1.dist-info → ai_cr-3.2.0.dist-info}/RECORD

@@ -1,20 +1,20 @@
 gito/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gito/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
-gito/bootstrap.py,sha256=m8g7e4sacTe7SsRKmDms1_L2ESF8TAas1lMaH3hvrl8,3218
-gito/cli.py,sha256=D0XZ7H1Xo6Q7dOL0rC6mJVNQuD7C8MAw1E01jnZXbSw,7072
-gito/cli_base.py,sha256=h0CvkfOaIYGArqNuKyAuDcJDx-hOB7H7uyfJV3afINg,2390
+gito/bootstrap.py,sha256=hJfRKTmCLKxMgzqWvTYhSF5zFKnS4t2N98BS5E7Ggew,3217
+gito/cli.py,sha256=h4Bn7BUa4Nxr1yQWcO5s6T-mBRHBJpW60rfpNvOCx5Y,8203
+gito/cli_base.py,sha256=nJGxE_zcGr51KZ4EXTFLrHwj88JIz3OQyQXL5m22FJY,2573
 gito/commands/__init__.py,sha256=B2uUQsLMEsHfNT1N3lWYm38WSuQIHFmjiGs2tdBuDBA,55
-gito/commands/deploy.py,sha256=PbNcw7Ccau2Bncpi121YDRz9gg9xvkrviytrAEFfpmw,3749
-gito/commands/fix.py,sha256=C4imdS776yl7g-KmH9Wu2PqeN4WNJh8NvSeV3pV-63g,5304
+gito/commands/deploy.py,sha256=ybmlBvuDsOXKBhNvYI9xp6ph7LaH0d39stxVUORhEjo,4965
+gito/commands/fix.py,sha256=kROlQSlW1dDDBvl0tr21vBTuH8APcKjL05xeCOOH_Mc,5375
 gito/commands/gh_post_review_comment.py,sha256=xrCauuifrUEufBjx43sw5FMtWP9seHiGYzwAq5SFnvQ,3795
 gito/commands/gh_react_to_comment.py,sha256=QAc5cZOu9GfPtbEOWH6dQYhsgFSSWFWzzZ1RPNzHxFA,7090
-gito/commands/linear_comment.py,sha256=8kCudz0cogWm8LsgLRWN-BybDq13zEqwV456JB3_7xo,1411
-gito/commands/repl.py,sha256=jJCRO-O7r_fFXZrk9f1_oAcYPOAwPi3cGI3bMoRyer8,549
-gito/commands/version.py,sha256=u3khraY95jpIoIo-ndBxXYIEvSy_uyCmiHicAXk-V28,188
-gito/config.toml,sha256=kd2fbztnr2LGaNE2BE81yt1Ed0PTF5xe_8WtTgDxxkw,18417
+gito/commands/linear_comment.py,sha256=c67A_v263rYorO43pyvSKqnV4WEVQZM8WEovDDu411M,1484
+gito/commands/repl.py,sha256=s3GxYw3m7wMi7lMDiVovvVU9xW6keL9nej7OX1lkGUE,631
+gito/commands/version.py,sha256=OdAuKtjGV9Ok2_igAs-EqdJijXCKU1dcLcA5KEz1ydg,178
+gito/config.toml,sha256=51TeM_m0_v89u3X1lmafA-D5TqjiXWc-j1W_12VBppg,17777
 gito/constants.py,sha256=1ElhE4RH0EPEq3xlhwyYRUcgr38X8wXduos0gV9yPy8,819
 gito/context.py,sha256=OBfcQOREsNx8WHANsplNrnrKYrXz1PyZyne11lSfZjw,446
-gito/core.py,sha256=YgPuVCZsoSgvskbjHmkB9Bj4cQtnxUfoBjcunSoGRJc,16289
+gito/core.py,sha256=H4DcVFt46BdqXfy1AxYFJMFlKgzLiXzBPqY4oaO6NeM,17379
 gito/env.py,sha256=TVNxqrnLefqfZt5sSg495p8UenSgHaMgTImK1rRMIlY,146
 gito/gh_api.py,sha256=2yDikXr9BM2tndYpCo-weJxjoCAlEtuPh-QBinlnHtg,4052
 gito/issue_trackers.py,sha256=XYspyaIuf0ANQSvDUea5_oOdo9tQvpZZsapI5S9g78U,1551
@@ -22,18 +22,20 @@ gito/pipeline.py,sha256=H6eiyDHUg_p3jxNVhSnyB7EVVNbMIZkA35WMymgPnh0,2610
 gito/pipeline_steps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gito/pipeline_steps/jira.py,sha256=NjFgpGFAkT5PSXi6jQ9Yr8CY9M8sa3_rMb7RFhdpoNg,1862
 gito/pipeline_steps/linear.py,sha256=6UDc8nGKGpwHruPq8VItE2QBWshWxaTapoMhu_qjN_g,2445
-gito/project_config.py,sha256=jOPVMgN01_krELlNXzZlrZOKmXZP-RLDS7iOgVSUyic,3182
+gito/project_config.py,sha256=ZdHy4aNzjlVAgTUjmznrGcdd2NHMMvGX8VeSmAnzZ34,3237
 gito/report_struct.py,sha256=96gDYnw0MXhOZrrGaNOTyWstqpjjS7_cuWufd0XJzR4,4320
+gito/tpl/answer.j2,sha256=JrBOv-a8xBqTccRJeWly2U1Y5jehc_mOBt5nSbRJldI,700
 gito/tpl/github_workflows/components/env-vars.j2,sha256=ypmf938h5PA38mXTZnP1eI4Un3AIhhmnl6wXg2X4kqI,406
 gito/tpl/github_workflows/components/installs.j2,sha256=j5wl0yVEIrXZDpAgzqBwmhXQA9End3xFspPxr2ZzHR0,693
 gito/tpl/github_workflows/gito-code-review.yml.j2,sha256=rciiX_HzygwVFTp0nUxzsLYQTRcJlR-wnft7-6gM_6Q,963
 gito/tpl/github_workflows/gito-react-to-comments.yml.j2,sha256=EpBXgFwF7jMU-Zty0usx6q2lj31Ocd_OMoTPYRg7kr0,2129
+gito/tpl/partial/aux_files.j2,sha256=lJhqnCsHBbEEocpyyOmQX27jzuLvEIuEVXY0RGqxWnY,191
 gito/tpl/questions/changes_summary.j2,sha256=N80OQoo9UKii0CWLuck5bOwbijul5RefvCqHJljenmE,2213
-gito/tpl/questions/release_notes.j2,sha256=20QtQwdZYcFEjmfYxTysenY-njTPl2nmHpv9077WFdg,849
-gito/tpl/questions/testing_guide.j2,sha256=AVnl7MoFrRxrH2A83PgV-l7VxqPE6XNRh7VksjE50as,832
+gito/tpl/questions/release_notes.j2,sha256=OXi6o7T1bum88_2Pt4FiLHmKUe86A1t9Be_3s4mrnmU,889
+gito/tpl/questions/test_cases.j2,sha256=bB7ESjy02mwWml4zyq87DqkFDj-I0-BYpfJVgzE77cc,1410
 gito/utils.py,sha256=OSBn7IeWKjoLJoGOcdgQcJHBA69UiHUChtaYMInUeko,6852
-ai_cr-3.1.1.dist-info/LICENSE,sha256=VbdF_GbbDK24JvdTfnsxa2M6jmhsxmRSFeHCx-lICGE,1075
-ai_cr-3.1.1.dist-info/METADATA,sha256=PZrnP1catEWRFiD5cjUTjCBYfydpPeLZkqFZeFQfQ-k,7989
-ai_cr-3.1.1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-ai_cr-3.1.1.dist-info/entry_points.txt,sha256=Ua1DxkhJJ8TZuLgnH-IlWCkrre_0S0dq_GtYRaYupWk,38
-ai_cr-3.1.1.dist-info/RECORD,,
+ai_cr-3.2.0.dist-info/LICENSE,sha256=VbdF_GbbDK24JvdTfnsxa2M6jmhsxmRSFeHCx-lICGE,1075
+ai_cr-3.2.0.dist-info/METADATA,sha256=jpHSdAUyaroAZRxlDG6rX2QfohgnCgrbCvFHslRguPA,8874
+ai_cr-3.2.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+ai_cr-3.2.0.dist-info/entry_points.txt,sha256=Ua1DxkhJJ8TZuLgnH-IlWCkrre_0S0dq_GtYRaYupWk,38
+ai_cr-3.2.0.dist-info/RECORD,,

gito/bootstrap.py

@@ -35,7 +35,7 @@ def bootstrap(verbosity: int = 1):
     log_levels_by_verbosity = {
         0: logging.CRITICAL,
         1: logging.INFO,
-        2: logging.DEBUG,
+        2: logging.INFO,
         3: logging.DEBUG,
     }
     Env.verbosity = verbosity

gito/cli.py

@@ -47,14 +47,31 @@ def main():
         app()
 
 
-@app.callback(invoke_without_command=True)
+@app.callback(
+    invoke_without_command=True,
+    help="\bGito is an open-source AI code reviewer that works with any language model provider."
+         "\nIt detects issues in GitHub pull requests or local codebase changes"
+         "—instantly, reliably, and without vendor lock-in."
+)
 def cli(
     ctx: typer.Context,
-    verbose: bool = typer.Option(default=None),
     verbosity: int = typer.Option(
         None,
         '--verbosity', '-v',
-        help="Set verbosity level (0-3, default 1)"
+        show_default=False,
+        help="\b"
+             "Set verbosity level. Supported values: 0-3. Default: 1."
+             "\n [ 0 ]: no additional output, "
+             "\n [ 1 ]: normal mode, shows warnings, shortened LLM requests and logging.INFO"
+             "\n [ 2 ]: verbose mode, show full LLM requests"
+             "\n [ 3 ]: very verbose mode, also debug information"
+    ),
+    verbose: bool = typer.Option(
+        default=None,
+        help="\b"
+             "--verbose is equivalent to -v2, "
+             "\n--no-verbose is equivalent to -v0. "
+             "\n(!) Can't be used together with -v or --verbosity."
     ),
 ):
     if verbose is not None and verbosity is not None:
@@ -71,7 +88,7 @@ def cli(
 
 
 @app_no_subcommand.command(name="review", help="Perform code review")
-@app.command(name="review", help="Perform code review")
+@app.command(name="review", help="Perform a code review of the target codebase changes.")
 @app.command(name="run", hidden=True)
 def cmd_review(
     refs: str = arg_refs(),
@@ -120,7 +137,7 @@ def cmd_review(
             )
 
 
-@app.command(name="ask", help="Answer questions about codebase changes")
+@app.command(name="ask", help="Answer questions about the target codebase changes.")
 @app.command(name="answer", hidden=True)
 @app.command(name="talk", hidden=True)
 def cmd_answer(
@@ -140,6 +157,10 @@ def cmd_answer(
         default=None,
         help="GitHub Pull Request number"
     ),
+    aux_files: list[str] = typer.Option(
+        default=None,
+        help="Auxiliary files that might be helpful"
+    )
 ):
     _what, _against = args_to_target(refs, what, against)
     pr = pr or os.getenv("PR_NUMBER_FROM_WORKFLOW_DISPATCH")
@@ -157,6 +178,7 @@ def cmd_answer(
         prompt_file=prompt_file,
         use_pipeline=use_pipeline,
         pr=pr,
+        aux_files=aux_files,
     )
     if post_to == 'linear':
         logging.info("Posting answer to Linear...")
@@ -164,12 +186,12 @@ def cmd_answer(
     return out
 
 
-@app.command(help="Configure LLM for local usage interactively")
+@app.command(help="Configure LLM for local usage interactively.")
 def setup():
     mc.interactive_setup(HOME_ENV_PATH)
 
 
-@app.command(name="render")
+@app.command(name="render", help="Render and display code review report.")
 @app.command(name="report", hidden=True)
 def render(
     format: str = typer.Argument(default=Report.Format.CLI),
@@ -183,7 +205,11 @@ def render(
     Report.load(file_name=source).to_cli(report_format=format)
 
 
-@app.command(help="List files in the diff. Might be useful to check what will be reviewed.")
+@app.command(
+    help="\bList files in the changeset. "
+         "\nMight be useful to check what will be reviewed if run `gito review` "
+         "with current CLI arguments and options."
+)
 def files(
     refs: str = arg_refs(),
     what: str = arg_what(),

gito/cli_base.py

@@ -30,7 +30,11 @@ def args_to_target(refs, what, against) -> tuple[str | None, str | None]:
 def arg_refs() -> typer.Argument:
     return typer.Argument(
         default=None,
-        help="Git refs to review, [what]..[against] e.g. 'HEAD..HEAD~1'"
+        help=(
+            "Git refs to review, [what]..[against] (e.g., 'HEAD..HEAD~1'). "
+            "If omitted, the current index (including added but not committed files) "
+            "will be compared to the repository’s main branch."
+        ),
     )
 
 

gito/commands/deploy.py

@@ -1,16 +1,34 @@
+import logging
 from pathlib import Path
 
 import microcore as mc
 from microcore import ApiType, ui, utils
-from git import Repo
+from git import Repo, GitCommandError
+import typer
 
+from ..core import get_base_branch
 from ..utils import version, extract_gh_owner_repo
 from ..cli_base import app
+from ..gh_api import gh_api
 
 
-@app.command(name="deploy", help="Deploy Gito workflows to GitHub Actions")
+@app.command(
+    name="deploy",
+    help="\bCreate and configure Gito GitHub Actions for current repository.\naliases: init"
+)
 @app.command(name="init", hidden=True)
-def deploy(api_type: ApiType = None, commit: bool = None, rewrite: bool = False):
+def deploy(
+    api_type: ApiType = None,
+    commit: bool = None,
+    rewrite: bool = False,
+    to_branch: str = typer.Option(
+        default="gito_deploy",
+        help="Branch name for new PR containing with Gito workflows commit"
+    ),
+    token: str = typer.Option(
+        "", help="GitHub token (or set GITHUB_TOKEN env var)"
+    ),
+):
     repo = Repo(".")
     workflow_files = dict(
         code_review=Path(".github/workflows/gito-code-review.yml"),
@@ -77,16 +95,35 @@ def deploy(api_type: ApiType = None, commit: bool = None, rewrite: bool = False)
         "Do you want to commit and push created GitHub workflows to a new branch?"
     ):
         repo.git.add([str(file) for file in workflow_files.values()])
-        branch_name = "gito_deploy"
-        if not repo.active_branch.name.startswith(branch_name):
-            repo.git.checkout("-b", branch_name)
-        repo.git.commit("-m", "Deploy Gito workflows")
-        repo.git.push("origin", branch_name)
-        print(f"Changes pushed to {branch_name} branch.")
-        print(
-            f"Please create a PR from {branch_name} to your main branch and merge it:\n"
-            f"https://github.com/{owner}/{repo_name}/compare/gito_deploy?expand=1"
-        )
+        if not repo.active_branch.name.startswith(to_branch):
+            repo.git.checkout("-b", to_branch)
+        try:
+            repo.git.commit("-m", "Deploy Gito workflows")
+        except GitCommandError as e:
+            if "nothing added" in str(e):
+                ui.warning("Failed to commit changes: nothing was added")
+            else:
+                ui.error(f"Failed to commit changes: {e}")
+                return False
+
+        repo.git.push("origin", to_branch)
+        print(f"Changes pushed to {to_branch} branch.")
+        try:
+            api = gh_api(repo=repo)
+            base = get_base_branch(repo).split('/')[-1]
+            logging.info(f"Creating PR {ui.green(to_branch)} -> {ui.yellow(base)}...")
+            res = api.pulls.create(
+                head=to_branch,
+                base=base,
+                title="Deploy Gito workflows",
+            )
+            print(f"Pull request #{res.number} created successfully:\n{res.html_url}")
+        except Exception as e:
+            mc.ui.error(f"Failed to create pull request automatically: {e}")
+            print(
+                f"Please create a PR from '{to_branch}' to your main branch and merge it:\n"
+                f"https://github.com/{owner}/{repo_name}/compare/{to_branch}?expand=1"
+            )
     else:
         print(
             "Now you can commit and push created GitHub workflows to your main repository branch.\n"

gito/commands/fix.py

@@ -15,7 +15,10 @@ from ..constants import JSON_REPORT_FILE_NAME
 from ..report_struct import Report, Issue
 
 
-@app.command(help="Fix an issue from the code review report")
+@app.command(
+    help="Fix an issue from the code review report "
+         "(latest code review results will be used by default)"
+)
 def fix(
     issue_number: int = typer.Argument(..., help="Issue number to fix"),
     report_path: Optional[str] = typer.Option(

gito/commands/linear_comment.py

@@ -29,7 +29,7 @@ def post_linear_comment(issue_key, text, api_key):
     return response.json()
 
 
-@app.command()
+@app.command(help="Post a comment with specified text to the associated Linear issue.")
 def linear_comment(
     text: str = typer.Argument(None),
     refs: str = arg_refs(),

gito/commands/repl.py

@@ -23,6 +23,8 @@ from ..utils import *
 from ..gh_api import *
 
 
-@app.command(help="python REPL")
+@app.command(
+    help="Python REPL with core functionality loaded for quick testing/debugging and exploration."
+)
 def repl():
     code.interact(local=globals())

gito/commands/version.py

@@ -2,7 +2,7 @@ from ..cli_base import app
 from ..env import Env
 
 
-@app.command(name='version', help='Show the version of gito.bot')
+@app.command(name='version', help='Show Gito version.')
 def version():
     print(Env.gito_version)
     return Env.gito_version

gito/config.toml

@@ -242,32 +242,8 @@ If there are concerns about how thoroughly the code covers the requirements and
 {{ summary_requirements -}}
 """
 answer_github_comments = true
-answer_prompt = """
-{{ self_id }}
-----TASK----
-Answer the following user question:
---USER QUESTION--
-{{ question }}
-----
-----RELATED CODEBASE CHANGES----
-{% for part in diff %}{{ part }}\n{% endfor %}
-
-----FULL FILE CONTENT AFTER APPLYING CHANGES----
-{% for file, file_lines in all_file_lines.items() %}
---FILE: {{ file }}--
-{{ file_lines }}
-{% endfor %}
-
-{%- if pipeline_out.associated_issue and pipeline_out.associated_issue.title %}
-----ASSOCIATED ISSUE----
-# {{ pipeline_out.associated_issue.title }}
-{{ pipeline_out.associated_issue.description }}
-URL: {{ pipeline_out.associated_issue.url }}
-{%- endif -%}{{ '\n' }}
-
-----ANSWERING INSTRUCTIONS----
-{{ answering_instructions }}
-"""
+answer_prompt = "tpl:answer.j2"
+aux_files = []
 [pipeline_steps.jira]
 call="gito.pipeline_steps.jira.fetch_associated_issue"
 envs=["local","gh-action"]

gito/core.py

@@ -190,7 +190,7 @@ def get_diff(
                 else:
                     logging.error(f"Can't find other merge parent for {merge_sha}")
             else:
-                logging.error(
+                logging.warning(
                     f"No merge‐commit found for {current_ref!r}→{against!r}; "
                     "falling back to merge‐base diff"
                 )
@@ -243,18 +243,20 @@ def filter_diff(
     return files
 
 
-def file_lines(repo: Repo, file: str, max_tokens: int = None, use_local_files: bool = False) -> str:
+def read_file(repo: Repo, file: str, use_local_files: bool = False) -> str:
     if use_local_files:
         file_path = Path(repo.working_tree_dir) / file
         try:
-            text = file_path.read_text(encoding='utf-8')
+            return file_path.read_text(encoding='utf-8')
         except (FileNotFoundError, UnicodeDecodeError) as e:
             logging.warning(f"Could not read file {file} from working directory: {e}")
-            text = repo.tree()[file].data_stream.read().decode('utf-8')
-    else:
-        # Read from HEAD (committed version)
-        text = repo.tree()[file].data_stream.read().decode('utf-8')
 
+    # Read from HEAD (committed version)
+    return repo.tree()[file].data_stream.read().decode('utf-8')
+
+
+def file_lines(repo: Repo, file: str, max_tokens: int = None, use_local_files: bool = False) -> str:
+    text = read_file(repo=repo, file=file, use_local_files=use_local_files)
     lines = [f"{i + 1}: {line}\n" for i, line in enumerate(text.splitlines())]
     if max_tokens:
         lines, removed_qty = mc.tokenizing.fit_to_token_size(lines, max_tokens)
@@ -265,6 +267,22 @@ def file_lines(repo: Repo, file: str, max_tokens: int = None, use_local_files: b
     return "".join(lines)
 
 
+def read_files(repo: Repo, files: list[str], max_tokens: int = None) -> dict:
+    out = dict()
+    total_tokens = 0
+    for file in files:
+        content = read_file(repo=repo, file=file, use_local_files=True)
+        total_tokens += mc.tokenizing.num_tokens_from_string(file)
+        total_tokens += mc.tokenizing.num_tokens_from_string(content)
+        if max_tokens and total_tokens > max_tokens:
+            logging.warning(
+                f"Skipping file {file} due to exceeding max_tokens limit ({max_tokens})"
+            )
+            continue
+        out[file] = content
+    return out
+
+
 def make_cr_summary(ctx: Context, **kwargs) -> str:
     return (
         mc.prompt(
@@ -428,6 +446,7 @@ def answer(
     use_pipeline: bool = True,
     prompt_file: str = None,
     pr: str | int = None,
+    aux_files: list[str] = None,
 ) -> str | None:
     try:
         repo, config, diff, lines = _prepare(
@@ -454,18 +473,33 @@ def answer(
             steps=config.pipeline_steps
         )
         pipe.run()
+
+    if aux_files or config.aux_files:
+        aux_files_dict = read_files(
+            repo,
+            (aux_files or list()) + config.aux_files,
+            config.max_code_tokens // 2
+        )
+    else:
+        aux_files_dict = dict()
+
+    if not prompt_file and config.answer_prompt.startswith("tpl:"):
+        prompt_file = str(config.answer_prompt)[4:]
+
     if prompt_file:
         prompt_func = partial(mc.tpl, prompt_file)
     else:
         prompt_func = partial(mc.prompt, config.answer_prompt)
+    prompt = prompt_func(
+        question=question,
+        diff=diff,
+        all_file_lines=lines,
+        pipeline_out=ctx.pipeline_out,
+        aux_files=aux_files_dict,
+        **config.prompt_vars,
+    )
     response = mc.llm(
-        prompt_func(
-            question=question,
-            diff=diff,
-            all_file_lines=lines,
-            pipeline_out=ctx.pipeline_out,
-            **config.prompt_vars,
-        ),
+        prompt,
         callback=make_streaming_function() if Env.verbosity == 0 else None,
     )
     return response

gito/project_config.py

@@ -32,6 +32,7 @@ class ProjectConfig:
     Defines the keyword or mention tag that triggers bot actions
     when referenced in code review comments.
     """
+    aux_files: list[str] = field(default_factory=list)
     pipeline_steps: dict[str, dict | PipelineStep] = field(default_factory=dict)
     collapse_previous_code_review_comments: bool = field(default=True)
     """

gito/tpl/{questions/testing_guide.j2 → answer.j2}

@@ -1,11 +1,9 @@
 {{ self_id }}
 ----TASK----
-Create a concise comment for QA specialists that explains how to test the code-base changes.
-Include:
-- User journeys that could be disrupted by failures
-- Relevant security scenarios and edge cases
-- Potential risk areas introduced by the changes, with suggestions for focused testing to mitigate them
-
+Answer the following user question:
+--USER QUESTION--
+{{ question }}
+----
 ----RELATED CODEBASE CHANGES----
 {% for part in diff %}{{ part }}\n{% endfor %}
 
@@ -15,9 +13,14 @@ Include:
 {{ file_lines }}
 {% endfor %}
 
+{% include "partial/aux_files.j2" %}
+
 {%- if pipeline_out.associated_issue and pipeline_out.associated_issue.title %}
 ----ASSOCIATED ISSUE----
 # {{ pipeline_out.associated_issue.title }}
 {{ pipeline_out.associated_issue.description }}
 URL: {{ pipeline_out.associated_issue.url }}
 {%- endif -%}{{ '\n' }}
+
+----ANSWERING INSTRUCTIONS----
+{{ answering_instructions }}

gito/tpl/partial/aux_files.j2

@@ -0,0 +1,8 @@
+{% if aux_files %}
+----AUXILIARY INFORMATION----
+* Use if helpful for the task.
+{% for file, text in aux_files.items() %}
+--FILE: {{ file }}--
+{{ text.strip() }}
+{%- endfor -%}
+{%- endif -%}

gito/tpl/questions/release_notes.j2

@@ -16,6 +16,8 @@ Avoid internal technical jargon or developer-specific details.
 {{ file_lines }}
 {% endfor %}
 
+{%- include "partial/aux_files.j2" -%}
+
 {%- if pipeline_out.associated_issue and pipeline_out.associated_issue.title %}
 ----ASSOCIATED ISSUE----
 # {{ pipeline_out.associated_issue.title }}

gito/tpl/questions/test_cases.j2

@@ -0,0 +1,37 @@
+{{ self_id }}
+----TASK----
+Create a concise list of manual QA test cases for the newly introduced codebase changes.
+The purpose of this document is to identify user journeys that could be disrupted by failures,
+cover security scenarios and edge cases, highlight potential risk areas introduced by the changes,
+and suggest focused testing to mitigate them.
+
+- Split the test cases into two categories:
+  - Critical
+  - Extended Coverage
+
+- Structure test cases using Markdown headers or bullet-point lists.
+
+- If the context includes the necessary details, describe the steps as thoroughly as possible—like for a junior QA
+  seeing this project for the first time.
+  If there are no details on how to perform a specific action, keep it abstract.
+  It is extremely important not to invent information.
+
+- Number test cases sequentially (C-01, C-02, E-01, E-02, etc.).
+
+----RELATED CODEBASE CHANGES----
+{% for part in diff %}{{ part }}\n{% endfor %}
+
+----FULL FILE CONTENT AFTER APPLYING CHANGES----
+{% for file, file_lines in all_file_lines.items() %}
+--FILE: {{ file }}--
+{{ file_lines }}
+{% endfor %}
+
+{%- include "partial/aux_files.j2" -%}
+
+{%- if pipeline_out.associated_issue and pipeline_out.associated_issue.title %}
+----ASSOCIATED ISSUE----
+# {{ pipeline_out.associated_issue.title }}
+{{ pipeline_out.associated_issue.description }}
+URL: {{ pipeline_out.associated_issue.url }}
+{%- endif -%}{{ '\n' }}