@mycadet/cli 0.12.7 → 0.12.8

package/src/commands/recover.ts

@@ -1,131 +0,0 @@
-import { resolveExistingLocalSigningKey } from "@mycadet/local-mode";
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  renameSync,
-  unlinkSync,
-} from "fs";
-import { basename, dirname, join } from "path";
-
-import { saveAssistantEntry } from "../lib/assistant-config";
-import type { AssistantEntry } from "../lib/assistant-config";
-import {
-  generateLocalSigningKey,
-  startCes,
-  startLocalDaemon,
-  startGateway,
-} from "../lib/local";
-import { getArchivePath, getMetadataPath } from "../lib/retire-archive";
-import { exec } from "../lib/step-runner";
-
-export const recover = Object.assign(
-  async function recover(): Promise<void> {
-  const args = process.argv.slice(3);
-  if (args.includes("--help") || args.includes("-h")) {
-    console.log("Usage: cadet recover <name>");
-    console.log("");
-    console.log(
-      "Restore a previously retired local assistant from its archive.",
-    );
-    console.log("");
-    console.log(
-      "Extracts the archived workspace data back to its original location,",
-    );
-    console.log(
-      "restores the lockfile entry, and starts the assistant and gateway.",
-    );
-    console.log(
-      "Archives are stored in $XDG_DATA_HOME/cadet/retired/ (default: ~/.local/share/cadet/retired/).",
-    );
-    console.log("");
-    console.log("Arguments:");
-    console.log("  <name>    Name of the retired assistant to recover");
-    console.log("");
-    console.log("Examples:");
-    console.log("  $ cadet recover my-assistant");
-    console.log("  $ cadet recover aria-7f3a");
-    process.exit(0);
-  }
-
-  const name = process.argv[3];
-  if (!name) {
-    console.error("Usage: cadet recover <name>");
-    process.exit(1);
-  }
-
-  const archivePath = getArchivePath(name);
-  const metadataPath = getMetadataPath(name);
-
-  // 1. Verify archive exists
-  if (!existsSync(archivePath) || !existsSync(metadataPath)) {
-    console.error(`No retired archive found for '${name}'.`);
-    process.exit(1);
-  }
-
-  // 2. Read and validate metadata before any side effects
-  const entry: AssistantEntry = JSON.parse(readFileSync(metadataPath, "utf-8"));
-  if (!entry.resources) {
-    throw new Error(
-      `Retired assistant '${name}' is missing resource configuration. ` +
-        `Fix the archive metadata at ${metadataPath} and retry, ` +
-        `or run 'cadet hatch' to re-provision with proper resource allocation.`,
-    );
-  }
-
-  // 3. Check that the recovering entry's own target directory is free.
-  const target = entry.resources.instanceDir;
-  if (existsSync(target)) {
-    console.error(
-      `Error: ${target} already exists (owned by ${entry.assistantId}). ` +
-        `Retire the current assistant first.`,
-    );
-    process.exit(1);
-  }
-
-  // 4. Determine the original target directory, then extract and rename.
-  //
-  // retireLocal archives the full instanceDir. The directory is staged under
-  // `<archive>.staging` inside the retired dir before being packed with
-  // `tar -C <retiredDir> <stagingBasename>`, so the top-level entry inside
-  // the tarball is always `<name>.tar.gz.staging`.
-  //
-  // Correct restoration: extract to retiredDir, then rename the staging entry
-  // back to the original target path. Using homedir() as the -C target was
-  // wrong for any instance stored outside the home directory.
-  const targetDir = entry.resources.instanceDir;
-  const retiredDir = dirname(archivePath);
-  const extractedPath = join(retiredDir, basename(archivePath) + ".staging");
-
-  await exec("tar", ["xzf", archivePath, "-C", retiredDir]);
-  // Validate the staged identity before occupying the destination or updating
-  // the registry. A failed validation leaves the archive available for retry.
-  const signingKey = resolveExistingLocalSigningKey(
-    entry.resources,
-    extractedPath,
-  );
-  const bootstrapSecret =
-    entry.guardianBootstrapSecret ?? generateLocalSigningKey();
-  entry.resources = { ...entry.resources, signingKey };
-  entry.guardianBootstrapSecret = bootstrapSecret;
-  mkdirSync(dirname(targetDir), { recursive: true });
-  renameSync(extractedPath, targetDir);
-  saveAssistantEntry(entry);
-
-  // 7. Start CES sibling + daemon + gateway in parallel, the way the
-  // Docker topology brings its sibling processes up together. startCes
-  // always launches the CES sibling.
-  await Promise.all([
-    startCes(false, entry.resources),
-    startLocalDaemon(false, entry.resources, { signingKey }),
-    startGateway(false, entry.resources, { signingKey, bootstrapSecret }),
-  ]);
-
-  unlinkSync(archivePath);
-  unlinkSync(metadataPath);
-
-  console.log(`✅ Recovered assistant '${name}'.`);
-},
-  { description: "Restore a previously retired local assistant" },
-);
-

