code-aide 1.5.0__tar.gz → 1.7.0__tar.gz

{code_aide-1.5.0 → code_aide-1.7.0}/AGENTS.md

@@ -3,15 +3,20 @@
 ## Key Design Decisions
 
 - No external dependencies - stdlib only
-- Three-layer version data: bundled definitions, bundled baseline versions,
+- Two-layer version data: bundled definitions (with SHA256 checksums),
   user's local cache (~/.config/code-aide/versions.json)
 - All tests should pass before committing
-- pre-commit runs black and ruff on commit; run `pre-commit run --all-files` to
-  check before committing
-- When changing pyproject.toml dependencies, run `uv lock` and commit uv.lock
+- pre-commit runs black and ruff on commit; run `black` to format and then
+ `pre-commit run --all-files` to check before committing
+- When changing pyproject.toml dependencies, run `uv lock` and commit
+  uv.lock
 - Write useful commit messages: start subjects with past-tense action verbs
   (`Added`, `Changed`, `Fixed`, `Removed`), keep them user-facing, and keep
   commits focused.
 - Python 3.11+ compatible
 - Keep files under 300 lines where practical
-- Run `format-markdown` on markdown files before commits (if it is available)
+- Run `format-markdown` on markdown files before commits (if it is
+  available)
+- When pushing tags, always push them explicitly with `git push <remote>
+  <tag>` rather than relying on `--follow-tags`, which silently skips tags
+  when the branch commits are already on the remote

