code-aide 1.0.2__tar.gz → 1.1.0__tar.gz

code_aide-1.1.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.2 → code_aide-1.1.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.2 → code_aide-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-aide
-Version: 1.0.2
+Version: 1.1.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
@@ -62,7 +62,7 @@ code-aide install
 # Install with automatic prerequisite installation (Node.js, npm)
 code-aide install -p
 
-# Upgrade installed tools
+# Upgrade installed tools (no args = only out-of-date tools)
 code-aide upgrade [NAMES]
 
 # Remove tools
@@ -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
@@ -133,6 +136,37 @@ uv run pytest tests/ -v
 uv run pytest tests/test_install.py::TestDetectOsArch -v
 ```
 
+## Release
+
+`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__`).
+   `pyproject.toml` reads it automatically via Hatchling.
+3. Run checks:
+   - `uv run pytest tests/ -v`
+   - `uv build`
+4. 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:
+   - 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:
+   - `git tag vX.Y.Z`
+   - `git push origin main --follow-tags`
+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
 
 Apache-2.0

{code_aide-1.0.2 → code_aide-1.1.0}/README.md

@@ -36,7 +36,7 @@ code-aide install
 # Install with automatic prerequisite installation (Node.js, npm)
 code-aide install -p
 
-# Upgrade installed tools
+# Upgrade installed tools (no args = only out-of-date tools)
 code-aide upgrade [NAMES]
 
 # Remove tools
@@ -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
@@ -107,6 +110,37 @@ uv run pytest tests/ -v
 uv run pytest tests/test_install.py::TestDetectOsArch -v
 ```
 
+## Release
+
+`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__`).
+   `pyproject.toml` reads it automatically via Hatchling.
+3. Run checks:
+   - `uv run pytest tests/ -v`
+   - `uv build`
+4. 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:
+   - 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:
+   - `git tag vX.Y.Z`
+   - `git push origin main --follow-tags`
+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
 
 Apache-2.0

code_aide-1.1.0/TODO.md

@@ -0,0 +1,39 @@
+# TODO
+
+Keep the project focused on managing AI coding CLI tools (install, upgrade,
+remove, status, and version metadata).
+
+## 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`.
+
+## 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.
+
+## 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 prerequisite edge cases and cache write behavior.

{code_aide-1.0.2 → code_aide-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "code-aide"
-version = "1.0.2"
+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.2 → code_aide-1.1.0}/src/code_aide/__init__.py

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

{code_aide-1.0.2 → code_aide-1.1.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.")
+            dest = _save(config["tools"])
+            print(f"Updated latest version info in {dest}.")
         if version_info_changed:
             print(
                 "No installer checksum updates required "
@@ -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.2 → code_aide-1.1.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.2 → code_aide-1.1.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.2 → code_aide-1.1.0}/src/code_aide/entry.py

@@ -40,7 +40,6 @@ def main() -> None:
     install_parser.add_argument(
         "tools",
         nargs="*",
-        choices=list(TOOLS.keys()),
         help="Tools to install (default: all)",
     )
     install_parser.add_argument(
@@ -62,8 +61,7 @@ def main() -> None:
     upgrade_parser.add_argument(
         "tools",
         nargs="*",
-        choices=list(TOOLS.keys()),
-        help="Tools to upgrade (default: all)",
+        help="Tools to upgrade (default: out-of-date only)",
     )
     upgrade_parser.set_defaults(func=cmd_upgrade)
 
@@ -71,7 +69,6 @@ def main() -> None:
     remove_parser.add_argument(
         "tools",
         nargs="*",
-        choices=list(TOOLS.keys()),
         help="Tools to remove (default: all)",
     )
     remove_parser.set_defaults(func=cmd_remove)
@@ -103,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.2 → code_aide-1.1.0}/tests/test_commands_actions.py

@@ -2,10 +2,12 @@
 
 import contextlib
 import io
+import sys
 import unittest
 from unittest import mock
 
 from code_aide import commands_actions
+from code_aide import entry
 
 
 class TestCmdInstall(unittest.TestCase):
@@ -55,7 +57,13 @@ class TestCmdUpdateVersions(unittest.TestCase):
         args = type(
             "Args",
             (),
-            {"tools": ["missing"], "dry_run": False, "yes": False, "verbose": False},
+            {
+                "tools": ["missing"],
+                "dry_run": False,
+                "yes": False,
+                "verbose": False,
+                "bundled": False,
+            },
         )()
         with mock.patch.object(
             commands_actions,
@@ -71,7 +79,13 @@ class TestCmdUpdateVersions(unittest.TestCase):
         args = type(
             "Args",
             (),
-            {"tools": [], "dry_run": True, "yes": False, "verbose": False},
+            {
+                "tools": [],
+                "dry_run": True,
+                "yes": False,
+                "verbose": False,
+                "bundled": False,
+            },
         )()
         with (
             mock.patch.object(
@@ -109,3 +123,80 @@ class TestCmdUpdateVersions(unittest.TestCase):
                 commands_actions.cmd_update_versions(args)
         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": [],
+                "dry_run": 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."""
+
+    def test_upgrade_with_no_args_parses_to_empty_tools_list(self):
+        with (
+            mock.patch.object(sys, "argv", ["code-aide", "upgrade"]),
+            mock.patch.object(entry, "cmd_upgrade") as mock_upgrade,
+        ):
+            entry.main()
+        mock_upgrade.assert_called_once()
+        (args,) = mock_upgrade.call_args[0]
+        self.assertEqual(args.command, "upgrade")
+        self.assertEqual(args.tools, [])

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

@@ -1,15 +0,0 @@
-name: Publish to PyPI
-on:
-  push:
-    tags: ["v*"]
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      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