port-nuker 1.0.1 → 1.0.4

package/README.md

@@ -32,6 +32,9 @@ nuke <PORT>
 # Kill and wait until port is actually free
 nuke <PORT> --wait
 
+# Force kill even on protected ports
+nuke <PORT> --force
+
 # List all active ports and select one to kill interactively
 nuke list
 ```
@@ -87,6 +90,7 @@ nuke 5000 --wait && echo "Port is free!"
 ## Features
 
 - **Cross-Platform**: Works on Windows (using `netstat` + `taskkill`) and Unix-like systems (Linux/macOS using `lsof` + `kill`)
+- **Safe Mode Protection**: Protected ports (22, 80, 443, 3306, 5432, 6379, 27017, 5000, 8080) require `--force` flag to prevent accidental termination of critical services
 - **Interactive Mode**: Browse all active ports with `nuke list` and select which one to kill
 - **Wait Mode**: Block until port is actually released with `--wait` flag for safe command chaining
 - **Detailed Process Info**: See PID, command name, user, memory usage, and protocol for each port
@@ -113,6 +117,25 @@ nuke 8080
 node server.js
 ```
 
+### Protected Ports (Safe Mode)
+
+```bash
+# Attempting to kill a protected port (e.g., SSH on 22)
+nuke 22
+# Output:
+# ⚠️  Port 22 is protected (SSH).
+#    This port is typically used for critical services.
+#    Use --force to override: nuke 22 --force
+
+# Force kill a protected port
+nuke 443 --force
+# Successfully nukes the process on port 443 (HTTPS)
+
+# Protected ports: 22 (SSH), 80 (HTTP), 443 (HTTPS), 3306 (MySQL),
+#                  5432 (PostgreSQL), 6379 (Redis), 27017 (MongoDB),
+#                  5000 (Flask/Docker), 8080 (Alt HTTP)
+```
+
 ## Requirements
 
 - Node.js >= 12.0.0

package/index.js

@@ -5,16 +5,34 @@ const os = require('os');
 const inquirer = require('inquirer');
 const Table = require('cli-table3');
 
+// Protected ports that require --force flag
+const SAFE_PORTS = [22, 80, 443, 3306, 5432, 6379, 27017, 5000, 8080];
+
+const SAFE_PORT_DESCRIPTIONS = {
+  22: 'SSH',
+  80: 'HTTP',
+  443: 'HTTPS',
+  3306: 'MySQL',
+  5432: 'PostgreSQL',
+  6379: 'Redis',
+  27017: 'MongoDB',
+  5000: 'Flask/Docker Registry',
+  8080: 'Alternative HTTP'
+};
+
 const args = process.argv.slice(2);
 
 // Parse arguments
 let port = null;
 let shouldWait = false;