{code_aide-1.5.0 → code_aide-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-aide
-Version: 1.5.0
+Version: 1.7.0
 Summary: Manage AI coding CLI tools (Claude, Copilot, Cursor, Gemini, Amp, Codex)
 Project-URL: Homepage, https://github.com/dajobe/code-aide
 Project-URL: Repository, https://github.com/dajobe/code-aide
@@ -74,9 +74,6 @@ code-aide update-versions -n
 
 # Update version cache
 code-aide update-versions -y
-
-# Update bundled version baseline (developer use, before releases)
-code-aide update-versions -b -y
 ```
 
 ## Supported Tools
@@ -94,22 +91,18 @@ code-aide update-versions -b -y
 
 ## How Version Data Works
 
-code-aide uses a three-layer version data model:
-
-1. **Tool definitions** (bundled with the package): Install methods, URLs,
-   npm packages, version args. Updated by releasing new versions of
-   code-aide.
+code-aide uses a two-layer version data model:
 
-2. **Bundled version baseline** (in `data/tools.json`): Latest versions and
-   SHA256 hashes as known at release time. Acts as a fallback for fresh
-   installs.
+1. **Bundled tool definitions** (in `data/tools.json`): Install methods,
+   URLs, npm packages, version args, and SHA256 checksums. Updated by
+   releasing new versions of code-aide.
 
-3. **User's local version cache** (`~/.config/code-aide/versions.json`):
-   Written by `code-aide update-versions`. Takes precedence over bundled
-   data when present.
+2. **User's local version cache** (`~/.config/code-aide/versions.json`):
+   Written by `code-aide update-versions`. Provides latest versions, dates,
+   and updated SHA256 checksums.
 
-Run `code-aide update-versions` to get fresher version data without waiting
-for a new code-aide release.
+Run `code-aide update-versions` to get the latest version data without
+waiting for a new code-aide release.
 
 ## Features
 
@@ -147,29 +140,26 @@ uv run pytest tests/test_install.py::TestDetectOsArch -v
 
 `publish.yml` publishes to PyPI when a Git tag matching `v*` is pushed.
 
-1. Update the bundled version baseline:
-   - `code-aide update-versions -b -y`
-   - `git add src/code_aide/data/tools.json`
-   - `git commit -m "Updated bundled version data"`
-2. Update the version string in `src/code_aide/__init__.py` (`__version__`).
+1. Update the version string in `src/code_aide/__init__.py` (`__version__`).
    `pyproject.toml` reads it automatically via Hatchling.
-3. Run checks:
+2. Run checks:
    - `uv run pytest tests/ -v`
    - `uv build`
-4. Commit the release version bump:
+3. Commit the release version bump:
    - `git add src/code_aide/__init__.py`
    - `git commit -m "Bumped version to X.Y.Z"`
-5. Write useful commit messages before tagging:
+4. Write useful commit messages before tagging:
    - Start subject lines with an action verb in past tense (`Added`,
      `Changed`, `Fixed`, `Removed`).
    - Keep subjects user-facing so auto-generated release notes are
      meaningful.
    - Group related changes into focused commits instead of one broad commit.
    - Example: `Fixed timeout handling in status command`
-6. Tag and push:
+5. Tag and push:
    - `git tag vX.Y.Z`
-   - `git push origin main --follow-tags`
-7. Confirm GitHub Actions:
+   - `git push origin main`
+   - `git push origin vX.Y.Z`
+6. Confirm GitHub Actions:
    - CI should pass.
    - Publish workflow should upload to PyPI and create GitHub Release notes.
    - Release notes should include generated notes plus a commit summary from

{code_aide-1.5.0 → code_aide-1.7.0}/README.md

@@ -48,9 +48,6 @@ code-aide update-versions -n
 
 # Update version cache
 code-aide update-versions -y
-
-# Update bundled version baseline (developer use, before releases)
-code-aide update-versions -b -y
 ```
 
 ## Supported Tools
@@ -68,22 +65,18 @@ code-aide update-versions -b -y
 
 ## How Version Data Works
 
-code-aide uses a three-layer version data model:
-
-1. **Tool definitions** (bundled with the package): Install methods, URLs,
-   npm packages, version args. Updated by releasing new versions of
-   code-aide.
+code-aide uses a two-layer version data model:
 
-2. **Bundled version baseline** (in `data/tools.json`): Latest versions and
-   SHA256 hashes as known at release time. Acts as a fallback for fresh
-   installs.
+1. **Bundled tool definitions** (in `data/tools.json`): Install methods,
+   URLs, npm packages, version args, and SHA256 checksums. Updated by
+   releasing new versions of code-aide.
 
-3. **User's local version cache** (`~/.config/code-aide/versions.json`):
-   Written by `code-aide update-versions`. Takes precedence over bundled
-   data when present.
+2. **User's local version cache** (`~/.config/code-aide/versions.json`):
+   Written by `code-aide update-versions`. Provides latest versions, dates,
+   and updated SHA256 checksums.
 
-Run `code-aide update-versions` to get fresher version data without waiting
-for a new code-aide release.
+Run `code-aide update-versions` to get the latest version data without
+waiting for a new code-aide release.
 
 ## Features
 
@@ -121,29 +114,26 @@ uv run pytest tests/test_install.py::TestDetectOsArch -v
 
 `publish.yml` publishes to PyPI when a Git tag matching `v*` is pushed.
 
-1. Update the bundled version baseline:
-   - `code-aide update-versions -b -y`
-   - `git add src/code_aide/data/tools.json`
-   - `git commit -m "Updated bundled version data"`
-2. Update the version string in `src/code_aide/__init__.py` (`__version__`).
+1. Update the version string in `src/code_aide/__init__.py` (`__version__`).
    `pyproject.toml` reads it automatically via Hatchling.
-3. Run checks:
+2. Run checks:
    - `uv run pytest tests/ -v`
    - `uv build`
-4. Commit the release version bump:
+3. Commit the release version bump:
    - `git add src/code_aide/__init__.py`
    - `git commit -m "Bumped version to X.Y.Z"`
-5. Write useful commit messages before tagging:
+4. Write useful commit messages before tagging:
    - Start subject lines with an action verb in past tense (`Added`,
      `Changed`, `Fixed`, `Removed`).
    - Keep subjects user-facing so auto-generated release notes are
      meaningful.
    - Group related changes into focused commits instead of one broad commit.
    - Example: `Fixed timeout handling in status command`
-6. Tag and push:
+5. Tag and push:
    - `git tag vX.Y.Z`
-   - `git push origin main --follow-tags`
-7. Confirm GitHub Actions:
+   - `git push origin main`
+   - `git push origin vX.Y.Z`
+6. Confirm GitHub Actions:
    - CI should pass.
    - Publish workflow should upload to PyPI and create GitHub Release notes.
    - Release notes should include generated notes plus a commit summary from

{code_aide-1.5.0 → code_aide-1.7.0}/TODO.md

@@ -7,8 +7,8 @@ remove, status, and version metadata).
 
 - [x] Standardize `--dryrun` flag: `update-versions` uses `--dry-run` but
   `install` uses `--dryrun`. Change `update-versions` to `--dryrun`.
