@thynameisjayvee/alpha-cli 0.1.0

package/scripts/postinstall.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for @thynameisjayvee/alpha-cli
+ *
+ * Keeps setup minimal and non-destructive:
+ * 1. Creates the .alpha/ directory in the user's project
+ * 2. Adds .alpha/ to .gitignore
+ * 3. Creates a default config file
+ *
+ * The agent skill surface (AGENTS.md, SKILL.md, .cursor/.claude command files)
+ * is generated on demand by `alpha init`, not here.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const DEFAULT_CONFIG = {
+  version: '0.1.0',
+  output: {
+    alphaDir: '.alpha',
+    specsDir: '.alpha/specs',
+    reportsDir: '.alpha/reports',
+  },
+  review: {
+    defaultChecks: ['quality', 'security', 'performance'],
+  },
+  spec: {
+    defaultType: 'feature',
+    generateBDD: true,
+  },
+};
+
+/**
+ * Find the user's project root (not alpha's package root)
+ */
+function findProjectRoot() {
+  let currentDir = path.resolve(__dirname, '..');
+  
+  // Walk up until we find package.json (not in node_modules)
+  while (currentDir !== path.parse(currentDir).root) {
+    const pkgPath = path.join(currentDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      // Make sure it's not in node_modules
+      if (!currentDir.includes('node_modules')) {
+        return currentDir;
+      }
+    }
+    currentDir = path.dirname(currentDir);
+  }
+  
+  // Fallback: use current directory
+  return process.cwd();
+}
+
+/**
+ * Main postinstall function
+ */
+function postinstall() {
+  try {
+    const projectRoot = findProjectRoot();
+    const alphaDir = path.join(projectRoot, '.alpha');
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    const configPath = path.join(alphaDir, 'config.json');
+
+    // 1. Create .alpha/ directory
+    if (!fs.existsSync(alphaDir)) {
+      fs.mkdirSync(alphaDir, { recursive: true });
+      console.log('✓ Created .alpha/ directory');
+    }
+
+    // 2. Add to .gitignore
+    let gitignore = '';
+    if (fs.existsSync(gitignorePath)) {
+      gitignore = fs.readFileSync(gitignorePath, 'utf-8');
+    }
+    
+    if (!gitignore.includes('.alpha/')) {
+      gitignore += '\n# Alpha AI artifacts\n.alpha/\n';
+      fs.writeFileSync(gitignorePath, gitignore);
+      console.log('✓ Added .alpha/ to .gitignore');
+    }
+
+    // 3. Create default config
+    if (!fs.existsSync(configPath)) {
+      fs.writeFileSync(configPath, JSON.stringify(DEFAULT_CONFIG, null, 2));
+      console.log('✓ Created .alpha/config.json');
+    }
+
+    console.log('\nAlpha installed.');
+    console.log('\nNext step:');
+    console.log('  npx alpha init      - Generate agent skill files (AGENTS.md, etc.)');
+    console.log('\nThen drive Alpha from your LLM agent or terminal:');
+    console.log('  alpha gather        - Capture project requirements');
+    console.log('  alpha review        - Run deterministic code review');
+    console.log('  alpha implement     - Get a fix plan to apply yourself\n');
+
+  } catch (error) {
+    console.error('⚠️  Alpha postinstall warning:');
+    console.error('   Could not complete setup automatically.');
+    console.error('   Please create .alpha/ directory manually.');
+    console.error('   Error:', error.message);
+  }
+}
+
+// Run postinstall
+postinstall();