code-aide 1.16.2__tar.gz → 1.17.0__tar.gz

{code_aide-1.16.2 → code_aide-1.17.0}/.github/workflows/ci.yml

@@ -20,5 +20,7 @@ jobs:
         run: uv run ruff check .
       - name: Format check
         run: uv run black --check .
+      - name: Type check
+        run: uv run mypy
       - name: Run tests
         run: uv run pytest tests/ -v

{code_aide-1.16.2 → code_aide-1.17.0}/.gitlab-ci.yml

@@ -12,6 +12,7 @@ variables:
   script:
     - uv run ruff check .
     - uv run black --check .
+    - uv run mypy
     - uv run pytest tests/ -v
 
 check:python3.11:

{code_aide-1.16.2 → code_aide-1.17.0}/.pre-commit-config.yaml

@@ -36,3 +36,11 @@ repos:
     rev: 0.10.6
     hooks:
       - id: uv-lock
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy
+        entry: uv run mypy
+        language: system
+        pass_filenames: false
+        files: ^src/code_aide/.*\.py$

code_aide-1.17.0/Makefile

@@ -0,0 +1,29 @@
+# code-aide quality checks (uv-based)
+
+.PHONY: build install test lint format format-check typecheck hooks check
+
+build:
+	uv build
+
+install:
+	uv sync
+
+test:
+	uv run pytest -n4 -q
+
+lint:
+	uv run ruff check .
+
+format:
+	uv run black .
+
+format-check:
+	uv run black --check .
+
+typecheck:
+	uv run mypy
+
+hooks:
+	pre-commit install
+
+check: lint format-check typecheck

