Fix failing dump-config . Improve prepare-envs: distinguish empty list and missing value for envs to run discovery only on missing value. Fix adding finecode_extension_runner to env not declared in dependency-groups

Author: Aksem

finecode_builtin_handlers/src/finecode_builtin_handlers/create_envs_discover_envs.py

@@ -21,7 +21,7 @@ class CreateEnvsDiscoverEnvsHandler(
 ):
     """Discover and populate run_context.envs from the current project's config.
 
-    If payload.envs is already non-empty (explicit caller), those envs are
+    If payload.envs is provided (explicit caller), those envs are
     used as-is — the caller is responsible for any filtering.
     Otherwise all envs defined in ``dependency-groups`` are discovered.
     """
@@ -41,7 +41,7 @@ async def run(
         payload: create_envs_action.CreateEnvsRunPayload,
         run_context: create_envs_action.CreateEnvsRunContext,
     ) -> create_envs_action.CreateEnvsRunResult:
-        if payload.envs:
+        if payload.envs is not None:
             envs = list(payload.envs)
         else:
             project_def_path = self.project_info_provider.get_current_project_def_path()

finecode_builtin_handlers/src/finecode_builtin_handlers/dump_config_save.py

@@ -6,6 +6,7 @@
 from finecode_extension_api import code_action
 from finecode_extension_api.actions.system import dump_config_action
 from finecode_extension_api.interfaces import ifilemanager, ifileeditor
+from finecode_extension_api.resource_uri import resource_uri_to_path
 
 
 @dataclasses.dataclass
@@ -35,14 +36,15 @@ async def run(
         run_context: dump_config_action.DumpConfigRunContext,
     ) -> dump_config_action.DumpConfigRunResult:
         raw_config_str = tomlkit.dumps(run_context.raw_config_dump)
