code-aide 1.0.3__tar.gz → 1.2.0__tar.gz

code_aide-1.2.0/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish to PyPI
+on:
+  push:
+    tags: ["v*"]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v5
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+      - name: Build commit changelog
+        id: changelog
+        run: |
+          set -euo pipefail
+          current_tag="${GITHUB_REF_NAME}"
+          previous_tag="$(git describe --tags --abbrev=0 "${current_tag}^" 2>/dev/null || true)"
+
+          {
+            echo "body<<EOF"
+            echo "## Commits"
+            echo
+            if [ -n "${previous_tag}" ]; then
+              echo "Range: \`${previous_tag}..${current_tag}\`"
+              echo
+              git log --pretty=format:'* %s (%h)' "${previous_tag}..${current_tag}"
+            else
+              echo "First tagged release."
+              echo
+              git log --pretty=format:'* %s (%h)' "${current_tag}"
+            fi
+            echo
+            echo "EOF"
+          } >> "${GITHUB_OUTPUT}"
+      - name: Create GitHub release notes
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          generate_release_notes: true
+          body: ${{ steps.changelog.outputs.body }}

{code_aide-1.0.3 → code_aide-1.2.0}/AGENTS.md

@@ -7,6 +7,9 @@
   user's local cache (~/.config/code-aide/versions.json)
 - All tests should pass before committing
 - Run `black` formatter on python before commits
+- 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)

