@design-ai/cli 4.55.0

package/cli/commands/status.mjs

@@ -0,0 +1,161 @@
+// `design-ai status` — show installed symlinks.
+
+import { readdirSync, readlinkSync, statSync } from "node:fs";
+import path from "node:path";
+
+import { hasHelpFlag } from "../lib/help-flags.mjs";
+import { header, info, success, warn, dim } from "../lib/log.mjs";
+import {
+  DESIGN_AI_HOME,
+  CLAUDE_HOME,
+  SYMLINK_PREFIX,
+  SKILLS_DST,
+  AGENTS_DST,
+  COMMANDS_DST,
+  pathExists,
+  isDirectory,
+} from "../lib/paths.mjs";
+import { unknownOptionMessage } from "../lib/suggest.mjs";
+
+const STATUS_OPTIONS = ["-h", "--help", "--json"];
+const STATUS_USAGE = "Usage: design-ai status [--json]";
+
+export const STATUS_TARGETS = [
+  { kind: "skills", label: "Skills", dir: SKILLS_DST },
+  { kind: "agents", label: "Agents", dir: AGENTS_DST },
+  { kind: "commands", label: "Slash commands", dir: COMMANDS_DST },
+];
+
+export function parseStatusArgs(args) {
+  const flags = {
+    help: false,
+    json: false,
+  };
+
+  for (const arg of args) {
+    if (arg === "-h" || arg === "--help") {
+      flags.help = true;
+      continue;
+    }
+    if (arg === "--json") {
+      flags.json = true;
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      throw new Error(`${unknownOptionMessage("status", arg, STATUS_OPTIONS)}\n${STATUS_USAGE}`);
+    }
+    throw new Error(STATUS_USAGE);
+  }
+
+  return flags;
+}
+
+export function listLinkedFromSource(dir, sourceRoot = DESIGN_AI_HOME) {
+  if (!pathExists(dir)) return null;
+  const entries = readdirSync(dir);
+  const ours = [];
+  for (const name of entries) {
+    const full = path.join(dir, name);
+    let st;
+    try {
+      st = statSync(full, { throwIfNoEntry: false });
+    } catch {
+      continue;
+    }
+    if (!st) continue;
+    try {
+      const link = readlinkSync(full);
+      const resolved = path.resolve(dir, link);
+      if (resolved.startsWith(sourceRoot)) ours.push(name);
+    } catch {
+      // not a symlink; skip
+    }
+  }
+  return ours.sort((a, b) => a.localeCompare(b));
+}
+
+export function collectStatusReport({
+  sourceRoot = DESIGN_AI_HOME,
+  claudeHome = CLAUDE_HOME,
+  prefix = SYMLINK_PREFIX,
+  targets = STATUS_TARGETS,
+} = {}) {
+  const sections = targets.map((target) => {
+    const targetExists = isDirectory(target.dir);
+    const entries = targetExists ? listLinkedFromSource(target.dir, sourceRoot) || [] : [];
+    return {
+      kind: target.kind,
+      label: target.label,
+      targetDir: target.dir,
+      targetExists,
+      installed: entries.length,
+      entries,
+    };
+  });
+
+  return {
+    context: {
+      sourceRoot,
+      claudeHome,
+      prefix,
+    },
+    sections,
+    summary: {
+      installed: sections.reduce((total, section) => total + section.installed, 0),
+      missingSections: sections.filter((section) => !section.targetExists).length,
+      emptySections: sections.filter((section) => section.targetExists && section.installed === 0).length,
+    },
+  };
+}
+
+export function formatStatusJson(report) {
+  return JSON.stringify(report, null, 2);
+}
+
+function printHelp() {
+  console.log("Usage:  design-ai status [--json]\n");
+  console.log("Shows design-ai symlinks currently installed in Claude Code.");
+  console.log("Set VERBOSE=1 to print each installed skill, command, and agent name.\n");
+  console.log("Options:");
+  console.log("  --json                         Emit machine-readable install status");
+  console.log("\nEnvironment:");
+  console.log("  CLAUDE_HOME=/path/to/.claude    Target Claude Code home directory");
+  console.log("  DESIGN_AI_HOME=/path/to/source  Source repository or package root");
+  console.log("  DESIGN_AI_PREFIX=mydesign-     Prefix for installed skill and command names");
+  console.log("  VERBOSE=1                       Print full installed item lists");
+}
+
+export async function runStatus(args) {
+  if (hasHelpFlag(args)) {
+    printHelp();
+    return;
+  }
+
+  const parsed = parseStatusArgs(args);
+  const report = collectStatusReport();
+  if (parsed.json) {
+    console.log(formatStatusJson(report));
+    return;
+  }
+
+  header("design-ai status");
+  info(`Source: ${report.context.sourceRoot}`);
+  info(`Target: ${report.context.claudeHome}`);
+  info(`Prefix: ${report.context.prefix}`);
+  console.log();
+
+  for (const section of report.sections) {
+    if (!section.targetExists) {
+      warn(`${section.label}: target dir does not exist (${section.targetDir})`);
+      continue;
+    }
+    if (section.installed === 0) {
+      warn(`${section.label}: 0 installed`);
+    } else {
+      success(`${section.label}: ${section.installed} installed`);
+      if (process.env.VERBOSE) {
+        for (const n of section.entries) console.log(`   ${dim("•")} ${n}`);
+      }
+    }
+  }
+}

