mantisai-cli 2.0.1 → 3.0.0

package/lib/map-create.js

@@ -1,148 +0,0 @@
-import path from 'node:path';
-
-import { createMapInSpace, createSpace, createSpaceState } from './api.js';
-import { loadConfig, normalizeBaseUrl, saveConfig } from './config.js';
-import { readCsvHeaders } from './csv.js';
-import { fieldSummary, inferFieldTypes } from './fields.js';
-import { fetchSpaceById, searchSpaces } from './spaces.js';
-import { syncMcpConfigs } from './mcp-config.js';
-import { info, promptConfirm, promptInput, promptSelect, success } from './ui.js';
-
-function requireAuth() {
-  const cfg = loadConfig();
-  if (!cfg.apiKey || !cfg.apiBaseUrl) {
-    throw new Error('Run mantis setup first (API key + URL).');
-  }
-  return cfg;
-}
-
-function boolOption(value, fallback = false) {
-  if (value == null) return fallback;
-  if (typeof value === 'boolean') return value;
-  return ['1', 'true', 'yes', 'public'].includes(String(value).toLowerCase());
-}
-
-function frontendBaseUrl(apiBaseUrl) {
-  const root = normalizeBaseUrl(apiBaseUrl).replace(/\/api\/?$/, '');
-  let url;
-  try {
-    url = new URL(root);
-  } catch {
-    return root;
-  }
-  // Local dev: API on :8000, frontend on :3000.
-  if (/^(localhost|127\.0\.0\.1)$/i.test(url.hostname)) {
-    url.port = '3000';
-    return url.origin;
-  }
-  // Mantis production: API on kellis-h200-1.csail.mit.edu, frontend on mantis.csail.mit.edu.
-  if (/(^|\.)kellis-h200-1\.csail\.mit\.edu$/i.test(url.hostname)) {
-    url.hostname = 'mantis.csail.mit.edu';
-    return url.origin;
-  }
-  return root;
-}
-
-function spaceUrl(baseUrl, spaceId) {
-  return `${frontendBaseUrl(baseUrl)}/space/${spaceId}`;
-}
-
-async function chooseExistingSpace(cfg, filter = '') {
-  const page = await searchSpaces(cfg.apiBaseUrl, cfg.apiKey, { q: filter, limit: 12 });
-  if (!page.spaces?.length) throw new Error('No spaces found.');
-  return promptSelect('Which space should receive this map?', page.spaces.map((s) => ({
-    name: `${s.name} · ${s.map_count ?? 0} map(s) · ${s.role || 'space'}`,
-    value: s,
-    description: s.id,
-  })));
-}
-
-async function resolveSpaceTarget(cfg, opts) {
-  let mode = opts.spaceMode;
-  if (!mode) {
-    mode = await promptSelect('Where should this map go?', [
-      { name: 'Create a new space', value: 'new' },
-      { name: 'Add to an existing space', value: 'existing' },
-    ]);
-  }
-
-  if (mode === 'existing') {
-    if (opts.spaceId) {
-      const space = opts.spaceName ? null : await fetchSpaceById(cfg.apiBaseUrl, cfg.apiKey, opts.spaceId);
-      return { spaceId: opts.spaceId, spaceName: opts.spaceName || space?.name };
-    }
-    const picked = await chooseExistingSpace(cfg, opts.spaceSearch || '');
-    return { spaceId: picked.id, spaceName: picked.name };
-  }
-
-  const spaceName = opts.spaceName || await promptInput('New space name', {
-    default: path.basename(opts.file, path.extname(opts.file)) || 'Claude Code Map',
-  });
-  const isPublic = opts.public != null ? boolOption(opts.public) : await promptConfirm('Make this space public?', { default: false });
-  return { spaceName, isPublic };
-}
-
-export async function createMapFlow(file, opts = {}) {
-  const cfg = requireAuth();
-  const mapName = opts.mapName || await promptInput('Map name', {
-    default: path.basename(file, path.extname(file)),
-  });
-  const headers = readCsvHeaders(file);
-  const dataTypes = opts.dataTypes ? JSON.parse(opts.dataTypes) : inferFieldTypes(headers, opts);
-  info(`Fields: ${fieldSummary(headers, dataTypes).join(' | ')}`);
-
-  const target = await resolveSpaceTarget(cfg, { ...opts, file });
-
-  let spaceId = target.spaceId;
-  let spaceName = target.spaceName;
-  if (!spaceId) {
-    const space = await createSpace(cfg.apiBaseUrl, cfg.apiKey, {
-      name: target.spaceName,
-      isPublic: target.isPublic,
-    });
-    spaceId = space.id;
-    spaceName = space.name;
-    info(`Created space: ${spaceName} (${spaceId})`);
-  }
-
-  const result = await createMapInSpace(cfg.apiBaseUrl, cfg.apiKey, spaceId, {
-    file,
-    mapName,
-    dataTypes,
-    selectedFields: opts.selectedFields,
-    fieldWeights: opts.fieldWeights,
-  });
-
-  const primaryMapId = result.map_id || result.base_map_id || result.map_ids?.[0];
-  target.spaceName = spaceName;
-  success('Map creation started');
-  info(`Space: ${target.spaceName || spaceId} (${spaceId})`);
-  info(`Map:   ${mapName}${primaryMapId ? ` (${primaryMapId})` : ''}`);
-  if (spaceId) info(`Link:  ${spaceUrl(cfg.apiBaseUrl, spaceId)}`);
-
-  const activate = opts.activate != null ? boolOption(opts.activate) : await promptConfirm('Set this as the active Claude Code Mantis space?', { default: true });
-  let thread = null;
-  if (activate) {
-    const threadName = opts.threadName || await promptInput('Thread name', { default: `${mapName} Exploration` });
-    thread = await createSpaceState(cfg.apiBaseUrl, cfg.apiKey, spaceId, threadName);
-    const next = {
-      ...cfg,
-      spaceId,
-      spaceName: target.spaceName || mapName,
-      spaceStateId: thread.id,
-      spaceStateName: thread.name,
-    };
-    saveConfig(next);
-    syncMcpConfigs(next);
-    success(`Active thread: ${thread.name}`);
-    info('Run /reload-plugins in Claude Code before using Mantis MCP tools.');
-  }
-
-  return {
-    ...result,
-    space_id: spaceId,
-    map_id: primaryMapId,
-    space_url: spaceId ? spaceUrl(cfg.apiBaseUrl, spaceId) : undefined,
-    thread,
-  };
-}