-        target_file_dir_path = payload.target_file_path.parent
+        target_file_path = resource_uri_to_path(payload.target_file_path)
+        target_file_dir_path = target_file_path.parent
 
         await self.file_manager.create_dir(dir_path=target_file_dir_path)
         async with self.file_editor.session(
             author=self.FILE_OPERATION_AUTHOR
         ) as session:
             await session.save_file(
-                file_path=payload.target_file_path, file_content=raw_config_str
+                file_path=target_file_path, file_content=raw_config_str
             )
 
         return dump_config_action.DumpConfigRunResult(

finecode_builtin_handlers/src/finecode_builtin_handlers/install_envs_discover_envs.py

@@ -23,7 +23,7 @@ class InstallEnvsDiscoverEnvsHandler(
 ):
     """Discover and populate run_context.envs from the current project's config.
 
-    If payload.envs is already non-empty (explicit caller), those envs are
+    If payload.envs is provided (explicit caller), those envs are
     used as-is — the caller is responsible for any filtering.
     Otherwise envs are discovered from dependency-groups: every dependency group
     defined in the project definition is included as an env.
@@ -44,7 +44,7 @@ async def run(
         payload: install_envs_action.InstallEnvsRunPayload,
         run_context: install_envs_action.InstallEnvsRunContext,
     ) -> install_envs_action.InstallEnvsRunResult:
-        if payload.envs:
+        if payload.envs is not None:
             envs = list(payload.envs)
         else:
             project_def_path = self.project_info_provider.get_current_project_def_path()

finecode_extension_api/src/finecode_extension_api/actions/environments/create_envs_action.py

@@ -19,8 +19,8 @@ class EnvInfo:
 
 @dataclasses.dataclass
 class CreateEnvsRunPayload(code_action.RunActionPayload):
-    envs: list[EnvInfo] = dataclasses.field(default_factory=list)
-    """Explicit list of environments to create. Empty means handlers discover envs."""
+    envs: list[EnvInfo] | None = None
+    """Explicit list of environments to create. ``None`` means handlers discover envs, empty list means explicit no-op."""
     recreate: bool = False
     """Remove and recreate existing environments from scratch even if they are already valid."""
 
@@ -43,7 +43,7 @@ def __init__(
         self.envs: list[EnvInfo] | None = None
 
     async def init(self) -> None:
-        if self.initial_payload.envs:
+        if self.initial_payload.envs is not None:
             self.envs = list(self.initial_payload.envs)
 
 

finecode_extension_api/src/finecode_extension_api/actions/environments/install_envs_action.py

@@ -14,8 +14,8 @@
 
 @dataclasses.dataclass
 class InstallEnvsRunPayload(code_action.RunActionPayload):
-    envs: list[EnvInfo] = dataclasses.field(default_factory=list)
-    """Explicit list of environments to install dependencies in. Empty means handlers discover envs at run time."""
+    envs: list[EnvInfo] | None = None
+    """Explicit list of environments to install dependencies in. ``None`` means handlers discover envs, empty list means explicit no-op."""
     env_names: list[str] | None = None
     """Filter: when set, only in environments whose name is in this list dependencies will be installed. Applied during discovery only."""
 
@@ -40,6 +40,9 @@ def __init__(
         self.project_def_by_venv_dir_path: dict[ResourceUri, dict[str, typing.Any]] = {}
 
     async def init(self) -> None:
+        if self.initial_payload.envs is None:
+            return
+
         self.envs = list(self.initial_payload.envs)
         for env_info in self.initial_payload.envs:
             self.project_def_path_by_venv_dir_path[env_info.venv_dir_path] = (

src/finecode/cli_app/commands/dump_config_cmd.py

@@ -2,6 +2,7 @@
 import pathlib
 
 from finecode.wm_client import ApiClient, ApiError
+from finecode_extension_api.resource_uri import path_to_resource_uri
 from finecode.wm_server import wm_lifecycle
 
 
@@ -50,9 +51,13 @@ async def dump_config(
                     action="dump_config",
                     project=project_path,
                     params={
-                        "source_file_path": str(source_file_path),
+                        "source_file_path": str(
+                            path_to_resource_uri(source_file_path)
+                        ),
                         "project_raw_config": project_raw_config,
-                        "target_file_path": str(target_file_path),
+                        "target_file_path": str(
+                            path_to_resource_uri(target_file_path)
+                        ),
                     },
                     options={
                         "resultFormats": ["string"],

src/finecode/cli_app/commands/prepare_envs_cmd.py

@@ -170,15 +170,18 @@ async def _check_or_remove_dw(project: dict) -> None:
 
     # Steps 3a + 3b — create virtualenvs and install deps via shared helper.
     # ('recreate' for dev_workspace envs is handled above via remove_env, no need to pass here)
-    try:
-        await create_and_install_envs(
-            client=client,
-            project_path=current_project["path"],
-            envs=dw_envs,
-            dev_env=dev_env,
-        )
-    except EnvSetupFailed as exc:
-        raise PrepareEnvsFailed(f"dev_workspace setup failed: {exc.message}") from exc
+    if dw_envs:
+        try:
+            await create_and_install_envs(
+                client=client,
+                project_path=current_project["path"],
+                envs=dw_envs,
+                dev_env=dev_env,
+            )
+        except EnvSetupFailed as exc:
+            raise PrepareEnvsFailed(f"dev_workspace setup failed: {exc.message}") from exc
+    else:
+        logger.info("No dev_workspace environments selected for bootstrap, skipping")
 
     # Step 4 — start dev_workspace runners (resolves preset-defined actions).
     logger.info("Starting dev_workspace runners...")

src/finecode/mcp_server.py

@@ -15,6 +15,7 @@
 
 from finecode.wm_client import ApiClient
 from finecode.wm_server import wm_lifecycle
+from finecode_extension_api.resource_uri import path_to_resource_uri
 from loguru import logger
 from mcp.server import Server
 from mcp.server.stdio import stdio_server
@@ -268,10 +269,14 @@ async def call_tool(name: str, arguments: dict) -> list[TextContent]:
             "dump_config",
             project,
             params={
-                "source_file_path": str(project_path / "pyproject.toml"),
+                "source_file_path": str(
+                    path_to_resource_uri(project_path / "pyproject.toml")
+                ),
                 "project_raw_config": raw_config,
                 "target_file_path": str(
-                    project_path / "finecode_config_dump" / "pyproject.toml"
+                    path_to_resource_uri(
+                        project_path / "finecode_config_dump" / "pyproject.toml"
+                    )
                 ),
             },
             options={"resultFormats": ["json"], "trigger": "user", "devEnv": "ai"},

src/finecode/wm_server/config/read_configs.py

@@ -170,10 +170,11 @@ async def read_project_config(
         # add runtime dependency group if it's not explicitly declared
         add_runtime_dependency_group_if_new(project_config)
 
-        add_extension_runner_to_dependencies(project_config)
-
         merge_handlers_dependencies_into_groups(project_config)
         merge_services_dependencies_into_groups(project_config)
+        # add extension runner after mergin handlers dependencies into groups
+        # because env may be missing in dependency-groups and be used in handlers
+        add_extension_runner_to_dependencies(project_config)
 
         ws_context.ws_projects_raw_configs[project.dir_path] = project_config
     else: