refactor(naming): replace grab-bag ops/manager module names with responsibility names

mcpp.bmi_cache.ops      -> mcpp.bmi_cache.maintenance
mcpp.scaffold.ops       -> mcpp.scaffold.create
mcpp.publish.ops        -> mcpp.publish.pipeline
mcpp.pack.ops           -> mcpp.pack.pipeline
mcpp.pm.index_ops       -> mcpp.pm.index_management
mcpp.toolchain.manager  -> mcpp.toolchain.lifecycle

Pure rename (module/file/import sites); namespaces, exported symbols and
behavior unchanged.

Author: Sunrisepeak

.agents/docs/2026-06-10-cli-modularization.md

@@ -133,17 +133,17 @@ validation of CLI shapes, and routing. Relocation map (bodies verbatim again):
 | Phase-1 location | Phase-2 owner | Contents |
 |---|---|---|
 | `mcpp.cli.common` | `mcpp.project` (`src/project.cppm`) | `find_manifest_root`, `find_workspace_root`, `merge_workspace_deps` (also folds the private copy `pm.commands` kept) |
-| `mcpp.cli.common` | `mcpp.bmi_cache.ops` | `dir_size`, `human_bytes` |
+| `mcpp.cli.common` | `mcpp.bmi_cache.maintenance` | `dir_size`, `human_bytes` |
 | `mcpp.cli.common` | `mcpp.build.prepare` (internal) | `target_dir` |
 | `mcpp.cli.install_ui` | `mcpp.fetcher.progress` (`src/fetcher/progress.cppm`) | NDJSON→ui adapters (`CliInstallProgress` → `InstallProgressHandler`), `make_bootstrap_progress_callback`, `make_path_ctx` |
 | `mcpp.cli.build` | `mcpp.build.prepare` (`src/build/prepare.cppm`) | `BuildContext`, `BuildOverrides`, `prepare_build` |
 | `mcpp.cli.cmd_build` | `mcpp.build.execute` (`src/build/execute.cppm`) | build cache + fast path, `run_build_plan`, `try_fast_build`, `build_run_target`, `run_tests`, `clean_project` |
-| `mcpp.cli.cmd_toolchain` | `mcpp.toolchain.manager` (`src/toolchain/manager.cppm`) | version matching + `toolchain_list/install/set_default/remove` |
-| `mcpp.cli.cmd_registry` | `mcpp.pm.index_ops` (`src/pm/index_ops.cppm`) | `search_packages`, `index_list/add/remove/update/pin/unpin` |
-| `mcpp.cli.cmd_cache` | `mcpp.bmi_cache.ops` (`src/bmi_cache/ops.cppm`) | `cache_list/info/prune/clean` |
-| `mcpp.cli.cmd_new` | `mcpp.scaffold.ops` (`src/scaffold/ops.cppm`) | template fetch/instantiate + `create_builtin_project` |
-| `mcpp.cli.cmd_publish` | `mcpp.publish.ops` (`src/publish/ops.cppm`) | `publish_package`, `emit_xpkg_to` |
-| `mcpp.cli.cmd_publish` | `mcpp.pack.ops` (`src/pack/ops.cppm`) | `build_and_pack` |
+| `mcpp.cli.cmd_toolchain` | `mcpp.toolchain.lifecycle` (`src/toolchain/lifecycle.cppm`) | version matching + `toolchain_list/install/set_default/remove` |
+| `mcpp.cli.cmd_registry` | `mcpp.pm.index_management` (`src/pm/index_management.cppm`) | `search_packages`, `index_list/add/remove/update/pin/unpin` |
+| `mcpp.cli.cmd_cache` | `mcpp.bmi_cache.maintenance` (`src/bmi_cache/maintenance.cppm`) | `cache_list/info/prune/clean` |
+| `mcpp.cli.cmd_new` | `mcpp.scaffold.create` (`src/scaffold/create.cppm`) | template fetch/instantiate + `create_builtin_project` |
+| `mcpp.cli.cmd_publish` | `mcpp.publish.pipeline` (`src/publish/pipeline.cppm`) | `publish_package`, `emit_xpkg_to` |
+| `mcpp.cli.cmd_publish` | `mcpp.pack.pipeline` (`src/pack/pipeline.cppm`) | `build_and_pack` |
 | `mcpp.cli.cmd_self` | `mcpp.doctor` (`src/doctor.cppm`) | `env_report`, `doctor_report`, `why_report`, `explain_code`, `self_init`, `self_config` |
 
 Resulting cli layer: `cli.cppm` (dispatcher, 481) + seven `cmd_*` adapters