package/lib/mcp-config.js

@@ -1,50 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { mcpUrl } from './config.js';
-
-const MARKETPLACE = 'mantis-plugins';
-const PACKAGE = 'mantisai-cli';
-
-function existingPackageRoot(root) {
-  return root && fs.existsSync(path.join(root, 'package.json')) ? path.normalize(root) : null;
-}
-
-function isInstallRoot(root) {
-  const p = root.toLowerCase();
-  return p.includes(`${path.sep}.claude${path.sep}plugins${path.sep}`) ||
-    p.endsWith(`${path.sep}node_modules${path.sep}${PACKAGE}`);
-}
-
-function cacheRoots() {
-  const base = path.join(os.homedir(), '.claude', 'plugins', 'cache', MARKETPLACE, 'mantis');
-  if (!fs.existsSync(base)) return [];
-  return fs.readdirSync(base).map((v) => path.join(base, v));
-}
-
-export function pluginRoots() {
-  const here = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-  const home = os.homedir();
-  return [
-    here,
-    path.join(home, '.claude', 'plugins', 'marketplaces', MARKETPLACE),
-    path.join(home, '.claude', 'plugins', 'npm-cache', 'node_modules', PACKAGE),
-    path.join(home, 'AppData', 'Roaming', 'npm', 'node_modules', PACKAGE),
-    ...cacheRoots(),
-  ].map(existingPackageRoot).filter(Boolean).filter(isInstallRoot).filter((v, i, a) => a.indexOf(v) === i);
-}
-
-export function mcpConfig(cfg) {
-  const server = { type: 'http', url: mcpUrl(cfg) };
-  if (cfg.spaceStateId) server.headers = { 'X-Space-State-ID': String(cfg.spaceStateId) };
-  return { mcpServers: { mantis: server } };
-}
-
-export function syncMcpConfigs(cfg) {
-  const body = `${JSON.stringify(mcpConfig(cfg), null, 2)}\n`;
-  for (const root of pluginRoots()) {
-    fs.writeFileSync(path.join(root, '.mcp.json'), body);
-  }
-}

package/lib/picker.js

