feat(pinning): add s/p options for non-installed tools

- Extended [y/N/s/p] prompt to non-installed tools
- Added 's' option for not-installed: Skip this version (prompt if newer)
- Added 'p' option for not-installed: Never install (permanently skip)
- When tool not installed and user selects 'p', pins to 'never'
- Updated audit to treat pinned_version='never' as UP-TO-DATE
- Suppresses install prompts for tools user doesn't want

User experience:
  For installed tools:
    p = Pin to current version (don't ask for upgrades)
  For non-installed tools:
    p = Never install (permanently skip this tool)

Example:
  ==> ❌ Ruby (rbenv)
      installed: <none> via unknown
      target:    3.4.7
      Options:
        y = Install/upgrade now
        N = Skip (ask again next time)
        s = Skip version 3.4.7 (ask again if newer available)
        p = Never install (permanently skip this tool)
  Install/update? [y/N/s/p]

Author: CybotTM

catalog/docker.json

@@ -4,10 +4,11 @@
   "description": "Container platform for building and running applications",
   "homepage": "https://www.docker.com",
   "binary_name": "docker",
-  "script": "install_docker.sh"
-  ,"guide": {
+  "script": "install_docker.sh",
+  "guide": {
     "display_name": "Docker CLI",
     "install_action": "install",
     "order": 200
-  }
+  },
+  "pinned_version": "29.0.0"
 }

catalog/node.json

@@ -4,10 +4,11 @@
   "description": "Node.js JavaScript runtime",
   "homepage": "https://nodejs.org",
   "binary_name": "node",
-  "script": "install_node.sh"
-  ,"guide": {
+  "script": "install_node.sh",
+  "guide": {
     "display_name": "Node.js stack",
     "install_action": "reconcile",
     "order": 40
-  }
+  },
+  "pinned_version": "25.0.0"
 }

catalog/ruby.json

@@ -6,8 +6,8 @@
   "github_repo": "ruby/ruby",
   "binary_name": "ruby",
   "script": "install_ruby.sh",