-- [x] Add missing `success()` message for direct-download installs in non-dryrun
-  mode (`install.py`, `install_tool()`).
+- [x] Add missing `success()` message for direct-download installs in
+  non-dryrun mode (`install.py`, `install_tool()`).
 - [x] Replace PID-based temp directory naming with `tempfile.mkdtemp()` in
   `install.py` `install_direct_download()`.
 - [x] Guard `package.split("/", 1)` in `detection.py`
@@ -18,21 +18,21 @@ remove, status, and version metadata).
 
 - [ ] Handle missing `node` cleanly during prerequisite checks
   (`FileNotFoundError` path in Node version probing).
-- [ ] Read tool version output from both stdout and stderr so status does not
-  miss installed versions.
+- [ ] Read tool version output from both stdout and stderr so status does
+  not miss installed versions.
 - [ ] Make version cache writes atomic (write temp file + rename) to avoid
-  partial/corrupted `versions.json`. Apply to `save_bundled_versions()` too.
-- [ ] Warn when `versions.json` cache contains invalid JSON instead of silently
-  returning empty data.
+  partial/corrupted `versions.json`.
+- [ ] Warn when `versions.json` cache contains invalid JSON instead of
+  silently returning empty data.
 - [ ] Use `os.pathsep` instead of hardcoded `":"` in `prereqs.py`
   `check_path_directories()`.
 
 ## Security and Integrity
 
-- [ ] Add integrity verification for direct-download tarballs (not only install
-  script SHA256).
-- [ ] Extend tool metadata to support tarball checksum/signature fields where
-  applicable.
+- [ ] Add integrity verification for direct-download tarballs (not only
+  install script SHA256).
+- [ ] Extend tool metadata to support tarball checksum/signature fields
+  where applicable.
 
 ## CLI and Automation UX
 
@@ -40,21 +40,23 @@ remove, status, and version metadata).
 - [ ] Add a focused `doctor` command for environment checks (PATH,
   prerequisites, command health).
 - [ ] Consider `install --force` for reinstall/repair flows.
-- [ ] Add cleanup support for stale direct-download versions no longer in use.
-- [ ] Expand `upgrade` help text to mention the default "only out-of-date tools"
-  behavior.
+- [ ] Add cleanup support for stale direct-download versions no longer in
+  use.
+- [ ] Expand `upgrade` help text to mention the default "only out-of-date
+  tools" behavior.
 
 ## Documentation
 
-- [ ] Document that running `code-aide` with no subcommand defaults to `status`.
+- [ ] Document that running `code-aide` with no subcommand defaults to
+  `status`.
 - [ ] Add `install --dryrun` to the README usage examples.
 - [ ] Document environment variables and config file paths
   (`~/.config/code-aide/versions.json`).
 
 ## Platform and Package Detection
 
-- [ ] Broaden system package metadata detection beyond Gentoo-specific tooling
-  where practical.
+- [ ] Broaden system package metadata detection beyond Gentoo-specific
+  tooling where practical.
 
 ## Maintainability and Tests
 
@@ -65,6 +67,5 @@ remove, status, and version metadata).
   - `cmd_remove()` (completely untested)
   - `fetch_url()` (completely untested)
   - `check_prerequisites()` / `install_nodejs_npm()` (completely untested)
-  - `save_bundled_versions()` (untested)
   - `get_system_package_info()` (completely untested)
 - [ ] Add tests for prerequisite edge cases and cache write behavior.

code_aide-1.7.0/specs/auto-migrate-deprecated-installs.md

