chore: migrate codebase memory to CLI defaults

Author: ngallodev

.github/workflows/_lint.yml

@@ -71,9 +71,9 @@ jobs:
       - name: Install LLVM 21 (pinned analyzer toolchain)
         run: |
           wget -qO- https://apt.llvm.org/llvm-snapshot.gpg.key | sudo tee /etc/apt/trusted.gpg.d/apt.llvm.org.asc
-          echo "deb http://apt.llvm.org/noble/ llvm-toolchain-noble-21 main" | sudo tee /etc/apt/sources.list.d/llvm-21.list
+          echo "deb http://apt.llvm.org/noble/ llvm-toolchain-noble-22 main" | sudo tee /etc/apt/sources.list.d/llvm-22.list
           sudo apt-get update
-          sudo apt-get install -y clang-tidy-21
+          sudo apt-get install -y clang-tidy-22
 
       - name: Memory-analyzer gate
-        run: scripts/ci/lint-mem.sh clang-tidy-21
+        run: scripts/ci/lint-mem.sh clang-tidy-22

Makefile.cbm

@@ -1101,11 +1101,9 @@ clean-c:
 
 # ── Linting ─────────────────────────────────────────────────────
 
-# clang-tidy and clang-format: use Homebrew LLVM on macOS, overridable via make args
-# e.g. make lint-format CLANG_FORMAT=clang-format-18
-LLVM_BIN := $(shell brew --prefix llvm 2>/dev/null)/bin
-CLANG_TIDY ?= $(shell [ -x "$(LLVM_BIN)/clang-tidy" ] && echo "$(LLVM_BIN)/clang-tidy" || echo clang-tidy)
-CLANG_FORMAT ?= $(shell [ -x "$(LLVM_BIN)/clang-format" ] && echo "$(LLVM_BIN)/clang-format" || echo clang-format)
+# Pinned lint toolchain; callers may override either binary explicitly.
+CLANG_TIDY ?= clang-tidy-22
+CLANG_FORMAT ?= clang-format-20
 CPPCHECK ?= cppcheck
 # Cppcheck is the long pole in the CI lint gate. Its own worker pool is safer
 # than partitioning LINT_SRCS across separate invocations because diagnostics,

docs/CONFIGURATION.md

@@ -1,18 +1,18 @@
 # Configuration Reference
 
-This page documents the configuration and persisted runtime files used by `codebase-memory-cli`. Several filesystem paths retain the historical `codebase-memory-mcp` name for compatibility; those paths do not represent an MCP product interface.
+This page documents the configuration and persisted runtime files used by `codebase-memory-cli`.
 
 ## At a Glance
 
 | Purpose | Path | Format | Notes |
 |---|---|---|---|
-| Global custom extension mapping | `$XDG_CONFIG_HOME/codebase-memory-mcp/config.json` | JSON | Falls back to `~/.config/codebase-memory-mcp/config.json` when `XDG_CONFIG_HOME` is unset. |
+| Global custom extension mapping | `$XDG_CONFIG_HOME/codebase-memory-cli/config.json` | JSON | Falls back to `~/.config/codebase-memory-cli/config.json` when `XDG_CONFIG_HOME` is unset. |
 | Per-project custom extension mapping | `{repo_root}/.codebase-memory.json` | JSON | Overrides conflicting global `extra_extensions` entries. |