{code_aide-1.0.3 → code_aide-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-aide
-Version: 1.0.3
+Version: 1.2.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
@@ -73,6 +73,9 @@ 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
@@ -137,27 +140,32 @@ uv run pytest tests/test_install.py::TestDetectOsArch -v
 
 `publish.yml` publishes to PyPI when a Git tag matching `v*` is pushed.
 
-1. Update version strings:
-   - `pyproject.toml` (`[project].version`)
-   - `src/code_aide/__init__.py` (`__version__`)
-2. Run checks:
+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__`).
+   `pyproject.toml` reads it automatically via Hatchling.
+3. Run checks:
    - `uv run pytest tests/ -v`
    - `uv build`
-3. Commit the release version bump:
-   - `git add pyproject.toml src/code_aide/__init__.py`
+4. Commit the release version bump:
+   - `git add src/code_aide/__init__.py`
    - `git commit -m "Bumped version to X.Y.Z"`
-4. Write useful commit messages before tagging:
+5. 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`
-5. Tag and push:
+6. Tag and push:
    - `git tag vX.Y.Z`
    - `git push origin main --follow-tags`
-6. Confirm GitHub Actions:
+7. 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 the
+     previous tag to the current tag.
 
 ## License
 

{code_aide-1.0.3 → code_aide-1.2.0}/README.md

@@ -47,6 +47,9 @@ 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
@@ -111,27 +114,32 @@ uv run pytest tests/test_install.py::TestDetectOsArch -v
 
 `publish.yml` publishes to PyPI when a Git tag matching `v*` is pushed.
 
-1. Update version strings:
-   - `pyproject.toml` (`[project].version`)
-   - `src/code_aide/__init__.py` (`__version__`)
-2. Run checks:
+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__`).
+   `pyproject.toml` reads it automatically via Hatchling.
+3. Run checks:
    - `uv run pytest tests/ -v`
    - `uv build`
-3. Commit the release version bump:
-   - `git add pyproject.toml src/code_aide/__init__.py`
+4. Commit the release version bump:
+   - `git add src/code_aide/__init__.py`
    - `git commit -m "Bumped version to X.Y.Z"`
-4. Write useful commit messages before tagging:
+5. 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`
-5. Tag and push:
+6. Tag and push:
    - `git tag vX.Y.Z`
    - `git push origin main --follow-tags`
-6. Confirm GitHub Actions:
+7. 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 the
+     previous tag to the current tag.
 
 ## License
 

code_aide-1.2.0/TODO.md

@@ -0,0 +1,70 @@
+# TODO
+
+Keep the project focused on managing AI coding CLI tools (install, upgrade,
+remove, status, and version metadata).
+
+## Bugs
+
+- [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] Replace PID-based temp directory naming with `tempfile.mkdtemp()` in
+  `install.py` `install_direct_download()`.
+- [x] Guard `package.split("/", 1)` in `detection.py`
+  `get_system_package_info()` against missing `/` in subprocess output.
+
+## Reliability and Correctness
+
+- [ ] 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.
+- [ ] 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.
+- [ ] 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.
+
+## 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.
+- [ ] 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`.
+- [ ] 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 major untested functions:
+  - `upgrade_tool()` (completely untested)
+  - `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.0.3 → code_aide-1.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "code-aide"
-version = "1.0.3"
+dynamic = ["version"]
 description = "Manage AI coding CLI tools (Claude, Copilot, Cursor, Gemini, Amp, Codex)"
 readme = "README.md"
 authors = [
@@ -37,6 +37,9 @@ code-aide = "code_aide.__main__:main"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
+[tool.hatch.version]
+path = "src/code_aide/__init__.py"
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 

{code_aide-1.0.3 → code_aide-1.2.0}/src/code_aide/__init__.py

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

{code_aide-1.0.3 → code_aide-1.2.0}/src/code_aide/commands_actions.py

@@ -26,6 +26,7 @@ from code_aide.config import (
     load_bundled_tools,
     load_versions_cache,
     merge_cached_versions,
+    save_bundled_versions,
     save_updated_versions,
 )
 
@@ -233,7 +234,8 @@ 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", {})
-    merge_cached_versions(tools, load_versions_cache())
+    if not args.bundled:
+        merge_cached_versions(tools, load_versions_cache())
 
     config: Dict[str, Any] = {"tools": tools}
 
@@ -290,11 +292,19 @@ def cmd_update_versions(args: argparse.Namespace) -> None:
                 tool_entry["latest_date"] = date
                 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_updated_versions(tools)
+        return "~/.config/code-aide/versions.json"
+
     updates = [result for result in results if result["update"]]
     if not updates:
-        if version_info_changed and not args.dry_run:
-            save_updated_versions(config["tools"])
-            print("Updated latest version info in ~/.config/code-aide/versions.json.")
+        if version_info_changed and not args.dryrun:
+            dest = _save(config["tools"])
+            print(f"Updated latest version info in {dest}.")
         if version_info_changed:
             print(
                 "No installer checksum updates required "
@@ -313,7 +323,7 @@ def cmd_update_versions(args: argparse.Namespace) -> None:
     for result in updates:
         print(f"  {result['tool']}: SHA256 changed")
 
-    if args.dry_run:
+    if args.dryrun:
         print("\nDry run mode - no changes written.")
         return
 
@@ -325,18 +335,16 @@ def cmd_update_versions(args: argparse.Namespace) -> None:
             return
         if answer not in ("y", "yes"):
             if version_info_changed:
-                save_updated_versions(config["tools"])
-                print(
-                    "Updated latest version info in ~/.config/code-aide/versions.json."
-                )
+                dest = _save(config["tools"])
+                print(f"Updated latest version info in {dest}.")
             else:
                 print("No changes made.")
             return
 
     updated = apply_sha256_updates(config, results)
-    save_updated_versions(config["tools"])
+    dest = _save(config["tools"])
 
-    print(f"\nUpdated {len(updated)} tool(s) in ~/.config/code-aide/versions.json:")
+    print(f"\nUpdated {len(updated)} tool(s) in {dest}:")
     for name in updated:
         print(f"  {name}")
     if version_info_changed:

{code_aide-1.0.3 → code_aide-1.2.0}/src/code_aide/config.py

@@ -103,3 +103,29 @@ 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.0.3 → code_aide-1.2.0}/src/code_aide/data/tools.json

@@ -30,8 +30,13 @@
       "command": "claude",
       "install_type": "self_managed",
       "npm_package": "@anthropic-ai/claude-code",
-      "upgrade_command": ["claude", "upgrade"],
-      "prerequisites": ["npm"],
+      "upgrade_command": [
+        "claude",
+        "upgrade"
+      ],
+      "prerequisites": [
+        "npm"
+      ],
       "min_node_version": null,
       "next_steps": "Run 'claude' and then use '/login' to authenticate",
       "version_args": [
@@ -39,8 +44,8 @@
       ],
       "docs_url": "https://docs.anthropic.com/en/docs/build-with-claude/claude-code",
       "default_install": true,
-      "latest_version": "2.1.62",
-      "latest_date": "2026-02-27"
+      "latest_version": "2.1.63",
+      "latest_date": "2026-02-28"
     },
     "gemini": {
       "name": "Gemini CLI",
@@ -57,7 +62,7 @@
       ],
       "docs_url": "https://github.com/google-gemini/gemini-cli",
       "default_install": true,
-      "latest_version": "0.30.1",
+      "latest_version": "0.31.0",
       "latest_date": "2026-02-27"
     },
     "amp": {
@@ -75,8 +80,8 @@
       ],
       "docs_url": "https://ampcode.com/manual",
       "default_install": false,
