@reservine/dx 1.0.0

package/bin/cli.ts

@@ -0,0 +1,549 @@
+#!/usr/bin/env bun
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { execSync } from "child_process";
+import { homedir } from "os";
+import { join } from "path";
+
+// ─── Branding ──────────────────────────────────────────────────────────────────
+
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const RED = "\x1b[31m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const BLUE = "\x1b[34m";
+const MAGENTA = "\x1b[35m";
+const CYAN = "\x1b[36m";
+const WHITE = "\x1b[37m";
+const BG_GREEN = "\x1b[42m";
+const BG_RED = "\x1b[41m";
+const BG_YELLOW = "\x1b[43m";
+
+const LOGO = `
+${CYAN}${BOLD}  ╱╲${RESET}
+${CYAN}${BOLD} ╱  ╲${RESET}  ${BOLD}Reservine-DX${RESET}
+${CYAN}${BOLD}╱ ╱╲ ╲${RESET} ${DIM}Shared developer experience for Reservine${RESET}
+${CYAN}${BOLD}╲ ╲╱ ╱${RESET} ${DIM}github.com/Reservine/Reservine-DX${RESET}
+${CYAN}${BOLD} ╲  ╱${RESET}
+${CYAN}${BOLD}  ╲╱${RESET}
+`;
+
+// ─── Helpers ───────────────────────────────────────────────────────────────────
+
+const ok = (msg: string) => console.log(`  ${GREEN}✓${RESET} ${msg}`);
+const info = (msg: string) => console.log(`  ${BLUE}ℹ${RESET} ${msg}`);
+const warn = (msg: string) => console.log(`  ${YELLOW}⚠${RESET} ${msg}`);
+const fail = (msg: string) => console.log(`  ${RED}✗${RESET} ${msg}`);
+const step = (n: number, msg: string) =>
+  console.log(`\n  ${MAGENTA}${BOLD}[${n}]${RESET} ${BOLD}${msg}${RESET}`);
+
+const SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
+const MARKETPLACE_DIR = join(
+  homedir(),
+  ".claude",
+  "plugins",
+  "marketplaces",
+  "reservine-dx"
+);
+const REPO_URL = "https://github.com/Reservine/Reservine-DX.git";
+
+interface Settings {
+  extraKnownMarketplaces?: Record<string, unknown>;
+  enabledPlugins?: Record<string, boolean>;
+  [key: string]: unknown;
+}
+
+function readSettings(): Settings {
+  if (!existsSync(SETTINGS_PATH)) {
+    return {};
+  }
+  return JSON.parse(readFileSync(SETTINGS_PATH, "utf-8"));
+}
+
+function writeSettings(settings: Settings) {
+  const dir = join(homedir(), ".claude");
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
+}
+
+function isInstalled(): boolean {
+  const settings = readSettings();
+  return (
+    !!settings.extraKnownMarketplaces?.["reservine-dx" as keyof typeof settings.extraKnownMarketplaces] &&
+    !!settings.enabledPlugins?.["reservine-dx@reservine-dx"]
+  );
+}
+
+function getMarketplaceVersion(): string | null {
+  try {
+    const hash = execSync("git -C " + JSON.stringify(MARKETPLACE_DIR) + " rev-parse --short HEAD 2>/dev/null", {
+      encoding: "utf-8",
+    }).trim();
+    const date = execSync(
+      "git -C " + JSON.stringify(MARKETPLACE_DIR) + ' log -1 --format="%ci" 2>/dev/null',
+      { encoding: "utf-8" }
+    ).trim();
+    return `${hash} (${date.split(" ")[0]})`;
+  } catch {
+    return null;
+  }
+}
+
+// ─── Commands ──────────────────────────────────────────────────────────────────
+
+function install() {
+  console.log(LOGO);
+  console.log(
+    `  ${BOLD}Installing Reservine-DX marketplace...${RESET}\n`
+  );
+
+  // Step 1: Check prerequisites
+  step(1, "Checking prerequisites");
+
+  try {
+    execSync("claude --version 2>/dev/null", { stdio: "pipe" });
+    ok("Claude Code CLI found");
+  } catch {
+    warn("Claude Code CLI not found — install will continue but skills won't load until Claude Code is installed");
+  }
+
+  try {
+    execSync("gh auth status 2>/dev/null", { stdio: "pipe" });
+    ok("GitHub CLI authenticated");
+  } catch {
+    warn("GitHub CLI not authenticated — some skills require gh auth");
+  }
+
+  // Step 2: Patch settings.json
+  step(2, "Configuring Claude Code settings");
+
+  const settings = readSettings();
+
+  if (!settings.extraKnownMarketplaces) {
+    settings.extraKnownMarketplaces = {};
+  }
+
+  const marketplaces = settings.extraKnownMarketplaces as Record<string, unknown>;
+  if (marketplaces["reservine-dx"]) {
+    info("Marketplace already registered");
+  } else {
+    marketplaces["reservine-dx"] = {
+      source: {
+        source: "git",
+        url: REPO_URL,
+      },
+    };
+    ok("Added marketplace to extraKnownMarketplaces");
+  }
+
+  if (!settings.enabledPlugins) {
+    settings.enabledPlugins = {};
+  }
+
+  if (settings.enabledPlugins["reservine-dx@reservine-dx"]) {
+    info("Plugin already enabled");
+  } else {
+    settings.enabledPlugins["reservine-dx@reservine-dx"] = true;
+    ok("Enabled reservine-dx plugin");
+  }
+
+  writeSettings(settings);
+  ok(`Settings written to ${DIM}${SETTINGS_PATH}${RESET}`);
+
+  // Step 3: Summary
+  step(3, "Done!");
+
+  console.log(`
+  ${GREEN}${BOLD}Reservine-DX installed successfully!${RESET}
+
+  ${BOLD}What's included:${RESET}
+  ${DIM}Skills${RESET}    reservine-dx:new-feature-planning
+            reservine-dx:implement-plan
+            reservine-dx:cross-plan
+  ${DIM}Commands${RESET}  reservine-dx:cherry-pick-pr
+            reservine-dx:commit
+  ${DIM}Scripts${RESET}   setup-worktree.sh (auto-detects Angular/Laravel)
+
+  ${BOLD}Next steps:${RESET}
+  ${DIM}1.${RESET} Restart Claude Code to load the marketplace
+  ${DIM}2.${RESET} Run ${CYAN}/reservine-dx:new-feature-planning${RESET} in any Reservine repo
+  ${DIM}3.${RESET} Run ${CYAN}bunx reservine-dx doctor${RESET} to verify everything
+
+  ${DIM}Each repo needs a local plugin at:${RESET}
+  ${DIM}.claude/skills/implement-plan/plugin.md${RESET}
+`);
+}
+
+function update() {
+  console.log(LOGO);
+  console.log(`  ${BOLD}Updating Reservine-DX...${RESET}\n`);
+
+  if (!isInstalled()) {
+    fail("Reservine-DX is not installed");
+    console.log(`\n  Run ${CYAN}bunx reservine-dx install${RESET} first.\n`);
+    process.exit(1);
+  }
+
+  step(1, "Pulling latest from GitHub");
+
+  if (existsSync(MARKETPLACE_DIR)) {
+    try {
+      const before = execSync(
+        `git -C ${JSON.stringify(MARKETPLACE_DIR)} rev-parse --short HEAD`,
+        { encoding: "utf-8" }
+      ).trim();
+      execSync(`git -C ${JSON.stringify(MARKETPLACE_DIR)} pull --ff-only 2>&1`, {
+        encoding: "utf-8",
+        stdio: "pipe",
+      });
+      const after = execSync(
+        `git -C ${JSON.stringify(MARKETPLACE_DIR)} rev-parse --short HEAD`,
+        { encoding: "utf-8" }
+      ).trim();
+
+      if (before === after) {
+        ok("Already up to date");
+      } else {
+        ok(`Updated ${DIM}${before}${RESET} → ${GREEN}${after}${RESET}`);
+
+        // Show changelog
+        const log = execSync(
+          `git -C ${JSON.stringify(MARKETPLACE_DIR)} log --oneline ${before}..${after}`,
+          { encoding: "utf-8" }
+        ).trim();
+        if (log) {
+          console.log(`\n  ${BOLD}Changes:${RESET}`);
+          log.split("\n").forEach((line) => {
+            console.log(`  ${DIM}${line}${RESET}`);
+          });
+        }
+      }
+    } catch (e) {
+      fail("Failed to pull updates");
+      console.log(`  ${DIM}Try: git -C ${MARKETPLACE_DIR} pull${RESET}\n`);
+      process.exit(1);
+    }
+  } else {
+    warn("Marketplace directory not found — Claude Code will clone it on next startup");
+    info(`Expected at: ${DIM}${MARKETPLACE_DIR}${RESET}`);
+  }
+
+  // Also update the local checkout if this CLI is being run from one
+  const cliDir = new URL(".", import.meta.url).pathname;
+  const localCheckout = join(cliDir, "..");
+  const localCheckouts = existsSync(join(localCheckout, ".git", "config"))
+    ? [localCheckout]
+    : [];
+
+  for (const dir of localCheckouts) {
+    if (existsSync(join(dir, ".git"))) {
+      step(2, "Updating local checkout");
+      try {
+        execSync(`git -C ${JSON.stringify(dir)} pull --ff-only 2>&1`, {
+          encoding: "utf-8",
+          stdio: "pipe",
+        });
+        ok(`Updated ${DIM}${dir}${RESET}`);
+      } catch {
+        warn(`Could not update ${dir} — may have local changes`);
+      }
+    }
+  }
+
+  console.log(`\n  ${GREEN}${BOLD}Update complete!${RESET}\n`);
+}
+
+function doctor() {
+  console.log(LOGO);
+  console.log(`  ${BOLD}Health Check${RESET}\n`);
+
+  let issues = 0;
+
+  // Check 1: Settings
+  console.log(`  ${BOLD}Settings${RESET}`);
+  if (existsSync(SETTINGS_PATH)) {
+    ok(`${DIM}${SETTINGS_PATH}${RESET} exists`);
+  } else {
+    fail(`${DIM}${SETTINGS_PATH}${RESET} not found`);
+    issues++;
+  }
+
+  const settings = readSettings();
+
+  const marketplaces = settings.extraKnownMarketplaces as Record<string, unknown> | undefined;
+  if (marketplaces?.["reservine-dx"]) {
+    ok("Marketplace registered in extraKnownMarketplaces");
+  } else {
+    fail("Marketplace NOT registered — run: bunx reservine-dx install");
+    issues++;
+  }
+
+  if (settings.enabledPlugins?.["reservine-dx@reservine-dx"]) {
+    ok("Plugin enabled in enabledPlugins");
+  } else {
+    fail("Plugin NOT enabled — run: bunx reservine-dx install");
+    issues++;
+  }
+
+  // Check 2: Marketplace clone
+  console.log(`\n  ${BOLD}Marketplace Clone${RESET}`);
+  if (existsSync(MARKETPLACE_DIR)) {
+    ok(`Cloned at ${DIM}${MARKETPLACE_DIR}${RESET}`);
+    const version = getMarketplaceVersion();
+    if (version) ok(`Version: ${version}`);
+
+    // Check key files
+    const keyFiles = [
+      "plugins/reservine-dx/skills/new-feature-planning/SKILL.md",
+      "plugins/reservine-dx/skills/cross-plan/SKILL.md",
+      "plugins/reservine-dx/skills/implement-plan/SKILL.md",
+      "plugins/reservine-dx/commands/cherry-pick-pr.md",
+      "plugins/reservine-dx/commands/commit.md",
+      "plugins/reservine-dx/scripts/setup-worktree.sh",
+    ];
+    let allPresent = true;
+    for (const f of keyFiles) {
+      if (!existsSync(join(MARKETPLACE_DIR, f))) {
+        fail(`Missing: ${f}`);
+        allPresent = false;
+        issues++;
+      }
+    }
+    if (allPresent) ok("All skill/command files present");
+  } else {
+    warn("Not yet cloned — Claude Code will clone on next startup");
+    info(`Expected at: ${DIM}${MARKETPLACE_DIR}${RESET}`);
+  }
+
+  // Check 3: Local plugins — detect project paths dynamically
+  console.log(`\n  ${BOLD}Local Plugins${RESET}`);
+
+  // Try to find Reservine repos by searching common locations
+  const searchDirs = [
+    process.cwd(), // current directory might be a repo
+    join(process.cwd(), ".."), // parent directory might contain both repos
+  ];
+
+  // Also check if CLI is running from within a Reservine repo
+  const cliParent = join(new URL(".", import.meta.url).pathname, "..", "..");
+
+  interface ProjectCheck { name: string; markers: string[]; pluginPath: string; }
+  const projects: ProjectCheck[] = [
+    { name: "Reservine (FE)", markers: ["angular.json", "nx.json"], pluginPath: ".claude/skills/implement-plan/plugin.md" },
+    { name: "ReservineBack (BE)", markers: ["artisan", "composer.json"], pluginPath: ".claude/skills/implement-plan/plugin.md" },
+  ];
+
+  for (const project of projects) {
+    let found = false;
+    // Search current dir and its siblings
+    for (const base of searchDirs) {
+      if (!existsSync(base)) continue;
+      try {
+        const entries = require("fs").readdirSync(base, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!entry.isDirectory()) continue;
+          const dir = join(base, entry.name);
+          const hasMarker = project.markers.some(m => existsSync(join(dir, m)));
+          if (hasMarker) {
+            const pluginPath = join(dir, project.pluginPath);
+            if (existsSync(pluginPath)) {
+              ok(`${project.name}: plugin.md found`);
+            } else {
+              warn(`${project.name}: plugin.md not found at ${DIM}${pluginPath}${RESET}`);
+              info("The implement-plan orchestrator needs this for stack-specific phases");
+            }
+            found = true;
+            break;
+          }
+        }
+      } catch { /* skip unreadable dirs */ }
+      if (found) break;
+    }
+    if (!found) {
+      info(`${project.name}: repo not found in current directory tree (run doctor from a Reservine repo)`);
+    }
+  }
+
+  // Check 4: Prerequisites
+  console.log(`\n  ${BOLD}Prerequisites${RESET}`);
+  try {
+    const v = execSync("claude --version 2>/dev/null", {
+      encoding: "utf-8",
+    }).trim();
+    ok(`Claude Code: ${DIM}${v}${RESET}`);
+  } catch {
+    warn("Claude Code CLI not found");
+  }
+
+  try {
+    execSync("gh auth status 2>/dev/null", { stdio: "pipe" });
+    ok("GitHub CLI: authenticated");
+  } catch {
+    warn("GitHub CLI: not authenticated");
+  }
+
+  try {
+    const v = execSync("bun --version 2>/dev/null", {
+      encoding: "utf-8",
+    }).trim();
+    ok(`Bun: ${DIM}${v}${RESET}`);
+  } catch {
+    warn("Bun not found");
+  }
+
+  // Check 5: Stale worktrees + orphaned Docker
+  console.log(`\n  ${BOLD}Worktree Health${RESET}`);
+  try {
+    // Find worktree Docker stacks
+    const dockerStacks = execSync(
+      'docker ps --filter "name=wt-" --format "{{.Names}}" 2>/dev/null',
+      { encoding: "utf-8" }
+    ).trim();
+    if (dockerStacks) {
+      const uniqueStacks = [...new Set(
+        dockerStacks.split("\n").map((n: string) => {
+          // wt-feat-my-feature-app → wt-feat-my-feature
+          const parts = n.split("-");
+          parts.pop(); // remove container suffix (app, db, redis, etc.)
+          return parts.join("-");
+        })
+      )];
+      if (uniqueStacks.length > 0) {
+        warn(`${uniqueStacks.length} isolated Docker stack(s) running:`);
+        uniqueStacks.forEach((s: string) => info(`  ${s}`));
+      }
+    } else {
+      ok("No orphaned Docker stacks");
+    }
+  } catch {
+    ok("No orphaned Docker stacks");
+  }
+
+  // Count worktrees across repos
+  let totalWorktrees = 0;
+  for (const project of projects) {
+    for (const base of searchDirs) {
+      if (!existsSync(base)) continue;
+      try {
+        const entries = require("fs").readdirSync(base, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!entry.isDirectory()) continue;
+          const dir = join(base, entry.name);
+          const hasMarker = project.markers.some(m => existsSync(join(dir, m)));
+          if (hasMarker) {
+            const wtDir = join(dir, ".worktrees");
+            if (existsSync(wtDir)) {
+              const wts = require("fs").readdirSync(wtDir, { withFileTypes: true })
+                .filter((e: any) => e.isDirectory());
+              totalWorktrees += wts.length;
+              if (wts.length > 0) {
+                info(`${project.name}: ${wts.length} worktree(s) in .worktrees/`);
+              }
+            }
+            break;
+          }
+        }
+      } catch { /* skip */ }
+    }
+  }
+  if (totalWorktrees === 0) {
+    ok("No active worktrees");
+  }
+
+  // Summary
+  console.log("");
+  if (issues === 0) {
+    console.log(
+      `  ${BG_GREEN}${WHITE}${BOLD} HEALTHY ${RESET} Everything looks good!\n`
+    );
+  } else {
+    console.log(
+      `  ${BG_YELLOW}${WHITE}${BOLD} ${issues} ISSUE${issues > 1 ? "S" : ""} ${RESET} Run ${CYAN}bunx reservine-dx install${RESET} to fix.\n`
+    );
+  }
+}
+
+function uninstall() {
+  console.log(LOGO);
+  console.log(`  ${BOLD}Uninstalling Reservine-DX...${RESET}\n`);
+
+  const settings = readSettings();
+
+  const marketplaces = settings.extraKnownMarketplaces as Record<string, unknown> | undefined;
+  if (marketplaces?.["reservine-dx"]) {
+    delete marketplaces["reservine-dx"];
+    ok("Removed from extraKnownMarketplaces");
+  }
+
+  if (settings.enabledPlugins?.["reservine-dx@reservine-dx"]) {
+    delete settings.enabledPlugins["reservine-dx@reservine-dx"];
+    ok("Removed from enabledPlugins");
+  }
+
+  writeSettings(settings);
+  ok(`Settings updated at ${DIM}${SETTINGS_PATH}${RESET}`);
+
+  console.log(`
+  ${BOLD}Uninstalled.${RESET}
+
+  ${DIM}Note: The marketplace clone at${RESET}
+  ${DIM}${MARKETPLACE_DIR}${RESET}
+  ${DIM}was not deleted. Remove it manually if desired.${RESET}
+
+  ${DIM}Local plugin.md files in each repo were not touched.${RESET}
+`);
+}
+
+function showHelp() {
+  console.log(LOGO);
+  console.log(`  ${BOLD}Usage:${RESET} bunx reservine-dx ${CYAN}<command>${RESET}
+
+  ${BOLD}Commands:${RESET}
+    ${CYAN}install${RESET}     Register marketplace in Claude Code settings
+    ${CYAN}update${RESET}      Pull latest skills from GitHub
+    ${CYAN}doctor${RESET}      Verify installation health
+    ${CYAN}uninstall${RESET}   Remove from Claude Code settings
+
+  ${BOLD}Examples:${RESET}
+    ${DIM}$${RESET} bunx reservine-dx install    ${DIM}# First-time setup${RESET}
+    ${DIM}$${RESET} bunx reservine-dx update     ${DIM}# Get latest skills${RESET}
+    ${DIM}$${RESET} bunx reservine-dx doctor     ${DIM}# Check everything works${RESET}
+`);
+}
+
+// ─── Main ──────────────────────────────────────────────────────────────────────
+
+const command = process.argv[2];
+
+switch (command) {
+  case "install":
+  case "i":
+    install();
+    break;
+  case "update":
+  case "up":
+    update();
+    break;
+  case "doctor":
+  case "doc":
+  case "check":
+    doctor();
+    break;
+  case "uninstall":
+  case "remove":
+  case "rm":
+    uninstall();
+    break;
+  case "--help":
+  case "-h":
+  case "help":
+  case undefined:
+    showHelp();
+    break;
+  default:
+    fail(`Unknown command: ${command}`);
+    showHelp();
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@reservine/dx",
+  "version": "1.0.0",
+  "description": "Shared developer experience skills for the Reservine ecosystem",
+  "type": "module",
+  "bin": {
+    "reservine-dx": "./bin/cli.ts"
+  },
+  "files": [
+    "bin/",
+    "plugins/",
+    ".claude-plugin/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Reservine/Reservine-DX.git"
+  },
+  "keywords": [
+    "reservine",
+    "claude-code",
+    "marketplace",
+    "developer-experience"
+  ],
+  "author": "Reservine",
+  "license": "MIT"
+}

package/plugins/reservine-dx/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "reservine-dx",
+  "version": "1.0.0",
+  "description": "Cross-repo developer experience skills for Reservine.",
+  "author": { "name": "Reservine" },
+  "commands": "./commands/",
+  "skills": "./skills/"
+}