-| CLI-managed runtime settings | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-mcp}/_config.db` | SQLite | Written by `codebase-memory-cli config set/reset`. |
-| UI settings | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-mcp}/config.json` | JSON | Stores `ui_enabled` and `ui_port`. |
-| Daemon operation log | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-mcp}/logs/cbm-daemon.log` | Structured log | Durable daemon lifecycle, watcher/indexing, UI, resource, and error events. |
-| Admission conflict log | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-mcp}/logs/daemon-conflicts.ndjson` | NDJSON | Exact-build, ABI, and canonical-cache conflicts. |
-| Activation log | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-mcp}/logs/activation-events.ndjson` | NDJSON | Install/update/uninstall activation progress and outcomes. |
+| CLI-managed runtime settings | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-cli}/_config.db` | SQLite | Written by `codebase-memory-cli config set/reset`. |
+| UI settings | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-cli}/config.json` | JSON | Stores `ui_enabled` and `ui_port`. |
+| Daemon operation log | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-cli}/logs/cbm-daemon.log` | Structured log | Durable daemon lifecycle, watcher/indexing, UI, resource, and error events. |
+| Admission conflict log | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-cli}/logs/daemon-conflicts.ndjson` | NDJSON | Exact-build, ABI, and canonical-cache conflicts. |
+| Activation log | `${CBM_CACHE_DIR:-~/.cache/codebase-memory-cli}/logs/activation-events.ndjson` | NDJSON | Install/update/uninstall activation progress and outcomes. |
 
 CBM resolves `CBM_CACHE_DIR` to a canonical per-account path before using any of these locations. The log directory and files are private to the account.
 
@@ -25,13 +25,13 @@ Two optional JSON files let you map additional file extensions to built-in langu
 Default path:
 
 ```text
-$XDG_CONFIG_HOME/codebase-memory-mcp/config.json
+$XDG_CONFIG_HOME/codebase-memory-cli/config.json
 ```
 
 Fallback when `XDG_CONFIG_HOME` is unset:
 
 ```text
-~/.config/codebase-memory-mcp/config.json
+~/.config/codebase-memory-cli/config.json
 ```
 
 ### Per-project config
@@ -67,7 +67,7 @@ Notes:
 The `config` subcommand stores runtime settings in a small SQLite database:
 
 ```text
-${CBM_CACHE_DIR:-~/.cache/codebase-memory-mcp}/_config.db
+${CBM_CACHE_DIR:-~/.cache/codebase-memory-cli}/_config.db
 ```
 
 Inspect or change values with the CLI:
@@ -105,7 +105,7 @@ Current keys:
 The optional built-in graph UI stores its settings in:
 
 ```text