-  "notes": "Installed via rbenv for version management. Removes apt-managed Ruby in favor of rbenv."
-  ,"guide": {
+  "notes": "Installed via rbenv for version management. Removes apt-managed Ruby in favor of rbenv.",
+  "guide": {
     "display_name": "Ruby (rbenv)",
     "install_action": "reconcile",
     "order": 32

cli_audit.py

@@ -2515,6 +2515,21 @@ def audit_tool(tool: Tool) -> tuple[str, str, str, str, str, str, str, str]:
                 except Exception:
                     pass  # Catalog read failed, continue with original status
 
+    # Check if tool is marked as "never install"
+    if status == "NOT INSTALLED":
+        script_dir = os.path.dirname(os.path.abspath(__file__))
+        catalog_file = os.path.join(script_dir, "catalog", f"{tool.name}.json")
+        if os.path.exists(catalog_file):
+            try:
+                with open(catalog_file, "r", encoding="utf-8") as f:
+                    catalog_data = json.load(f)
+                    pinned_version = catalog_data.get("pinned_version", "")
+                    if pinned_version == "never":
+                        # Tool is marked as never install - treat as up-to-date to suppress prompts
+                        status = "UP-TO-DATE"
+            except Exception:
+                pass  # Catalog read failed, continue with original status
+
     # Sanitize latest display to numeric (like installed)
     if latest_num:
         latest_display = latest_num

latest_versions.json

@@ -19,10 +19,10 @@
     "gh:docker/compose": "latest_redirect",
     "gh:eradman/entr": "atom",
     "gh:eslint/eslint": "latest_redirect",
-    "gh:git-lfs/git-lfs": "latest_redirect",
+    "gh:git-lfs/git-lfs": "atom",
     "gh:git/git": "atom",
     "gh:gitleaks/gitleaks": "latest_redirect",
-    "gh:golang/go": "tags_api",
+    "gh:golang/go": "atom",
     "gh:golangci/golangci-lint": "latest_redirect",
     "gh:hashicorp/terraform": "latest_redirect",
     "gh:jqlang/jq": "latest_redirect",
@@ -36,7 +36,7 @@
     "gh:phiresky/ripgrep-all": "latest_redirect",
     "gh:prettier/prettier": "latest_redirect",
     "gh:profclems/glab": "latest_redirect",
-    "gh:python/cpython": "tags_api",
+    "gh:python/cpython": "atom",
     "gh:rs/curlie": "latest_redirect",
     "gh:ruby/ruby": "latest_redirect",
     "gh:rubygems/rubygems": "latest_redirect",

scripts/guide.sh

@@ -117,16 +117,18 @@ process_tool() {
   printf "    will run: scripts/%s\n" "$install_cmd"
 
   # Prompt with options explained
+  printf "    Options:\n"
+  printf "      y = Install/upgrade now\n"
+  printf "      N = Skip (ask again next time)\n"
   if [ -n "$installed" ]; then
-    printf "    Options:\n"
-    printf "      y = Install/upgrade now\n"
-    printf "      N = Skip (ask again next time)\n"
     printf "      s = Skip version %s (ask again if newer available)\n" "$latest"
     printf "      p = Pin to %s (don't ask for upgrades)\n" "$installed"
+  else
+    printf "      s = Skip version %s (ask again if newer available)\n" "$latest"
+    printf "      p = Never install (permanently skip this tool)\n"
   fi
 
   local prompt_text="Install/update? [y/N/s/p] "
-  [ -z "$installed" ] && prompt_text="Install? [y/N] "
 
   local ans=""
   if [ -t 0 ]; then
@@ -164,9 +166,15 @@ process_tool() {
       "$ROOT"/scripts/pin_version.sh "$tool" "$latest" || true
       ;;
     [Pp])
-      # Pin to current version
-      printf "    Pinning to current version %s\n" "$installed"
-      "$ROOT"/scripts/pin_version.sh "$tool" "$installed" || true
+      if [ -n "$installed" ]; then
+        # Pin to current version
+        printf "    Pinning to current version %s\n" "$installed"
+        "$ROOT"/scripts/pin_version.sh "$tool" "$installed" || true
+      else
+        # Never install - pin to "never"
+        printf "    Marking as 'never install' (permanently skip this tool)\n"
+        "$ROOT"/scripts/pin_version.sh "$tool" "never" || true
+      fi
       ;;
     *)
       # User declined (N or empty)

tools_snapshot.json

@@ -1,7 +1,7 @@
 {
   "__meta__": {
     "count": 70,
-    "created_at": "2025-10-21T05:58:11Z",
+    "created_at": "2025-10-21T06:01:02Z",
     "offline": false,
     "partial_failures": 0,
     "schema_version": 1
@@ -44,10 +44,10 @@
       "installed_method": "uv python",
       "installed_path_selected": "/home/cybot/.venvs/dev/bin/python",
       "installed_version": "3.14.0",
-      "latest_upstream": "3.14.0",
-      "latest_url": "https://github.com/python/cpython/releases/tag/v3.14.0",
-      "latest_version": "3.14.0",
-      "status": "UP-TO-DATE",
+      "latest_upstream": "3.15.0",
+      "latest_url": "https://github.com/python/cpython/releases/tag/v3.15.0a1",
+      "latest_version": "3.15.0",
+      "status": "OUTDATED",
       "tool": "python",
       "tool_url": "https://github.com/python/cpython",
       "upstream_method": "github"
@@ -197,7 +197,7 @@
       "latest_upstream": "3.4.7",
       "latest_url": "https://github.com/ruby/ruby/releases/tag/v3.4.7",
       "latest_version": "3.4.7",
-      "status": "NOT INSTALLED",
+      "status": "UP-TO-DATE",
       "tool": "ruby",
       "tool_url": "https://github.com/ruby/ruby",
       "upstream_method": "github"