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

{code_aide-1.5.0 → code_aide-1.6.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.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-aide
-Version: 1.5.0
+Version: 1.6.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,25 @@ 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:
+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.6.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,25 @@ 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:
+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.6.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.6.0}/src/code_aide/__init__.py

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

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

@@ -26,7 +26,6 @@ from code_aide.config import (
     load_bundled_tools,
     load_versions_cache,
     merge_cached_versions,
-    save_bundled_versions,
     save_updated_versions,
 )
 
@@ -234,8 +233,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 +291,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.6.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

{code_aide-1.5.0 → code_aide-1.6.0}/src/code_aide/data/tools.json

@@ -21,9 +21,7 @@
         "--version"
       ],
       "docs_url": "https://docs.cursor.com/",
-      "default_install": true,
-      "latest_version": "2026.02.27-e7d2ef6",
-      "latest_date": "2026-02-27"
+      "default_install": true
     },
     "claude": {
       "name": "Claude CLI (Claude Code)",
@@ -38,9 +36,7 @@
         "--version"
       ],
       "docs_url": "https://code.claude.com/docs/en/setup",
-      "default_install": true,
-      "latest_version": "2.1.63",
-      "latest_date": "2026-02-28"
+      "default_install": true
     },
     "gemini": {
       "name": "Gemini CLI",
@@ -56,9 +52,7 @@
         "--version"
       ],
       "docs_url": "https://github.com/google-gemini/gemini-cli",
-      "default_install": true,
-      "latest_version": "0.31.0",
-      "latest_date": "2026-02-27"
+      "default_install": true
     },
     "amp": {
       "name": "Amp (Sourcegraph)",
@@ -74,9 +68,7 @@
         "--version"
       ],
       "docs_url": "https://ampcode.com/manual",
-      "default_install": false,
-      "latest_version": "0.0.1772339780-g24a24e",
-      "latest_date": "2026-03-01"
+      "default_install": false
     },
     "codex": {
       "name": "Codex CLI",
@@ -92,9 +84,7 @@
         "--version"
       ],
       "docs_url": "https://github.com/openai/codex",
-      "default_install": false,
-      "latest_version": "0.106.0",
-      "latest_date": "2026-02-26"
+      "default_install": false
     },
     "copilot": {
       "name": "Copilot CLI",
@@ -110,9 +100,7 @@
         "--version"
       ],
       "docs_url": "https://github.com/github/copilot-cli",
-      "default_install": false,
-      "latest_version": "0.0.420",
-      "latest_date": "2026-02-27"
+      "default_install": false
     },
     "opencode": {
       "name": "OpenCode",
@@ -128,9 +116,7 @@
         "--version"
       ],
       "docs_url": "https://opencode.ai/docs/cli",
-      "default_install": false,
-      "latest_version": "1.2.15",
-      "latest_date": "2026-02-26"
+      "default_install": false
     },
     "kilo": {
       "name": "Kilo CLI",
@@ -146,9 +132,7 @@
         "--version"
       ],
       "docs_url": "https://kilo.ai/docs/cli",
-      "default_install": false,
-      "latest_version": "7.0.33",
-      "latest_date": "2026-02-27"
+      "default_install": false
     }
   }
 }

{code_aide-1.5.0 → code_aide-1.6.0}/src/code_aide/entry.py

@@ -100,12 +100,6 @@ def main() -> None:
         action="store_true",
         help="Show full SHA256 hashes",
     )
-    update_versions_parser.add_argument(
-        "-b",
-        "--bundled",
-        action="store_true",
-        help="Update bundled data/tools.json instead of user cache (developer use)",
-    )
     update_versions_parser.set_defaults(func=cmd_update_versions)
 
     args = parser.parse_args()

{code_aide-1.5.0 → code_aide-1.6.0}/src/code_aide/install.py

@@ -12,7 +12,7 @@ from typing import Any, Dict, Optional
 
 from code_aide.constants import TOOLS
 from code_aide.console import command_exists, error, info, run_command, success, warning
-from code_aide.versions import fetch_url
+from code_aide.versions import check_script_tool, fetch_url
 
 
 def run_install_script(
@@ -117,7 +117,17 @@ def install_direct_download(
 ) -> bool:
     """Download, extract, and install a tool via direct tarball download."""
     try:
-        version = tool_config["latest_version"]
+        version = tool_config.get("latest_version")
+        if not version:
+            info("No cached version found, fetching latest version...")
+            result = check_script_tool(tool_name, tool_config)
+            version = result.get("version")
+            if not version or version == "-":
+                error(
+                    f"Could not determine latest version for {tool_name}. "
+                    "Run 'code-aide update-versions -y' first."
+                )
+                return False
         install_url = tool_config["install_url"]
         expected_sha256 = tool_config.get("install_sha256")
 

{code_aide-1.5.0 → code_aide-1.6.0}/tests/test_commands_actions.py

@@ -62,7 +62,6 @@ class TestCmdUpdateVersions(unittest.TestCase):
                 "dryrun": False,
                 "yes": False,
                 "verbose": False,
-                "bundled": False,
             },
         )()
         with mock.patch.object(
@@ -84,7 +83,6 @@ class TestCmdUpdateVersions(unittest.TestCase):
                 "dryrun": True,
                 "yes": False,
                 "verbose": False,
-                "bundled": False,
             },
         )()
         with (
@@ -124,65 +122,6 @@ class TestCmdUpdateVersions(unittest.TestCase):
         self.assertIn("No upstream config changes detected.", buf.getvalue())
         mock_save.assert_not_called()
 
-    def test_bundled_flag_skips_cache_and_saves_to_bundled(self):
-        args = type(
-            "Args",
-            (),
-            {
-                "tools": [],
-                "dryrun": False,
-                "yes": True,
-                "verbose": False,
-                "bundled": True,
-            },
-        )()
-        bundled_tools = {
-            "tools": {
-                "ok": {
-                    "install_type": "npm",
-                    "npm_package": "pkg",
-                    "latest_version": "1.0.0",
-                    "latest_date": "2026-01-01",
-                }
-            }
-        }
-        with (
-            mock.patch.object(
-                commands_actions,
-                "load_bundled_tools",
-                return_value=bundled_tools,
-            ),
-            mock.patch.object(
-                commands_actions, "load_versions_cache", return_value={}
-            ) as mock_cache,
-            mock.patch.object(commands_actions, "merge_cached_versions") as mock_merge,
-            mock.patch.object(
-                commands_actions,
-                "check_npm_tool",
-                return_value={
-                    "tool": "ok",
-                    "type": "npm",
-                    "version": "2.0.0",
-                    "date": "2026-02-01",
-                    "status": "ok",
-                    "update": None,
-                },
-            ),
-            mock.patch.object(commands_actions, "print_check_results_table"),
-            mock.patch.object(commands_actions, "save_updated_versions") as mock_save,
-            mock.patch.object(
-                commands_actions, "save_bundled_versions", return_value="/fake/path"
-            ) as mock_bundled,
-        ):
-            buf = io.StringIO()
-            with contextlib.redirect_stdout(buf):
-                commands_actions.cmd_update_versions(args)
-
-        mock_cache.assert_not_called()
-        mock_merge.assert_not_called()
-        mock_save.assert_not_called()
-        mock_bundled.assert_called_once()
-
 
 class TestUpgradeNoArgsParsing(unittest.TestCase):
     """Test that 'code-aide upgrade' with no arguments parses successfully."""