@fredlackey/devutils 0.0.19 → 0.1.0

package/src/utils/git-status/index.js

@@ -0,0 +1,116 @@
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+const meta = {
+  name: 'git-status',
+  description: 'Scan directories for git repos and show a color-coded status summary',
+  platforms: ['macos', 'ubuntu', 'raspbian', 'amazon-linux', 'windows', 'gitbash'],
+  arguments: [
+    { name: 'path', required: false, description: 'Directory to scan (defaults to current directory)' },
+  ],
+  flags: [
+    { name: 'depth', type: 'number', description: 'How many levels deep to scan for repos (default: 1)' },
+  ],
+};
+
+/**
+ * Run the Unix bash script for git status scanning.
+ * @param {string} dir - The directory to scan.
+ */
+async function runUnixScript(dir) {
+  const shell = require('../../lib/shell');
+  const scriptPath = path.join(__dirname, 'unix.sh');
+
+  const result = await shell.exec(`bash "${scriptPath}" "${dir}"`);
+
+  if (result.exitCode !== 0) {
+    console.error(result.stderr || 'git-status script failed');
+    return;
+  }
+
+  if (result.stdout) {
+    console.log(result.stdout);
+  }
+}
+
+/**
+ * Pure JavaScript fallback for platforms without bash (Windows, Git Bash).
+ * @param {string} dir - The directory to scan.
+ */
+async function runJsFallback(dir) {
+  const shell = require('../../lib/shell');
+
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const repos = entries
+    .filter(e => e.isDirectory() && fs.existsSync(path.join(dir, e.name, '.git')))
+    .map(e => ({ name: e.name, path: path.join(dir, e.name) }));
+
+  if (repos.length === 0) {
+    console.log('No git repositories found in ' + dir);
+    return;
+  }
+
+  for (const repo of repos) {
+    const opts = { cwd: repo.path };
+
+    // Get branch
+    let branch = shell.execSync('git symbolic-ref --short HEAD', opts);
+    if (branch === null) branch = 'detached';
+
+    // Get dirty count
+    const porcelain = shell.execSync('git status --porcelain', opts) || '';
+    const dirtyCount = porcelain ? porcelain.split('\n').filter(Boolean).length : 0;
+
+    // Get stash count
+    const stashList = shell.execSync('git stash list', opts) || '';
+    const stashCount = stashList ? stashList.split('\n').filter(Boolean).length : 0;
+
+    // Get ahead/behind
+    let ahead = 0;
+    let behind = 0;
+    const tracking = shell.execSync('git rev-parse --abbrev-ref @{upstream}', opts);
+    if (tracking) {
+      const counts = shell.execSync('git rev-list --left-right --count HEAD...@{upstream}', opts);
+      if (counts) {
+        const parts = counts.split(/\s+/);
+        ahead = parseInt(parts[0], 10) || 0;
+        behind = parseInt(parts[1], 10) || 0;
+      }
+    }
+
+    // Build status string
+    const statusParts = [];
+    if (dirtyCount > 0) statusParts.push(`${dirtyCount} dirty`);
+    if (ahead > 0) statusParts.push(`+${ahead}`);
+    if (behind > 0) statusParts.push(`-${behind}`);
+    if (stashCount > 0) statusParts.push(`${stashCount} stash`);
+    if (statusParts.length === 0) statusParts.push('clean');
+
+    const nameCol = repo.name.padEnd(30);
+    const branchCol = branch.padEnd(20);
+    console.log(`${nameCol} ${branchCol} ${statusParts.join('  ')}`);
+  }
+}
+
+async function run(args) {
+  const platform = require('../../lib/platform').detect();
+  const targetDir = args[0] || process.cwd();
+  const resolvedDir = path.resolve(targetDir);
+
+  if (!fs.existsSync(resolvedDir)) {
+    console.error(`Directory not found: ${resolvedDir}`);
+    return;
+  }
+
+  const unixPlatforms = ['macos', 'ubuntu', 'raspbian', 'amazon-linux'];
+
+  if (unixPlatforms.includes(platform.type)) {
+    await runUnixScript(resolvedDir);
+  } else {
+    await runJsFallback(resolvedDir);
+  }
+}
+
+module.exports = { meta, run };