@@ -1,150 +0,0 @@
-import { createSpaceState, fetchThreads } from './fetch.js';
-import { loadConfig, saveConfig } from './config.js';
-import { syncMcpConfigs } from './mcp-config.js';
-import { searchSpaces, resolveSpaceFromInput } from './spaces.js';
-import { parseSpaceIdFromInput } from './space-id.js';
-import { die, info, promptInput, promptSearch, success } from './ui.js';
-
-const BROWSE_PAGE = 20;
-
-function spaceLabel(s) {
-  const name = s.name || '(unnamed)';
-  const maps = s.map_count != null ? ` · ${s.map_count} map(s)` : '';
-  const role = s.role ? ` · ${s.role}` : '';
-  return name + maps + role;
-}
-
-function spaceChoices(spaces) {
-  return spaces.map((s) => ({
-    name: spaceLabel(s),
-    value: s,
-    description: s.id,
-  }));
-}
-
-export async function requireConfig() {
-  const cfg = loadConfig();
-  if (!cfg.apiKey || !cfg.apiBaseUrl) {
-    die('Run mantis setup or /mantis:connect first (API key + URL).');
-  }
-  return cfg;
-}
-
-function threadChoices(threads, query) {
-  const terms = (query || '').trim().toLowerCase();
-  const list = terms
-    ? threads.filter((t) => {
-        const hay = `${t.name} ${t.id}`.toLowerCase();
-        return hay.includes(terms);
-      })
-    : threads;
-  const out = [
-    { name: '➕ Create new thread', value: '__new__', description: 'New space state' },
-  ];
-  for (const t of list) {
-    const when = t.updated_at ? String(t.updated_at).slice(0, 10) : '';
-    out.push({
-      name: t.name || '(unnamed)',
-      value: t,
-      description: when || t.id,
-    });
-  }
-  return out;
-}
-
-async function pickSpaceByLink(cfg) {
-  const raw = await promptInput('Paste Mantis space link or UUID (Enter to browse)', {
-    default: '',
-  });
-  if (!raw?.trim()) return null;
-  const space = await resolveSpaceFromInput(cfg.apiBaseUrl, cfg.apiKey, raw);
-  if (!space) die('Space not found or you do not have access.');
-  return saveSpace(cfg, space);
-}
-
-export async function pickSpace() {
-  const cfg = await requireConfig();
-
-  if (!process.stdin.isTTY) {
-    const page = await searchSpaces(cfg.apiBaseUrl, cfg.apiKey, { limit: 1 });
-    if (!page.spaces?.length) die('No spaces found.');
-    return saveSpace(cfg, page.spaces[0]);
-  }
-
-  const fromLink = await pickSpaceByLink(cfg);
-  if (fromLink) return fromLink;
-
-  const picked = await promptSearch(
-    'Select space (↑↓ type to search, paste link in previous step)',
-    async (input) => {
-      const id = parseSpaceIdFromInput(input);
-      if (id) {
-        const one = await resolveSpaceFromInput(cfg.apiBaseUrl, cfg.apiKey, input);
-        return one ? spaceChoices([one]) : [{ name: 'No match for that link/id', value: null, disabled: true }];
-      }
-      const page = await searchSpaces(cfg.apiBaseUrl, cfg.apiKey, {
-        q: input || '',
-        limit: BROWSE_PAGE,
-        offset: 0,
-      });
-      return spaceChoices(page.spaces || []);
-    },
-  );
-  if (!picked) die('No space selected.');
-  return saveSpace(cfg, picked);
-}
-
-function saveSpace(cfg, space) {
-  const changed = cfg.spaceId !== space.id;
-  const next = { ...cfg, spaceId: space.id, spaceName: space.name };
-  if (changed) {
-    delete next.spaceStateId;
-    delete next.spaceStateName;
-  }
-  saveConfig(next);
-  syncMcpConfigs(next);
-  success(`Space: ${space.name}`);
-  if (changed) {
-    info('Thread cleared — pick a thread, then /reload-plugins in Claude Code.');
-  }
-  return next;
-}
-
-export async function pickThread(initialFilter = '') {
-  const cfg = await requireConfig();
-  if (!cfg.spaceId) die('Pick a space first: /mantis:space');
-
-  const threads = await fetchThreads(cfg.apiBaseUrl, cfg.apiKey, cfg.spaceId);
-
-  if (!process.stdin.isTTY) {
-    if (!threads.length) die('No threads. Run interactively to create one.');
-    return saveThread(cfg, threads[0]);
-  }
-
-  const picked = await promptSearch(
-    `Thread in "${cfg.spaceName || 'space'}" (↑↓, type to filter)`,
-    async (input) => threadChoices(threads, input || initialFilter),
-  );
-
-  if (picked === '__new__') {
-    const name = await promptInput('Thread name', { default: 'Claude Code' });
-    const created = await createSpaceState(
-      cfg.apiBaseUrl, cfg.apiKey, cfg.spaceId, name || 'Claude Code',
-    );
-    return saveThread(cfg, created);
-  }
-  return saveThread(cfg, picked);
-}
-
-function saveThread(cfg, thread) {
-  const next = {
-    ...cfg,
-    spaceStateId: thread.id,
-    spaceStateName: thread.name,
-  };
-  saveConfig(next);
-  syncMcpConfigs(next);
-  success(`Thread: ${thread.name}`);
-  info('MCP headers update on reconnect — run /reload-plugins if tools lack context.');
-  return next;
-}