package/cli/commands/uninstall.mjs

@@ -0,0 +1,119 @@
+// `design-ai uninstall` — remove symlinks.
+
+import { run } from "../lib/exec.mjs";
+import { header, info, success } from "../lib/log.mjs";
+import { hasHelpFlag } from "../lib/help-flags.mjs";
+import { unknownOptionMessage } from "../lib/suggest.mjs";
+import {
+  DESIGN_AI_HOME,
+  CLAUDE_HOME,
+  SYMLINK_PREFIX,
+  INSTALL_SCRIPT,
+  pathExists,
+} from "../lib/paths.mjs";
+
+const UNINSTALL_OPTIONS = ["-h", "--help", "--json"];
+const UNINSTALL_USAGE = "Usage: design-ai uninstall [--json]";
+const REMOVED_COUNT_RE = /\bRemoved\s+(\d+)\s+design-ai symlinks\b/;
+
+export function parseUninstallArgs(args) {
+  const flags = {
+    help: false,
+    json: false,
+  };
+
+  for (const arg of args) {
+    if (arg === "-h" || arg === "--help") {
+      flags.help = true;
+      continue;
+    }
+    if (arg === "--json") {
+      flags.json = true;
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      throw new Error(`${unknownOptionMessage("uninstall", arg, UNINSTALL_OPTIONS)}\n${UNINSTALL_USAGE}`);
+    }
+    throw new Error(UNINSTALL_USAGE);
+  }
+
+  return flags;
+}
+
+export function parseRemovedCount(raw) {
+  const match = REMOVED_COUNT_RE.exec(String(raw || ""));
+  if (!match) {
+    throw new Error("Unable to parse uninstall output: missing removed symlink count");
+  }
+  return Number(match[1]);
+}
+
+export function buildUninstallReport({
+  sourceRoot = DESIGN_AI_HOME,
+  claudeHome = CLAUDE_HOME,
+  prefix = SYMLINK_PREFIX,
+  removed = 0,
+} = {}) {
+  return {
+    context: {
+      sourceRoot,
+      claudeHome,
+      prefix,
+    },
+    result: {
+      removed,
+    },
+  };
+}
+
+export function formatUninstallJson(report) {
+  return JSON.stringify(report, null, 2);
+}
+
+function printHelp() {
+  console.log("Usage:  design-ai uninstall [--json]\n");
+  console.log("Removes design-ai symlinks from Claude Code while keeping the source files.");
+  console.log("Uses CLAUDE_HOME and DESIGN_AI_PREFIX to find the installed links.\n");
+  console.log("Options:");
+  console.log("  --json                         Emit machine-readable uninstall result\n");
+  console.log("Environment:");
+  console.log("  CLAUDE_HOME=/path/to/.claude    Target Claude Code home directory");
+  console.log("  DESIGN_AI_PREFIX=mydesign-     Prefix for installed skill and command names");
+}
+
+export async function runUninstall(args) {
+  if (hasHelpFlag(args)) {
+    printHelp();
+    return;
+  }
+
+  const parsed = parseUninstallArgs(args);
+
+  if (!pathExists(INSTALL_SCRIPT)) {
+    throw new Error(`install.sh not found at ${INSTALL_SCRIPT}`);
+  }
+
+  if (!parsed.json) {
+    header("design-ai uninstaller");
+  }
+
+  const result = await run("bash", [INSTALL_SCRIPT, "--uninstall"], {
+    cwd: DESIGN_AI_HOME,
+    silent: parsed.json,
+    env: {
+      DESIGN_AI_PREFIX: SYMLINK_PREFIX,
+      CLAUDE_HOME,
+    },
+  });
+
+  if (parsed.json) {
+    console.log(formatUninstallJson(buildUninstallReport({
+      removed: parseRemovedCount(result.stdout),
+    })));
+    return;
+  }
+
+  console.log();
+  success("Done. To remove the design-ai source, delete its directory manually.");
+  info(`Source location: ${DESIGN_AI_HOME}`);
+}

package/cli/commands/update.mjs

