Add possibility to provide dev env in CLI

Author: Aksem

docs/cli.md

@@ -58,6 +58,7 @@ python -m finecode run [options] <action> [<action> ...] [payload] [--config.<ke
 | `--log-level=<level>` | Set log level: `TRACE`, `DEBUG`, `INFO`, `WARNING`, `ERROR` (default: `INFO`) |
 | `--no-env-config` | Ignore `FINECODE_CONFIG_*` environment variables |
 | `--no-save-results` | Do not write action results to the cache directory |
+| `--dev-env=<env>` | Override the detected dev environment. One of: `ai`, `ci`, `cli`, `ide`, `precommit` (default: auto-detected — see [Dev environment detection](#dev-environment-detection)) |
 
 ### Payload
 
@@ -124,6 +125,7 @@ Must be run from the workspace or project root. Creates venvs under `.venvs/<env
 | `--recreate` | Delete and recreate all venvs from scratch |
 | `--log-level=<level>` | Set log level: `TRACE`, `DEBUG`, `INFO`, `WARNING`, `ERROR` (default: `INFO`) |
 | `--debug` | Wait for a debugpy client on port 5680 before starting |
+| `--dev-env=<env>` | Override the detected dev environment. One of: `ai`, `ci`, `cli`, `ide`, `precommit` (default: auto-detected) |
 
 ---
 
@@ -142,6 +144,34 @@ Output is written to `<cwd>/finecode_config_dump/`.
 | `--project=<name>` | **(Required)** Project to dump config for |
 | `--log-level=<level>` | Set log level: `TRACE`, `DEBUG`, `INFO`, `WARNING`, `ERROR` (default: `INFO`) |
 | `--debug` | Wait for a debugpy client on port 5680 |
+| `--dev-env=<env>` | Override the detected dev environment. One of: `ai`, `ci`, `cli`, `ide`, `precommit` (default: auto-detected) |
+
+---
+
+## Dev environment detection
+
+FineCode tracks which environment triggered an action run (e.g. IDE, CLI, CI/CD). This value is passed to handlers via `RunActionMeta.dev_env` and can be used to adjust behavior — for example, to emit machine-readable output in CI.
+
+The `run`, `prepare-envs`, and `dump-config` commands detect the environment automatically:
+
+| Condition | Detected value |
+|---|---|
+| `CI` environment variable is set (any non-empty value) | `ci` |
+| Default | `cli` |
+
+The `CI` variable is set automatically by GitHub Actions, GitLab CI, CircleCI, Travis CI, Bitbucket Pipelines, and most other CI systems.
+
+Use `--dev-env=<value>` on any command to override the detected value explicitly:
+
+```bash
+# Force CI/CD mode locally
+python -m finecode run --dev-env=ci lint
+
+# Mark as a pre-commit run
+python -m finecode run --dev-env=precommit lint
+```
+
+Valid values: `ai`, `ci`, `cli`, `ide`, `precommit`.
 
 ---
 

docs/wm-protocol.md

@@ -376,7 +376,7 @@ Required: `action`, `project`. All other fields optional.
 
 `trigger` values: `"user"`, `"system"`, `"unknown"` (default: `"unknown"`)
 
-`dev_env` values: `"ide"`, `"cli"`, `"ai"`, `"precommit"`, `"cicd"` (default: `"cli"`)
+`dev_env` values: `"ide"`, `"cli"`, `"ai"`, `"precommit"`, `"ci"` (default: `"cli"`)
 
 **Result:**
 

finecode_extension_api/src/finecode_extension_api/code_action.py

@@ -29,7 +29,7 @@ class DevEnv(enum.StrEnum):
     CLI = "cli"
     AI = "ai"
     PRECOMMIT = "precommit"
-    CI_CD = "cicd"
+    CI = "ci"
 
 
 @dataclasses.dataclass

src/finecode/cli.py

@@ -16,6 +16,14 @@
 
 
 FINECODE_CONFIG_ENV_PREFIX = "FINECODE_CONFIG_"
+_VALID_DEV_ENVS = {"ide", "cli", "ai", "precommit", "ci"}
+
+
+def detect_dev_env() -> str:
+    """Detect dev environment from context. CI env var overrides the default 'cli'."""
+    if os.environ.get("CI"):
+        return "ci"
+    return "cli"
 
 # TODO: unify possibilities of CLI options and env vars
 def parse_handler_config_from_env() -> dict[str, dict[str, dict[str, str]]]:
@@ -252,6 +260,7 @@ def run(ctx) -> None:
     save_results: bool = True
     map_payload_fields: set[str] = set()
     shared_server: bool = False
+    dev_env: str = detect_dev_env()
 
     # finecode run parameters
     for arg in args:
@@ -283,6 +292,14 @@ def run(ctx) -> None:
             map_payload_fields = {f.replace("-", "_") for f in fields.split(",")}
         elif arg == "--shared-server":
             shared_server = True
+        elif arg.startswith("--dev-env"):
+            dev_env = arg.removeprefix("--dev-env=")
+            if dev_env not in _VALID_DEV_ENVS:
+                click.echo(
+                    f"Invalid --dev-env value '{dev_env}'. Valid values: {', '.join(sorted(_VALID_DEV_ENVS))}",
+                    err=True,
+                )
+                sys.exit(1)
         elif not arg.startswith("--"):
             break
         processed_args_count += 1
@@ -360,6 +377,7 @@ def run(ctx) -> None:
                 map_payload_fields,
                 own_server=not shared_server,
                 log_level=log_level,
+                dev_env=dev_env,
             )
         )
         click.echo(result.output)
@@ -389,7 +407,8 @@ def run(ctx) -> None:
 @click.option("--debug", "debug", is_flag=True, default=False)
 @click.option("--recreate", "recreate", is_flag=True, default=False)
 @click.option("--shared-server", "shared_server", is_flag=True, default=False)
-def prepare_envs(log_level: str, debug: bool, recreate: bool, shared_server: bool) -> None:
+@click.option("--dev-env", "dev_env", default=None, type=click.Choice(sorted(_VALID_DEV_ENVS)), help="Override detected dev environment")
+def prepare_envs(log_level: str, debug: bool, recreate: bool, shared_server: bool, dev_env: str | None) -> None:
     """
     `prepare-envs` should be called from workspace/project root directory.
     """
@@ -413,6 +432,7 @@ def prepare_envs(log_level: str, debug: bool, recreate: bool, shared_server: boo
                 recreate=recreate,
                 own_server=not shared_server,
                 log_level=log_level,
+                dev_env=dev_env or detect_dev_env(),
             )
         )
     except prepare_envs_cmd.PrepareEnvsFailed as exception:
@@ -429,7 +449,8 @@ def prepare_envs(log_level: str, debug: bool, recreate: bool, shared_server: boo
 @click.option("--debug", "debug", is_flag=True, default=False)
 @click.option("--project", "project", type=str)
 @click.option("--shared-server", "shared_server", is_flag=True, default=False)
-def dump_config(log_level: str, debug: bool, project: str | None, shared_server: bool):
+@click.option("--dev-env", "dev_env", default=None, type=click.Choice(sorted(_VALID_DEV_ENVS)), help="Override detected dev environment")
+def dump_config(log_level: str, debug: bool, project: str | None, shared_server: bool, dev_env: str | None):
     if debug is True:
         import debugpy
 
@@ -453,6 +474,7 @@ def dump_config(log_level: str, debug: bool, project: str | None, shared_server:
                 project_name=project,
                 own_server=not shared_server,
                 log_level=log_level,
+                dev_env=dev_env or detect_dev_env(),
             )
         )
     except dump_config_cmd.DumpFailed as exception:

src/finecode/cli_app/commands/dump_config_cmd.py

@@ -10,7 +10,7 @@ def __init__(self, message: str) -> None:
 
 
 async def dump_config(
-    workdir_path: pathlib.Path, project_name: str, own_server: bool = True, log_level: str = "INFO"
+    workdir_path: pathlib.Path, project_name: str, own_server: bool = True, log_level: str = "INFO", dev_env: str = "cli"
 ):
     port_file = None
     try:
@@ -55,7 +55,7 @@ async def dump_config(
                     options={
                         "result_formats": ["string"],
                         "trigger": "user",
-                        "dev_env": "cli",
+                        "dev_env": dev_env,
                     },
                 )
             except ApiError as exc:

src/finecode/cli_app/commands/prepare_envs_cmd.py

@@ -12,7 +12,7 @@ def __init__(self, message: str) -> None:
 
 
 async def prepare_envs(
-    workdir_path: pathlib.Path, recreate: bool, own_server: bool = True, log_level: str = "INFO"
+    workdir_path: pathlib.Path, recreate: bool, own_server: bool = True, log_level: str = "INFO", dev_env: str = "cli"
 ) -> None:
     """Prepare all virtual environments for a workspace.
 
@@ -42,7 +42,7 @@ async def prepare_envs(
         client = ApiClient()
         await client.connect("127.0.0.1", port)
         try:
-            await _run(client, workdir_path, recreate)
+            await _run(client, workdir_path, recreate, dev_env)
         finally:
             await client.close()
     finally:
@@ -51,7 +51,7 @@ async def prepare_envs(
 
 
 async def _run(
-    client: ApiClient, workdir_path: pathlib.Path, recreate: bool
+    client: ApiClient, workdir_path: pathlib.Path, recreate: bool, dev_env: str = "cli"
 ) -> None:
     # Step 1 — discover projects without starting runners (envs may not exist).
     logger.info("Discovering projects...")
@@ -135,7 +135,7 @@ async def _run(
             options={
                 "result_formats": ["string"],
                 "trigger": "user",
-                "dev_env": "cli",
+                "dev_env": dev_env,
             },
         )
     except ApiError as exc:
@@ -168,7 +168,7 @@ async def _run(
                 "concurrently": False,
                 "result_formats": ["string"],
                 "trigger": "user",
-                "dev_env": "cli",
+                "dev_env": dev_env,
             },
         )
     except ApiError as exc:

src/finecode/cli_app/commands/run_cmd.py

@@ -27,6 +27,7 @@ async def run_actions(
     map_payload_fields: set[str] | None = None,
     own_server: bool = False,
     log_level: str = "INFO",
+    dev_env: str = "cli",
 ) -> utils.RunActionsResult:
     port_file = None
     try:
@@ -78,7 +79,7 @@ async def run_actions(
                         "concurrently": concurrently,
                         "result_formats": result_formats,
                         "trigger": "user",
-                        "dev_env": "cli",
+                        "dev_env": dev_env,
                     },
                 )
             except ApiError as exc:

src/finecode/wm_server/runner/runner_client.py

@@ -104,7 +104,7 @@ class DevEnv(enum.StrEnum):
     CLI = 'cli'
     AI = 'ai'
     PRECOMMIT = 'precommit'
-    CI_CD = 'cicd'
+    CI = 'ci'
 
 
 async def run_action(