mantisai-cli 2.0.0 → 2.0.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) Kellis Lab, MIT
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) Kellis Lab, MIT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/mantis-list-spaces.js

@@ -1,32 +1,32 @@
-#!/usr/bin/env node
-import { spacesForPrompt } from '../lib/list-cli.js';
-
-const args = process.argv.slice(2);
-let filter = '';
-let offset = 0;
-let limit = 4;
-for (let i = 0; i < args.length; i++) {
-  const a = args[i];
-  if (a === '--offset') {
-    offset = parseInt(args[++i], 10) || 0;
-    continue;
-  }
-  if (a === '--limit') {
-    limit = parseInt(args[++i], 10) || 4;
-    continue;
-  }
-  if (a === '--filter') {
-    filter = args[++i] ?? '';
-    continue;
-  }
-  filter = args.slice(i).join(' ').trim();
-  break;
-}
-
-try {
-  const data = await spacesForPrompt(filter, { limit, offset });
-  process.stdout.write(JSON.stringify(data));
-} catch (e) {
-  console.error(JSON.stringify({ error: e.message }));
-  process.exit(1);
-}
+#!/usr/bin/env node
+import { spacesForPrompt } from '../lib/list-cli.js';
+
+const args = process.argv.slice(2);
+let filter = '';
+let offset = 0;
+let limit = 4;
+for (let i = 0; i < args.length; i++) {
+  const a = args[i];
+  if (a === '--offset') {
+    offset = parseInt(args[++i], 10) || 0;
+    continue;
+  }
+  if (a === '--limit') {
+    limit = parseInt(args[++i], 10) || 4;
+    continue;
+  }
+  if (a === '--filter') {
+    filter = args[++i] ?? '';
+    continue;
+  }
+  filter = args.slice(i).join(' ').trim();
+  break;
+}
+
+try {
+  const data = await spacesForPrompt(filter, { limit, offset });
+  process.stdout.write(JSON.stringify(data));
+} catch (e) {
+  console.error(JSON.stringify({ error: e.message }));
+  process.exit(1);
+}

package/bin/mantis-list-threads.js

@@ -1,32 +1,32 @@
-#!/usr/bin/env node
-import { threadsForPrompt } from '../lib/list-cli.js';
-
-const args = process.argv.slice(2);
-let filter = '';
-let offset = 0;
-let limit = 4;
-for (let i = 0; i < args.length; i++) {
-  const a = args[i];
-  if (a === '--offset') {
-    offset = parseInt(args[++i], 10) || 0;
-    continue;
-  }
-  if (a === '--limit') {
-    limit = parseInt(args[++i], 10) || 4;
-    continue;
-  }
-  if (a === '--filter') {
-    filter = args[++i] ?? '';
-    continue;
-  }
-  filter = args.slice(i).join(' ').trim();
-  break;
-}
-
-try {
-  const data = await threadsForPrompt(filter, { limit, offset });
-  process.stdout.write(JSON.stringify(data));
-} catch (e) {
-  console.error(JSON.stringify({ error: e.message }));
-  process.exit(1);
-}
+#!/usr/bin/env node
+import { threadsForPrompt } from '../lib/list-cli.js';
+
+const args = process.argv.slice(2);
+let filter = '';
+let offset = 0;
+let limit = 4;
+for (let i = 0; i < args.length; i++) {
+  const a = args[i];
+  if (a === '--offset') {
+    offset = parseInt(args[++i], 10) || 0;
+    continue;
+  }
+  if (a === '--limit') {
+    limit = parseInt(args[++i], 10) || 4;
+    continue;
+  }
+  if (a === '--filter') {
+    filter = args[++i] ?? '';
+    continue;
+  }
+  filter = args.slice(i).join(' ').trim();
+  break;
+}
+
+try {
+  const data = await threadsForPrompt(filter, { limit, offset });
+  process.stdout.write(JSON.stringify(data));
+} catch (e) {
+  console.error(JSON.stringify({ error: e.message }));
+  process.exit(1);
+}

