@revturbine/cli 0.8.0 → 0.9.1

package/dist/cli.js

@@ -6716,6 +6716,48 @@ function validatePlaybook(config) {
   return { ok: blocking.length === 0, problems: blocking };
 }
 
+// src/lib/init-skills.ts
+var SKILLS_SOURCE = "revt-eng/revturbine-skills";
+var START_HERE_SKILL = "revturbine-start-here";
+function detectHarness(env) {
+  if (env["CLAUDECODE"] || env["CLAUDE_CODE_SESSION_ID"] || env["CLAUDE_CODE_ENTRYPOINT"]) {
+    return { label: "Claude Code", invocation: `Run the skill:  /${START_HERE_SKILL}` };
+  }
+  if (env["CURSOR_TRACE_ID"] || env["CURSOR"]) {
+    return { label: "Cursor", invocation: `Mention the skill:  @${START_HERE_SKILL}` };
+  }
+  return {
+    label: null,
+    invocation: `Ask your coding agent to run the "${START_HERE_SKILL}" skill.`
+  };
+}
+function skillsAddArgs(source = SKILLS_SOURCE) {
+  return ["--yes", "skills", "add", source, "-y", "--copy"];
+}
+function finalOutputLines(params) {
+  const lines = ["", "RevTurbine is set up.", ""];
+  if (params.installedSdkAndCli) {
+    lines.push(`  \u2713 Installed the SDK and pinned the CLI (${params.cliVersion}) to this repo`);
+  }
+  if (params.playbookAdded) {
+    lines.push("  \u2713 Added a starter playbook (local mode \u2014 no account needed)");
+  }
+  if (params.skills === "installed") {
+    lines.push("  \u2713 Installed the Agent Skills");
+  } else if (params.skills === "skipped") {
+    lines.push("  \u2022 Skipped the Agent Skills (--no-skills)");
+  } else {
+    lines.push("  \u26A0 Agent Skills not installed \u2014 see above to add them by hand");
+  }
+  lines.push("", "Next step:");
+  lines.push(`  ${params.harness.invocation}`);
+  if (params.harness.label) lines.push(`  (detected ${params.harness.label})`);
+  lines.push("", "Your setup path:");
+  lines.push("  create playbook \u2192 billing \u2192 app wiring \u2192 verify \u2192 launch");
+  lines.push("", "Docs: https://revturbine.com/docs", "");
+  return lines;
+}
+
 // src/lib/output.ts
 var EXIT = {
   OK: 0,
@@ -7080,7 +7122,7 @@ function renderShow(kind, config) {
 var pkgVersion = createRequire(import.meta.url)("../package.json").version ?? "0.0.0";
 var HELP_AFTER = `
 Command groups:
-  Set up        init
+  Set up        init (alias: create)
   Auth & meta   login, logout, signup, whoami, schema, docs
   Download      download
   Check         validate, diff, show
@@ -7143,7 +7185,7 @@ function runInstall(manager, args, cwd) {
     child.on("close", (code) => resolve(code ?? 1));
   });
 }
-program.command("init").description("Scaffold RevTurbine into this app: detect the stack, install the SDK, and pin the CLI to the repo.").option("-d, --dir <path>", "Target directory (defaults to the current directory)").option("--dry-run", "Report what would be installed without running the package manager").option("--json", "Emit the scaffold plan as JSON").action(async (opts) => {
+program.command("init").alias("create").description("Scaffold RevTurbine into this app: detect the stack, install the SDK, pin the CLI, drop a starter Playbook, and install the Agent Skills.").option("-d, --dir <path>", "Target directory (defaults to the current directory)").option("--dry-run", "Report what would be installed without running the package manager").option("--no-skills", "Do not install the RevTurbine Agent Skills").option("--json", "Emit the scaffold plan as JSON").action(async (opts) => {
   const dir = path2.resolve(opts.dir ?? process.cwd());
   const manifestPath = path2.join(dir, "package.json");
   if (!existsSync2(manifestPath)) {
@@ -7172,6 +7214,7 @@ program.command("init").description("Scaffold RevTurbine into this app: detect t
   const playbookPath = path2.join(dir, STARTER_PLAYBOOK_FILENAME);
   const playbookExists = existsSync2(playbookPath);
   if (playbookExists) diag(`\u2022 ${STARTER_PLAYBOOK_FILENAME} already present \u2014 left as-is`);
+  const installSkills = opts.skills !== false;
   if (opts.json) {
     emit(
       {
@@ -7180,7 +7223,8 @@ program.command("init").description("Scaffold RevTurbine into this app: detect t
         stack,
         install: plan.install,
         skipped: plan.skipped,
-        playbook: playbookExists ? "present" : STARTER_PLAYBOOK_FILENAME
+        playbook: playbookExists ? "present" : STARTER_PLAYBOOK_FILENAME,
+        skills: installSkills ? SKILLS_SOURCE : "skipped"
       },
       true
     );
@@ -7190,6 +7234,7 @@ program.command("init").description("Scaffold RevTurbine into this app: detect t
       diag(`would run: ${manager.name} ${installArgs(manager.name, step).join(" ")}`);
     }
     if (!playbookExists) diag(`would write: ${STARTER_PLAYBOOK_FILENAME}`);
+    if (installSkills) diag(`would run: npx ${skillsAddArgs().join(" ")}`);
     if (plan.install.length === 0 && playbookExists) diag("\u2713 Already set up \u2014 nothing to do.");
     return;
   }
@@ -7207,7 +7252,8 @@ program.command("init").description("Scaffold RevTurbine into this app: detect t
   if (plan.install.length > 0) {
     diag(`\u2713 Installed the RevTurbine SDK and CLI (CLI pinned to ${pkgVersion})`);
   }
-  if (!playbookExists) {
+  const playbookAdded = !playbookExists;
+  if (playbookAdded) {
     const check = validatePlaybook(STARTER_PLAYBOOK);
     if (!check.ok) {
       fail(
@@ -7219,7 +7265,38 @@ program.command("init").description("Scaffold RevTurbine into this app: detect t
 `, "utf8");
     diag(`\u2713 Added a starter playbook (${STARTER_PLAYBOOK_FILENAME} \u2014 local mode, no account needed)`);
   }