@@ -0,0 +1,184 @@
+// `design-ai update` — re-fetch upstream + reinstall.
+
+import { run, runSync } from "../lib/exec.mjs";
+import { header, info, success, warn } from "../lib/log.mjs";
+import { hasHelpFlag } from "../lib/help-flags.mjs";
+import { unknownOptionMessage } from "../lib/suggest.mjs";
+import {
+  DESIGN_AI_HOME,
+  CLAUDE_HOME,
+  SYMLINK_PREFIX,
+  INSTALL_SCRIPT,
+  pathExists,
+} from "../lib/paths.mjs";
+import path from "node:path";
+
+const UPDATE_OPTIONS = ["-h", "--help", "--dry-run", "--json"];
+const UPDATE_USAGE = "Usage: design-ai update [--dry-run] [--json]";
+
+export function parseUpdateArgs(args) {
+  const flags = {
+    help: false,
+    dryRun: false,
+    json: false,
+  };
+
+  for (const arg of args) {
+    if (arg === "-h" || arg === "--help") {
+      flags.help = true;
+      continue;
+    }
+    if (arg === "--dry-run") {
+      flags.dryRun = true;
+      continue;
+    }
+    if (arg === "--json") {
+      flags.json = true;
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      throw new Error(`${unknownOptionMessage("update", arg, UPDATE_OPTIONS)}\n${UPDATE_USAGE}`);
+    }
+    throw new Error(UPDATE_USAGE);
+  }
+
+  if (flags.json && !flags.dryRun) {
+    throw new Error("--json is only supported with --dry-run.\nUsage: design-ai update --dry-run [--json]");
+  }
+
+  return flags;
+}
+
+export function buildUpdateDryRunReport({
+  sourceRoot = DESIGN_AI_HOME,
+  claudeHome = CLAUDE_HOME,
+  prefix = SYMLINK_PREFIX,
+  installScript = INSTALL_SCRIPT,
+} = {}) {
+  const sourceIsGitClone = pathExists(path.join(sourceRoot, ".git"));
+  const installScriptExists = pathExists(installScript);
+
+  return {
+    context: {
+      sourceRoot,
+      claudeHome,
+      prefix,
+    },
+    plan: {
+      gitPull: {
+        sourceIsGitClone,
+        wouldRun: sourceIsGitClone,
+        command: sourceIsGitClone ? ["git", "pull", "--ff-only"] : [],
+        reason: sourceIsGitClone ? "source is a git clone" : "source is not a git clone",
+      },
+      install: {
+        installScriptExists,
+        wouldRun: installScriptExists,
+        installScript,
+        command: installScriptExists ? ["bash", installScript, "install"] : [],
+        reason: installScriptExists ? "install.sh is available" : "install.sh is missing",
+      },
+    },
+    result: {
+      dryRun: true,
+      mutating: false,
+      ready: installScriptExists,
+    },
+  };
+}
+
+export function formatUpdateDryRunJson(report) {
+  return JSON.stringify(report, null, 2);
+}
+
+function printHelp() {
+  console.log("Usage:  design-ai update [--dry-run] [--json]\n");
+  console.log("Pulls the latest git source when DESIGN_AI_HOME is a clone, then re-runs install.sh.");
+  console.log("For npm installs, update the package with npm and then run install again.\n");
+  console.log("Options:");
+  console.log("  --dry-run                      Preview git/install actions without changing files");
+  console.log("  --json                         Emit machine-readable dry-run plan; requires --dry-run\n");
+  console.log("Environment:");
+  console.log("  DESIGN_AI_HOME=/path/to/source  Source repository or package root");
+  console.log("  CLAUDE_HOME=/path/to/.claude    Target Claude Code home directory");
+  console.log("  DESIGN_AI_PREFIX=mydesign-     Prefix for installed skill and command names");
+}
+
+function printDryRun(report) {
+  header("design-ai update dry run");
+  info(`Source: ${report.context.sourceRoot}`);
+  info(`Target: ${report.context.claudeHome}`);
+  info(`Prefix: ${report.context.prefix}`);
+  console.log();
+
+  if (report.plan.gitPull.wouldRun) {
+    info(`Git: would run ${report.plan.gitPull.command.join(" ")}`);
+  } else {
+    warn(`Git: skipped; ${report.plan.gitPull.reason}.`);
+  }
+
+  if (report.plan.install.wouldRun) {
+    info(`Install: would run ${report.plan.install.command.join(" ")}`);
+  } else {
+    warn(`Install: skipped; ${report.plan.install.reason}.`);
+  }
+
+  console.log();
+  success("Dry run complete. No files changed.");
+}
+
+export async function runUpdate(args) {
+  if (hasHelpFlag(args)) {
+    printHelp();
+    return;
+  }
+
+  const parsed = parseUpdateArgs(args);
+
+  if (parsed.dryRun) {
+    const report = buildUpdateDryRunReport();
+    if (parsed.json) {
+      console.log(formatUpdateDryRunJson(report));
+      return;
+    }
+    printDryRun(report);
+    return;
+  }
+
+  header("design-ai update");
+  info(`Source: ${DESIGN_AI_HOME}`);
+
+  const gitDir = path.join(DESIGN_AI_HOME, ".git");
+  const isGitClone = pathExists(gitDir);
+
+  if (isGitClone) {
+    info("Pulling latest from git...");
+    try {
+      const out = runSync("git", ["pull", "--ff-only"], { cwd: DESIGN_AI_HOME });
+      console.log(out.trim());
+    } catch (err) {
+      warn("git pull failed; continuing with current source.");
+      if (process.env.DEBUG) console.error(err.stderr || err.message);
+    }
+  } else {
+    warn("Not a git clone; can't auto-update the source.");
+    info("If installed via npm, run: npm install -g @design-ai/cli@latest");
+    info("If installed manually, re-clone or pull yourself.");
+  }
+
+  if (!pathExists(INSTALL_SCRIPT)) {
+    throw new Error(`install.sh not found at ${INSTALL_SCRIPT}`);
+  }
+
+  info("Re-running install.sh...");
+  await run("bash", [INSTALL_SCRIPT, "install"], {
+    cwd: DESIGN_AI_HOME,
+    env: {
+      DESIGN_AI_PREFIX: SYMLINK_PREFIX,
+      CLAUDE_HOME,
+    },
+  });
+
+  console.log();
+  success("Update complete. Restart Claude Code to pick up changes.");
+}

