github-delivery-os 1.0.0

package/src/install.js

@@ -0,0 +1,232 @@
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+
+const WORKFLOWS = [
+  'sprint-child-creator',
+  'auto-close-sprint',
+  'notify-release-approver',
+  'authorize-deployment',
+  'auto-assign-qa',
+  'telegram-issues',
+  'setup-labels',
+];
+
+const LABELS = [
+  ['intake', '0E8A16'],
+  ['bug', 'D93F0B'],
+  ['sprint', '1D76DB'],
+  ['sprint-active', '1D76DB'],
+  ['planning', '5319E7'],
+  ['sprint-planning', '5319E7'],
+  ['task', '7057FF'],
+  ['qa', 'FBCA04'],
+  ['qa-request', 'FBCA04'],
+  ['production', 'D93F0B'],
+  ['release', 'B60205'],
+  ['approval', '0E8A16'],
+  ['ready-for-deploy', '0E8A16'],
+  ['declined', 'B60205'],
+  ['risk', 'B60205'],
+];
+
+function getPackageRoot() {
+  // When installed via npm, __dirname is node_modules/github-delivery-os/src
+  const possibleRoots = [
+    path.join(__dirname, '..'),
+    path.join(__dirname, '..', '..', '..'), // npx: node_modules/.bin/../../
+  ];
+  for (const root of possibleRoots) {
+    const workflowsPath = path.join(root, '.github', 'workflows', 'sprint-child-creator.yml');
+    if (fs.existsSync(workflowsPath)) {
+      return root;
+    }
+  }
+  throw new Error('Could not find package assets. Ensure .github/workflows exists.');
+}
+
+function runInstall(options) {
+  const {
+    targetDir = '.',
+    withTemplates = false,
+    withLabels = false,
+    overwrite = false,
+    dryRun = false,
+  } = options;
+
+  const pkgRoot = getPackageRoot();
+  const workflowsSrc = path.join(pkgRoot, '.github', 'workflows');
+  const templatesSrc = path.join(pkgRoot, '.github', 'ISSUE_TEMPLATE');
+  const targetAbs = path.resolve(process.cwd(), targetDir);
+
+  console.log('=== GitHub Delivery Operating System ===');
+  console.log(`Target: ${targetAbs}`);
+
+  if (overwrite) {
+    console.log('');
+    console.log('⚠️  WARNING: Overwrite mode — existing Delivery OS workflows/templates will be REPLACED.');
+    console.log('    (Your other workflows/templates with different names are not affected.)');
+    console.log('');
+  } else if (dryRun) {
+    console.log('Mode: dry-run (no files will be changed)');
+    console.log('');
+  } else {
+    console.log('Mode: skip-existing (existing workflows/templates will NOT be overwritten)');
+    console.log('');
+  }
+
+  // Ensure target structure
+  const workflowsDest = path.join(targetAbs, '.github', 'workflows');
+  const templatesDest = path.join(targetAbs, '.github', 'ISSUE_TEMPLATE');
+
+  if (!dryRun) {
+    fs.mkdirSync(workflowsDest, { recursive: true });
+    fs.mkdirSync(templatesDest, { recursive: true });
+  }
+
+  let workflowsCopied = 0;
+  let templatesCopied = 0;
+
+  // Copy workflows
+  for (const wf of WORKFLOWS) {
+    const src = path.join(workflowsSrc, `${wf}.yml`);
+    const dest = path.join(workflowsDest, `${wf}.yml`);
+
+    if (!fs.existsSync(src)) {
+      console.log(`  Warning: source not found: ${wf}.yml`);
+      continue;
+    }
+
+    if (fs.existsSync(dest) && !overwrite) {
+      console.log(`  Skipped (exists): ${wf}.yml`);
+    } else if (dryRun) {
+      console.log(`  [dry-run] Would create: ${wf}.yml`);
+      workflowsCopied++;
+    } else {
+      fs.copyFileSync(src, dest);
+      console.log(`  Created: ${wf}.yml`);
+      workflowsCopied++;
+    }
+  }
+
+  // Copy templates
+  if (withTemplates && fs.existsSync(templatesSrc)) {
+    const files = fs.readdirSync(templatesSrc);
+    for (const name of files) {
+      if (!name.endsWith('.yml') && !name.endsWith('.yaml')) continue;
+      const src = path.join(templatesSrc, name);
+      const dest = path.join(templatesDest, name);
+      if (!fs.statSync(src).isFile()) continue;
+
+      if (fs.existsSync(dest) && !overwrite) {
+        console.log(`  Skipped (exists): ${name}`);
+      } else if (dryRun) {
+        console.log(`  [dry-run] Would create template: ${name}`);
+        templatesCopied++;
+      } else {
+        fs.copyFileSync(src, dest);
+        console.log(`  Created template: ${name}`);
+        templatesCopied++;
+      }
+    }
+  }
+
+  // Create labels via gh
+  let labelsCreated = 0;
+  let labelsSkipReason = '';
+
+  if (withLabels) {
+    if (dryRun) {
+      labelsSkipReason = 'Skipped in dry-run.';
+      console.log('  [dry-run] Labels would be created (skipped)');
+    } else {
+      try {
+        execSync('gh --version', { stdio: 'ignore' });
+      } catch {
+        labelsSkipReason = 'gh CLI not installed. Install from https://cli.github.com/';
+        console.log(`  Skipped labels: ${labelsSkipReason}`);
+      }
+
+      if (!labelsSkipReason && !fs.existsSync(path.join(targetAbs, '.git'))) {
+        labelsSkipReason = 'Target is not a git repository.';
+        console.log(`  Skipped labels: ${labelsSkipReason}`);
+      }
+
+      if (!labelsSkipReason) {
+        try {
+          execSync('gh auth status', { cwd: targetAbs, stdio: 'ignore' });
+        } catch {
+          labelsSkipReason = 'gh CLI not authenticated. Run: gh auth login';
+          console.log(`  Skipped labels: ${labelsSkipReason}`);
+        }
+      }
+
+      if (!labelsSkipReason) {
+        try {
+          execSync('gh repo view', { cwd: targetAbs, stdio: 'ignore' });
+        } catch {
+          labelsSkipReason = 'Target repo not on GitHub or no push access.';
+          console.log(`  Skipped labels: ${labelsSkipReason}`);
+        }
+      }
+
+      if (!labelsSkipReason) {
+        for (const [name, color] of LABELS) {
+          try {
+            execSync(`gh label create "${name}" --color "${color}"`, {
+              cwd: targetAbs,
+              stdio: 'pipe',
+            });
+            console.log(`  Created label: ${name}`);
+            labelsCreated++;
+          } catch (err) {
+            const msg = err.stderr?.toString() || err.message || '';
+            if (/already exists/i.test(msg)) {
+              console.log(`  Skipped (exists): ${name}`);
+            } else {
+              console.log(`  Failed to create label '${name}': ${msg.trim()}`);
+            }
+          }
+        }
+      }
+    }
+  }
+
+  // Summary
+  console.log('');
+  if (workflowsCopied > 0 || templatesCopied > 0 || labelsCreated > 0) {
+    if (dryRun) {
+      if (workflowsCopied > 0) console.log(`Would install ${workflowsCopied} workflow(s).`);
+      if (templatesCopied > 0) console.log(`Would copy ${templatesCopied} issue template(s).`);
+    } else {
+      if (workflowsCopied > 0) console.log(`Installed ${workflowsCopied} workflow(s).`);
+      if (templatesCopied > 0) console.log(`Copied ${templatesCopied} issue template(s).`);
+      if (labelsCreated > 0) console.log(`Created ${labelsCreated} label(s).`);
+    }
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. Create labels: Actions → Setup Labels → Run workflow');
+    if (labelsSkipReason) console.log(`     (Labels skipped: ${labelsSkipReason})`);
+    console.log('  2. Configure repo variables (Settings → Secrets and variables → Actions):');
+    console.log('     - RELEASE_APPROVER: GitHub username of release approver');
+    console.log('     - QA_APPROVER: GitHub username of QA approver');
+    console.log('     - QA_ASSIGNEES: Comma-separated usernames for QA assignment');
+    console.log('  3. Add secrets (optional, for Telegram): TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID');
+    if (!withTemplates) {
+      console.log('  4. Copy templates: re-run with --with-templates');
+    }
+    console.log('');
+    console.log('See https://jkaweesi22.github.io/github-delivery-operating-system/ for full docs.');
+  } else {
+    if (dryRun) {
+      console.log('Dry run complete. No files were changed.');
+    } else {
+      console.log('No new files created (existing files were skipped).');
+      console.log('To update: use --overwrite (run with --dry-run first to preview).');
+    }
+  }
+  console.log('');
+  console.log('=== Installation complete ===');
+}
+
+module.exports = { runInstall };