awesome-agv 1.0.0

package/bin/awesome-agv.js

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const https = require('https');
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { createInterface } = require('readline');
+const { execSync } = require('child_process');
+const os = require('os');
+const { createGunzip } = require('zlib');
+
+// ── ANSI Colors (zero-dependency) ──────────────────────────────────────────────
+const color = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+};
+
+const icons = {
+  check: `${color.green}✓${color.reset}`,
+  warn: `${color.yellow}⚠${color.reset}`,
+  error: `${color.red}✗${color.reset}`,
+  arrow: `${color.cyan}→${color.reset}`,
+  rocket: '🚀',
+  shield: '🛡️',
+  gear: '⚙️',
+  book: '📏',
+  tool: '🛠️',
+  cycle: '🔄',
+};
+
+// ── Constants ──────────────────────────────────────────────────────────────────
+const REPO_OWNER = 'irahardianto';
+const REPO_NAME = 'awesome-agv';
+const BRANCH = 'main';
+const TARBALL_URL = `https://github.com/${REPO_OWNER}/${REPO_NAME}/archive/refs/heads/${BRANCH}.tar.gz`;
+const AGENT_DIR = '.agent';
+
+// ── CLI Argument Parsing ───────────────────────────────────────────────────────
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  const options = {
+    force: false,
+    targetDir: process.cwd(),
+    help: false,
+  };
+
+  for (const arg of args) {
+    if (arg === '--force' || arg === '-f') {
+      options.force = true;
+    } else if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (!arg.startsWith('-')) {
+      options.targetDir = path.resolve(arg);
+    }
+  }
+
+  return options;
+}
+
+// ── Help Text ──────────────────────────────────────────────────────────────────
+function printHelp() {
+  console.log(`
+${color.bold}awesome-agv${color.reset} — Install the Awesome AGV AI Agent configuration suite
+
+${color.bold}USAGE${color.reset}
+  npx awesome-agv [target-dir] [options]
+
+${color.bold}ARGUMENTS${color.reset}
+  target-dir    Directory to install into (default: current directory)
+
+${color.bold}OPTIONS${color.reset}
+  -f, --force   Overwrite existing .agent directory without prompting
+  -h, --help    Show this help message
+
+${color.bold}EXAMPLES${color.reset}
+  ${color.dim}# Install into current directory${color.reset}
+  npx awesome-agv
+
+  ${color.dim}# Install into a specific project${color.reset}
+  npx awesome-agv ./my-project
+
+  ${color.dim}# Overwrite existing installation${color.reset}
+  npx awesome-agv --force
+
+${color.bold}WHAT GETS INSTALLED${color.reset}
+  ${icons.book}  30 Rules    — Security, architecture, testing, DevOps standards
+  ${icons.tool}  7 Skills    — Debugging, design, code review, and more
+  ${icons.cycle}  10 Workflows — End-to-end development processes
+
+${color.dim}https://github.com/${REPO_OWNER}/${REPO_NAME}${color.reset}
+`);
+}
+
+// ── User Prompt ────────────────────────────────────────────────────────────────
+function promptUser(question) {
+  return new Promise((resolve) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+// ── HTTP Download with Redirect Following ──────────────────────────────────────
+function downloadToFile(url, destPath, maxRedirects = 5) {
+  return new Promise((resolve, reject) => {
+    if (maxRedirects <= 0) {
+      reject(new Error('Too many redirects'));
+      return;
+    }
+
+    const client = url.startsWith('https') ? https : http;
+    client
+      .get(url, (res) => {
+        // Follow redirects (GitHub returns 302)
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          res.resume(); // Consume response to free up memory
+          downloadToFile(res.headers.location, destPath, maxRedirects - 1)
+            .then(resolve)
+            .catch(reject);
+          return;
+        }
+
+        if (res.statusCode !== 200) {
+          res.resume();
+          reject(new Error(`Failed to download: HTTP ${res.statusCode}`));
+          return;
+        }
+
+        const fileStream = fs.createWriteStream(destPath);
+        res.pipe(fileStream);
+        fileStream.on('finish', () => {
+          fileStream.close(resolve);
+        });
+        fileStream.on('error', (err) => {
+          fs.unlinkSync(destPath);
+          reject(err);
+        });
+      })
+      .on('error', reject);
+  });
+}
+
+// ── Extract .agent directory from tarball ──────────────────────────────────────
+function extractAgentDir(tarballPath, targetDir) {
+  // The tarball from GitHub has a root directory like: awesome-agv-main/
+  // We need to extract awesome-agv-main/.agent/ → targetDir/.agent/
+  const stripPrefix = `${REPO_NAME}-${BRANCH}/${AGENT_DIR}`;
+
+  const agentTargetDir = path.join(targetDir, AGENT_DIR);
+
+  // Ensure target exists
+  fs.mkdirSync(agentTargetDir, { recursive: true });
+
+  try {
+    // Use system tar (available on macOS and Linux)
+    execSync(
+      `tar -xzf "${tarballPath}" --strip-components=2 -C "${agentTargetDir}" "${stripPrefix}"`,
+      { stdio: 'pipe' }
+    );
+  } catch {
+    // Fallback: manual extraction using Node.js streams
+    extractManually(tarballPath, targetDir, stripPrefix);
+  }
+}
+
+// ── Manual tar extraction fallback (for Windows or missing tar) ────────────────
+function extractManually(tarballPath, targetDir, stripPrefix) {
+  // Read the gzipped tarball
+  const gzipData = fs.readFileSync(tarballPath);
+
+  // Decompress using zlib
+  const { execFileSync } = require('child_process');
+  const tmpExtractDir = path.join(os.tmpdir(), `awesome-agv-extract-${Date.now()}`);
+  fs.mkdirSync(tmpExtractDir, { recursive: true });
+
+  try {
+    // Try using tar with different flags (Windows Git Bash compatibility)
+    execFileSync('tar', ['-xzf', tarballPath, '-C', tmpExtractDir], { stdio: 'pipe' });
+
+    // Find the extracted .agent directory
+    const extractedRoot = path.join(tmpExtractDir, `${REPO_NAME}-${BRANCH}`, AGENT_DIR);
+
+    if (fs.existsSync(extractedRoot)) {
+      copyDirRecursive(extractedRoot, path.join(targetDir, AGENT_DIR));
+    } else {
+      throw new Error(`Could not find ${AGENT_DIR} in downloaded archive`);
+    }
+  } finally {
+    // Clean up temp extraction dir
+    fs.rmSync(tmpExtractDir, { recursive: true, force: true });
+  }
+}
+
+// ── Recursive directory copy ───────────────────────────────────────────────────
+function copyDirRecursive(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// ── Count files recursively ────────────────────────────────────────────────────
+function countFiles(dirPath) {
+  let count = 0;
+  if (!fs.existsSync(dirPath)) return count;
+
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      count += countFiles(fullPath);
+    } else {
+      count++;
+    }
+  }
+  return count;
+}
+
+// ── Print Banner ───────────────────────────────────────────────────────────────
+function printBanner() {
+  // Load version from package.json
+  const { version } = require('../package.json');
+  console.log(`
+${color.bold}${color.cyan}  ╔══════════════════════════════════════════╗
+  ║         ${color.magenta}awesome-agv${color.cyan}  ${color.dim}v${version}${color.cyan}${color.bold}            ║
+  ║   ${color.reset}${color.dim}Awesome AGV AI Agent Configuration${color.cyan}${color.bold}    ║
+  ╚══════════════════════════════════════════╝${color.reset}
+`);
+}
+
+// ── Print Success Summary ──────────────────────────────────────────────────────
+function printSuccess(targetDir) {
+  const agentDir = path.join(targetDir, AGENT_DIR);
+  const rulesDir = path.join(agentDir, 'rules');
+  const skillsDir = path.join(agentDir, 'skills');
+  const workflowsDir = path.join(agentDir, 'workflows');
+
+  const rulesCount = fs.existsSync(rulesDir)
+    ? fs.readdirSync(rulesDir).filter((f) => f.endsWith('.md')).length
+    : 0;
+  const skillsCount = fs.existsSync(skillsDir)
+    ? fs.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).length
+    : 0;
+  const workflowsCount = fs.existsSync(workflowsDir)
+    ? fs.readdirSync(workflowsDir).filter((f) => f.endsWith('.md')).length
+    : 0;
+  const totalFiles = countFiles(agentDir);
+
+  console.log(`
+${color.green}${color.bold}  Installation complete! ${icons.rocket}${color.reset}
+
+  ${icons.check} ${color.bold}${totalFiles} files${color.reset} installed to ${color.cyan}${path.relative(process.cwd(), agentDir) || AGENT_DIR}/${color.reset}
+
+  ${icons.book}  ${color.bold}${rulesCount}${color.reset} Rules      ${color.dim}Security, architecture, testing standards${color.reset}
+  ${icons.tool}  ${color.bold}${skillsCount}${color.reset} Skills     ${color.dim}Debugging, design, code review${color.reset}
+  ${icons.cycle}  ${color.bold}${workflowsCount}${color.reset} Workflows  ${color.dim}End-to-end dev processes${color.reset}
+
+  ${icons.arrow} ${color.dim}Your AI agent will automatically pick up the${color.reset}
+    ${color.dim}${AGENT_DIR}/ directory. No additional configuration needed.${color.reset}
+
+  ${icons.shield}  ${color.dim}Learn more: ${color.cyan}https://github.com/${REPO_OWNER}/${REPO_NAME}${color.reset}
+`);
+}
+
+// ── Main ───────────────────────────────────────────────────────────────────────
+async function main() {
+  const options = parseArgs(process.argv);
+
+  if (options.help) {
+    printHelp();
+    process.exit(0);
+  }
+
+  printBanner();
+
+  const targetAgentDir = path.join(options.targetDir, AGENT_DIR);
+
+  // Check if .agent already exists
+  if (fs.existsSync(targetAgentDir)) {
+    if (!options.force) {
+      console.log(
+        `  ${icons.warn}  ${color.yellow}An existing ${AGENT_DIR}/ directory was found at:${color.reset}`
+      );
+      console.log(`     ${color.dim}${targetAgentDir}${color.reset}\n`);
+
+      const answer = await promptUser(
+        `  ${color.bold}Overwrite? ${color.reset}${color.dim}(y/N)${color.reset} `
+      );
+
+      if (answer !== 'y' && answer !== 'yes') {
+        console.log(`\n  ${icons.arrow} ${color.dim}Installation cancelled.${color.reset}\n`);
+        process.exit(0);
+      }
+    }
+
+    // Remove existing .agent directory
+    console.log(`  ${icons.arrow} Removing existing ${AGENT_DIR}/ directory...`);
+    fs.rmSync(targetAgentDir, { recursive: true, force: true });
+  }
+
+  // Download tarball to a temp file
+  const tmpDir = os.tmpdir();
+  const tarballPath = path.join(tmpDir, `awesome-agv-${Date.now()}.tar.gz`);
+
+  try {
+    console.log(`  ${icons.arrow} Fetching latest configuration from GitHub...`);
+    await downloadToFile(TARBALL_URL, tarballPath);
+
+    console.log(`  ${icons.arrow} Extracting ${AGENT_DIR}/ directory...`);
+    extractAgentDir(tarballPath, options.targetDir);
+
+    printSuccess(options.targetDir);
+  } catch (err) {
+    console.error(`\n  ${icons.error} ${color.red}Installation failed:${color.reset} ${err.message}\n`);
+
+    // Clean up partial installation
+    if (fs.existsSync(targetAgentDir)) {
+      fs.rmSync(targetAgentDir, { recursive: true, force: true });
+    }
+
+    process.exit(1);
+  } finally {
+    // Clean up tarball
+    if (fs.existsSync(tarballPath)) {
+      fs.unlinkSync(tarballPath);
+    }
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "awesome-agv",
+  "version": "1.0.0",
+  "description": "1-click installer for Awesome AGV — a rugged, high-quality configuration suite for AI Agents.",
+  "bin": {
+    "awesome-agv": "./bin/awesome-agv.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "coding-assistant",
+    "configuration",
+    "rules",
+    "skills",
+    "workflows",
+    "awesome-agv",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/irahardianto/awesome-agv.git"
+  },
+  "homepage": "https://github.com/irahardianto/awesome-agv",
+  "bugs": {
+    "url": "https://github.com/irahardianto/awesome-agv/issues"
+  },
+  "license": "MIT",
+  "author": "irahardianto",
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}