feat: dev tools

2026-07-20 20:47:28 +02:00
parent a12229a147
commit cb2301d709
25 changed files with 614 additions and 7 deletions
@@ -0,0 +1,22 @@
+# Custom install scripts
+
+This directory supplies the ready-made `python` and `dotnet` scripts. They are not reserved:
+modify, replace, or remove them like any other script. Place other trusted executable install
+scripts here and add the desired file names to `AGENTCI_INSTALL_SCRIPTS`. Compose mounts the
+directory read-only at `/etc/agentci/install-scripts`.
+
+Scripts run from the cloned repository with a sanitized environment. They receive:
+
+- `DEV_TOOLS_DIR`: persistent, writable tool storage at `/var/lib/agentci/dev-tools`
+- `PATH`: `$DEV_TOOLS_DIR/bin` followed by the service path
+- `PYTHON_VERSION` and `DOTNET_CHANNEL`: configured built-in runtime versions
+
+`DEV_TOOLS_DIR` is shared by jobs through the `agentci_data` volume. Put downloaded SDK/runtime
+files beneath it and install command wrappers or symlinks into `$DEV_TOOLS_DIR/bin`; that `bin`
+directory is prepended to implementation agents' `PATH`. Environment changes made by a script do
+not persist into implementation turns.
+
+The configured scripts run in list order after the repository is cloned (or an existing agent PR
+branch is synchronized) and before the first implementation turn for `implement`, `iterate`, and
+`fix`. They do not rerun between implementation and review-revision turns within one job. Scripts
+must be executable, idempotent, and must not expect AgentCI or Gitea credentials.