package/bin/mantis-set-space.js

@@ -1,31 +1,31 @@
-#!/usr/bin/env node
-import { loadConfig, saveConfig } from '../lib/config.js';
-import { syncMcpConfigs } from '../lib/mcp-config.js';
-
-const id = process.argv[2];
-const name = process.argv[3] || '';
-if (!id) {
-  console.error('Usage: mantis-set-space <space-uuid> [name]');
-  process.exit(1);
-}
-
-const cfg = loadConfig();
-const changed = cfg.spaceId !== id;
-const next = {
-  ...cfg,
-  spaceId: id,
-  spaceName: name || cfg.spaceName,
-  ...(changed ? { spaceStateId: undefined, spaceStateName: undefined } : {}),
-};
-saveConfig(next);
-syncMcpConfigs(next);
-console.log(
-  JSON.stringify({
-    ok: true,
-    spaceId: id,
-    spaceName: name,
-    threadCleared: changed,
-    needThread: changed,
-    needReloadPlugins: true,
-  }),
-);
+#!/usr/bin/env node
+import { loadConfig, saveConfig } from '../lib/config.js';
+import { syncMcpConfigs } from '../lib/mcp-config.js';
+
+const id = process.argv[2];
+const name = process.argv[3] || '';
+if (!id) {
+  console.error('Usage: mantis-set-space <space-uuid> [name]');
+  process.exit(1);
+}
+
+const cfg = loadConfig();
+const changed = cfg.spaceId !== id;
+const next = {
+  ...cfg,
+  spaceId: id,
+  spaceName: name || cfg.spaceName,
+  ...(changed ? { spaceStateId: undefined, spaceStateName: undefined } : {}),
+};
+saveConfig(next);
+syncMcpConfigs(next);
+console.log(
+  JSON.stringify({
+    ok: true,
+    spaceId: id,
+    spaceName: name,
+    threadCleared: changed,
+    needThread: changed,
+    needReloadPlugins: true,
+  }),
+);

package/bin/mantis.js