@@ -153,6 +153,10 @@ the cli layer. The split rule for each command: CLI-shape validation and
 usage errors stay in the adapter; everything after lives in the domain op
 with identical statements, messages and exit codes.
 
+Naming rule: module names state the responsibility (`maintenance`, `create`,
+`pipeline`, `lifecycle`, `index_management`) — grab-bag suffixes like `ops`,
+`manager` or `utils` are not acceptable module names in this codebase.
+
 ## 5. Follow-ups (out of scope here)
 
 - Decompose `prepare_build` internally (workspace / toolchain / dep-resolution / feature phases) now that it lives in `mcpp.build.prepare`.
@@ -169,8 +173,8 @@ with identical statements, messages and exit codes.
   PR opened; CI green on linux/windows/macos.
 - 2026-06-10 (phase 2): domain relocation executed — implementations moved out
   of `mcpp.cli.*` into `mcpp.project`, `mcpp.fetcher.progress`,
-  `mcpp.build.{prepare,execute}`, `mcpp.toolchain.manager`,
-  `mcpp.pm.index_ops`, `mcpp.bmi_cache.ops`, `mcpp.scaffold.ops`,
-  `mcpp.publish.ops`, `mcpp.pack.ops`, `mcpp.doctor`; `cli/cmd_*` reduced to
+  `mcpp.build.{prepare,execute}`, `mcpp.toolchain.lifecycle`,
+  `mcpp.pm.index_management`, `mcpp.bmi_cache.maintenance`, `mcpp.scaffold.create`,
+  `mcpp.publish.pipeline`, `mcpp.pack.pipeline`, `mcpp.doctor`; `cli/cmd_*` reduced to
   parse + route adapters (~450 lines total). Self-host build + 18/18 unit
   tests pass; e2e parity with baseline re-verified.

src/bmi_cache/ops.cppm src/bmi_cache/maintenance.cppmsrc/bmi_cache/ops.cppm renamed to src/bmi_cache/maintenance.cppm

@@ -1,12 +1,12 @@
-// mcpp.bmi_cache.ops — global BMI cache inspection + pruning, and the
+// mcpp.bmi_cache.maintenance — global BMI cache inspection + pruning, and the
 // shared fs-size/byte-formatting helpers they are built on.
 // Bodies moved verbatim from the CLI layer. Zero behavior change.
 
 module;
 #include <cstdio>
 #include <cstdlib>
 
-export module mcpp.bmi_cache.ops;
+export module mcpp.bmi_cache.maintenance;
 
 import std;
 import mcpp.toolchain.stdmod;

src/cli.cppm

@@ -5,8 +5,8 @@
 //   mcpp.cli.cmd_toolchain / cmd_publish / cmd_self   (parse + route)
 //   mcpp.pm.commands                                  (add / remove / update)
 // Domain logic lives in its owning subsystem: mcpp.build.{prepare,execute},
-// mcpp.pm.index_ops, mcpp.toolchain.manager, mcpp.scaffold.ops,
-// mcpp.publish.ops, mcpp.pack.ops, mcpp.bmi_cache.ops, mcpp.doctor,
+// mcpp.pm.index_management, mcpp.toolchain.lifecycle, mcpp.scaffold.create,
+// mcpp.publish.pipeline, mcpp.pack.pipeline, mcpp.bmi_cache.maintenance, mcpp.doctor,
 // mcpp.project, mcpp.fetcher.progress.
 // See .agents/docs/2026-06-10-cli-modularization.md for the architecture.
 

src/cli/cmd_cache.cppm

@@ -1,5 +1,5 @@
 // mcpp.cli.cmd_cache — CLI parsing + routing for the `mcpp cache` family.