package/src/commands/roadmap.ts

@@ -1,459 +0,0 @@
-import { readPlatformToken, getWebUrl } from "../lib/platform-client.js";
-import { loopbackSafeFetch } from "../lib/loopback-fetch.js";
-
-function printUsage(): void {
-  console.log("Usage: cadet roadmap <subcommand>");
-  console.log("");
-  console.log("Manage roadmap items.");
-  console.log("");
-  console.log("Subcommands:");
-  console.log(
-    "  list     [--query <q>] [--status <s>] [--tag <slug>] [--sort upvotes|created] [--limit <n>]",
-  );
-  console.log("  get      <slug>");
-  console.log(
-    "  create   --title <title> [--description <desc>] [--tag <slug>...]",
-  );
-  console.log(
-    "  update   <slug> [--title <title>] [--description <desc>] [--status <s>] [--tag <slug>...]",
-  );
-  console.log("  delete   <slug>");
-  console.log("  upvote   <slug>");
-  console.log("  unvote   <slug>");
-  console.log("");
-  console.log(
-    "update: --status and --tag are staff-only. Anyone else can edit only the",
-  );
-  console.log(
-    "title and description of an item they filed, while it is still open.",
-  );
-  console.log("");
-  console.log("Examples:");
-  console.log('  $ cadet roadmap list --query "dark mode"');
-  console.log("  $ cadet roadmap list --status planned --sort upvotes");
-  console.log("  $ cadet roadmap get my-feature-slug");
-  console.log('  $ cadet roadmap create --title "Add dark mode"');
-  console.log(
-    '  $ cadet roadmap update my-feature --description "Follow the OS setting"',
-  );
-  console.log("  $ cadet roadmap upvote my-feature-slug");
-}
-
-function consumeValue(args: string[], i: number, flag: string): string {
-  const next = args[i + 1];
-  if (next === undefined || next.startsWith("--")) {
-    console.error(`Error: ${flag} requires a value.`);
-    process.exit(1);
-  }
-  return next;
-}
-
-function requireAuth(): string {
-  const token = readPlatformToken();
-  if (!token) {
-    console.error("Not logged in. Run `cadet login` first.");
-    process.exit(1);
-  }
-  return token;
-}
-
-function requireSlug(args: string[], command: string): string {
-  const slug = args[0];
-  if (!slug || slug.startsWith("--")) {
-    console.error(`Usage: cadet roadmap ${command} <slug>`);
-    process.exit(1);
-  }
-  return slug;
-}
-
-const ANSI_RE =
-  /[\x00-\x08\x0b-\x1f\x7f]|\x1b(?:\[[0-9;]*[A-Za-z]|\].*?(?:\x07|\x1b\\))/g;
-function sanitize(text: string): string {
-  return text.replace(ANSI_RE, "");
-}
-
-function makeLink(url: string): string {
-  return `\x1b]8;;${url}\x1b\\${url}\x1b]8;;\x1b\\`;
-}
-
-async function apiFetch(
-  path: string,
-  options: {
-    method?: string;
-    token?: string;
-    body?: Record<string, unknown>;
-    params?: Record<string, string>;
-  } = {},
-): Promise<Response> {
-  const webUrl = getWebUrl();
-  let url = `${webUrl}/api/marketing${path}`;
-  if (options.params) {
-    const qs = new URLSearchParams(options.params).toString();
-    if (qs) url += `?${qs}`;
-  }
-
-  const headers: Record<string, string> = {};
-  if (options.token) headers["X-Session-Token"] = options.token;
-  if (options.body) headers["Content-Type"] = "application/json";
-
-  return loopbackSafeFetch(url, {
-    method: options.method ?? "GET",
-    headers,
-    body: options.body ? JSON.stringify(options.body) : undefined,
-  });
-}
-
-async function handleError(response: Response, action: string): Promise<never> {
-  const text = await response.text().catch(() => "");
-  console.error(`Failed to ${action} (${response.status}): ${text}`);
-  process.exit(1);
-}
-
-// ── list ──
-
-interface ListItem {
-  slug: string;
-  title: string;
-  status: string;
-  upvote_count: number;
-  comment_count: number;
-  tags: { slug: string; name: string }[];
-  viewer_upvoted: boolean | null;
-}
-
-async function roadmapList(args: string[]): Promise<void> {
-  const params: Record<string, string> = {};
-  const token = readPlatformToken() ?? undefined;
-
-  for (let i = 0; i < args.length; i++) {
-    switch (args[i]) {
-      case "--query":
-      case "-q":
-        params.q = consumeValue(args, i, "--query");
-        i++;
-        break;
-      case "--status":
-        params.status = consumeValue(args, i, "--status");
-        i++;
-        break;
-      case "--tag":
-        params.tag = consumeValue(args, i, "--tag");
-        i++;
-        break;
-      case "--sort":
-        params.sort = consumeValue(args, i, "--sort");
-        i++;
-        break;
-      case "--limit":
-        params.limit = consumeValue(args, i, "--limit");
-        i++;
-        break;
-      case "--offset":
-        params.offset = consumeValue(args, i, "--offset");
-        i++;
-        break;
-    }
-  }
-
-  const response = await apiFetch("/v1/roadmap", { params, token });
-  if (!response.ok) return handleError(response, "list roadmap items");
-
-  const data = (await response.json()) as {
-    items: ListItem[];
-    total: number;
-  };
-
-  if (data.items.length === 0) {
-    console.log("No roadmap items found.");
-    return;
-  }
-
-  const webUrl = getWebUrl();
-  console.log(`Showing ${data.items.length} of ${data.total} items:\n`);
-
-  for (const item of data.items) {
-    const upvoted = item.viewer_upvoted ? " (upvoted)" : "";
-    const tags =
-      item.tags.length > 0
-        ? ` [${item.tags.map((t) => sanitize(t.slug)).join(", ")}]`
-        : "";
-    console.log(
-      `  ${sanitize(item.title)}  ▲${item.upvote_count}${upvoted}  💬${item.comment_count}  ${item.status}${tags}`,
-    );
-    console.log(`    ${makeLink(`${webUrl}/roadmap/${item.slug}`)}`);
-  }
-}
-
-// ── get ──
-
-async function roadmapGet(args: string[]): Promise<void> {
-  const slug = requireSlug(args, "get");
-  const token = readPlatformToken() ?? undefined;
-  const response = await apiFetch(`/v1/roadmap/${slug}`, { token });
-  if (!response.ok) return handleError(response, "get roadmap item");
-
-  const item = (await response.json()) as {
-    slug: string;
-    title: string;
-    description: string;
-    status: string;
-    upvote_count: number;
-    comment_count: number;
-    tags: { slug: string; name: string }[];
-    viewer_upvoted: boolean | null;
-    creator_username: string;
-    created: string;
-    comments: {
-      id: string;
-      author_username: string;
-      author_is_staff: boolean;
-      body: string;
-      created: string;
-    }[];
-  };
-
-  const webUrl = getWebUrl();
-  const upvoted = item.viewer_upvoted ? " (upvoted)" : "";
-  const tags =
-    item.tags.length > 0
-      ? item.tags.map((t) => sanitize(t.slug)).join(", ")
-      : "none";
-
-  console.log(sanitize(item.title));
-  console.log(`  slug:     ${item.slug}`);
-  console.log(`  status:   ${item.status}`);
-  console.log(`  upvotes:  ${item.upvote_count}${upvoted}`);
-  console.log(`  tags:     ${tags}`);
-  console.log(`  by:       ${sanitize(item.creator_username)}`);
-  console.log(`  created:  ${item.created}`);
-  console.log(`  url:      ${makeLink(`${webUrl}/roadmap/${item.slug}`)}`);
-  if (item.description) {
-    console.log(`\n${sanitize(item.description)}`);
-  }
-
-  if (item.comments.length > 0) {
-    console.log(`\nComments (${item.comments.length}):`);
-    for (const c of item.comments) {
-      const staff = c.author_is_staff ? " [staff]" : "";
-      console.log(`  ${sanitize(c.author_username)}${staff} (${c.created}):`);
-      console.log(`    ${sanitize(c.body)}`);
-    }
-  }
-}
-
-// ── create ──
-
-async function roadmapCreate(args: string[]): Promise<void> {
-  let title: string | undefined;
-  let description: string | undefined;
-  const tags: string[] = [];
-
-  for (let i = 0; i < args.length; i++) {
-    switch (args[i]) {
-      case "--title":
-        title = consumeValue(args, i, "--title");
-        i++;
-        break;
-      case "--description":
-        description = consumeValue(args, i, "--description");
-        i++;
-        break;
-      case "--tag":
-        tags.push(consumeValue(args, i, "--tag"));
-        i++;
-        break;
-    }
-  }
-
-  if (!title) {
-    console.error("Error: --title is required.");
-    console.error('Usage: cadet roadmap create --title "My feature request"');
-    process.exitCode = 1;
-    return;
-  }
-
-  const token = requireAuth();
-  const body: Record<string, unknown> = { title };
-  if (description) body.description = description;
-  if (tags.length > 0) body.tags = tags;
-
-  const response = await apiFetch("/v1/roadmap", {
-    method: "POST",
-    token,
-    body,
-  });
-  if (!response.ok) return handleError(response, "create roadmap item");
-
-  const item = (await response.json()) as {
-    slug: string;
-    title: string;
-    status: string;
-  };
-
-  const webUrl = getWebUrl();
-  console.log(`Created roadmap item: ${sanitize(item.title)}`);
-  console.log(`  slug:   ${item.slug}`);
-  console.log(`  status: ${item.status}`);
-  console.log(`  url:    ${makeLink(`${webUrl}/roadmap/${item.slug}`)}`);
-}
-
-// ── update ──
-
-async function roadmapUpdate(args: string[]): Promise<void> {
-  const slug = requireSlug(args, "update");
-
-  let title: string | undefined;
-  let description: string | undefined;
-  let status: string | undefined;
-  const tags: string[] = [];
-
-  for (let i = 1; i < args.length; i++) {
-    switch (args[i]) {
-      case "--title":
-        title = consumeValue(args, i, "--title");
-        i++;
-        break;
-      case "--description":
-        description = consumeValue(args, i, "--description");
-        i++;
-        break;
-      case "--status":
-        status = consumeValue(args, i, "--status");
-        i++;
-        break;
-      case "--tag":
-        tags.push(consumeValue(args, i, "--tag"));
-        i++;
-        break;
-    }
-  }
-
-  const body: Record<string, unknown> = {};
-  if (title !== undefined) body.title = title;
-  if (description !== undefined) body.description = description;
-  if (status !== undefined) body.status = status;
-  if (tags.length > 0) body.tags = tags;
-
-  if (Object.keys(body).length === 0) {
-    console.error("Error: at least one field to update is required.");
-    process.exitCode = 1;
-    return;
-  }
-
-  const token = requireAuth();
-  const response = await apiFetch(`/v1/roadmap/${slug}`, {
-    method: "PATCH",
-    token,
-    body,
-  });
-  if (!response.ok) return handleError(response, "update roadmap item");
-
-  const item = (await response.json()) as {
-    slug: string;
-    title: string;
-    status: string;
-  };
-
-  const webUrl = getWebUrl();
-  console.log(`Updated roadmap item: ${sanitize(item.title)}`);
-  console.log(`  slug:   ${item.slug}`);
-  console.log(`  status: ${item.status}`);
-  console.log(`  url:    ${makeLink(`${webUrl}/roadmap/${item.slug}`)}`);
-}
-
-// ── delete ──
-
-async function roadmapDelete(args: string[]): Promise<void> {
-  const slug = requireSlug(args, "delete");
-  const token = requireAuth();
-  const response = await apiFetch(`/v1/roadmap/${slug}`, {
-    method: "DELETE",
-    token,
-  });
-  if (!response.ok) return handleError(response, "delete roadmap item");
-
-  console.log(`Deleted roadmap item: ${slug}`);
-}
-
-// ── upvote / unvote ──
-
-async function roadmapUpvote(args: string[]): Promise<void> {
-  const slug = requireSlug(args, "upvote");
-  const token = requireAuth();
-  const response = await apiFetch(`/v1/roadmap/${slug}/upvote`, {
-    method: "POST",
-    token,
-  });
-  if (!response.ok) return handleError(response, "upvote roadmap item");
-
-  const data = (await response.json()) as {
-    slug: string;
-    upvote_count: number;
-  };
-
-  console.log(`Upvoted: ${data.slug} (${data.upvote_count} total)`);
-}
-
-async function roadmapUnvote(args: string[]): Promise<void> {
-  const slug = requireSlug(args, "unvote");
-  const token = requireAuth();
-  const response = await apiFetch(`/v1/roadmap/${slug}/upvote`, {
-    method: "DELETE",
-    token,
-  });
-  if (!response.ok) return handleError(response, "remove upvote");
-
-  const data = (await response.json()) as {
-    slug: string;
-    upvote_count: number;
-  };
-
-  console.log(`Removed upvote: ${data.slug} (${data.upvote_count} total)`);
-}
-
-// ── main ──
-
-export const roadmap = Object.assign(
-  async function roadmap(): Promise<void> {
-  const args = process.argv.slice(3);
-  const sub = args[0];
-
-  if (!sub || sub === "--help" || sub === "-h") {
-    printUsage();
-    return;
-  }
-
-  switch (sub) {
-    case "list":
-    case "ls":
-      await roadmapList(args.slice(1));
-      break;
-    case "get":
-    case "show":
-      await roadmapGet(args.slice(1));
-      break;
-    case "create":
-      await roadmapCreate(args.slice(1));
-      break;
-    case "update":
-      await roadmapUpdate(args.slice(1));
-      break;
-    case "delete":
-    case "rm":
-      await roadmapDelete(args.slice(1));
-      break;
-    case "upvote":
-      await roadmapUpvote(args.slice(1));
-      break;
-    case "unvote":
-      await roadmapUnvote(args.slice(1));
-      break;
-    default:
-      console.error(`Unknown subcommand: ${sub}`);
-      printUsage();
-      process.exitCode = 1;
-  }
-},
-  { description: "Manage roadmap items" },
-);
-