@@ -38,7 +38,7 @@ function addMapOptions(cmd) {
 program
   .name('mantis')
   .description('Mantis developer CLI — manage spaces, create maps, and configure Claude Code integration')
-  .version('2.0.0');
+  .version('2.0.1');
 
 program
   .command('setup')
@@ -90,6 +90,9 @@ addMapOptions(create
       const result = await createCodebaseCsv(root, out, { maxChars: opts.maxChars });
       success(`Indexed ${result.count} files`);
       info(`CSV: ${result.outFile}`);
+      if (result.skipped?.length) {
+        info(`Skipped ${result.skipped.length} binary file(s) (e.g. ${result.skipped.slice(0, 3).join(', ')})`);
+      }
       if (opts.createMap) {
         const mapResult = await createMapFlow(result.outFile, {
           ...opts,

package/lib/claude-plugin.js

@@ -1,150 +1,150 @@
-import { execSync, spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { loadConfig } from './config.js';
-import { syncMcpConfigs } from './mcp-config.js';
-
-const MARKETPLACE = 'mantis-plugins';
-const PLUGIN_ID = `mantis@${MARKETPLACE}`;
-const MARKETPLACE_REPO = 'KellisLab/mantis-cli';
-const NPM_PACKAGE = 'mantisai-cli';
-const LEGACY_NPM_PACKAGES = ['mantis-cli', 'mantis-claude-code'];
-
-export function resolvePluginRoot() {
-  try {
-    const root = execSync('npm root -g', { encoding: 'utf8', windowsHide: true }).trim();
-    for (const candidate of [NPM_PACKAGE, ...LEGACY_NPM_PACKAGES]) {
-      const globalPkg = path.join(root, candidate);
-      if (fs.existsSync(path.join(globalPkg, '.claude-plugin', 'plugin.json'))) {
-        return path.normalize(globalPkg);
-      }
-    }
-  } catch {
-    /* not installed globally */
-  }
-  const here = path.dirname(fileURLToPath(import.meta.url));
-  return path.normalize(path.resolve(here, '..'));
-}
-
-function settingsPath() {
-  return path.join(os.homedir(), '.claude', 'settings.json');
-}
-
-function installedPluginsPath() {
-  return path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
-}
-
-function readSettings() {
-  const file = settingsPath();
-  if (!fs.existsSync(file)) return {};
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return {};
-  }
-}
-
-function writeSettings(settings) {
-  const file = settingsPath();
-  fs.mkdirSync(path.dirname(file), { recursive: true });
-  fs.writeFileSync(file, `${JSON.stringify(settings, null, 2)}\n`);
-}
-
-function stripBrokenInlinePlugins(settings) {
-  const bad = (v) =>
-    typeof v === 'string' &&
-    (v.includes('$(npm') || v.includes('mantis-claude-code-plugin') || v.includes('mantis-cli-plugin'));
-  if (Array.isArray(settings.plugins)) {
-    settings.plugins = settings.plugins.filter((p) => {
-      const paths = [p?.path, p?.commands, p?.source?.path].filter(Boolean);
-      return !paths.some(bad);
-    });
-    if (!settings.plugins.length) delete settings.plugins;
-  }
-}
-
-export function isPluginInstalled() {
-  try {
-    const data = JSON.parse(fs.readFileSync(installedPluginsPath(), 'utf8'));
-    const entries = data.plugins?.[PLUGIN_ID];
-    if (!Array.isArray(entries) || !entries.length) return false;
-    const installPath = entries[0]?.installPath;
-    if (!installPath || !fs.existsSync(installPath)) return false;
-    return !fs.existsSync(path.join(installPath, '.orphaned_at'));
-  } catch {
-    return false;
-  }
-}
-
-function mergeMarketplaceIntoSettings() {
-  const settings = readSettings();
-  stripBrokenInlinePlugins(settings);
-  settings.extraKnownMarketplaces = settings.extraKnownMarketplaces || {};
-  settings.extraKnownMarketplaces[MARKETPLACE] = {
-    source: { source: 'github', repo: MARKETPLACE_REPO },
-  };
-  writeSettings(settings);
-}
-
-const BENIGN = [
-  /already enabled/i,
-  /already installed/i,
-  /already on disk/i,
-  /no updates/i,
-  /is already enabled/i,
-];
-
-function quoteCmdArg(arg) {
-  return `"${String(arg).replace(/"/g, '\\"')}"`;
-}
-
-function runClaude(argv, { optional = false } = {}) {
-  const opts = { encoding: 'utf8', windowsHide: true };
-  const r = process.platform === 'win32'
-    ? spawnSync(['claude', ...argv.map(quoteCmdArg)].join(' '), { ...opts, shell: true })
-    : spawnSync('claude', argv, opts);
-  if (r.error) {
-    const msg =
-      r.error.code === 'ENOENT'
-        ? 'claude not found on PATH — install Claude Code CLI first'
-        : r.error.message;
-    if (optional) return null;
-    throw new Error(msg);
-  }
-  const out = `${r.stdout || ''}${r.stderr || ''}`.trim();
-  if (r.status === 0 || BENIGN.some((re) => re.test(out))) return out;
-  if (optional) return null;
-  throw new Error(out || `claude ${argv.join(' ')} failed (exit ${r.status})`);
-}
-
-function installPluginScopes() {
-  for (const scope of ['user', 'local']) {
-    if (isPluginInstalled()) return scope;
-    runClaude(['plugin', 'install', PLUGIN_ID, '--scope', scope], { optional: true });
-  }
-  return isPluginInstalled() ? 'user' : null;
-}
-
-export function installClaudePlugin() {
-  const pluginRoot = resolvePluginRoot();
-  mergeMarketplaceIntoSettings();
-
-  runClaude(['plugin', 'marketplace', 'add', MARKETPLACE_REPO, '--scope', 'user'], { optional: true });
-  const scope = installPluginScopes();
-  if (!scope) {
-    throw new Error(
-      'Plugin not registered after install. Run: claude plugin install mantis@mantis-plugins',
-    );
-  }
-  runClaude(['plugin', 'update', PLUGIN_ID, '--scope', scope], { optional: true });
-  runClaude(['plugin', 'enable', PLUGIN_ID, '--scope', scope], { optional: true });
-  const settings = readSettings();
-  settings.enabledPlugins = settings.enabledPlugins || {};
-  settings.enabledPlugins[PLUGIN_ID] = true;
-  writeSettings(settings);
-  syncMcpConfigs(loadConfig());
-  return { ok: true, method: 'cli', pluginRoot, scope };
-}
+import { execSync, spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { loadConfig } from './config.js';
+import { syncMcpConfigs } from './mcp-config.js';
+
+const MARKETPLACE = 'mantis-plugins';
+const PLUGIN_ID = `mantis@${MARKETPLACE}`;
+const MARKETPLACE_REPO = 'KellisLab/mantis-cli';
+const NPM_PACKAGE = 'mantisai-cli';
+const LEGACY_NPM_PACKAGES = ['mantis-cli', 'mantis-claude-code'];
+
+export function resolvePluginRoot() {
+  try {
+    const root = execSync('npm root -g', { encoding: 'utf8', windowsHide: true }).trim();
+    for (const candidate of [NPM_PACKAGE, ...LEGACY_NPM_PACKAGES]) {
+      const globalPkg = path.join(root, candidate);
+      if (fs.existsSync(path.join(globalPkg, '.claude-plugin', 'plugin.json'))) {
+        return path.normalize(globalPkg);
+      }
+    }
+  } catch {
+    /* not installed globally */
+  }
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  return path.normalize(path.resolve(here, '..'));
+}
+
+function settingsPath() {
+  return path.join(os.homedir(), '.claude', 'settings.json');
+}
+
+function installedPluginsPath() {
+  return path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
+}
+
+function readSettings() {
+  const file = settingsPath();
+  if (!fs.existsSync(file)) return {};
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function writeSettings(settings) {
+  const file = settingsPath();
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, `${JSON.stringify(settings, null, 2)}\n`);
+}
+
+function stripBrokenInlinePlugins(settings) {
+  const bad = (v) =>
+    typeof v === 'string' &&
+    (v.includes('$(npm') || v.includes('mantis-claude-code-plugin') || v.includes('mantis-cli-plugin'));
+  if (Array.isArray(settings.plugins)) {
+    settings.plugins = settings.plugins.filter((p) => {
+      const paths = [p?.path, p?.commands, p?.source?.path].filter(Boolean);
+      return !paths.some(bad);
+    });
+    if (!settings.plugins.length) delete settings.plugins;
+  }
+}
+
+export function isPluginInstalled() {
+  try {
+    const data = JSON.parse(fs.readFileSync(installedPluginsPath(), 'utf8'));
+    const entries = data.plugins?.[PLUGIN_ID];
+    if (!Array.isArray(entries) || !entries.length) return false;
+    const installPath = entries[0]?.installPath;
+    if (!installPath || !fs.existsSync(installPath)) return false;
+    return !fs.existsSync(path.join(installPath, '.orphaned_at'));
+  } catch {
+    return false;
+  }
+}
+
+function mergeMarketplaceIntoSettings() {
+  const settings = readSettings();
+  stripBrokenInlinePlugins(settings);
+  settings.extraKnownMarketplaces = settings.extraKnownMarketplaces || {};
+  settings.extraKnownMarketplaces[MARKETPLACE] = {
+    source: { source: 'github', repo: MARKETPLACE_REPO },
+  };
+  writeSettings(settings);
+}
+
+const BENIGN = [
+  /already enabled/i,
+  /already installed/i,
+  /already on disk/i,
+  /no updates/i,
+  /is already enabled/i,
+];
+
+function quoteCmdArg(arg) {
+  return `"${String(arg).replace(/"/g, '\\"')}"`;
+}
+
+function runClaude(argv, { optional = false } = {}) {
+  const opts = { encoding: 'utf8', windowsHide: true };
+  const r = process.platform === 'win32'
+    ? spawnSync(['claude', ...argv.map(quoteCmdArg)].join(' '), { ...opts, shell: true })
+    : spawnSync('claude', argv, opts);
+  if (r.error) {
+    const msg =
+      r.error.code === 'ENOENT'
+        ? 'claude not found on PATH — install Claude Code CLI first'
+        : r.error.message;
+    if (optional) return null;
+    throw new Error(msg);
+  }
+  const out = `${r.stdout || ''}${r.stderr || ''}`.trim();
+  if (r.status === 0 || BENIGN.some((re) => re.test(out))) return out;
+  if (optional) return null;
+  throw new Error(out || `claude ${argv.join(' ')} failed (exit ${r.status})`);
+}
+
+function installPluginScopes() {
+  for (const scope of ['user', 'local']) {
+    if (isPluginInstalled()) return scope;
+    runClaude(['plugin', 'install', PLUGIN_ID, '--scope', scope], { optional: true });
+  }
+  return isPluginInstalled() ? 'user' : null;
+}
+
+export function installClaudePlugin() {
+  const pluginRoot = resolvePluginRoot();
+  mergeMarketplaceIntoSettings();
+
+  runClaude(['plugin', 'marketplace', 'add', MARKETPLACE_REPO, '--scope', 'user'], { optional: true });
+  const scope = installPluginScopes();
+  if (!scope) {
+    throw new Error(
+      'Plugin not registered after install. Run: claude plugin install mantis@mantis-plugins',
+    );
+  }
+  runClaude(['plugin', 'update', PLUGIN_ID, '--scope', scope], { optional: true });
+  runClaude(['plugin', 'enable', PLUGIN_ID, '--scope', scope], { optional: true });
+  const settings = readSettings();
+  settings.enabledPlugins = settings.enabledPlugins || {};
+  settings.enabledPlugins[PLUGIN_ID] = true;
+  writeSettings(settings);
+  syncMcpConfigs(loadConfig());
+  return { ok: true, method: 'cli', pluginRoot, scope };
+}

package/lib/codebase-csv.js

@@ -18,6 +18,8 @@ const DEFAULT_IGNORES = [
   '**/package-lock.json',
   '**/pnpm-lock.yaml',
   '**/yarn.lock',
+  '**/.DS_Store',
+  '**/Thumbs.db',
 ];
 
 const EXT_LANGUAGE = {
@@ -42,6 +44,8 @@ const EXT_LANGUAGE = {
 
 const SOURCE_EXTENSIONS = Object.keys(EXT_LANGUAGE);
 
+const NULL_BYTE = String.fromCharCode(0);
+
 function inferKind(rel) {
   const base = path.basename(rel).toLowerCase();
   if (base.includes('test') || base.includes('spec')) return 'test';
@@ -73,8 +77,27 @@ function summarize(content) {
   return (comment || lines[0] || '').replace(/^\/\/|^#|^\/\*+|^\*|<!--|-->/g, '').trim().slice(0, 240);
 }
 
+function isBinaryBuffer(buf) {
+  // Postgres JSON/text columns reject the NUL byte (0x00), and other low
+  // control bytes are a strong signal of non-text payloads (images,
+  // .DS_Store, compiled artifacts). Sniff the head of the file.
+  const sample = buf.subarray(0, Math.min(buf.length, 8192));
+  for (let i = 0; i < sample.length; i++) {
+    const b = sample[i];
+    if (b === 0) return true;
+    // allow \t (9), \n (10), \r (13); reject other C0 control bytes
+    if (b < 9 || (b > 13 && b < 32)) return true;
+  }
+  return false;
+}
+
 function readText(file, maxChars) {
-  const raw = fs.readFileSync(file, 'utf8');
+  const buf = fs.readFileSync(file);
+  if (isBinaryBuffer(buf)) return null;
+  let raw = buf.toString('utf8');
+  // belt-and-suspenders: strip any NUL chars that survived decoding,
+  // since Postgres JSON columns will reject them.
+  if (raw.indexOf(NULL_BYTE) !== -1) raw = raw.split(NULL_BYTE).join('');
   return raw.length > maxChars ? `${raw.slice(0, maxChars)}\n\n[truncated]` : raw;
 }
 
@@ -89,12 +112,18 @@ export async function createCodebaseCsv(rootDir, outFile, { maxChars = 12000, in
     onlyFiles: true,
   });
 
-  const rows = files.sort().map((file) => {
+  const skipped = [];
+  const rows = [];
+  for (const file of files.sort()) {
     const rel = path.relative(root, file).replace(/\\/g, '/');
     const ext = path.extname(file).toLowerCase();
     const content = readText(file, maxChars);
+    if (content === null) {
+      skipped.push(rel);
+      continue;
+    }
     const stat = fs.statSync(file);
-    return {
+    rows.push({
       path: rel,
       file_name: path.basename(file),
       extension: ext.replace(/^\./, ''),
@@ -105,11 +134,11 @@ export async function createCodebaseCsv(rootDir, outFile, { maxChars = 12000, in
       imports: importsFrom(content),
       summary: summarize(content),
       content,
-    };
-  });
+    });
+  }
 
   if (!rows.length) throw new Error(`No source files found in ${root}`);
   fs.mkdirSync(path.dirname(path.resolve(outFile)), { recursive: true });
   fs.writeFileSync(outFile, stringify(rows, { header: true }));
-  return { root, outFile: path.resolve(outFile), count: rows.length };
+  return { root, outFile: path.resolve(outFile), count: rows.length, skipped };
 }

package/lib/map-create.js

@@ -22,9 +22,29 @@ function boolOption(value, fallback = false) {
   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) {
-  const root = normalizeBaseUrl(baseUrl).replace(/\/api\/?$/, '');
-  return `${root}/space/${spaceId}`;
+  return `${frontendBaseUrl(baseUrl)}/space/${spaceId}`;
 }
 
 async function chooseExistingSpace(cfg, filter = '') {

package/lib/mcp-config.js

@@ -1,50 +1,50 @@
-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);
-  }
-}
+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/space-id.js

@@ -1,13 +1,13 @@
-const UUID_RE =
-  /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i;
-
-/** Extract space UUID from a Mantis URL (/space/{id}), raw UUID, or search text containing one. */
-export function parseSpaceIdFromInput(text) {
-  const t = (text || '').trim();
-  if (!t) return null;
-  const pathMatch = t.match(/\/space\/([0-9a-f-]{36})/i);
-  if (pathMatch) return pathMatch[1].toLowerCase();
-  const uuidMatch = t.match(UUID_RE);
-  if (uuidMatch) return uuidMatch[0].toLowerCase();
-  return null;
-}
+const UUID_RE =
+  /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i;
+
+/** Extract space UUID from a Mantis URL (/space/{id}), raw UUID, or search text containing one. */
+export function parseSpaceIdFromInput(text) {
+  const t = (text || '').trim();
+  if (!t) return null;
+  const pathMatch = t.match(/\/space\/([0-9a-f-]{36})/i);
+  if (pathMatch) return pathMatch[1].toLowerCase();
+  const uuidMatch = t.match(UUID_RE);
+  if (uuidMatch) return uuidMatch[0].toLowerCase();
+  return null;
+}

package/lib/spaces.js

@@ -1,48 +1,48 @@
-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,
-  };
-}
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mantisai-cli",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Mantis developer CLI — create maps, manage spaces and threads, configure Claude Code, and connect agents to Mantis MCP.",
   "type": "module",
   "license": "MIT",