package/lib/spaces.js

@@ -1,48 +0,0 @@
-import { listSpaces } from './api.js';
-import { parseSpaceIdFromInput } from './space-id.js';
-
-export async function fetchSpaceById(baseUrl, apiKey, spaceId) {
-  const page = await listSpaces(baseUrl, apiKey, {
-    scope: 'accessible',
-    space_id: spaceId,
-    limit: 1,
-    offset: 0,
-  });
-  return page.spaces?.[0] ?? null;
-}
-
-export async function resolveSpaceFromInput(baseUrl, apiKey, text) {
-  const id = parseSpaceIdFromInput(text);
-  if (!id) return null;
-  return fetchSpaceById(baseUrl, apiKey, id);
-}
-
-/** One page of spaces; optional name/id search — does not load the full catalog. */
-export async function searchSpaces(
-  baseUrl,
-  apiKey,
-  { q = '', limit = 20, offset = 0, scope = 'accessible' } = {},
-) {
-  const id = parseSpaceIdFromInput(q);
-  if (id) {
-    const one = await fetchSpaceById(baseUrl, apiKey, id);
-    return {
-      spaces: one ? [one] : [],
-      total: one ? 1 : 0,
-      limit: 1,
-      offset: 0,
-    };
-  }
-  const page = await listSpaces(baseUrl, apiKey, {
-    scope,
-    limit,
-    offset,
-    q: q.trim() || undefined,
-  });
-  return {
-    spaces: page.spaces || [],
-    total: page.total ?? (page.spaces || []).length,
-    limit: page.limit ?? limit,
-    offset: page.offset ?? offset,
-  };
-}

package/lib/ui.js

@@ -1,73 +0,0 @@
-import { confirm, input, password, search, select } from '@inquirer/prompts';
-
-export function isCancel(err) {
-  return err?.name === 'ExitPromptError';
-}
-
-export function die(msg) {
-  console.error(`\n  ✖ ${msg}\n`);
-  process.exit(1);
-}
-
-export function banner(title, subtitle) {
-  console.log('');
-  console.log(`  \x1b[36m${title}\x1b[0m`);
-  if (subtitle) console.log(`  \x1b[2m${subtitle}\x1b[0m`);
-  console.log('');
-}
-
-export function success(msg) {
-  console.log(`  \x1b[32m✔\x1b[0m ${msg}`);
-}
-
-export function info(msg) {
-  console.log(`  \x1b[2m→\x1b[0m ${msg}`);
-}
-
-export async function promptInput(message, { default: def } = {}) {
-  try {
-    return await input({ message, default: def });
-  } catch (e) {
-    if (isCancel(e)) die('Cancelled.');
-    throw e;
-  }
-}
-
-export async function promptSecret(message, { default: def } = {}) {
-  if (def) {
-    return promptInput(message, { default: def });
-  }
-  try {
-    return await password({ message, mask: '•' });
-  } catch (e) {
-    if (isCancel(e)) die('Cancelled.');
-    throw e;
-  }
-}
-
-export async function promptSearch(message, source, { pageSize = 12 } = {}) {
-  try {
-    return await search({ message, pageSize, source });
-  } catch (e) {
-    if (isCancel(e)) die('Cancelled.');
-    throw e;
-  }
-}
-
-export async function promptSelect(message, choices) {
-  try {
-    return await select({ message, choices });
-  } catch (e) {
-    if (isCancel(e)) die('Cancelled.');
-    throw e;
-  }
-}
-
-export async function promptConfirm(message, { default: def = false } = {}) {
-  try {
-    return await confirm({ message, default: def });
-  } catch (e) {
-    if (isCancel(e)) die('Cancelled.');
-    throw e;
-  }
-}