package/cli/commands/version.mjs

@@ -0,0 +1,94 @@
+// `design-ai version` — show CLI + plugin versions.
+
+import { readFileSync } from "node:fs";
+import path from "node:path";
+
+import { hasHelpFlag } from "../lib/help-flags.mjs";
+import { info, dim } from "../lib/log.mjs";
+import { DESIGN_AI_HOME, pathExists } from "../lib/paths.mjs";
+import { unknownOptionMessage } from "../lib/suggest.mjs";
+
+const VERSION_OPTIONS = ["-h", "--help", "--json"];
+const VERSION_USAGE = "Usage: design-ai version [--json]";
+
+export function parseVersionArgs(args) {
+  const flags = {
+    help: false,
+    json: false,
+  };
+
+  for (const arg of args) {
+    if (arg === "-h" || arg === "--help") {
+      flags.help = true;
+      continue;
+    }
+    if (arg === "--json") {
+      flags.json = true;
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      throw new Error(`${unknownOptionMessage("version", arg, VERSION_OPTIONS)}\n${VERSION_USAGE}`);
+    }
+    throw new Error(VERSION_USAGE);
+  }
+
+  return flags;
+}
+
+function readVersion(filePath) {
+  if (!pathExists(filePath)) return "unknown";
+  try {
+    const data = JSON.parse(readFileSync(filePath, "utf8"));
+    return typeof data.version === "string" && data.version ? data.version : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+export function collectVersionReport({
+  sourceRoot = DESIGN_AI_HOME,
+  packagePath = path.join(sourceRoot, "package.json"),
+  pluginManifest = path.join(sourceRoot, ".claude-plugin", "plugin.json"),
+} = {}) {
+  const cliVersion = readVersion(packagePath);
+  const pluginVersion = readVersion(pluginManifest);
+  return {
+    context: {
+      sourceRoot,
+    },
+    versions: {
+      cli: cliVersion,
+      plugin: pluginVersion,
+      aligned: cliVersion !== "unknown" && cliVersion === pluginVersion,
+    },
+  };
+}
+
+export function formatVersionJson(report) {
+  return JSON.stringify(report, null, 2);
+}
+
+function printHelp() {
+  console.log("Usage:  design-ai version [--json]\n");
+  console.log("Prints the CLI package version, plugin/corpus version, and source root.");
+  console.log("\nOptions:");
+  console.log("  --json   Emit machine-readable version metadata");
+}
+
+export async function runVersion(args) {
+  if (hasHelpFlag(args)) {
+    printHelp();
+    return;
+  }
+
+  const parsed = parseVersionArgs(args);
+  const report = collectVersionReport();
+  if (parsed.json) {
+    console.log(formatVersionJson(report));
+    return;
+  }
+
+  info(`design-ai CLI:    ${report.versions.cli}`);
+  info(`Plugin / corpus:  ${report.versions.plugin}`);
+  info(dim(`Source:           ${report.context.sourceRoot}`));
+}