@gmickel/gno 0.3.0

package/src/cli/commands/mcp/uninstall.ts

@@ -0,0 +1,158 @@
+/**
+ * Uninstall gno MCP server from client configurations.
+ *
+ * @module src/cli/commands/mcp/uninstall
+ */
+
+import { CliError } from '../../errors.js';
+import { getGlobals } from '../../program.js';
+import {
+  type AnyMcpConfig,
+  isYamlFormat,
+  readMcpConfig,
+  removeServerEntry,
+  writeMcpConfig,
+} from './config.js';
+import {
+  getTargetDisplayName,
+  MCP_SERVER_NAME,
+  type McpScope,
+  type McpTarget,
+  resolveMcpConfigPath,
+  TARGETS_WITH_PROJECT_SCOPE,
+} from './paths.js';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface UninstallOptions {
+  target?: McpTarget;
+  scope?: McpScope;
+  /** Override cwd (testing) */
+  cwd?: string;
+  /** Override home dir (testing) */
+  homeDir?: string;
+  /** JSON output */
+  json?: boolean;
+  /** Quiet mode */
+  quiet?: boolean;
+}
+
+interface UninstallResult {
+  target: McpTarget;
+  scope: McpScope;
+  configPath: string;
+  action: 'removed' | 'not_found';
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Uninstall Logic
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Uninstall gno from a single target.
+ */
+async function uninstallFromTarget(
+  target: McpTarget,
+  scope: McpScope,
+  options: { cwd?: string; homeDir?: string }
+): Promise<UninstallResult> {
+  const { cwd, homeDir } = options;
+
+  const { configPath, configFormat } = resolveMcpConfigPath({
+    target,
+    scope,
+    cwd,
+    homeDir,
+  });
+
+  const useYaml = isYamlFormat(configFormat);
+  const config = await readMcpConfig(configPath, {
+    returnNullOnMissing: true,
+    yaml: useYaml,
+  });
+
+  // File doesn't exist
+  if (config === null) {
+    return { target, scope, configPath, action: 'not_found' };
+  }
+
+  // Try to remove entry using format-aware helper
+  const removed = removeServerEntry(
+    config as AnyMcpConfig,
+    MCP_SERVER_NAME,
+    configFormat
+  );
+
+  if (!removed) {
+    return { target, scope, configPath, action: 'not_found' };
+  }
+
+  // Write back
+  await writeMcpConfig(configPath, config as AnyMcpConfig, { yaml: useYaml });
+
+  return { target, scope, configPath, action: 'removed' };
+}
+
+/**
+ * Get globals safely.
+ */
+function safeGetGlobals(): { json: boolean; quiet: boolean } {
+  try {
+    return getGlobals();
+  } catch {
+    return { json: false, quiet: false };
+  }
+}
+
+/**
+ * Uninstall gno MCP server.
+ */
+export async function uninstallMcp(opts: UninstallOptions = {}): Promise<void> {
+  const target = opts.target ?? 'claude-desktop';
+  const scope = opts.scope ?? 'user';
+  const globals = safeGetGlobals();
+  const json = opts.json ?? globals.json;
+  const quiet = opts.quiet ?? globals.quiet;
+
+  // Validate scope - only some targets support project scope
+  if (scope === 'project' && !TARGETS_WITH_PROJECT_SCOPE.includes(target)) {
+    throw new CliError(
+      'VALIDATION',
+      `${getTargetDisplayName(target)} does not support project scope.`
+    );
+  }
+
+  const result = await uninstallFromTarget(target, scope, {
+    cwd: opts.cwd,
+    homeDir: opts.homeDir,
+  });
+
+  // Output
+  if (json) {
+    process.stdout.write(
+      `${JSON.stringify({ uninstalled: result }, null, 2)}\n`
+    );
+    return;
+  }
+
+  if (quiet) {
+    return;
+  }
+
+  if (result.action === 'not_found') {
+    process.stdout.write(
+      `gno is not configured in ${getTargetDisplayName(target)}.\n`
+    );
+    return;
+  }
+
+  process.stdout.write(
+    `Removed gno MCP server from ${getTargetDisplayName(target)}.\n`
+  );
+  process.stdout.write(`  Config: ${result.configPath}\n\n`);
+  process.stdout.write(
+    `Restart ${getTargetDisplayName(target)} to apply changes.\n`
+  );
+}

package/src/cli/commands/mcp.ts

@@ -0,0 +1,20 @@
+/**
+ * MCP command - starts MCP server on stdio transport.
+ *
+ * @module src/cli/commands/mcp
+ */
+
+import type { GlobalOptions } from '../context';
+
+/**
+ * Start the MCP server.
+ * Reads global options for --index and --config flags.
+ */
+export async function mcpCommand(options: GlobalOptions): Promise<void> {
+  const { startMcpServer } = await import('../../mcp/server.js');
+  await startMcpServer({
+    indexName: options.index,
+    configPath: options.config,
+    verbose: options.verbose,
+  });
+}

package/src/cli/commands/models/clear.ts

@@ -0,0 +1,103 @@
+/**
+ * gno models clear command implementation.
+ * Remove cached models.
+ *
+ * @module src/cli/commands/models/clear
+ */
+
+import { getModelsCachePath } from '../../../app/constants';
+import { ModelCache } from '../../../llm/cache';
+import type { ModelType } from '../../../llm/types';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface ModelsClearOptions {
+  /** Clear all models */
+  all?: boolean;
+  /** Clear embedding model */
+  embed?: boolean;
+  /** Clear reranker model */
+  rerank?: boolean;
+  /** Clear generation model */
+  gen?: boolean;
+  /** Skip confirmation */
+  yes?: boolean;
+}
+
+export interface ModelsClearResult {
+  cleared: ModelType[];
+  sizeBefore: number;
+  sizeAfter: number;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Execute gno models clear command.
+ */
+export async function modelsClear(
+  options: ModelsClearOptions = {}
+): Promise<ModelsClearResult> {
+  const cache = new ModelCache(getModelsCachePath());
+
+  // Determine which models to clear
+  let types: ModelType[] | undefined;
+
+  if (options.all) {
+    types = undefined; // Clear all
+  } else if (options.embed || options.rerank || options.gen) {
+    types = [];
+    if (options.embed) {
+      types.push('embed');
+    }
+    if (options.rerank) {
+      types.push('rerank');
+    }
+    if (options.gen) {
+      types.push('gen');
+    }
+  } else {
+    // Default: clear all
+    types = undefined;
+  }
+
+  const sizeBefore = await cache.totalSize();
+  await cache.clear(types);
+  const sizeAfter = await cache.totalSize();
+
+  return {
+    cleared: types ?? ['embed', 'rerank', 'gen'],
+    sizeBefore,
+    sizeAfter,
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Formatting
+// ─────────────────────────────────────────────────────────────────────────────
+
+function formatBytes(bytes: number): string {
+  if (bytes === 0) {
+    return '0 B';
+  }
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB', 'GB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / k ** i).toFixed(1)} ${sizes[i]}`;
+}
+
+/**
+ * Format models clear result for output.
+ */
+export function formatModelsClear(result: ModelsClearResult): string {
+  const lines: string[] = [];
+
+  lines.push(`Cleared: ${result.cleared.join(', ')}`);
+  lines.push(`Freed: ${formatBytes(result.sizeBefore - result.sizeAfter)}`);
+
+  return lines.join('\n');
+}

package/src/cli/commands/models/index.ts

@@ -0,0 +1,32 @@
+/**
+ * Models commands public API.
+ *
+ * @module src/cli/commands/models
+ */
+
+export {
+  formatModelsClear,
+  type ModelsClearOptions,
+  type ModelsClearResult,
+  modelsClear,
+} from './clear';
+export {
+  formatModelsList,
+  type ModelsListOptions,
+  type ModelsListResult,
+  modelsList,
+} from './list';
+export {
+  formatModelsPath,
+  type ModelsPathOptions,
+  type ModelsPathResult,
+  modelsPath,
+} from './path';
+export {
+  createProgressRenderer,
+  formatModelsPull,
+  type ModelPullResult,
+  type ModelsPullOptions,
+  type ModelsPullResult,
+  modelsPull,
+} from './pull';

package/src/cli/commands/models/list.ts

@@ -0,0 +1,214 @@
+/**
+ * gno models list command implementation.
+ * List configured and available models.
+ *
+ * @module src/cli/commands/models/list
+ */
+
+import { getModelsCachePath } from '../../../app/constants';
+import { loadConfig } from '../../../config';
+import { ModelCache } from '../../../llm/cache';
+import { getActivePreset } from '../../../llm/registry';
+import type { ModelStatus } from '../../../llm/types';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface ModelsListOptions {
+  /** Override config path */
+  configPath?: string;
+  /** Output as JSON */
+  json?: boolean;
+  /** Output as Markdown */
+  md?: boolean;
+}
+
+export interface PresetInfo {
+  id: string;
+  name: string;
+  active: boolean;
+}
+
+export interface ModelsListResult {
+  activePreset: string;
+  presets: PresetInfo[];
+  embed: ModelStatus;
+  rerank: ModelStatus;
+  gen: ModelStatus;
+  cacheDir: string;
+  totalSize: number;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function getModelStatus(
+  cache: ModelCache,
+  uri: string
+): Promise<ModelStatus> {
+  const cached = await cache.getCachedPath(uri);
+  if (cached) {
+    const entries = await cache.list();
+    const entry = entries.find((e) => e.uri === uri);
+    return {
+      uri,
+      cached: true,
+      path: cached,
+      size: entry?.size,
+    };
+  }
+  return {
+    uri,
+    cached: false,
+    path: null,
+  };
+}
+
+/**
+ * Execute gno models list command.
+ */
+export async function modelsList(
+  options: ModelsListOptions = {}
+): Promise<ModelsListResult> {
+  // Load config (use defaults if not initialized)
+  const { createDefaultConfig } = await import('../../../config');
+  const { getModelConfig, listPresets } = await import('../../../llm/registry');
+  const configResult = await loadConfig(options.configPath);
+  const config = configResult.ok ? configResult.value : createDefaultConfig();
+
+  const modelConfig = getModelConfig(config);
+  const allPresets = listPresets(config);
+  const preset = getActivePreset(config);
+  const cache = new ModelCache(getModelsCachePath());
+
+  const [embed, rerank, gen] = await Promise.all([
+    getModelStatus(cache, preset.embed),
+    getModelStatus(cache, preset.rerank),
+    getModelStatus(cache, preset.gen),
+  ]);
+
+  return {
+    activePreset: modelConfig.activePreset,
+    presets: allPresets.map((p) => ({
+      id: p.id,
+      name: p.name,
+      active: p.id === modelConfig.activePreset,
+    })),
+    embed,
+    rerank,
+    gen,
+    cacheDir: cache.dir,
+    totalSize: await cache.totalSize(),
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Formatting
+// ─────────────────────────────────────────────────────────────────────────────
+
+function formatBytes(bytes: number): string {
+  if (bytes === 0) {
+    return '0 B';
+  }
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+  const i = Math.min(
+    Math.floor(Math.log(bytes) / Math.log(k)),
+    sizes.length - 1
+  );
+  return `${(bytes / k ** i).toFixed(1)} ${sizes[i]}`;
+}
+
+function formatTerminal(result: ModelsListResult): string {
+  const lines: string[] = [];
+
+  // Show presets
+  lines.push('Presets:');
+  for (const p of result.presets) {
+    const marker = p.active ? '>' : ' ';
+    lines.push(`  ${marker} ${p.id}: ${p.name}`);
+  }
+  lines.push('');
+
+  // Show models for active preset
+  lines.push(`Models (${result.activePreset}):`);
+
+  const statusIcon = (s: ModelStatus) => (s.cached ? '✓' : '✗');
+
+  lines.push(
+    `  embed:  ${statusIcon(result.embed)} ${result.embed.uri}` +
+      (result.embed.size ? ` (${formatBytes(result.embed.size)})` : '')
+  );
+  lines.push(
+    `  rerank: ${statusIcon(result.rerank)} ${result.rerank.uri}` +
+      (result.rerank.size ? ` (${formatBytes(result.rerank.size)})` : '')
+  );
+  lines.push(
+    `  gen:    ${statusIcon(result.gen)} ${result.gen.uri}` +
+      (result.gen.size ? ` (${formatBytes(result.gen.size)})` : '')
+  );
+
+  lines.push('');
+  lines.push(`Cache: ${result.cacheDir}`);
+  lines.push(`Total size: ${formatBytes(result.totalSize)}`);
+
+  const allCached =
+    result.embed.cached && result.rerank.cached && result.gen.cached;
+  if (!allCached) {
+    lines.push('');
+    lines.push('Run: gno models pull --all');
+  }
+
+  lines.push('');
+  lines.push('Switch preset: gno models use <preset>');
+
+  return lines.join('\n');
+}
+
+function formatMarkdown(result: ModelsListResult): string {
+  const lines: string[] = [];
+
+  lines.push('# Models');
+  lines.push('');
+  lines.push('| Type | URI | Cached | Size |');
+  lines.push('|------|-----|--------|------|');
+
+  const status = (s: ModelStatus) => (s.cached ? '✓' : '✗');
+  const size = (s: ModelStatus) => (s.size ? formatBytes(s.size) : '-');
+
+  lines.push(
+    `| embed | ${result.embed.uri} | ${status(result.embed)} | ${size(result.embed)} |`
+  );
+  lines.push(
+    `| rerank | ${result.rerank.uri} | ${status(result.rerank)} | ${size(result.rerank)} |`
+  );
+  lines.push(
+    `| gen | ${result.gen.uri} | ${status(result.gen)} | ${size(result.gen)} |`
+  );
+
+  lines.push('');
+  lines.push(`**Cache**: ${result.cacheDir}`);
+  lines.push(`**Total size**: ${formatBytes(result.totalSize)}`);
+
+  return lines.join('\n');
+}
+
+/**
+ * Format models list result for output.
+ */
+export function formatModelsList(
+  result: ModelsListResult,
+  options: ModelsListOptions
+): string {
+  if (options.json) {
+    return JSON.stringify(result, null, 2);
+  }
+
+  if (options.md) {
+    return formatMarkdown(result);
+  }
+
+  return formatTerminal(result);
+}

package/src/cli/commands/models/path.ts

@@ -0,0 +1,51 @@
+/**
+ * gno models path command implementation.
+ * Print model cache directory.
+ *
+ * @module src/cli/commands/models/path
+ */
+
+import { getModelsCachePath } from '../../../app/constants';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface ModelsPathOptions {
+  /** Output as JSON */
+  json?: boolean;
+}
+
+export interface ModelsPathResult {
+  path: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Execute gno models path command.
+ */
+export function modelsPath(): ModelsPathResult {
+  return {
+    path: getModelsCachePath(),
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Formatting
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Format models path result for output.
+ */
+export function formatModelsPath(
+  result: ModelsPathResult,
+  options: ModelsPathOptions
+): string {
+  if (options.json) {
+    return JSON.stringify(result, null, 2);
+  }
+  return result.path;
+}