@cursor/bdk 0.2.3 → 0.2.4

package/src/internal/cli-skills.ts

@@ -1,98 +0,0 @@
-/**
- * `install-skills` — install the package's coding-agent skills into
- * `~/.cursor/skills/bdk/` without running `init`.
- *
- * Never prompts: running the command is the confirmation. The interactive
- * offer lives in `init`. Consumer `npm install` / `npx` copies the same
- * skills in postinstall (with `alwaysApply: true` so Cursor injects them);
- * this command refreshes them without reinstalling.
- */
-
-import { CLI_COMMAND_NAME } from "./distribution.js";
-import {
-  formatSkillInstall,
-  installCursorSkills,
-  planSkillInstall,
-  type SkillInstallPlan,
-} from "./install-cursor-skills.js";
-import { stdoutPalette } from "./terminal-style.js";
-
-export interface InstallSkillsCliOptions {
-  json?: boolean;
-  /** Preview the skills, the removals, and the install address; write nothing. */
-  print?: boolean;
-  /** Injected seams for tests. */
-  packageRoot?: string;
-  skillsHome?: string;
-  out?: (text: string) => void;
-  err?: (text: string) => void;
-}
-
-export async function cmdInstallSkills(options: InstallSkillsCliOptions = {}): Promise<number> {
-  const out = options.out ?? (text => process.stdout.write(text));
-  const err = options.err ?? (text => process.stderr.write(text));
-  const plan = await planSkillInstall({
-    packageRoot: options.packageRoot,
-    skillsHome: options.skillsHome,
-  });
-
-  if (plan.shipped.length === 0) {
-    err(`${CLI_COMMAND_NAME} ships no skills to install.\n`);
-    return 1;
-  }
-
-  const emit = (run: { dryRun: boolean; removed: string[] }): void => {
-    const payload: SkillInstallPayload = {
-      ok: true,
-      dryRun: run.dryRun,
-      directory: plan.directory,
-      firstInstall: plan.firstInstall,
-      skills: plan.leaves,
-      removed: run.removed,
-    };
-    out(`${JSON.stringify(payload, null, 2)}\n`);
-  };
-
-  const noun = plan.shipped.length === 1 ? "skill" : "skills";
-  if (options.print === true) {
-    if (options.json === true) {
-      emit({ dryRun: true, removed: plan.orphans });
-      return 0;
-    }
-    const action = plan.firstInstall ? "install" : "update";
-    out(`Would ${action} ${plan.leaves.length} BDK ${noun}\n`);
-    out(previewBlock(plan));
-    return 0;
-  }
-
-  const result = await installCursorSkills(plan.shipped, plan.skillsHome);
-  if (options.json === true) {
-    emit({ dryRun: false, removed: result.removed });
-    return 0;
-  }
-  out(formatSkillInstall(plan, result));
-  return 0;
-}
-
-interface SkillInstallPayload {
-  ok: true;
-  /** True when `--print` previewed the install instead of running it. */
-  dryRun: boolean;
-  directory: string;
-  firstInstall: boolean;
-  skills: string[];
-  removed: string[];
-}
-
-function previewBlock(plan: SkillInstallPlan): string {
-  const c = stdoutPalette();
-  const lines = [c.dim(`  skills:   ${plan.leaves.join(", ")}`)];
-  if (plan.orphans.length > 0) {
-    lines.push(`  removes:  ${plan.orphans.join(", ")}`);
-  }
-  for (const dir of plan.legacyDirs) {
-    lines.push(`  removes:  ${dir}`);
-  }
-  lines.push(`  location: ${plan.directory}`);
-  return `${lines.join("\n")}\n`;
-}

package/src/internal/cli-slack-manual.ts