@@ -0,0 +1,128 @@
+# Auto-migrate deprecated install methods
+
+## Context
+
+Claude Code switched from npm to a native installer. Users who installed
+Claude via npm are stuck: `code-aide upgrade` runs `npm install -g @latest`
+(the detected method) instead of the native script installer (the configured
+method). `code-aide install` exits early because the command already exists.
+There is no migration path. code-aide should detect this and fix it
+automatically.
+
+This is a general pattern -- any tool could change install methods in the
+future. The solution should not be Claude-specific.
+
+## Approach
+
+A detected install method is "deprecated" when:
+
+- Detected method is `npm` or `brew_npm` AND config `install_type` is
+  `script` or `direct_download`
+
+Methods that are never considered deprecated (user-managed choices):
+
+- `brew_formula`, `brew_cask` -- user explicitly chose Homebrew
+- `system` -- managed by system package manager
+
+Migration flow: remove old (npm), install new (configured method), with
+clear messaging. If the new install fails after removal, provide recovery
+instructions.
+
+## Changes
+
+### 1. `src/code_aide/data/tools.json` -- add deprecated_npm_package
+
+Add a `deprecated_npm_package` field to Claude's entry:
+
+```json
+"claude": {
+  "name": "Claude CLI (Claude Code)",
+  "install_type": "script",
+  "deprecated_npm_package": "@anthropic-ai/claude-code",
+  ...
+}
+```
+
+This records the old npm package name explicitly so the migration removal
+step does not rely solely on extracting the package name from the binary
+path.
+
+### 2. `src/code_aide/detection.py` -- add deprecation detection
+
+Add two functions:
+
+- `is_deprecated_install(tool_name)` -- returns True when the detected
+  install method is `npm` or `brew_npm` but the configured `install_type` is
+  something else (script, direct_download). Also returns True when
+  `deprecated_npm_package` is set and the detected method is npm. Brew
+  formula/cask and system installs are never deprecated (user-managed).
+- `format_migration_warning(tool_name)` -- returns a human-readable warning
+  string, or None if not deprecated. Uses existing `format_install_method()`
+  for labels.
+
+### 3. `src/code_aide/operations.py` -- auto-migrate in upgrade
+
+Add `_migrate_install_method()` private function that:
+
+1. Warns about the deprecated method
+2. Calls `remove_tool()` to remove the old npm install
+3. Calls `install_tool()` to install via the configured method
+4. If install fails after remove, prints recovery instructions (`code-aide
+   install <tool>` and manual curl command for script types)
+
+Modify `upgrade_tool()`: after `detect_install_method()`, check
+`is_deprecated_install()`. If True, call `_migrate_install_method()` instead
+of the normal upgrade branch.
+
+Modify `remove_tool()` npm branch: fall back to
+`tool_config.get("deprecated_npm_package")` when looking up the npm package
+name. Current code: `npm_package = detail or
+tool_config.get("npm_package")`. Change to also check
+`deprecated_npm_package`.
+
+New imports needed: `is_deprecated_install`, `format_install_method` from
+detection, `install_tool` from install.
+
+Note: after `remove_tool()` succeeds, `command_exists()` returns False so
+`install_tool()` proceeds normally with the configured `install_type`.
+
+### 4. `src/code_aide/commands_actions.py` -- include deprecated in auto-upgrade
+
+Modify `cmd_upgrade()` no-args path: after building the version-outdated
+list, also add any installed tools with deprecated install methods. Without
+this, a tool whose version is current but install method is deprecated would
+be silently skipped by `code-aide upgrade`.
+
+New import: `is_deprecated_install` from detection.
+
+### 5. `src/code_aide/commands_tools.py` -- show warnings in status/list
+
+In both `cmd_list()` and `cmd_status()`, after displaying "Installed via:",
+call `format_migration_warning()` and display the warning if present.
+
+At the end of `cmd_status()`, add a summary line counting tools that need
+migration.
+
+New imports: `format_migration_warning`, `is_deprecated_install` from
+detection.
+
+### 6. Tests
+
+- `tests/test_detection.py`: Tests for `is_deprecated_install()` covering
+  npm to script (deprecated), npm to npm (not deprecated), brew_formula
+  (never deprecated), system (never deprecated), not installed, unknown
+  tool, npm to direct_download. Tests for `format_migration_warning()`.
+- `tests/test_operations.py`: Tests for migration in `upgrade_tool()`:
+  triggers migration, normal upgrade when not deprecated, migration fails on
+  remove, migration fails on install with recovery message.
+- `tests/test_commands_tools.py`: Test that status/list show migration
+  warnings for deprecated installs.
+
+## Verification
+
+1. `pre-commit run --all-files` -- formatting passes
+2. `uv run pytest tests/ -v` -- all tests pass
+3. `uv run python -m code_aide status` -- shows migration warning for
+   npm-installed Claude (if applicable)
+4. `uv run python -m code_aide upgrade claude` -- performs migration (remove
+   npm, install via script)

code_aide-1.7.0/specs/remove-bundled-version-baseline.md