-  if (plan.install.length === 0 && playbookExists) diag("\u2713 Already set up \u2014 nothing to do.");
+  let skillsOutcome = installSkills ? "installed" : "skipped";
+  if (installSkills) {
+    diag("Installing the RevTurbine Agent Skills (npx skills)\u2026");
+    const args = skillsAddArgs();
+    let code;
+    try {
+      code = await runInstall("npx", args, dir);
+    } catch {
+      code = 1;
+    }
+    if (code === 0) {
+      diag("\u2713 Installed the RevTurbine Agent Skills (some write app code \u2014 review before running them)");
+    } else {
+      skillsOutcome = "failed";
+      diag("\u26A0 Could not install the Agent Skills automatically. Add them by hand:");
+      diag(`    npx ${args.join(" ")}`);
+    }
+  } else {
+    diag("\u2022 Skipping the Agent Skills (--no-skills)");
+  }
+  if (!opts.json) {
+    const lines = finalOutputLines({
+      managerLabel: manager.name,
+      installedSdkAndCli: plan.install.length > 0,
+      cliVersion: pkgVersion,
+      playbookAdded,
+      skills: skillsOutcome,
+      harness: detectHarness(process.env)
+    });
+    process.stdout.write(`${lines.join("\n")}
+`);
+  }
 });
 program.command("login").description("Authorize this machine via the browser (device flow) and store a token for the instance (default: the production instance).").argument("[url]", `RevTurbine instance URL (default: ${DEFAULT_URL})`).action(async (url) => {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revturbine/cli",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "revturbine — verify RevTurbine ExportedConfig files and ship them to a RevTurbine instance through the Change Set lifecycle.",
   "license": "MIT",
   "repository": {