@reyemtech/stack-upgrade 0.4.0 → 0.5.0

package/README.md

@@ -0,0 +1,67 @@
+# @reyemtech/stack-upgrade
+
+[![npm](https://img.shields.io/npm/v/@reyemtech/stack-upgrade)](https://www.npmjs.com/package/@reyemtech/stack-upgrade)
+[![npm downloads](https://img.shields.io/npm/dm/@reyemtech/stack-upgrade)](https://www.npmjs.com/package/@reyemtech/stack-upgrade)
+[![License: BSL 1.1](https://img.shields.io/badge/License-BSL_1.1-yellow.svg)](https://github.com/ReyemTech/stack-upgrade/blob/main/LICENSE)
+[![Node](https://img.shields.io/node/v/@reyemtech/stack-upgrade)](https://nodejs.org)
+
+CLI to launch Stack Upgrade Agents via Docker or Kubernetes. Auto-detects repos, Claude credentials, and runtime — then launches disposable containers that upgrade your stack autonomously using [Claude Code](https://docs.anthropic.com/en/docs/claude-code).
+
+**Currently supports:** Laravel. **Coming soon:** React, Rails, Django.
+
+## Quick Start
+
+```bash
+npx @reyemtech/stack-upgrade
+```
+
+Or install globally:
+
+```bash
+npm i -g @reyemtech/stack-upgrade
+stack-upgrade
+```
+
+## Prerequisites
+
+- **Docker** or **kubectl** in PATH
+- **GitHub CLI** (`gh`) authenticated — for repo discovery and PR creation
+- **Claude credentials** — Claude Max token or Anthropic API key
+
+## What It Does
+
+1. Scans your GitHub repos for supported stacks (Laravel via `composer.json`)
+2. Prompts for target version, push/PR preference, and branch suffix
+3. Supports queuing multiple upgrades to run in parallel
+4. Launches a disposable Docker container (or K8s pod) per upgrade
+5. Each container runs Claude Code autonomously through upgrade phases
+6. Pushes an upgrade branch and optionally opens a PR with a generated changelog
+
+## Supported Stacks
+
+| Stack | Image | Status |
+|-------|-------|--------|
+| Laravel | `ghcr.io/reyemtech/laravel-upgrade-agent` | Available |
+| React | — | Planned |
+| Rails | — | Planned |
+| Django | — | Planned |
+
+## Configuration
+
+Config is persisted to `~/.stack-upgrade/config.json`:
+
+- Claude credentials (auto-detected from `~/.claude/.credentials.json`, env vars, or manual input)
+- GitHub token
+- Preferred run target (Docker or Kubernetes)
+
+## License
+
+[BSL 1.1](https://github.com/ReyemTech/stack-upgrade/blob/main/LICENSE)
+
+---
+
+<p align="center">
+  <a href="https://www.reyem.tech">
+    <img src="https://www.reyem.tech/images/logo-light-tagline.webp" alt="ReyemTech" width="200">
+  </a>
+</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reyemtech/stack-upgrade",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "CLI to launch Stack Upgrade Agents via Docker or Kubernetes",
   "type": "module",
   "bin": {
@@ -18,7 +18,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/ReyemTech/stack-upgrade.git",
+    "url": "git+https://github.com/reyemtech/stack-upgrade.git",
     "directory": "cli"
   },
   "license": "MIT"

package/src/github.js

@@ -88,23 +88,32 @@ export async function discoverRepos() {
 }
 
 /**
- * Prompt user to select a repo or enter manually.
- * @param {Array} repos
+ * Prompt for a manual repo URL and return a repo object.
  * @returns {Promise<{ name: string, url: string, stack: string, version: string }>}
  */
-export async function selectRepo(repos) {
-  if (repos.length === 0) {
-    const url = await p.text({
-      message: 'Enter the repository URL:',
-      placeholder: 'https://github.com/org/repo.git',
-      validate: (v) => {
-        if (!v) return 'URL is required';
-        if (!v.includes('github.com')) return 'Must be a GitHub URL';
-      },
-    });
-    if (p.isCancel(url)) process.exit(0);
+async function promptManualUrl() {
+  const url = await p.text({
+    message: 'Enter the repository URL:',
+    placeholder: 'https://github.com/org/repo.git',
+    validate: (v) => {
+      if (!v) return 'URL is required';
+      if (!v.includes('github.com')) return 'Must be a GitHub URL';
+    },
+  });
+  if (p.isCancel(url)) process.exit(0);
+
+  return { name: url.replace(/.*github\.com[:/]/, '').replace(/\.git$/, ''), url, stack: 'laravel', version: 'unknown' };
+}
 
-    return { name: url.replace(/.*github\.com[:/]/, '').replace(/\.git$/, ''), url, stack: 'laravel', version: 'unknown' };
+/**
+ * Prompt user to select one or more repos (or enter manually).
+ * @param {Array} repos
+ * @returns {Promise<Array<{ name: string, url: string, stack: string, version: string }>>}
+ */
+export async function selectRepos(repos) {
+  if (repos.length === 0) {
+    const repo = await promptManualUrl();
+    return [repo];
   }
 
   const options = repos.map((r) => ({
@@ -114,24 +123,22 @@ export async function selectRepo(repos) {
   }));
   options.push({ value: 'manual', label: 'Enter URL manually' });
 
-  const choice = await p.select({
-    message: 'Which repo do you want to upgrade?',
+  const choices = await p.multiselect({
+    message: 'Which repos do you want to upgrade?',
     options,
+    required: true,
   });
-  if (p.isCancel(choice)) process.exit(0);
-
-  if (choice === 'manual') {
-    const url = await p.text({
-      message: 'Enter the repository URL:',
-      placeholder: 'https://github.com/org/repo.git',
-      validate: (v) => {
-        if (!v) return 'URL is required';
-      },
-    });
-    if (p.isCancel(url)) process.exit(0);
-
-    return { name: url.replace(/.*github\.com[:/]/, '').replace(/\.git$/, ''), url, stack: 'laravel', version: 'unknown' };
+  if (p.isCancel(choices)) process.exit(0);
+
+  const selected = [];
+  for (const choice of choices) {
+    if (choice === 'manual') {
+      const repo = await promptManualUrl();
+      selected.push(repo);
+    } else {
+      selected.push(choice);
+    }
   }
 
-  return choice;
+  return selected;
 }

package/src/index.js

@@ -2,9 +2,9 @@
 
 import * as p from '@clack/prompts';
 import pc from 'picocolors';
-import { getGhToken, getGhUser, discoverRepos, selectRepo } from './github.js';
+import { getGhToken, getGhUser, discoverRepos, selectRepos } from './github.js';
 import { detectClaudeCredentials } from './credentials.js';
-import { askRunTarget, askTargetVersion, askPush, askSuffix, askAddAnother } from './prompts.js';
+import { askRunTarget, askTargetVersion, askPush, askSuffix } from './prompts.js';
 import { hasDocker, launchDocker } from './docker.js';
 import { hasKubectl, launchKubernetes } from './kubectl.js';
 import { getConfig, saveConfig } from './config.js';
@@ -71,22 +71,28 @@ async function main() {
   const push = await askPush();
   const suffix = await askSuffix();
 
-  // --- Multi-upgrade loop ---
-  const upgrades = [];
-
-  // eslint-disable-next-line no-constant-condition
-  while (true) {
-    const repo = await selectRepo(repos);
+  // --- Repo selection ---
+  const selectedRepos = await selectRepos(repos);
 
-    // Resolve stack
+  // Resolve stacks for each repo
+  const repoStacks = selectedRepos.map((repo) => {
     const stackConfig = getStack(repo.stack);
     if (!stackConfig) {
       p.log.warn(`Unknown stack: ${repo.stack}. Defaulting to Laravel.`);
     }
-    const stack = stackConfig || getStack('laravel');
-
-    const targetVersion = await askTargetVersion(stack.versionLabel);
+    return { repo, stack: stackConfig || getStack('laravel') };
+  });
+
+  // If all repos share the same stack, ask target version once; otherwise per-repo
+  const uniqueStacks = new Set(repoStacks.map((rs) => rs.repo.stack));
+  let sharedVersion = null;
+  if (uniqueStacks.size === 1) {
+    sharedVersion = await askTargetVersion(repoStacks[0].stack.versionLabel);
+  }
 
+  const upgrades = [];
+  for (const { repo, stack } of repoStacks) {
+    const targetVersion = sharedVersion || await askTargetVersion(`${stack.versionLabel} for ${repo.name}`);
     const branchName = suffix
       ? `${stack.branchPrefix}-${targetVersion}-${suffix}`
       : `${stack.branchPrefix}-${targetVersion}`;
@@ -105,20 +111,23 @@ async function main() {
       envKey: stack.envKey,
       branchName,
     });
-
-    const another = await askAddAnother();
-    if (!another) break;
   }
 
   // --- Confirmation ---
-  const summaryLines = upgrades.map((u, i) =>
-    `  ${i + 1}. ${u.repoName}    ${u.stackName} → ${u.targetVersion}    ${target === 'docker' ? 'Local Docker' : 'Kubernetes'}`,
-  );
+  const targetLabel = target === 'docker' ? 'Local Docker' : 'Kubernetes';
+  const maxName = Math.max(...upgrades.map((u) => u.repoName.length));
+  const maxStack = Math.max(...upgrades.map((u) => `${u.stackName} → ${u.targetVersion}`.length));
+
+  const summaryLines = upgrades.map((u, i) => {
+    const name = u.repoName.padEnd(maxName);
+    const stack = `${u.stackName} → ${u.targetVersion}`.padEnd(maxStack);
+    return `  ${i + 1}. ${name}  ${stack}  ${targetLabel}`;
+  });
 
   p.note([
     ...summaryLines,
     '',
-    `Push+PR: ${push ? 'yes' : 'no'}${suffix ? `    Suffix: ${suffix}` : ''}`,
+    `Push+PR: ${push ? 'yes' : 'no'}${suffix ? `  Suffix: ${suffix}` : ''}`,
   ].join('\n'), `Ready to launch ${upgrades.length} ${upgrades.length === 1 ? 'upgrade' : 'upgrades'}`);
 
   const confirm = await p.confirm({ message: 'Launch now?' });

package/src/prompts.js

@@ -70,16 +70,3 @@ export async function askRunTarget({ hasDocker, hasKubectl }) {
   if (p.isCancel(target)) process.exit(0);
   return target;
 }
-
-/**
- * Prompt to add another upgrade to the queue.
- * @returns {Promise<boolean>}
- */
-export async function askAddAnother() {
-  const another = await p.confirm({
-    message: 'Add another upgrade?',
-    initialValue: false,
-  });
-  if (p.isCancel(another)) process.exit(0);
-  return another;
-}