@@ -0,0 +1,77 @@
+# Remove bundled version baseline
+
+## Context
+
+code-aide has a three-layer version data model where `latest_version` and
+`latest_date` are bundled in `tools.json` as a baseline. These go stale
+between releases and require a manual release step (`update-versions -b
+-y`). The `install_sha256` field protects against tampered install scripts
+and must remain bundled.
+
+## Approach
+
+Remove `latest_version` and `latest_date` from bundled data and the
+`-b`/`--bundled` flag from `update-versions`, simplifying to two layers:
+bundled definitions (with SHA256) + user cache (with versions). The
+`install_direct_download()` function needs an on-demand fetch when
+`latest_version` is missing (fresh install with no cache).
+
+## Changes
+
+### 1. `src/code_aide/data/tools.json` -- remove version fields
+
+Remove `latest_version` and `latest_date` from all 8 tool entries. Keep
+`install_sha256`.
+
+### 2. `src/code_aide/config.py` -- remove bundled save function
+
+- Remove `save_bundled_versions()` function.
+- Update `load_tools_config()` docstring to describe two-layer model.
+- `DYNAMIC_FIELDS` stays the same (user cache still stores all three).
+
+### 3. `src/code_aide/entry.py` -- remove --bundled flag
+
+Remove `-b`/`--bundled` argument from the update-versions subparser.
+
+### 4. `src/code_aide/commands_actions.py` -- simplify update-versions
+
+- Remove `save_bundled_versions` from imports.
+- Remove `if not args.bundled:` guard around `merge_cached_versions` --
+  always merge.
+- Remove bundled branch in `_save()` -- always save to user cache.
+- Remove `args.bundled` reference.
+
+### 5. `src/code_aide/install.py` -- handle missing latest_version
+
+In `install_direct_download()`, `tool_config["latest_version"]` will
+KeyError on fresh installs with no cache. Add on-demand fetch: if
+`latest_version` is missing, call `check_script_tool()` to get it before
+proceeding with the download.
+
+### 6. `README.md` -- update documentation
+
+- Rewrite "How Version Data Works" to describe two-layer model.
+- Remove release step 1 (`update-versions -b -y` step).
+- Remove usage example for `update-versions -b -y`.
+
+### 7. `AGENTS.md` -- update layer description
+
+Change "Three-layer version data" to "Two-layer version data" and update
+description.
+
+### 8. Tests
+
+- `tests/test_commands_actions.py`: Remove
+  `test_bundled_flag_skips_cache_and_saves_to_bundled`. Update remaining
+  tests that set `"bundled": False` in args.
+
+## Verification
+
+1. `pre-commit run --all-files` -- formatting passes
+2. `uv run pytest tests/ -v` -- all tests pass
+3. `uv run python -m code_aide status` -- shows versions from cache, or
+   plain version without comparison if no cache
+4. `uv run python -m code_aide update-versions -n` -- fetches latest
+   versions
+5. `uv run python -m code_aide update-versions -y` -- saves to user cache
+6. `uv run python -m code_aide update-versions -b` -- errors (flag removed)

{code_aide-1.5.0 → code_aide-1.7.0}/src/code_aide/__init__.py

@@ -1,3 +1,3 @@
 """code-aide - Manage AI coding CLI tools."""
 
-__version__ = "1.5.0"
+__version__ = "1.7.0"

{code_aide-1.5.0 → code_aide-1.7.0}/src/code_aide/commands_actions.py

@@ -5,6 +5,7 @@ import sys
 from typing import Any, Dict, List
 
 from code_aide.constants import TOOLS
+from code_aide.detection import is_deprecated_install
 from code_aide.install import install_tool
 from code_aide.console import error, info, success, warning
 from code_aide.operations import remove_tool, upgrade_tool, validate_tools
@@ -26,7 +27,6 @@ from code_aide.config import (
     load_bundled_tools,
     load_versions_cache,
     merge_cached_versions,
-    save_bundled_versions,
     save_updated_versions,
 )
 
@@ -124,6 +124,10 @@ def cmd_upgrade(args: argparse.Namespace) -> None:
         for name, config in TOOLS.items():
             if not is_tool_installed(name):
                 continue
+            if is_deprecated_install(name):
+                if name not in tools_to_upgrade:
+                    tools_to_upgrade.append(name)
+                continue
             latest = config.get("latest_version")
             if not latest:
                 continue
@@ -234,8 +238,7 @@ def cmd_update_versions(args: argparse.Namespace) -> None:
     """Handle update-versions command: check upstream for latest tool versions."""
     bundled = load_bundled_tools()
     tools = bundled.get("tools", {})
-    if not args.bundled:
-        merge_cached_versions(tools, load_versions_cache())
+    merge_cached_versions(tools, load_versions_cache())
 
     config: Dict[str, Any] = {"tools": tools}
 