+let shouldForce = false;
 let command = null;
 
 for (let i = 0; i < args.length; i++) {
   if (args[i] === '--wait') {
     shouldWait = true;
+  } else if (args[i] === '--force') {
+    shouldForce = true;
   } else if (args[i] === 'list') {
     command = 'list';
   } else if (!isNaN(args[i])) {
@@ -26,16 +44,34 @@ for (let i = 0; i < args.length; i++) {
 if (command === 'list') {
   listPorts();
 } else if (port) {
-  // nuke <PORT> [--wait]
-  nukePort(port, shouldWait);
+  // nuke <PORT> [--wait] [--force]
+  nukePort(port, shouldWait, shouldForce);
 } else {
   console.error('Usage:');
-  console.error('  nuke <PORT>           Kill process on specific port');
-  console.error('  nuke <PORT> --wait    Kill process and wait until port is free');
-  console.error('  nuke list             List all active ports and select one to kill');
+  console.error('  nuke <PORT>              Kill process on specific port');
+  console.error('  nuke <PORT> --wait       Kill process and wait until port is free');
+  console.error('  nuke <PORT> --force      Force kill even on protected ports');
+  console.error('  nuke list                List all active ports and select one to kill');
+  console.error('');
+  console.error('Protected ports (require --force): 22, 80, 443, 3306, 5432, 6379, 27017, 5000, 8080');
   process.exit(1);
 }
 
+// Check if a port is protected and requires --force flag
+function checkSafePort(port, force) {
+  const portNum = parseInt(port);
+  
+  if (SAFE_PORTS.includes(portNum) && !force) {
+    const description = SAFE_PORT_DESCRIPTIONS[portNum] || 'System Service';
+    console.error(`\n⚠️  Port ${port} is protected (${description}).`);
+    console.error(`   This port is typically used for critical services.`);
+    console.error(`   Use --force to override: nuke ${port} --force\n`);
+    return false;
+  }
+  
+  return true;
+}
+
 // List all active ports with process details
 function listPorts() {
   const platform = os.platform();
@@ -235,11 +271,22 @@ async function promptKillProcess(processes) {
     if (answer.pid) {
       const selectedProcess = processes.find(p => p.pid === answer.pid);
       
+      // Check if port is protected
+      const portNum = parseInt(selectedProcess.port);
+      const isProtected = SAFE_PORTS.includes(portNum);
+      
+      let confirmMessage = `Kill process ${selectedProcess.command} (PID: ${answer.pid}) on port ${selectedProcess.port}?`;
+      
+      if (isProtected) {
+        const description = SAFE_PORT_DESCRIPTIONS[portNum] || 'System Service';
+        confirmMessage = `⚠️  Port ${selectedProcess.port} is protected (${description}).\n   Kill process ${selectedProcess.command} (PID: ${answer.pid})?`;
+      }
+      
       const confirm = await inquirer.prompt([
         {
           type: 'confirm',
           name: 'confirmed',
-          message: `Kill process ${selectedProcess.command} (PID: ${answer.pid}) on port ${selectedProcess.port}?`,
+          message: confirmMessage,
           default: false
         }
       ]);
@@ -335,7 +382,12 @@ function pollPortUntilFree(port, maxWaitSeconds = 30) {
 }
 
 // Original nuke port function
-function nukePort(port, shouldWait = false) {
+function nukePort(port, shouldWait = false, shouldForce = false) {
+  // Check if port is protected
+  if (!checkSafePort(port, shouldForce)) {
+    process.exit(1);
+  }
+  
   const platform = os.platform();
   let findCommand;
   

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "port-nuker",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "A simple CLI utility to kill processes holding a specific port. Solves EADDRINUSE errors instantly.",
   "main": "index.js",
   "bin": {
     "nuke": "./index.js"
   },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
@@ -23,7 +27,7 @@
     "lsof",
     "cross-platform"
   ],
-  "author": "Your Name <your.email@example.com>",
+  "author": "Alex Gutscher <alexgutscher26@gmail.com>",
   "license": "MIT",
   "repository": {
     "type": "git",

package/.agent/skills/scripts/generate_index.py

@@ -1,95 +0,0 @@
-import os
-import json
-import re
-
-import yaml
-
-def parse_frontmatter(content):
-    """
-    Parses YAML frontmatter using PyYAML for standard compliance.
-    """
-    fm_match = re.search(r'^---\s*\n(.*?)\n---', content, re.DOTALL)
-    if not fm_match:
-        return {}
-    
-    try:
-        return yaml.safe_load(fm_match.group(1)) or {}
-    except yaml.YAMLError as e:
-        print(f"⚠️ YAML parsing error: {e}")
-        return {}
-
-def generate_index(skills_dir, output_file):
-    print(f"🏗️ Generating index from: {skills_dir}")
-    skills = []
-
-    for root, dirs, files in os.walk(skills_dir):
-        # Skip .disabled or hidden directories
-        dirs[:] = [d for d in dirs if not d.startswith('.')]
-        
-        if "SKILL.md" in files:
-            skill_path = os.path.join(root, "SKILL.md")
-            dir_name = os.path.basename(root)
-            parent_dir = os.path.basename(os.path.dirname(root))
-            
-            # Default values
-            skill_info = {
-                "id": dir_name,
-                "path": os.path.relpath(root, os.path.dirname(skills_dir)),
-                "category": parent_dir if parent_dir != "skills" else "uncategorized",
-                "name": dir_name.replace("-", " ").title(),
-                "description": "",
-                "risk": "unknown",
-                "source": "unknown"
-            }
-            
-            try:
-                with open(skill_path, 'r', encoding='utf-8') as f:
-                    content = f.read()
-            except Exception as e:
-                print(f"⚠️ Error reading {skill_path}: {e}")
-                continue
-
-            # Parse Metadata
-            metadata = parse_frontmatter(content)
-            
-            # Merge Metadata
-            if "name" in metadata: skill_info["name"] = metadata["name"]
-            if "description" in metadata: skill_info["description"] = metadata["description"]
-            if "risk" in metadata: skill_info["risk"] = metadata["risk"]
-            if "source" in metadata: skill_info["source"] = metadata["source"]
-            
-            # Fallback for description if missing in frontmatter (legacy support)
-            if not skill_info["description"]:
-                body = content
-                fm_match = re.search(r'^---\s*\n(.*?)\n---', content, re.DOTALL)
-                if fm_match:
-                    body = content[fm_match.end():].strip()
-                
-                # Simple extraction of first non-header paragraph
-                lines = body.split('\n')
-                desc_lines = []
-                for line in lines:
-                    if line.startswith('#') or not line.strip():
-                        if desc_lines: break
-                        continue
-                    desc_lines.append(line.strip())
-                
-                if desc_lines:
-                    skill_info["description"] = " ".join(desc_lines)[:250].strip()
-
-            skills.append(skill_info)
-
-    # Sort validation: by name
-    skills.sort(key=lambda x: (x["name"].lower(), x["id"].lower()))
-
-    with open(output_file, 'w', encoding='utf-8') as f:
-        json.dump(skills, f, indent=2)
-    
-    print(f"✅ Generated rich index with {len(skills)} skills at: {output_file}")
-    return skills
-
-if __name__ == "__main__":
-    base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-    skills_path = os.path.join(base_dir, "skills")
-    output_path = os.path.join(base_dir, "skills_index.json")
-    generate_index(skills_path, output_path)

package/.agent/skills/scripts/skills_manager.py

@@ -1,119 +0,0 @@
-#!/usr/bin/env python3
-"""
-Skills Manager - Easily enable/disable skills locally
-
-Usage:
-  python3 scripts/skills_manager.py list          # List active skills
-  python3 scripts/skills_manager.py disabled      # List disabled skills
-  python3 scripts/skills_manager.py enable SKILL  # Enable a skill
-  python3 scripts/skills_manager.py disable SKILL # Disable a skill
-"""
-
-import sys
-import os
-from pathlib import Path
-
-SKILLS_DIR = Path(__file__).parent.parent / "skills"
-DISABLED_DIR = SKILLS_DIR / ".disabled"
-
-def list_active():
-    """List all active skills"""
-    print("🟢 Active Skills:\n")
-    skills = sorted([d.name for d in SKILLS_DIR.iterdir() 
-                    if d.is_dir() and not d.name.startswith('.')])
-    symlinks = sorted([s.name for s in SKILLS_DIR.iterdir() 
-                      if s.is_symlink()])
-    
-    for skill in skills:
-        print(f"  • {skill}")
-    
-    if symlinks:
-        print("\n📎 Symlinks:")
-        for link in symlinks:
-            target = os.readlink(SKILLS_DIR / link)
-            print(f"  • {link} → {target}")
-    
-    print(f"\n✅ Total: {len(skills)} skills + {len(symlinks)} symlinks")
-
-def list_disabled():
-    """List all disabled skills"""
-    if not DISABLED_DIR.exists():
-        print("❌ No disabled skills directory found")
-        return
-    
-    print("⚪ Disabled Skills:\n")
-    disabled = sorted([d.name for d in DISABLED_DIR.iterdir() if d.is_dir()])
-    
-    for skill in disabled:
-        print(f"  • {skill}")
-    
-    print(f"\n📊 Total: {len(disabled)} disabled skills")
-
-def enable_skill(skill_name):
-    """Enable a disabled skill"""
-    source = DISABLED_DIR / skill_name
-    target = SKILLS_DIR / skill_name
-    
-    if not source.exists():
-        print(f"❌ Skill '{skill_name}' not found in .disabled/")
-        return False
-    
-    if target.exists():
-        print(f"⚠️  Skill '{skill_name}' is already active")
-        return False
-    
-    source.rename(target)
-    print(f"✅ Enabled: {skill_name}")
-    return True
-
-def disable_skill(skill_name):
-    """Disable an active skill"""
-    source = SKILLS_DIR / skill_name
-    target = DISABLED_DIR / skill_name
-    
-    if not source.exists():
-        print(f"❌ Skill '{skill_name}' not found")
-        return False
-    
-    if source.name.startswith('.'):
-        print(f"⚠️  Cannot disable system directory: {skill_name}")
-        return False
-    
-    if source.is_symlink():
-        print(f"⚠️  Cannot disable symlink: {skill_name}")
-        print(f"   (Remove the symlink manually if needed)")
-        return False
-    
-    DISABLED_DIR.mkdir(exist_ok=True)
-    source.rename(target)
-    print(f"✅ Disabled: {skill_name}")
-    return True
-
-def main():
-    if len(sys.argv) < 2:
-        print(__doc__)
-        sys.exit(1)
-    
-    command = sys.argv[1].lower()
-    
-    if command == "list":
-        list_active()
-    elif command == "disabled":
-        list_disabled()
-    elif command == "enable":
-        if len(sys.argv) < 3:
-            print("❌ Usage: skills_manager.py enable SKILL_NAME")
-            sys.exit(1)
-        enable_skill(sys.argv[2])
-    elif command == "disable":
-        if len(sys.argv) < 3:
-            print("❌ Usage: skills_manager.py disable SKILL_NAME")
-            sys.exit(1)
-        disable_skill(sys.argv[2])
-    else:
-        print(f"❌ Unknown command: {command}")
-        print(__doc__)
-        sys.exit(1)
-
-if __name__ == "__main__":
-    main()

package/.agent/skills/scripts/sync_recommended_skills.sh

@@ -1,114 +0,0 @@
-#!/bin/bash
-# sync_recommended_skills.sh
-# Syncs only the 35 recommended skills from GitHub repo to local central library
-
-set -e
-
-# Paths
-GITHUB_REPO="/Users/nicco/Antigravity Projects/antigravity-awesome-skills/skills"
-LOCAL_LIBRARY="/Users/nicco/.gemini/antigravity/scratch/.agent/skills"
-BACKUP_DIR="/Users/nicco/.gemini/antigravity/scratch/.agent/skills_backup_$(date +%Y%m%d_%H%M%S)"
-
-# 35 Recommended Skills
-RECOMMENDED_SKILLS=(
-    # Tier S - Core Development (13)
-    "systematic-debugging"
-    "test-driven-development"
-    "writing-skills"
-    "doc-coauthoring"
-    "planning-with-files"
-    "concise-planning"
-    "software-architecture"
-    "senior-architect"
-    "senior-fullstack"
-    "verification-before-completion"
-    "git-pushing"
-    "address-github-comments"
-    "javascript-mastery"
-    
-    # Tier A - Your Projects (12)
-    "docx-official"
-    "pdf-official"
-    "pptx-official"
-    "xlsx-official"
-    "react-best-practices"
-    "web-design-guidelines"
-    "frontend-dev-guidelines"
-    "webapp-testing"
-    "playwright-skill"
-    "mcp-builder"
-    "notebooklm"
-    "ui-ux-pro-max"
-    
-    # Marketing & SEO (1)
-    "content-creator"
-    
-    # Corporate (4)
-    "brand-guidelines-anthropic"
-    "brand-guidelines-community"
-    "internal-comms-anthropic"
-    "internal-comms-community"
-    
-    # Planning & Documentation (1)
-    "writing-plans"
-    
-    # AI & Automation (5)
-    "workflow-automation"
-    "llm-app-patterns"
-    "autonomous-agent-patterns"
-    "prompt-library"
-    "github-workflow-automation"
-)
-
-echo "🔄 Sync Recommended Skills"
-echo "========================="
-echo ""
-echo "📍 Source: $GITHUB_REPO"
-echo "📍 Target: $LOCAL_LIBRARY"
-echo "📊 Skills to sync: ${#RECOMMENDED_SKILLS[@]}"
-echo ""
-
-# Create backup
-echo "📦 Creating backup at: $BACKUP_DIR"
-cp -r "$LOCAL_LIBRARY" "$BACKUP_DIR"
-echo "✅ Backup created"
-echo ""
-
-# Clear local library (keep README.md if exists)
-echo "🗑️  Clearing local library..."
-cd "$LOCAL_LIBRARY"
-for item in */; do
-    rm -rf "$item"
-done
-echo "✅ Local library cleared"
-echo ""
-
-# Copy recommended skills
-echo "📋 Copying recommended skills..."
-SUCCESS_COUNT=0
-MISSING_COUNT=0
-
-for skill in "${RECOMMENDED_SKILLS[@]}"; do
-    if [ -d "$GITHUB_REPO/$skill" ]; then
-        cp -r "$GITHUB_REPO/$skill" "$LOCAL_LIBRARY/"
-        echo "  ✅ $skill"
-        ((SUCCESS_COUNT++))
-    else
-        echo "  ⚠️  $skill (not found in repo)"
-        ((MISSING_COUNT++))
-    fi
-done
-
-echo ""
-echo "📊 Summary"
-echo "=========="
-echo "✅ Copied: $SUCCESS_COUNT skills"
-echo "⚠️  Missing: $MISSING_COUNT skills"
-echo "📦 Backup: $BACKUP_DIR"
-echo ""
-
-# Verify
-FINAL_COUNT=$(find "$LOCAL_LIBRARY" -maxdepth 1 -type d ! -name "." | wc -l | tr -d ' ')
-echo "🎯 Final count in local library: $FINAL_COUNT skills"
-echo ""
-echo "Done! Your local library now has only the recommended skills."

package/.agent/skills/scripts/update_readme.py

@@ -1,125 +0,0 @@
-#!/usr/bin/env python3
-import json
-import os
-import re
-
-def update_readme():
-    base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-    readme_path = os.path.join(base_dir, "README.md")
-    index_path = os.path.join(base_dir, "skills_index.json")
-
-    print(f"📖 Reading skills index from: {index_path}")
-    with open(index_path, 'r', encoding='utf-8') as f:
-        skills = json.load(f)
-
-    total_skills = len(skills)
-    print(f"🔢 Total skills found: {total_skills}")
-
-    print(f"📝 Updating README at: {readme_path}")
-    with open(readme_path, 'r', encoding='utf-8') as f:
-        content = f.read()
-
-    # 1. Update Title Count
-    content = re.sub(
-        r'(# 🌌 Antigravity Awesome Skills: )\d+(\+ Agentic Skills)',
-        f'\\g<1>{total_skills}\\g<2>',
-        content
-    )
-
-    # 2. Update Blockquote Count
-    content = re.sub(
-        r'(Collection of )\d+(\+ Universal)',
-        f'\\g<1>{total_skills}\\g<2>',
-        content
-    )
-
-    # 3. Update Intro Text Count
-    content = re.sub(
-        r'(library of \*\*)\d+( high-performance skills\*\*)',
-        f'\\g<1>{total_skills}\\g<2>',
-        content
-    )
-
-    # 4. Update Registry Header Count
-    content = re.sub(
-        r'(## Full Skill Registry \()\d+/\d+(\))',
-        f'\\g<1>{total_skills}/{total_skills}\\g<2>',
-        content
-    )
-
-    # 5. Insert Collections / Bundles Section (New in Phase 3)
-    # This logic checks if "## 📦 Curated Collections" exists. If not, it creates it before Full Registry.
-    collections_header = "## 📦 Curated Collections"
-    
-    if collections_header not in content:
-        # Insert before Full Skill Registry
-        content = content.replace("## Full Skill Registry", f"{collections_header}\n\n[Check out our Starter Packs in docs/BUNDLES.md](docs/BUNDLES.md) to find the perfect toolkit for your role.\n\n## Full Skill Registry")
-
-    # 6. Generate New Registry Table
-    print("🔄 Generating new registry table...")
-    
-    # Store the Note block to preserve it
-    note_pattern = r'(> \[!NOTE\].*?)\n\n\| Skill Name'
-    note_match = re.search(note_pattern, content, re.DOTALL)
-    note_block = ""
-    if note_match:
-        note_block = note_match.group(1)
-    else:
-        note_block = "> [!NOTE] > **Document Skills**: We provide both **community** and **official Anthropic** versions. Locally, the official versions are used by default."
-
-    table_header = "| Skill Name | Risk | Description | Path |\n| :--- | :--- | :--- | :--- |"
-    table_rows = []
-
-    for skill in skills:
-        name = skill.get('name', 'Unknown')
-        desc = skill.get('description', '').replace('\n', ' ').strip()
-        path = skill.get('path', '')
-        risk = skill.get('risk', 'unknown')
-        
-        # Risk Icons
-        risk_icon = "⚪"
-        if risk == "official": risk_icon = "🟣" # Mapping official to purple
-        if risk == "none": risk_icon = "🟢"
-        if risk == "safe": risk_icon = "🔵"
-        if risk == "critical": risk_icon = "🟠"
-        if risk == "offensive": risk_icon = "🔴"
-        
-        # Escape pipes
-        desc = desc.replace('|', r'\|')
-        
-        row = f"| **{name}** | {risk_icon} | {desc} | `{path}` |"
-        table_rows.append(row)
-
-    new_table_section = f"{note_block}\n\n{table_header}\n" + "\n".join(table_rows)
-
-    # Replace the old table section
-    header_pattern = r'## Full Skill Registry \(\d+/\d+\)'
-    header_match = re.search(header_pattern, content)
-    
-    if not header_match:
-        print("❌ Could not find 'Full Skill Registry' header.")
-        return
-
-    start_pos = header_match.end()
-    
-    # Find the next section (## ...) or end of file
-    next_section_match = re.search(r'\n## ', content[start_pos:])
-    
-    if next_section_match:
-        end_pos = start_pos + next_section_match.start()
-        rest_of_file = content[end_pos:]
-    else:
-        rest_of_file = ""
-
-    before_header = content[:header_match.start()]
-    new_header = f"## Full Skill Registry ({total_skills}/{total_skills})"
-    
-    new_content = f"{before_header}{new_header}\n\n{new_table_section}\n{rest_of_file}"
-
-    with open(readme_path, 'w', encoding='utf-8') as f:
-        f.write(new_content)
-
-    print("✅ README.md updated successfully with Collections link and Risk columns.")
-
-if __name__ == "__main__":
-    update_readme()