-${CBM_CACHE_DIR:-~/.cache/codebase-memory-mcp}/config.json
+${CBM_CACHE_DIR:-~/.cache/codebase-memory-cli}/config.json
 ```
 
 Current format:
@@ -130,7 +130,7 @@ These environment variables affect runtime behavior:
 | Variable | Default | Description |
 |---|---|---|
 | `CBM_ALLOWED_ROOT` | *(unset)* | Confine `index_repository` to paths within this directory. When set, a `repo_path` that resolves (after symlink / `..` resolution) outside this root is refused, and the same check now applies to the graph UI's `POST /api/index` route rather than only to one request path. Unset imposes no *containment* restriction — but see the always-on limits below, which apply whether or not this is set. Useful when agentic callers operate in a repository and indexing scope must remain human-controlled. |
-| `CBM_CACHE_DIR` | `~/.cache/codebase-memory-mcp` | Override the cache directory used for indexes, `_config.db`, and UI `config.json`. |
+| `CBM_CACHE_DIR` | `~/.cache/codebase-memory-cli` | Override the cache directory used for indexes, `_config.db`, and UI `config.json`. |
 | `CBM_DIAGNOSTICS` | `false` | Enable periodic `snapshot.json` and retained `trajectory.ndjson` below a fresh owner-private directory in the system temp directory. The daemon records the randomized paths in the `diagnostics.start` discovery record (a single JSON line) in `${CBM_CACHE_DIR}/logs/cbm-daemon.log`; that one record is emitted even when `CBM_LOG_LEVEL` suppresses ordinary logging, so the paths always remain discoverable. |
 | `CBM_DOWNLOAD_URL` | GitHub releases | Override the update download URL. |
 | `CBM_LOG_LEVEL` | `info` | Set the log level to `debug`, `info`, `warn`, `error`, or `none` (or `0`-`4`). One-shot CLI messages use that command's stderr; retained detached-runtime events use `${CBM_CACHE_DIR}/logs/cbm-daemon.log`. |

scripts/ci/lint-mem.sh

@@ -15,6 +15,6 @@ set -euo pipefail
 
 cd "$(dirname "$0")/../.."
 
-CLANG_TIDY_BIN="${1:-${CLANG_TIDY:-clang-tidy}}"
+CLANG_TIDY_BIN="${1:-${CLANG_TIDY:-clang-tidy-22}}"
 
 exec make -f Makefile.cbm lint-mem-ci CLANG_TIDY="$CLANG_TIDY_BIN"

scripts/hooks/pre-commit

@@ -35,7 +35,7 @@ echo "pre-commit: running all linters in parallel..."
 # the full lint-tidy sweep surfaces thousands of pre-existing findings that
 # have nothing to do with this commit and would block every contributor who
 # has clang-tidy on PATH. `make lint-tidy` remains available for a full audit.
-make -j3 -f Makefile.cbm lint-ci lint-tidy-diff
+make -j3 -f Makefile.cbm lint-ci lint-tidy-diff CLANG_FORMAT="$FORMATTER"
 
 echo "pre-commit: security audit (source-level)..."
 scripts/security-audit.sh

scripts/lint.sh

@@ -28,8 +28,7 @@ Options:
   --ci            CI mode: cppcheck + clang-format only (no clang-tidy) —
                   exactly what _lint.yml gates on. `make lint-ci` uses this.
   VAR=VAL         Forwarded to make, e.g. CLANG_FORMAT=clang-format-20.
-                  NOTE: the project formatter is the Homebrew LLVM build; a
-                  standalone clang-format-20 produces false whole-file drift.
+                  The pinned formatter is clang-format-20.
   -h, --help      This text.
 EOF
 }

src/cli/cli.c

@@ -168,7 +168,7 @@ static const char CLI_ACTIVATION_REFUSED_MESSAGE[] =
     "error: this is NOT a running-session problem — the reservation itself "
     "failed (coordination lock, leftover state, or permissions). Nothing needs "
     "to be closed. Check the errors above, and report this with the output of "
-    "'ls -la \"${CBM_CACHE_DIR:-$HOME/.cache/codebase-memory-mcp}\"' if it "
+    "'ls -la \"${CBM_CACHE_DIR:-$HOME/.cache/codebase-memory-cli}\"' if it "
     "persists.";
 static const char CLI_ACTIVATION_PARTIAL_MESSAGE[] =
     "error: activation stopped after one or more agent configuration or "

src/daemon/application.c

@@ -708,7 +708,7 @@ static bool application_cache_dir(char out[APPLICATION_PATH_CAP]) {
     if (!home[0]) {
         return false;
     }
-    int written = snprintf(out, APPLICATION_PATH_CAP, "%s/.cache/codebase-memory-mcp", home);
+    int written = snprintf(out, APPLICATION_PATH_CAP, "%s/.cache/codebase-memory-cli", home);
     if (written <= 0 || written >= APPLICATION_PATH_CAP) {
         return false;
     }

src/discover/userconfig.c

@@ -331,7 +331,7 @@ cbm_userconfig_t *cbm_userconfig_load(const char *repo_path) {
     const char *cfg_base = cbm_app_config_dir();
     const char *cfg_fallback = cfg_base ? cfg_base : "/tmp";
     char global_path[PATH_BUF_SZ];
-    snprintf(global_path, sizeof(global_path), "%s/codebase-memory-mcp/config.json", cfg_fallback);
+    snprintf(global_path, sizeof(global_path), "%s/codebase-memory-cli/config.json", cfg_fallback);
 
     if (load_config_file(global_path, &entries, &count, cfg->global_source_sha256) != 0) {
         for (int i = 0; i < count; i++) {

src/discover/userconfig.h

@@ -2,8 +2,8 @@
  * userconfig.h — User-defined file extension → language mappings.
  *
  * Reads extra_extensions from two optional JSON config files:
- *   Global:  $XDG_CONFIG_HOME/codebase-memory-mcp/config.json
- *            (falls back to ~/.config/codebase-memory-mcp/config.json)
+ *   Global:  $XDG_CONFIG_HOME/codebase-memory-cli/config.json
+ *            (falls back to ~/.config/codebase-memory-cli/config.json)
  *   Project: {repo_root}/.codebase-memory.json
  *
  * Project config wins over global. Unknown language values warn and are