-// Implementations live in mcpp.bmi_cache.ops.
+// Implementations live in mcpp.bmi_cache.maintenance.
 
 module;
 #include <cstdio>
@@ -9,7 +9,7 @@ export module mcpp.cli.cmd_cache;
 
 import std;
 import mcpplibs.cmdline;
-import mcpp.bmi_cache.ops;
+import mcpp.bmi_cache.maintenance;
 import mcpp.ui;
 
 namespace mcpp::cli {

src/cli/cmd_new.cppm

@@ -1,5 +1,5 @@
 // mcpp.cli.cmd_new — CLI parsing + routing for `mcpp new`.
-// Implementation lives in mcpp.scaffold.ops.
+// Implementation lives in mcpp.scaffold.create.
 
 module;
 #include <cstdio>
@@ -10,7 +10,7 @@ export module mcpp.cli.cmd_new;
 import std;
 import mcpplibs.cmdline;
 import mcpp.scaffold;
-import mcpp.scaffold.ops;
+import mcpp.scaffold.create;
 import mcpp.ui;
 
 namespace mcpp::cli {

src/cli/cmd_publish.cppm

@@ -1,5 +1,5 @@
 // mcpp.cli.cmd_publish — CLI parsing + routing for publish / pack /
-// emit xpkg. Implementations live in mcpp.publish.ops and mcpp.pack.ops.
+// emit xpkg. Implementations live in mcpp.publish.pipeline and mcpp.pack.pipeline.
 
 module;
 #include <cstdio>
@@ -10,8 +10,8 @@ export module mcpp.cli.cmd_publish;
 import std;
 import mcpplibs.cmdline;
 import mcpp.pack;
-import mcpp.pack.ops;
-import mcpp.publish.ops;
+import mcpp.pack.pipeline;
+import mcpp.publish.pipeline;
 import mcpp.ui;
 
 namespace mcpp::cli {

src/cli/cmd_registry.cppm

@@ -1,5 +1,5 @@
 // mcpp.cli.cmd_registry — CLI parsing + routing for search and the
-// `mcpp index` family. Implementations live in mcpp.pm.index_ops.
+// `mcpp index` family. Implementations live in mcpp.pm.index_management.
 
 module;
 #include <cstdio>
@@ -9,7 +9,7 @@ export module mcpp.cli.cmd_registry;
 
 import std;
 import mcpplibs.cmdline;
-import mcpp.pm.index_ops;
+import mcpp.pm.index_management;
 import mcpp.ui;
 
 namespace mcpp::cli {

src/cli/cmd_toolchain.cppm

@@ -1,5 +1,5 @@
 // mcpp.cli.cmd_toolchain — CLI parsing + routing for the `mcpp toolchain`
-// family. Implementations live in mcpp.toolchain.manager.
+// family. Implementations live in mcpp.toolchain.lifecycle.
 
 module;
 #include <cstdio>
@@ -11,7 +11,7 @@ import std;
 import mcpplibs.cmdline;
 import mcpp.config;
 import mcpp.fetcher.progress;
-import mcpp.toolchain.manager;
+import mcpp.toolchain.lifecycle;
 import mcpp.ui;
 
 namespace mcpp::cli {

src/doctor.cppm

@@ -10,7 +10,7 @@ module;
 export module mcpp.doctor;
 
 import std;
-import mcpp.bmi_cache.ops;
+import mcpp.bmi_cache.maintenance;
 import mcpp.build.prepare;
 import mcpp.build.plan;
 import mcpp.config;

src/pack/ops.cppm src/pack/pipeline.cppmsrc/pack/ops.cppm renamed to src/pack/pipeline.cppm

@@ -1,12 +1,12 @@
-// mcpp.pack.ops — pack orchestration: build (re-preparing for musl static
+// mcpp.pack.pipeline — pack orchestration: build (re-preparing for musl static
 // when needed), pick the main binary, plan + run the bundler.
 // Bodies moved verbatim from the CLI layer. Zero behavior change.
 
 module;
 #include <cstdio>
 #include <cstdlib>
 
-export module mcpp.pack.ops;
+export module mcpp.pack.pipeline;
 
 import std;
 import mcpp.build.prepare;