Method _run_sub_modules

codewiki/src/be/caw_toolkit.py:271–316

(self, sub_module_specs: dict[str, list[str]])

        # emits MCP progress notifications so the CLI does not treat the long
        # tool call as a stalled / cancelled invocation.
        work = asyncio.create_task(asyncio.to_thread(self._run_sub_modules, sub_module_specs))
        heartbeat = asyncio.create_task(_heartbeat(ctx, work))
        try:
            return await work
        finally:
            heartbeat.cancel()
            with contextlib.suppress(asyncio.CancelledError):
                await heartbeat

    # ------------------------------------------------------------------
    # Internal: synchronous recursion driver
    # ------------------------------------------------------------------

    def _run_sub_modules(self, sub_module_specs: dict[str, list[str]]) -> str:
        deps = self._deps
        previous_module_name = deps.current_module_name

        # Resolve name collisions against the module tree and files already on
        # disk before touching the tree (issue #76): names are unique across the wiki.
        # A request that is already documented (plain or parent-prefixed name) is
        # skipped rather than renamed x_2, x_3, ... (issue #113).
        plan = plan_sub_module_specs(
            sub_module_specs,
            previous_module_name,
            deps.module_tree,
            deps.absolute_docs_path,
        )
        name_map = plan.name_map
        layout = config_layout(deps.config)
        parent_path = list(deps.path_to_current_module)
        if not name_map:
            return skipped_report(
                plan.skipped, module_doc_file(previous_module_name, parent_path, layout)
            )
        final_specs = {
            name_map[requested_name]: core_ids
            for requested_name, core_ids in sub_module_specs.items()
            if requested_name in name_map
        }

        # Add sub-modules to the in-memory module tree.
        value = deps.module_tree
        for key in deps.path_to_current_module:
            value = value[key]["children"]
        for sub_name, core_ids in final_specs.items():
            value[sub_name] = {"components": core_ids, "children": {}}

        try:
            for sub_name, core_ids in final_specs.items():