@@ -1,418 +0,0 @@
-/**
- * `slack init --manual` and `slack manifest` — unmanaged Slack app.
- * Slack CLI create+install when `~/.slack/bin/slack` is present;
- * paste-at-api.slack.com is the fallback. Create/destroy/icon stay
- * in `cli-slack.ts`.
- */
-
-import { execFile } from "node:child_process";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { basename, join, resolve as resolvePath } from "node:path";
-import { promisify } from "node:util";
-import {
-  detectSlackCli,
-  parseSlackAuthTeams,
-  readSlackCliAppId,
-  SLACK_CLI_HOME_BIN,
-  type SlackCliEnvironment,
-} from "../channels/slack/cli-project.js";
-import {
-  buildSlackManifestPair,
-  initSlackManual,
-  slackManifestFileEntries,
-} from "../channels/slack/index.js";
-import { describeError } from "./describe-error.js";
-import { CLI_COMMAND_NAME as CLI } from "./distribution.js";
-import { ensureEnvLocalGitignored, upsertEnvFile } from "./env-file.js";
-
-const execFileAsync = promisify(execFile);
-
-export interface SlackManualCliOptions {
-  dir: string;
-  name?: string;
-  env?: "dev" | "prod" | "both";
-  print?: boolean;
-  prefix?: string;
-  noPrefix?: boolean;
-  channelPosts?: boolean;
-  /** Gate for `slack init`; ignored by `slack manifest`. */
-  manual?: boolean;
-  /** Require Slack CLI install (fail if missing or install fails). */
-  install?: boolean;
-  /** Skip Slack CLI install even when the CLI is present. */
-  noInstall?: boolean;
-  slackTeam?: string;
-  prod?: boolean;
-  detectSlackCli?: () => string | undefined;
-  runSlackCli?: SlackCliExec;
-  out?: (text: string) => void;
-  err?: (text: string) => void;
-}
-
-export interface SlackCliExecRequest {
-  bin: string;
-  argv: string[];
-  cwd: string;
-  env?: NodeJS.ProcessEnv;
-}
-
-export interface SlackCliExecResult {
-  code: number;
-  stdout: string;
-  stderr: string;
-}
-
-export type SlackCliExec = (request: SlackCliExecRequest) => Promise<SlackCliExecResult>;
-
-interface SlackCliInstallResult {
-  ok: boolean;
-  environment: SlackCliEnvironment;
-  team?: string;
-  appId?: string;
-  error?: string;
-  tokens: { bot: boolean; app: boolean };
-}
-
-interface SlackCliInstallOptions {
-  dir: string;
-  bin: string;
-  envKeys: { bot: string; app: string };
-  environment: SlackCliEnvironment;
-  team?: string;
-  exec?: SlackCliExec;
-}
-
-function errStream(options: SlackManualCliOptions): (text: string) => void {
-  return options.err ?? ((text: string) => void process.stderr.write(text));
-}
-
-function afterDoctor(prefix?: string): string[] {
-  return [
-    prefix === undefined ? `${CLI} slack doctor` : `${CLI} slack doctor --prefix ${prefix}`,
-    `${CLI} serve --dir . --dev`,
-    `${CLI} slack setup`,
-  ];
-}
-
-function slackCliEnvironment(prod?: boolean): SlackCliEnvironment {
-  return prod === true ? "deployed" : "local";
-}
-
-function slackAppSettingsUrl(appId?: string): string {
-  return appId === undefined ? "https://api.slack.com/apps" : `https://api.slack.com/apps/${appId}`;
-}
-
-function pasteNext(
-  envKeys: { bot: string; app: string },
-  options: { environment: SlackCliEnvironment; prefix?: string },
-): string[] {
-  return [
-    "Ask the user to install this Slack app on their workspace",
-    `Open ${slackAppSettingsUrl()} → Create from manifest`,
-    "Import .slack/manifest.dev.json (then prod)",
-    `Install apps; set ${envKeys.bot} + ${envKeys.app}`,
-    `Or install Slack CLI to ~/${SLACK_CLI_HOME_BIN}, then slack app install --environment ${options.environment} --team <T> --force`,
-    ...afterDoctor(options.prefix),
-  ];
-}
-
-function cliNext(
-  cli: string,
-  envKeys: { bot: string; app: string },
-  options: {
-    team?: string;
-    environment: SlackCliEnvironment;
-    prefix?: string;
-  },
-): string[] {
-  const workspace = options.team ?? "<T>";
-  return [
-    "Ask the user to install this Slack app on their workspace",
-    `${cli} login --no-prompt`,
-    `In Slack send /slackauthticket <ticket>; then ${cli} login --ticket <ticket> --challenge <code>`,
-    `${cli} app install --environment ${options.environment} --team ${workspace} --force`,
-    `Copy xoxb + xapp (connections:write) from ${slackAppSettingsUrl()} into .env.local as ${envKeys.bot} + ${envKeys.app}`,
-    `Fallback: paste .slack/manifest.dev.json at ${slackAppSettingsUrl()}`,
-    ...afterDoctor(options.prefix),
-  ];
-}
-
-function installedNext(
-  install: SlackCliInstallResult,
-  envKeys: { bot: string; app: string },
-  prefix?: string,
-): string[] {
-  const settings = slackAppSettingsUrl(install.appId);
-  const next: string[] = [];
-  if (!install.tokens.bot) {
-    next.push(`Copy the bot token (xoxb-...) from ${settings} into ${envKeys.bot}`);
-  }
-  if (!install.tokens.app) {
-    next.push(`Mint an app-level token with connections:write at ${settings}; set ${envKeys.app}`);
-  }
-  next.push(...afterDoctor(prefix));
-  return next;
-}
-
-export async function cmdSlackInit(options: SlackManualCliOptions): Promise<number> {
-  if (options.manual !== true) {
-    errStream(options)(
-      `\`slack init\` without --manual is not the first-run path. Socket Mode apps are created with:
-
-  ${CLI} slack create --dir .
-
-That opens the Cursor dashboard wizard.
-
-To install a custom Slack app from a manifest (Slack CLI or api.slack.com):
-
-  ${CLI} slack init --manual --dir .
-`,
-    );
-    return 1;
-  }
-
-  const dir = resolvePath(options.dir);
-  const out = options.out ?? ((text: string) => void process.stdout.write(text));
-  const err = errStream(options);
-  try {
-    const result = await initSlackManual({
-      dir,
-      name: options.name,
-      envPrefix: options.noPrefix === true ? "" : options.prefix,
-      channelPosts: options.channelPosts,
-    });
-    const cli = (options.detectSlackCli ?? detectSlackCli)();
-    const skipInstall = options.noInstall === true;
-    const requireInstall = options.install === true && !skipInstall;
-    let install: SlackCliInstallResult | undefined;
-    if (!skipInstall && cli !== undefined) {
-      install = await installSlackApp({
-        dir: result.rootDir,
-        bin: cli,
-        envKeys: result.envKeys,
-        environment: slackCliEnvironment(options.prod),
-        team: options.slackTeam,
-        exec: options.runSlackCli,
-      });
-      if (!install.ok && requireInstall) {
-        err(`${install.error ?? "slack app install failed"}\n`);
-      }
-    } else if (requireInstall) {
-      err(
-        `Slack CLI not found (~/${SLACK_CLI_HOME_BIN}). Install it or omit --install and paste at api.slack.com.\n`,
-      );
-    }
-    const ok = !requireInstall || install?.ok === true;
-    const next =
-      install?.ok === true
-        ? installedNext(install, result.envKeys, result.envPrefix)
-        : cli !== undefined
-          ? cliNext(cli, result.envKeys, {
-              team: install?.team ?? options.slackTeam,
-              environment: slackCliEnvironment(options.prod),
-              prefix: result.envPrefix,
-            })
-          : pasteNext(result.envKeys, {
-              environment: slackCliEnvironment(options.prod),
-              prefix: result.envPrefix,
-            });
-    out(
-      `${JSON.stringify(
-        {
-          ok,
-          directory: result.rootDir,
-          created: result.files,
-          envPrefix: result.envPrefix ?? null,
-          envKeys: result.envKeys,
-          cli: cli ?? null,
-          install: install ?? null,
-          next,
-        },
-        null,
-        2,
-      )}\n`,
-    );
-    return ok ? 0 : 1;
-  } catch (error) {
-    err(`${describeError(error)}\n`);
-    return 1;
-  }
-}
-
-export async function runSlackManifest(options: SlackManualCliOptions): Promise<number> {
-  const env = options.env ?? "both";
-  const dir = resolvePath(options.dir);
-  const pair = buildSlackManifestPair({
-    name: options.name ?? basename(dir),
-    managedByCursor: false,
-    channelPosts: options.channelPosts === true ? true : undefined,
-  });
-
-  if (options.print) {
-    if (env === "dev" || env === "both") {
-      process.stdout.write(`${JSON.stringify(pair.dev, null, 2)}\n`);
-    }
-    if (env === "prod" || env === "both") {
-      if (env === "both") {
-        process.stdout.write("--- prod ---\n");
-      }
-      process.stdout.write(`${JSON.stringify(pair.prod, null, 2)}\n`);
-    }
-    return 0;
-  }
-
-  const outDir = join(dir, ".slack");
-  await mkdir(outDir, { recursive: true });
-  const written: string[] = [];
-  for (const file of slackManifestFileEntries(pair, env)) {
-    const path = join(outDir, file.name);
-    await writeFile(path, file.contents);
-    written.push(path);
-  }
-  process.stdout.write(`${JSON.stringify({ ok: true, written }, null, 2)}\n`);
-  return 0;
-}
-
-function parseEnvAssignments(text: string): Record<string, string> {
-  const out: Record<string, string> = {};
-  for (const line of text.split(/\r?\n/)) {
-    const trimmed = line.trim();
-    if (trimmed === "" || trimmed.startsWith("#")) {
-      continue;
-    }
-    const raw = trimmed.startsWith("export ") ? trimmed.slice(7) : trimmed;
-    const eq = raw.indexOf("=");
-    if (eq <= 0) {
-      continue;
-    }
-    out[raw.slice(0, eq)] = raw.slice(eq + 1);
-  }
-  return out;
-}
-
-async function readDotenv(dir: string): Promise<Record<string, string>> {
-  return parseEnvAssignments(await readFile(join(dir, ".env"), "utf8").catch(() => ""));
-}
-
-function newToken(
-  before: string | undefined,
-  after: string | undefined,
-  prefix: string,
-): string | undefined {
-  if (after === undefined || !after.startsWith(prefix) || after === before) {
-    return undefined;
-  }
-  return after;
-}
-
-async function copySlackCliTokensToLocalEnv(options: {
-  dir: string;
-  envKeys: { bot: string; app: string };
-  before: Record<string, string>;
-}): Promise<{ bot: boolean; app: boolean }> {
-  const after = await readDotenv(options.dir);
-  const bot = newToken(options.before.SLACK_BOT_TOKEN, after.SLACK_BOT_TOKEN, "xoxb-");
-  const app = newToken(options.before.SLACK_APP_TOKEN, after.SLACK_APP_TOKEN, "xapp-");
-  const entries: Array<{ key: string; value: string }> = [];
-  const wrote = { bot: false, app: false };
-  if (bot !== undefined) {
-    entries.push({ key: options.envKeys.bot, value: bot });
-    wrote.bot = true;
-  }
-  if (app !== undefined) {
-    entries.push({ key: options.envKeys.app, value: app });
-    wrote.app = true;
-  }
-  if (entries.length === 0) {
-    return wrote;
-  }
-  await upsertEnvFile(join(options.dir, ".env.local"), entries);
-  await ensureEnvLocalGitignored(options.dir);
-  return wrote;
-}
-
-async function installSlackApp(options: SlackCliInstallOptions): Promise<SlackCliInstallResult> {
-  const exec = options.exec ?? defaultSlackCliExec;
-  const auth = await exec({
-    bin: options.bin,
-    argv: ["auth", "list"],
-    cwd: options.dir,
-  });
-  const teams = parseSlackAuthTeams(`${auth.stdout}\n${auth.stderr}`);
-  if (teams.length === 0) {
-    return {
-      ok: false,
-      environment: options.environment,
-      error: "Slack CLI is not logged in. Run slack login --no-prompt.",
-      tokens: { bot: false, app: false },
-    };
-  }
-  let team = options.team;
-  if (team === undefined) {
-    if (teams.length > 1) {
-      return {
-        ok: false,
-        environment: options.environment,
-        error: `Multiple Slack CLI teams (${teams.join(", ")}). Pass --slack-team.`,
-        tokens: { bot: false, app: false },
-      };
-    }
-    team = teams[0];
-  }
-  const before = await readDotenv(options.dir);
-  const installed = await exec({
-    bin: options.bin,
-    argv: ["app", "install", "--environment", options.environment, "--force", "--team", team],
-    cwd: options.dir,
-    env: { ...process.env, SLACK_ENV: options.environment },
-  });
-  if (installed.code !== 0) {
-    const detail = installed.stderr.trim() || installed.stdout.trim();
-    return {
-      ok: false,
-      environment: options.environment,
-      team,
-      error: detail === "" ? `slack app install exited ${installed.code}` : detail,
-      tokens: { bot: false, app: false },
-    };
-  }
-  await writeFile(join(options.dir, ".slack/cli-environment"), `${options.environment}\n`);
-  const appId = await readSlackCliAppId(options.dir, options.environment, team);
-  const tokens = await copySlackCliTokensToLocalEnv({
-    dir: options.dir,
-    envKeys: options.envKeys,
-    before,
-  });
-  return {
-    ok: true,
-    environment: options.environment,
-    team,
-    appId,
-    tokens,
-  };
-}
-
-async function defaultSlackCliExec(request: SlackCliExecRequest): Promise<SlackCliExecResult> {
-  try {
-    const { stdout, stderr } = await execFileAsync(request.bin, request.argv, {
-      cwd: request.cwd,
-      env: request.env,
-      timeout: 120_000,
-    });
-    return { code: 0, stdout, stderr };
-  } catch (error) {
-    if (!(error instanceof Error)) {
-      throw error;
-    }
-    const execError = error as Error & {
-      code?: number | string;
-      stdout?: string;
-      stderr?: string;
-    };
-    return {
-      code: typeof execError.code === "number" ? execError.code : 1,
-      stdout: execError.stdout ?? "",
-      stderr: execError.stderr ?? execError.message,
-    };
-  }
-}