-      "latest_version": "0.0.1772222620-g1de875",
-      "latest_date": "2026-02-27"
+      "latest_version": "0.0.1772308894-g06c525",
+      "latest_date": "2026-02-28"
     },
     "codex": {
       "name": "Codex CLI",

{code_aide-1.0.3 → code_aide-1.2.0}/src/code_aide/detection.py

@@ -105,6 +105,9 @@ def get_system_package_info(binary_path: str) -> Dict[str, Optional[str]]:
     except Exception:
         pass
 
+    if "/" not in package:
+        return result
+
     category, package_name = package.split("/", 1)
     ebuild_dirs = globmod.glob(f"/var/db/repos/*/{category}/{package_name}/")
     ebuilds = []

{code_aide-1.0.3 → code_aide-1.2.0}/src/code_aide/entry.py

@@ -84,7 +84,7 @@ def main() -> None:
     )
     update_versions_parser.add_argument(
         "-n",
-        "--dry-run",
+        "--dryrun",
         action="store_true",
         help="Show changes only, do not write updates",
     )
@@ -100,6 +100,12 @@ 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.0.3 → code_aide-1.2.0}/src/code_aide/install.py

@@ -7,6 +7,7 @@ import platform
 import shutil
 import subprocess
 import tarfile
+import tempfile
 from typing import Any, Dict, Optional
 
 from code_aide.constants import TOOLS