@@ -293,10 +296,7 @@ def cmd_update_versions(args: argparse.Namespace) -> None:
                 version_info_changed = True
 
     def _save(tools: dict) -> str:
-        """Save versions to bundled or user cache. Returns description."""
-        if args.bundled:
-            path = save_bundled_versions(tools)
-            return path
+        """Save versions to user cache. Returns description."""
         save_updated_versions(tools)
         return "~/.config/code-aide/versions.json"
 

{code_aide-1.5.0 → code_aide-1.7.0}/src/code_aide/commands_tools.py

@@ -8,6 +8,7 @@ from typing import List
 from code_aide.constants import Colors, PACKAGE_MANAGERS, TOOLS
 from code_aide.detection import (
     format_install_method,
+    format_migration_warning,
     get_system_package_info,
     detect_install_method,
 )
@@ -48,6 +49,9 @@ def cmd_list(args: argparse.Namespace) -> None:
                 "  Installed via: "
                 f"{format_install_method(install_info['method'], install_info['detail'])}"
             )
+            migration_msg = format_migration_warning(tool_name)
+            if migration_msg:
+                warning(f"  {migration_msg}")
 
         if tool_config.get("min_node_version"):
             print(f"  Requires:     Node.js v{tool_config['min_node_version']}+")
@@ -99,6 +103,7 @@ def cmd_status(args: argparse.Namespace) -> None:
     print()
 
     outdated_count = 0
+    migration_count = 0
     config_outdated: List[str] = []
 
     for tool_name, tool_config in TOOLS.items():
@@ -156,6 +161,10 @@ def cmd_status(args: argparse.Namespace) -> None:
                     "  Installed via: "
                     f"{format_install_method(install_info['method'], install_info['detail'])}"
                 )
+                migration_msg = format_migration_warning(tool_name)
+                if migration_msg:
+                    warning(f"  {migration_msg}")
+                    migration_count += 1
 
             if status["user"]:
                 print(f"  User:         {status['user']}")
@@ -181,3 +190,8 @@ def cmd_status(args: argparse.Namespace) -> None:
             f"{Colors.YELLOW}{outdated_count} tool(s) can be upgraded with "
             f"'code-aide upgrade'.{Colors.NC}"
         )
+    if migration_count > 0:
+        print(
+            f"{Colors.YELLOW}{migration_count} tool(s) need migration to a "
+            f"new install method. Run 'code-aide upgrade' to migrate.{Colors.NC}"
+        )

{code_aide-1.5.0 → code_aide-1.7.0}/src/code_aide/config.py

@@ -76,10 +76,10 @@ def merge_cached_versions(tools: dict, cache: dict) -> None:
 def load_tools_config() -> dict:
     """Load tool config: bundled definitions merged with cached versions.
 
-    The bundled tools.json provides all tool definitions plus a baseline
-    for latest_version, latest_date, and install_sha256. The user's
-    version cache (from update-versions) overrides these dynamic fields
-    when present.
+    Two-layer model: the bundled tools.json provides tool definitions and
+    install_sha256 checksums. The user's version cache (from
+    update-versions) provides latest_version, latest_date, and updated
+    install_sha256 values when present.
     """
     bundled = load_bundled_tools()
     cache = load_versions_cache()
@@ -103,29 +103,3 @@ def save_updated_versions(tools: dict) -> None:
         if entry:
             cache_data["tools"][tool_key] = entry
     save_versions_cache(cache_data)
-
-
-def save_bundled_versions(tools: dict) -> str:
-    """Update dynamic fields in the bundled data/tools.json.
-
-    Loads the existing bundled file to preserve static fields, then
-    overwrites only the dynamic version fields from the provided tools
-    dict.  Returns the file path written.
-    """
-    ref = importlib.resources.files("code_aide").joinpath("data/tools.json")
-    path = str(ref)
-
-    with open(path, encoding="utf-8") as f:
-        bundled = json.load(f)
-
-    for tool_key, tool_data in tools.items():
-        if tool_key in bundled.get("tools", {}):
-            for field in DYNAMIC_FIELDS:
-                if field in tool_data:
-                    bundled["tools"][tool_key][field] = tool_data[field]
-
-    with open(path, "w", encoding="utf-8") as f:
-        json.dump(bundled, f, indent=2)
-        f.write("\n")
-
-    return path