@moglenny/content-workbench-agent 0.1.0

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@moglenny/content-workbench-agent",
+  "version": "0.1.0",
+  "description": "Agent installer for Content Workbench CLI, Skills, and MCP configuration",
+  "type": "module",
+  "bin": {
+    "content-workbench-agent": "src/bin.mjs"
+  },
+  "files": [
+    "src/bin.mjs"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/bin.mjs

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { realpathSync } from "node:fs";
+import { mkdir, stat } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const scriptPath = fileURLToPath(import.meta.url);
+const defaultRepoUrl = "https://github.com/Himog0921/topic-dashboard.git";
+const defaultBranch = "main";
+
+function expandHome(filePath) {
+  if (filePath === "~") return os.homedir();
+  if (filePath.startsWith("~/")) return path.join(os.homedir(), filePath.slice(2));
+  return filePath;
+}
+
+function defaultRepoDir() {
+  return path.join(os.homedir(), ".content-workbench", "agent", "topic-dashboard");
+}
+
+function usage() {
+  return `Usage:
+  npx @moglenny/content-workbench-agent@latest install
+
+Options:
+  --dry-run                    Print the install plan without writing files.
+  --repo-url <url>             Git repository URL. Defaults to the official content workbench repo.
+  --branch <name>              Branch to install from. Defaults to main.
+  --repo-dir <path>            Local managed clone path. Defaults to ~/.content-workbench/agent/topic-dashboard.
+  --skills-target <path>       Skill install target. Repeatable.
+  --mcp-target <path>          Write MCP config snippet to this JSON file.
+  --skip-cli                   Do not install the global cw CLI.
+  --skip-skills                Do not copy Skills.
+  --skip-mcp                   Do not write MCP config.
+  --api-base-url <url>         Base URL shown in post-install setup guidance.
+  --help                       Show this help.
+`;
+}
+
+export function parseAgentInstallerArgs(argv = process.argv.slice(2)) {
+  const options = {
+    command: "install",
+    dryRun: false,
+    repoUrl: defaultRepoUrl,
+    branch: defaultBranch,
+    repoDir: defaultRepoDir(),
+    installArgs: ["--yes"],
+    help: false,
+  };
+
+  const args = [...argv];
+  if (args[0] && !args[0].startsWith("-")) {
+    options.command = args.shift();
+  }
+
+  if (options.command !== "install" && options.command !== "help") {
+    throw new Error(`Unknown command: ${options.command}`);
+  }
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--help" || arg === "-h") {
+      options.help = true;
+      continue;
+    }
+    if (arg === "--dry-run") {
+      options.dryRun = true;
+      continue;
+    }
+    if (arg === "--repo-url") {
+      options.repoUrl = args[++index] || options.repoUrl;
+      continue;
+    }
+    if (arg === "--branch") {
+      options.branch = args[++index] || options.branch;
+      continue;
+    }
+    if (arg === "--repo-dir") {
+      options.repoDir = path.resolve(expandHome(args[++index] || ""));
+      continue;
+    }
+    if (arg === "--skills-target" || arg === "--mcp-target" || arg === "--api-base-url") {
+      const value = args[++index];
+      if (!value) throw new Error(`Missing value for ${arg}`);
+      options.installArgs.push(arg, value);
+      continue;
+    }
+    if (arg === "--skip-cli" || arg === "--skip-skills" || arg === "--skip-mcp") {
+      options.installArgs.push(arg);
+      continue;
+    }
+    throw new Error(`Unknown option: ${arg}`);
+  }
+
+  return options;
+}
+
+export function buildInstallPlan(options, repoExists) {
+  const bootstrapSteps = repoExists
+    ? [
+        { command: "git", args: ["-C", options.repoDir, "fetch", "--depth", "1", "origin", options.branch] },
+        { command: "git", args: ["-C", options.repoDir, "checkout", options.branch] },
+        { command: "git", args: ["-C", options.repoDir, "pull", "--ff-only", "origin", options.branch] },
+      ]
+    : [
+        {
+          command: "git",
+          args: ["clone", "--depth", "1", "--branch", options.branch, options.repoUrl, options.repoDir],
+        },
+      ];
+
+  return {
+    repoDir: options.repoDir,
+    dryRun: options.dryRun,
+    steps: [
+      ...bootstrapSteps,
+      {
+        command: "node",
+        args: [
+          path.join(options.repoDir, "scripts", "install-cw-agent.mjs"),
+          "--repo-root",
+          options.repoDir,
+          ...options.installArgs,
+        ],
+      },
+    ],
+  };
+}
+
+async function exists(filePath) {
+  try {
+    await stat(filePath);
+    return true;
+  } catch (error) {
+    if (error?.code === "ENOENT") return false;
+    throw error;
+  }
+}
+
+async function run(command, args) {
+  await new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: "inherit",
+      env: process.env,
+    });
+    child.on("error", reject);
+    child.on("exit", (code, signal) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new Error(`${command} ${args.join(" ")} failed${signal ? ` with signal ${signal}` : ` with exit ${code}`}`));
+    });
+  });
+}
+
+function printPlan(plan, stdout) {
+  stdout.write(`${plan.dryRun ? "Content Workbench Agent install dry run" : "Content Workbench Agent install"}\n`);
+  stdout.write(`Managed repository: ${plan.repoDir}\n`);
+  for (const step of plan.steps) {
+    stdout.write(`- ${step.command} ${step.args.join(" ")}\n`);
+  }
+  if (plan.dryRun) {
+    stdout.write("\nRun without --dry-run to install.\n");
+  }
+}
+
+export async function runAgentInstaller(argv = process.argv.slice(2), io = process) {
+  const options = parseAgentInstallerArgs(argv);
+  if (options.help || options.command === "help") {
+    io.stdout.write(usage());
+    return { help: true };
+  }
+
+  await mkdir(path.dirname(options.repoDir), { recursive: true });
+  const repoExists = await (io.exists || exists)(path.join(options.repoDir, ".git"));
+  const plan = buildInstallPlan(options, repoExists);
+  printPlan(plan, io.stdout);
+
+  if (options.dryRun) return plan;
+
+  const runner = io.run || run;
+  for (const step of plan.steps) {
+    await runner(step.command, step.args);
+  }
+
+  io.stdout.write("Content Workbench Agent install complete\n");
+  return plan;
+}
+
+function isDirectInvocation() {
+  try {
+    return realpathSync(process.argv[1]) === realpathSync(scriptPath);
+  } catch {
+    return process.argv[1] === scriptPath;
+  }
+}
+
+if (isDirectInvocation()) {
+  runAgentInstaller().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+  });
+}