{code_aide-1.16.2 → code_aide-1.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: code-aide
-Version: 1.16.2
+Version: 1.17.0
 Summary: Manage AI coding CLI tools (Claude, Antigravity, Copilot, Cursor, Gemini, Amp, Codex)
 Project-URL: Homepage, https://github.com/dajobe/code-aide
 Project-URL: Repository, https://github.com/dajobe/code-aide
@@ -70,9 +70,15 @@ code-aide install -p
 # Upgrade installed tools (no args = only out-of-date tools)
 code-aide upgrade [NAMES]
 
-# Remove tools
+# Remove tools (prompts before removing all managed tools)
 code-aide remove [NAMES]
 
+# Preview a removal without changing anything
+code-aide remove -n
+
+# Remove all managed tools without prompting
+code-aide remove -y
+
 # Check upstream for latest versions (dry-run)
 code-aide update-versions -n
 
@@ -106,8 +112,8 @@ code-aide uses a two-layer version data model:
    versions of code-aide.
 
 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.
+   by `code-aide update-versions`. Provides latest versions, dates, updated
+   SHA256 checksums, and recorded tarball checksums for direct_download tools.
 
 Run `code-aide update-versions` to get the latest version data without waiting
 for a new code-aide release.
@@ -118,32 +124,34 @@ Each entry in `tools.json` describes one managed tool. Required fields are
 `name`, `command`, and `install_type`; the others are optional and only
 consulted when the relevant install method or platform applies.
 
-| Field                           | Required | Notes                                                                                        |
-|:--------------------------------|:---------|:---------------------------------------------------------------------------------------------|
-| `name`                          | Yes      | Display name for status output                                                               |
-| `command`                       | Yes      | Binary name (looked up in `PATH`)                                                            |
-| `aliases`                       | No       | Alternate names accepted by commands and resolved to the canonical tool key                  |
-| `install_type`                  | Yes      | One of `npm`, `script`, `direct_download`, `pkg`                                             |
-| `version_args`                  | No       | List of arguments passed to the binary to print its version (default: `["--version"]`)       |
-| `version_url`                   | No       | URL queried by `update-versions` to discover the latest upstream version                     |
-| `version_manifest_url_template` | No       | JSON manifest URL template with `{platform}`; reads its `version` field                      |
-| `latest_version`                | Cache    | Last known upstream version (filled by `update-versions`)                                    |
-| `latest_date`                   | Cache    | Release date for `latest_version`                                                            |
-| `prerequisites`                 | No       | List of required external commands (e.g. `["npm"]`)                                          |
-| `min_node_version`              | No       | Minimum major Node.js version required                                                       |
-| `npm_package`                   | npm      | npm package name (e.g. `@anthropic-ai/claude-code`)                                          |
-| `install_url`                   | script   | URL of the install script that will be downloaded and piped to `bash`                        |
-| `install_sha256`                | script   | SHA-256 of the install script body — required for verified installs                          |
-| `install_script_path_prepend`   | script   | Extra directories prepended to `PATH` when the install script runs (e.g. `["~/.local/bin"]`) |
-| `download_url_template`         | direct   | URL template with `{version}`, `{os}`, `{arch}` placeholders                                 |
-| `install_dir`                   | direct   | Directory to extract into; supports `{version}`                                              |
-| `bin_dir`                       | direct   | Directory where symlinks for `command` are created (e.g. `~/.local/bin`)                     |
-| `symlinks`                      | direct   | Map of `link_name` → relative path inside `install_dir` to symlink into `bin_dir`            |
-| `freebsd_port`                  | FreeBSD  | FreeBSD ports/pkg name (used when running on FreeBSD)                                        |
-| `freebsd_pkg_repo`              | FreeBSD  | Optional non-default pkg repository name (passed via `pkg install -r <repo>`)                |
-| `next_steps`                    | No       | Free-form text printed after a successful install                                            |
-| `docs_url`                      | No       | Documentation URL printed after install                                                      |
-| `self_updates`                  | No       | Tool updates itself when run; excludes it from managed upgrade actions                       |
+| Field                           | Required | Notes                                                                                                           |
+|:--------------------------------|:---------|:----------------------------------------------------------------------------------------------------------------|
+| `name`                          | Yes      | Display name for status output                                                                                  |
+| `command`                       | Yes      | Binary name (looked up in `PATH`)                                                                               |
+| `aliases`                       | No       | Alternate names accepted by commands and resolved to the canonical tool key                                     |
+| `install_type`                  | Yes      | One of `npm`, `script`, `direct_download`, `pkg`                                                                |
+| `version_args`                  | No       | List of arguments passed to the binary to print its version (default: `["--version"]`)                          |
+| `version_url`                   | No       | URL queried by `update-versions` to discover the latest upstream version                                        |
+| `version_manifest_url_template` | No       | JSON manifest URL template with `{platform}`; reads its `version` field                                         |
+| `version_extract_pattern`       | No       | Regex applied to the install script to extract the version before generic heuristics                            |
+| `latest_version`                | Cache    | Last known upstream version (filled by `update-versions`)                                                       |
+| `latest_date`                   | Cache    | Release date for `latest_version`                                                                               |
+| `prerequisites`                 | No       | List of required external commands (e.g. `["npm"]`)                                                             |
+| `min_node_version`              | No       | Minimum major Node.js version required                                                                          |
+| `npm_package`                   | npm      | npm package name (e.g. `@anthropic-ai/claude-code`)                                                             |
+| `install_url`                   | script   | URL of the install script that will be downloaded and piped to `bash`                                           |
+| `install_sha256`                | script   | SHA-256 of the install script body — required for verified installs                                             |
+| `download_sha256`               | Cache    | SHA-256 of the downloaded tarball for direct_download tools; recorded by `update-versions`, verified on install |
+| `install_script_path_prepend`   | script   | Extra directories prepended to `PATH` when the install script runs (e.g. `["~/.local/bin"]`)                    |
+| `download_url_template`         | direct   | URL template with `{version}`, `{os}`, `{arch}` placeholders                                                    |
+| `install_dir`                   | direct   | Directory to extract into; supports `{version}`                                                                 |
+| `bin_dir`                       | direct   | Directory where symlinks for `command` are created (e.g. `~/.local/bin`)                                        |
+| `symlinks`                      | direct   | Map of `link_name` → relative path inside `install_dir` to symlink into `bin_dir`                               |
+| `freebsd_port`                  | FreeBSD  | FreeBSD ports/pkg name (used when running on FreeBSD)                                                           |
+| `freebsd_pkg_repo`              | FreeBSD  | Optional non-default pkg repository name (passed via `pkg install -r <repo>`)                                   |
+| `next_steps`                    | No       | Free-form text printed after a successful install                                                               |
+| `docs_url`                      | No       | Documentation URL printed after install                                                                         |
+| `self_updates`                  | No       | Tool updates itself when run; excludes it from managed upgrade actions                                          |
 
 ## Features
 

{code_aide-1.16.2 → code_aide-1.17.0}/README.md

@@ -43,9 +43,15 @@ code-aide install -p
 # Upgrade installed tools (no args = only out-of-date tools)
 code-aide upgrade [NAMES]
 
-# Remove tools
+# Remove tools (prompts before removing all managed tools)
 code-aide remove [NAMES]
 
+# Preview a removal without changing anything
+code-aide remove -n
+
+# Remove all managed tools without prompting
+code-aide remove -y
+
 # Check upstream for latest versions (dry-run)
 code-aide update-versions -n
 
@@ -79,8 +85,8 @@ code-aide uses a two-layer version data model:
    versions of code-aide.
 
 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.
+   by `code-aide update-versions`. Provides latest versions, dates, updated
+   SHA256 checksums, and recorded tarball checksums for direct_download tools.
 
 Run `code-aide update-versions` to get the latest version data without waiting
 for a new code-aide release.
@@ -91,32 +97,34 @@ Each entry in `tools.json` describes one managed tool. Required fields are
 `name`, `command`, and `install_type`; the others are optional and only
 consulted when the relevant install method or platform applies.
 
-| Field                           | Required | Notes                                                                                        |
-|:--------------------------------|:---------|:---------------------------------------------------------------------------------------------|
-| `name`                          | Yes      | Display name for status output                                                               |
-| `command`                       | Yes      | Binary name (looked up in `PATH`)                                                            |
-| `aliases`                       | No       | Alternate names accepted by commands and resolved to the canonical tool key                  |
-| `install_type`                  | Yes      | One of `npm`, `script`, `direct_download`, `pkg`                                             |
-| `version_args`                  | No       | List of arguments passed to the binary to print its version (default: `["--version"]`)       |
-| `version_url`                   | No       | URL queried by `update-versions` to discover the latest upstream version                     |
-| `version_manifest_url_template` | No       | JSON manifest URL template with `{platform}`; reads its `version` field                      |
-| `latest_version`                | Cache    | Last known upstream version (filled by `update-versions`)                                    |
-| `latest_date`                   | Cache    | Release date for `latest_version`                                                            |
-| `prerequisites`                 | No       | List of required external commands (e.g. `["npm"]`)                                          |
-| `min_node_version`              | No       | Minimum major Node.js version required                                                       |
-| `npm_package`                   | npm      | npm package name (e.g. `@anthropic-ai/claude-code`)                                          |
-| `install_url`                   | script   | URL of the install script that will be downloaded and piped to `bash`                        |
-| `install_sha256`                | script   | SHA-256 of the install script body — required for verified installs                          |
-| `install_script_path_prepend`   | script   | Extra directories prepended to `PATH` when the install script runs (e.g. `["~/.local/bin"]`) |
-| `download_url_template`         | direct   | URL template with `{version}`, `{os}`, `{arch}` placeholders                                 |
-| `install_dir`                   | direct   | Directory to extract into; supports `{version}`                                              |
-| `bin_dir`                       | direct   | Directory where symlinks for `command` are created (e.g. `~/.local/bin`)                     |
-| `symlinks`                      | direct   | Map of `link_name` → relative path inside `install_dir` to symlink into `bin_dir`            |
-| `freebsd_port`                  | FreeBSD  | FreeBSD ports/pkg name (used when running on FreeBSD)                                        |
-| `freebsd_pkg_repo`              | FreeBSD  | Optional non-default pkg repository name (passed via `pkg install -r <repo>`)                |
-| `next_steps`                    | No       | Free-form text printed after a successful install                                            |
-| `docs_url`                      | No       | Documentation URL printed after install                                                      |
-| `self_updates`                  | No       | Tool updates itself when run; excludes it from managed upgrade actions                       |
+| Field                           | Required | Notes                                                                                                           |
+|:--------------------------------|:---------|:----------------------------------------------------------------------------------------------------------------|
+| `name`                          | Yes      | Display name for status output                                                                                  |
+| `command`                       | Yes      | Binary name (looked up in `PATH`)                                                                               |
+| `aliases`                       | No       | Alternate names accepted by commands and resolved to the canonical tool key                                     |
+| `install_type`                  | Yes      | One of `npm`, `script`, `direct_download`, `pkg`                                                                |
+| `version_args`                  | No       | List of arguments passed to the binary to print its version (default: `["--version"]`)                          |
+| `version_url`                   | No       | URL queried by `update-versions` to discover the latest upstream version                                        |
+| `version_manifest_url_template` | No       | JSON manifest URL template with `{platform}`; reads its `version` field                                         |
+| `version_extract_pattern`       | No       | Regex applied to the install script to extract the version before generic heuristics                            |
+| `latest_version`                | Cache    | Last known upstream version (filled by `update-versions`)                                                       |
+| `latest_date`                   | Cache    | Release date for `latest_version`                                                                               |
+| `prerequisites`                 | No       | List of required external commands (e.g. `["npm"]`)                                                             |
+| `min_node_version`              | No       | Minimum major Node.js version required                                                                          |
+| `npm_package`                   | npm      | npm package name (e.g. `@anthropic-ai/claude-code`)                                                             |
+| `install_url`                   | script   | URL of the install script that will be downloaded and piped to `bash`                                           |
+| `install_sha256`                | script   | SHA-256 of the install script body — required for verified installs                                             |
+| `download_sha256`               | Cache    | SHA-256 of the downloaded tarball for direct_download tools; recorded by `update-versions`, verified on install |
+| `install_script_path_prepend`   | script   | Extra directories prepended to `PATH` when the install script runs (e.g. `["~/.local/bin"]`)                    |
+| `download_url_template`         | direct   | URL template with `{version}`, `{os}`, `{arch}` placeholders                                                    |
+| `install_dir`                   | direct   | Directory to extract into; supports `{version}`                                                                 |
+| `bin_dir`                       | direct   | Directory where symlinks for `command` are created (e.g. `~/.local/bin`)                                        |
+| `symlinks`                      | direct   | Map of `link_name` → relative path inside `install_dir` to symlink into `bin_dir`                               |
+| `freebsd_port`                  | FreeBSD  | FreeBSD ports/pkg name (used when running on FreeBSD)                                                           |
+| `freebsd_pkg_repo`              | FreeBSD  | Optional non-default pkg repository name (passed via `pkg install -r <repo>`)                                   |
+| `next_steps`                    | No       | Free-form text printed after a successful install                                                               |
+| `docs_url`                      | No       | Documentation URL printed after install                                                                         |
+| `self_updates`                  | No       | Tool updates itself when run; excludes it from managed upgrade actions                                          |
 
 ## Features
 

code_aide-1.17.0/TODO.md

@@ -0,0 +1,77 @@
+# TODO
+
+Keep the project focused on managing AI coding CLI tools (install, upgrade,
+remove, status, and version metadata).
+
+## Summary
+
+| #  | Item                                        | Risk     | Effort  | Notes                                                              |
+|:---|:--------------------------------------------|:---------|:--------|:-------------------------------------------------------------------|
+| 1  | ~~Handle missing `node` cleanly~~ (done)    | -        | -       | Fixed in `prereqs.py` `check_prerequisites()`                      |
+| 2  | Read version from stdout+stderr             | Med      | Low     | Some tools write version to stderr; shown as not installed         |
+| 3  | ~~Atomic version cache writes~~ (done)      | -        | -       | Fixed in `config.py` `save_versions_cache()`                       |
+| 4  | ~~Warn on invalid cache JSON~~ (done)       | -        | -       | `config.py` `load_versions_cache()` logs a warning                 |
+| 5  | ~~Use `os.pathsep` not `":"`~~ (done)       | -        | -       | Fixed in `prereqs.py` `check_path_directories()`                   |
+| 6  | ~~Verify direct-download tarballs~~ (done)  | -        | -       | `download_sha256` recorded by update-versions, verified on install |
+| 7  | ~~Tarball checksum metadata fields~~ (done) | -        | -       | `download_sha256` field in tools schema and versions cache         |
+| 8  | `--json` output mode                        | Low      | Med     | Needed for CI/automation consumers                                 |
+| 9  | `doctor` command                            | Low      | Med     | Health checks exist but are scattered                              |
+| 10 | `install --force`                           | Low      | Trivial | Internal `force` param exists; not exposed in CLI                  |
+| 11 | Cleanup stale direct-download versions      | Low      | Med     | Old version dirs accumulate on disk                                |
+| 12 | Document default subcommand                 | Very Low | Trivial | One line in README                                                 |
+| 13 | Document `install --dryrun`                 | Very Low | Trivial | One line in README                                                 |
+| 14 | Document env vars and config paths          | Low      | Low     | `XDG_CONFIG_HOME` undocumented                                     |
+| 15 | Cross-distro package detection              | Med      | High    | Only Gentoo supported; other Linux distros get nothing             |
+| 16 | Split large modules                         | Low      | High    | Refactoring only; no behavior change                               |
+| 17 | Tests for untested functions                | Med      | High    | `fetch_url`, `get_system_package_info`                             |
+| 18 | Tests for edge cases                        | Med      | Med     | PATH oddities, more version parsing corners                        |
+
+## Reliability and Correctness
+
+- [x] Handle missing `node` cleanly during prerequisite checks (`OSError` path
+  in Node version probing).
+- [ ] Read tool version output from both stdout and stderr so status does not
+  miss installed versions.
+- [x] Make version cache writes atomic (temp file + rename) to avoid
+  partial/corrupted `versions.json`.
+- [x] Warn when `versions.json` cache contains invalid JSON instead of silently
+  returning empty data.
+- [x] Use `os.pathsep` instead of hardcoded `":"` in `prereqs.py`
+  `check_path_directories()`.
+
+## Security and Integrity
+
+- [x] Verify direct-download tarballs against a checksum recorded by
+  `update-versions` (warn when no checksum has been recorded yet).
+- [x] Extend tool metadata with a `download_sha256` field for tarball checksums.
+- [ ] Consider signature verification (beyond SHA256) for downloads where
+  upstream publishes signatures.
+
+## CLI and Automation UX
+
+- [ ] Add `--json` output mode for `list`, `status`, and `update-versions`.
+- [ ] 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.
+
+## Documentation
+
+- [ ] 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.
+
+## Maintainability and Tests
+
+- [ ] Split larger modules into smaller focused files where practical
+  (`commands_actions.py`, `versions.py`, `install.py`).
+- [ ] Add tests for remaining untested functions:
+  - `fetch_url()` (network; needs mocking)
+  - `get_system_package_info()` (Gentoo tooling)
+- [ ] Add tests for more prerequisite edge cases and PATH oddities.

{code_aide-1.16.2 → code_aide-1.17.0}/pyproject.toml

@@ -47,9 +47,6 @@ filterwarnings = [
     "error",
     "ignore::DeprecationWarning:_pytest.*",
 ]
-markers = [
-    "network: tests that make real network calls (deselect with '-m \"not network\"')",
-]
 
 [tool.mypy]
 python_version = "3.11"

{code_aide-1.16.2 → code_aide-1.17.0}/src/code_aide/__init__.py

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

{code_aide-1.16.2 → code_aide-1.17.0}/src/code_aide/commands_actions.py

@@ -6,7 +6,7 @@ from typing import Any, Dict, List
 
 from code_aide.constants import TOOLS
 from code_aide.detection import detect_install_method, get_brew_package_info
-from code_aide.install import install_tool
+from code_aide.install import fetch_download_checksum, install_tool
 from code_aide.install_types import (
     InstallMethod,
     InstallType,
@@ -34,6 +34,7 @@ from code_aide.versions import (
     print_check_results_table,
 )
 from code_aide.config import (
+    ensure_versions_cache,
     load_bundled_tools,
     load_versions_cache,
     merge_cached_versions,
@@ -75,7 +76,7 @@ def cmd_install(args: argparse.Namespace) -> None:
         )
 
     installed = []
-    installed_bin_dirs = []
+    installed_bin_dirs: List[str] = []
     failed = []
 
     for tool in tools_to_install:
@@ -136,6 +137,9 @@ def cmd_upgrade(args: argparse.Namespace) -> None:
         info(f"Upgrading specified tools: {', '.join(tools_to_upgrade)}")
     else:
         tools_to_upgrade = []
+        # Default selection is driven by latest_version, so refresh stale
+        # cache data first; named upgrades below skip this.
+        ensure_versions_cache(TOOLS)
         for name, config in TOOLS.items():
             assessment = ToolUpgradeEvaluator(name, config).evaluate()
             if assessment.actionable_by_upgrade and name not in tools_to_upgrade:
@@ -198,14 +202,37 @@ def cmd_upgrade(args: argparse.Namespace) -> None:
         )
 
 
+def _confirm_remove_all(tools: List[str]) -> bool:
+    """Prompt before removing every managed tool."""
+    print(f"This will remove {len(tools)} managed tools: {', '.join(tools)}")
+    try:
+        answer = input("Remove all of them? [y/N] ").strip().lower()
+    except (EOFError, KeyboardInterrupt):
+        print()
+        return False
+    return answer in ("y", "yes")
+
+
 def cmd_remove(args: argparse.Namespace) -> None:
     """Handle remove command."""
+    dryrun = getattr(args, "dryrun", False)
+    assume_yes = getattr(args, "yes", False)
+
     if args.tools:
         tools_to_remove = args.tools
         info(f"Removing specified tools: {', '.join(tools_to_remove)}")
     else:
         tools_to_remove = list(TOOLS.keys())
-        info(f"No tools specified, removing all: {', '.join(tools_to_remove)}")
+        if dryrun:
+            info(
+                "[DRYRUN] Would remove all managed tools: "
+                f"{', '.join(tools_to_remove)}"
+            )
+        else:
+            info(f"No tools specified, removing all: {', '.join(tools_to_remove)}")
+            if not assume_yes and not _confirm_remove_all(tools_to_remove):
+                print("Aborted.")
+                return
 
     tools_to_remove = resolve_tool_names(tools_to_remove, TOOLS)
     validate_tools(tools_to_remove)
@@ -216,6 +243,14 @@ def cmd_remove(args: argparse.Namespace) -> None:
 
     for tool in tools_to_remove:
         print()
+        if dryrun:
+            info(f"=== Checking {tool} ===")
+            if is_tool_installed(tool):
+                removed.append(tool)
+            else:
+                skipped.append(tool)
+            continue
+
         info(f"=== Removing {tool} ===")
 
         if not is_tool_installed(tool):
@@ -229,8 +264,19 @@ def cmd_remove(args: argparse.Namespace) -> None:
 
     print()
     print("=" * 42)
-    info("Removal Summary")
+    if dryrun:
+        info("Removal Summary (dry run)")
+    else:
+        info("Removal Summary")
     print("=" * 42)
+    if dryrun:
+        if removed:
+            success(f"Would remove: {', '.join(removed)}")
+        if skipped:
+            warning(f"Not installed (skipped): {', '.join(skipped)}")
+        print()
+        success("Dry run completed without removing anything!")
+        return
 
     if removed:
         success(f"Successfully removed: {', '.join(removed)}")
@@ -326,6 +372,30 @@ def cmd_update_versions(args: argparse.Namespace) -> None:
             tool_entry["latest_version"] = normalized
             version_info_changed = True
 
+    # Record the tarball checksum for direct-download tools so later
+    # installs can verify integrity against it.
+    if not args.dryrun:
+        for tool_name in tool_names:
+            tool_entry = config["tools"][tool_name]
+            if (
+                parse_install_type(tool_entry.get("install_type"))
+                != InstallType.DIRECT_DOWNLOAD
+            ):
+                continue
+            if "download_url_template" not in tool_entry:
+                continue
+            if not tool_entry.get("latest_version"):
+                continue
+            checksum = fetch_download_checksum(tool_entry)
+            if not checksum:
+                continue
+            if tool_entry.get("download_sha256") != checksum:
+                tool_entry["download_sha256"] = checksum
+                version_info_changed = True
+                print(f"Recorded download SHA256 for {tool_name}.")
+            else:
+                print(f"Download SHA256 for {tool_name} is unchanged.")
+
     def _save(tools: dict) -> str:
         """Save versions to user cache. Returns description."""
         save_updated_versions(tools)

{code_aide-1.16.2 → code_aide-1.17.0}/src/code_aide/commands_tools.py

@@ -30,6 +30,7 @@ from code_aide.status import (
     print_brew_version_status,
     print_pkg_version_status,
     print_system_version_status,
+    ToolUpgradeAssessment,
     ToolUpgradeEvaluator,
     UpgradeDecision,
     VersionDisplayState,
@@ -161,6 +162,51 @@ def _generic_version_annotation(
     )
 
 
+def _print_version_status(
+    assessment: ToolUpgradeAssessment,
+    status_version: str,
+    tool_path: str | None,
+    tool_config: dict,
+) -> None:
+    """Print the long-form version line for one installed tool."""
+    package_info = assessment.package_info
+    if assessment.install_method == InstallMethod.SYSTEM and tool_path and package_info:
+        print_system_version_status(
+            status_version, assessment.latest_version, package_info
+        )
+        return
+
+    if assessment.install_method == InstallMethod.PKG:
+        if package_info and package_info.get("available_version"):
+            print_pkg_version_status(
+                status_version,
+                assessment.latest_version,
+                package_info,
+                repo=tool_config.get("freebsd_pkg_repo"),
+            )
+            return
+    elif assessment.install_method in (
+        InstallMethod.BREW_FORMULA,
+        InstallMethod.BREW_CASK,
+    ):
+        if package_info and package_info.get("available_version"):
+            print_brew_version_status(
+                status_version, assessment.latest_version, package_info
+            )
+            return
+
+    if (
+        assessment.latest_version
+        and assessment.version_state == VersionDisplayState.UP_TO_DATE
+    ):
+        print(
+            f"  Version:      {status_version} "
+            f"{Colors.GREEN}(up to date){Colors.NC}"
+        )
+    else:
+        print(_generic_version_annotation(status_version, assessment.latest_version))
+
+
 def cmd_status_compact() -> None:
     """Show compact one-line-per-tool status."""
     ensure_versions_cache(TOOLS)
@@ -242,80 +288,9 @@ def cmd_status(args: argparse.Namespace) -> None:
             print(f"  Status:       {Colors.GREEN}✓ Installed{Colors.NC}")
 
             if status["version"]:
-                if (
-                    assessment.install_method == InstallMethod.SYSTEM
-                    and tool_path
-                    and assessment.package_info
-                ):
-                    print_system_version_status(
-                        status["version"],
-                        assessment.latest_version,
-                        assessment.package_info,
-                    )
-                elif assessment.install_method == InstallMethod.PKG:
-                    if assessment.package_info and assessment.package_info.get(
-                        "available_version"
-                    ):
-                        print_pkg_version_status(
-                            status["version"],
-                            assessment.latest_version,
-                            assessment.package_info,
-                            repo=tool_config.get("freebsd_pkg_repo"),
-                        )
-                    elif assessment.latest_version:
-                        if assessment.version_state == VersionDisplayState.UP_TO_DATE:
-                            print(
-                                f"  Version:      {status['version']} "
-                                f"{Colors.GREEN}(up to date){Colors.NC}"
-                            )
-                        else:
-                            print(
-                                _generic_version_annotation(
-                                    status["version"], assessment.latest_version
-                                )
-                            )
-                    else:
-                        print(f"  Version:      {status['version']}")
-                elif assessment.install_method in (
-                    InstallMethod.BREW_FORMULA,
-                    InstallMethod.BREW_CASK,
-                ):
-                    if assessment.package_info and assessment.package_info.get(
-                        "available_version"
-                    ):
-                        print_brew_version_status(
-                            status["version"],
-                            assessment.latest_version,
-                            assessment.package_info,
-                        )
-                    elif assessment.latest_version:
-                        if assessment.version_state == VersionDisplayState.UP_TO_DATE:
-                            print(
-                                f"  Version:      {status['version']} "
-                                f"{Colors.GREEN}(up to date){Colors.NC}"
-                            )
-                        else:
-                            print(
-                                _generic_version_annotation(
-                                    status["version"], assessment.latest_version
-                                )
-                            )
-                    else:
-                        print(f"  Version:      {status['version']}")
-                elif assessment.latest_version:
-                    if assessment.version_state == VersionDisplayState.UP_TO_DATE:
-                        print(
-                            f"  Version:      {status['version']} "
-                            f"{Colors.GREEN}(up to date){Colors.NC}"
-                        )
-                    else:
-                        print(
-                            _generic_version_annotation(
-                                status["version"], assessment.latest_version
-                            )
-                        )
-                else:
-                    print(f"  Version:      {status['version']}")
+                _print_version_status(
+                    assessment, status["version"], tool_path, tool_config
+                )
 
                 if assessment.decision == UpgradeDecision.UPGRADE:
                     outdated_count += 1