package/src/utils/git-status/unix.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+# git-status: Scan directory for git repos and show status summary
+
+TARGET_DIR="${1:-.}"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'  # No Color
+BOLD='\033[1m'
+
+# Find git repos (immediate subdirectories with .git folders)
+for dir in "$TARGET_DIR"/*/; do
+  if [ ! -d "$dir/.git" ]; then
+    continue
+  fi
+
+  repo_name=$(basename "$dir")
+
+  # Get branch name
+  branch=$(git -C "$dir" symbolic-ref --short HEAD 2>/dev/null)
+  if [ -z "$branch" ]; then
+    branch="detached"
+  fi
+
+  # Get dirty file count
+  dirty_count=$(git -C "$dir" status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+
+  # Get stash count
+  stash_count=$(git -C "$dir" stash list 2>/dev/null | wc -l | tr -d ' ')
+
+  # Get ahead/behind counts
+  ahead=0
+  behind=0
+  tracking=$(git -C "$dir" rev-parse --abbrev-ref '@{upstream}' 2>/dev/null)
+  if [ -n "$tracking" ]; then
+    counts=$(git -C "$dir" rev-list --left-right --count HEAD...'@{upstream}' 2>/dev/null)
+    if [ -n "$counts" ]; then
+      ahead=$(echo "$counts" | awk '{print $1}')
+      behind=$(echo "$counts" | awk '{print $2}')
+    fi
+  fi
+
+  # Determine color based on status
+  color="$GREEN"
+  if [ "$dirty_count" -gt 0 ]; then
+    color="$YELLOW"
+  fi
+  if [ "$behind" -gt 0 ]; then
+    color="$RED"
+  fi
+
+  # Build status string
+  status_parts=""
+  if [ "$dirty_count" -gt 0 ]; then
+    status_parts="${status_parts} ${YELLOW}${dirty_count} dirty${NC}"
+  fi
+  if [ "$ahead" -gt 0 ]; then
+    status_parts="${status_parts} ${GREEN}+${ahead}${NC}"
+  fi
+  if [ "$behind" -gt 0 ]; then
+    status_parts="${status_parts} ${RED}-${behind}${NC}"
+  fi
+  if [ "$stash_count" -gt 0 ]; then
+    status_parts="${status_parts} ${CYAN}${stash_count} stash${NC}"
+  fi
+  if [ -z "$status_parts" ]; then
+    status_parts=" ${GREEN}clean${NC}"
+  fi
+
+  # Print the line
+  printf "${color}${BOLD}%-30s${NC} ${CYAN}%-20s${NC}%s\n" "$repo_name" "$branch" "$status_parts"
+done

package/src/utils/registry.json

@@ -0,0 +1,41 @@
+{
+  "_comment": "Built-in utility metadata. Name, description, supported platforms, and arguments for each utility.",
+  "utilities": [
+    {
+      "name": "git-status",
+      "description": "Scan directories for git repos and show a color-coded status summary",
+      "type": "built-in",
+      "platforms": ["macos", "ubuntu", "raspbian", "amazon-linux", "windows", "gitbash"],
+      "arguments": [
+        { "name": "path", "required": false, "description": "Directory to scan (defaults to current directory)" }
+      ],
+      "flags": [
+        { "name": "depth", "type": "number", "description": "How many levels deep to scan for repos (default: 1)" }
+      ]
+    },
+    {
+      "name": "clone",
+      "description": "Clone a git repo and auto-install dependencies using the detected package manager",
+      "type": "built-in",
+      "platforms": ["macos", "ubuntu", "raspbian", "amazon-linux", "windows", "gitbash"],
+      "arguments": [
+        { "name": "url", "required": true, "description": "Git repository URL (SSH or HTTPS)" },
+        { "name": "directory", "required": false, "description": "Target directory name (defaults to repo name)" }
+      ],
+      "flags": []
+    },
+    {
+      "name": "git-push",
+      "description": "Safer git push: shows what will be pushed, confirms before pushing, and protects main/master",
+      "type": "built-in",
+      "platforms": ["macos", "ubuntu", "raspbian", "amazon-linux", "windows", "gitbash"],
+      "arguments": [
+        { "name": "message", "required": true, "description": "Commit message" }
+      ],
+      "flags": [
+        { "name": "force", "type": "boolean", "description": "Allow pushing to protected branches" },
+        { "name": "yes", "type": "boolean", "description": "Skip confirmation prompt" }
+      ]
+    }
+  ]
+}