@@ -162,8 +163,11 @@ def install_direct_download(
         tarball_data, _ = fetch_url(download_url, timeout=120)
         success(f"Downloaded {len(tarball_data)} bytes")
 
-        temp_dir = install_dir + f".tmp-{os.getpid()}"
-        os.makedirs(temp_dir, exist_ok=True)
+        install_parent = os.path.dirname(install_dir) or "."
+        os.makedirs(install_parent, exist_ok=True)
+        temp_dir = tempfile.mkdtemp(
+            prefix=os.path.basename(install_dir) + ".tmp-", dir=install_parent
+        )
 
         try:
             with tarfile.open(fileobj=io.BytesIO(tarball_data), mode="r:gz") as tf:
@@ -275,6 +279,7 @@ def install_tool(tool_name: str, dryrun: bool = False) -> bool:
                 if dryrun:
                     success(f"{tool_config['name']} verification passed")
                 else:
+                    success(f"{tool_config['name']} installed successfully")
                     info(tool_config["next_steps"])
                     if "docs_url" in tool_config:
                         info(f"Documentation: {tool_config['docs_url']}")

{code_aide-1.0.3 → code_aide-1.2.0}/tests/test_commands_actions.py

@@ -57,7 +57,13 @@ class TestCmdUpdateVersions(unittest.TestCase):
         args = type(
             "Args",
             (),
-            {"tools": ["missing"], "dry_run": False, "yes": False, "verbose": False},
+            {
+                "tools": ["missing"],
+                "dryrun": False,
+                "yes": False,
+                "verbose": False,
+                "bundled": False,
+            },
         )()
         with mock.patch.object(
             commands_actions,
@@ -73,7 +79,13 @@ class TestCmdUpdateVersions(unittest.TestCase):
         args = type(
             "Args",
             (),
-            {"tools": [], "dry_run": True, "yes": False, "verbose": False},
+            {
+                "tools": [],
+                "dryrun": True,
+                "yes": False,
+                "verbose": False,
+                "bundled": False,
+            },
         )()
         with (
             mock.patch.object(
@@ -113,6 +125,68 @@ class TestCmdUpdateVersions(unittest.TestCase):
         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."""
 

{code_aide-1.0.3 → code_aide-1.2.0}/tests/test_install.py

@@ -122,3 +122,57 @@ class TestInstallDirectDownloadDryrun(unittest.TestCase):
 
         result = cli_install.install_direct_download("test", tool_config, dryrun=True)
         self.assertFalse(result)
+
+
+class TestInstallDirectDownload(unittest.TestCase):
+    """Tests for install_direct_download in non-dryrun mode."""
+
+    @mock.patch.object(cli_install, "detect_os_arch", return_value=("linux", "x64"))
+    @mock.patch.object(cli_install, "fetch_url")
+    def test_creates_missing_install_parent_directory(self, mock_fetch, mock_os_arch):
+        script_content = b"echo install"
+        expected_sha256 = cli_install.hashlib.sha256(script_content).hexdigest()
+
+        tarball_data = io.BytesIO()
+        with tarfile.open(fileobj=tarball_data, mode="w:gz") as tf:
+            payload = b"#!/bin/sh\necho ok\n"
+            info = tarfile.TarInfo("package/test-bin")
+            info.mode = 0o755
+            info.size = len(payload)
+            tf.addfile(info, io.BytesIO(payload))
+        tarball_bytes = tarball_data.getvalue()
+
+        def _fake_fetch(url, timeout=30):
+            if url.endswith("/install"):
+                return script_content, None
+            return tarball_bytes, None
+
+        mock_fetch.side_effect = _fake_fetch
+
+        tool_config = {
+            "name": "Test Tool",
+            "install_url": "https://example.com/install",
+            "install_sha256": expected_sha256,
+            "download_url_template": "https://example.com/{version}/{os}/{arch}/pkg.tar.gz",
+            "install_dir": "/tmp/test-{version}",
+            "bin_dir": "/tmp/test-bin",
+            "symlinks": {"test": "test-bin"},
+            "latest_version": "1.0.0",
+        }
+
+        with tempfile.TemporaryDirectory() as td:
+            install_dir = os.path.join(td, "missing", "versions", "1.0.0")
+            bin_dir = os.path.join(td, "bin")
+
+            result = cli_install.install_direct_download(
+                "test",
+                tool_config,
+                dryrun=False,
+                install_dir_override=install_dir,
+                bin_dir_override=bin_dir,
+            )
+
+            self.assertTrue(result)
+            self.assertTrue(os.path.isdir(os.path.dirname(install_dir)))
+            self.assertTrue(os.path.exists(os.path.join(install_dir, "test-bin")))
+            self.assertTrue(os.path.islink(os.path.join(bin_dir, "test")))

code_aide-1.0.3/.github/workflows/publish.yml

@@ -1,20 +0,0 @@
-name: Publish to PyPI
-on:
-  push:
-    tags: ["v*"]
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v5
-      - run: uv build
-      - uses: pypa/gh-action-pypi-publish@release/v1
-      - name: Create GitHub release notes
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: ${{ github.ref_name }}
-          generate_release_notes: true