@cachly-dev/mcp-server 0.10.64 → 0.10.66

package/src/handlers/instances.ts

@@ -1,180 +0,0 @@
-import type { Redis } from 'ioredis';
-import type { Instance } from './brain.js';
-
-interface CreateResponse {
-  instance_id: string;
-  checkout_url?: string;
-  status: string;
-}
-
-type GetConnection = (instanceId: string) => Promise<Redis>;
-type ApiFetch = <T>(path: string, options?: RequestInit) => Promise<T>;
-
-export const INSTANCE_TOOL_NAMES = new Set([
-  'list_instances', 'create_instance', 'get_instance', 'get_connection_string', 'delete_instance',
-  'list_orgs', 'create_org', 'invite_member', 'get_org_plan',
-]);
-
-function formatInstance(inst: Instance): string {
-  const badge = inst.status === 'running' ? '🟢' : inst.status === 'provisioning' ? '🟡' : '🔴';
-  const mb = inst.memory_mb >= 1024 ? `${inst.memory_mb / 1024}GB` : `${inst.memory_mb}MB`;
-  return `${badge} **${inst.name}** (\`${inst.id}\`) · ${inst.tier} · ${mb} · ${inst.region}`;
-}
-
-function buildConnectionString(inst: Instance): string {
-  if (!inst.host) return '❌ Instance not ready yet.';
-  const proto = inst.tls_enabled ? 'rediss' : 'redis';
-  const auth = inst.password ? `:${inst.password}@` : '';
-  return `${proto}://${auth}${inst.host}:${inst.port ?? 6379}`;
-}
-
-export async function handleInstanceTool(
-  name: string,
-  args: Record<string, unknown>,
-  getConnection: GetConnection,
-  apiFetch: ApiFetch,
-): Promise<string | null> {
-  switch (name) {
-    case 'list_instances': {
-      const res = await apiFetch<{ data: Instance[] }>('/api/v1/instances');
-      const instances = res.data ?? [];
-      if (instances.length === 0)
-        return 'You have no cache instances yet. Use `create_instance` to create one.';
-      return [`Found ${instances.length} instance(s):\n`, ...instances.map(formatInstance)].join('\n');
-    }
-
-    case 'create_instance': {
-      const { name: instName, tier } = args as { name: string; tier: string };
-      const res = await apiFetch<CreateResponse>('/api/v1/instances', {
-        method: 'POST',
-        body: JSON.stringify({ name: instName, tier, created_via: 'api' }),
-      });
-      if (res.checkout_url) {
-        return [
-          `✅ Instance **${instName}** (${tier}) created! ID: \`${res.instance_id}\``,
-          ``,
-          `💳 This is a paid tier. Complete payment to activate:`,
-          `   ${res.checkout_url}`,
-          ``,
-          `After payment, provisioning starts automatically (~30 seconds).`,
-        ].join('\n');
-      }
-      return [
-        `✅ Instance **${instName}** (${tier}) created and provisioning started!`,
-        `   ID: \`${res.instance_id}\``,
-        `   Status: ${res.status}`,
-        ``,
-        `Use \`get_instance\` or \`get_connection_string\` to get your connection details.`,
-      ].join('\n');
-    }
-
-    case 'get_instance': {
-      const inst = await apiFetch<Instance>(`/api/v1/instances/${(args as { instance_id: string }).instance_id}`);
-      return formatInstance(inst);
-    }
-
-    case 'get_connection_string': {
-      const inst = await apiFetch<Instance>(`/api/v1/instances/${(args as { instance_id: string }).instance_id}`);
-      if (inst.status !== 'running') {
-        return `Instance is not running yet (status: ${inst.status}). Provisioning takes ~30 seconds after payment.`;
-      }
-      const connStr = buildConnectionString(inst);
-      return [
-        `**Connection string for ${inst.name}:**`,
-        `\`\`\``,
-        connStr,
-        `\`\`\``,
-        ``,
-        `**Environment variable:**`,
-        `\`\`\`bash`,
-        `REDIS_URL="${connStr}"`,
-        `CACHLY_URL="${connStr}"`,
-        `\`\`\``,
-        ``,
-        `**Quick test:**`,
-        `\`\`\`bash`,
-        `redis-cli -u "${connStr}" PING`,
-        `\`\`\``,
-      ].join('\n');
-    }
-
-    case 'delete_instance': {
-      const { instance_id, confirm } = args as { instance_id: string; confirm: boolean };
-      if (!confirm) return 'Deletion cancelled. Set `confirm: true` to proceed.';
-      // Clean up cached connection (best-effort; connection times out otherwise)
-      try { (getConnection as unknown as { _pool?: Map<string, unknown> })._pool?.delete?.(instance_id); } catch { /* ignore */ }
-      await apiFetch(`/api/v1/instances/${instance_id}`, { method: 'DELETE' });
-      return `✅ Instance \`${instance_id}\` has been deleted and all data removed.`;
-    }
-
-    // ── Org / Team management ────────────────────────────────────────────
-    case 'list_orgs': {
-      const res = await apiFetch<{ orgs: Array<{ id: string; name: string; slug: string; plan: string; max_members: number; member_count?: number }> }>('/api/v1/orgs');
-      const orgs = res.orgs ?? [];
-      if (orgs.length === 0) return `📭 No organizations yet.\n\nCreate one with \`create_org(name="My Team")\`.\nOrg plans: Team €99/mo (10 seats), Business €299/mo (50 seats), Enterprise custom.`;
-      return [
-        `🏢 **Your organizations (${orgs.length})**\n`,
-        ...orgs.map(o => `• **${o.name}** (\`${o.slug}\`) — plan: ${o.plan} · seats: ${o.member_count ?? '?'}/${o.max_members}\n  ID: \`${o.id}\``),
-        `\n_Manage: \`get_org_plan\`, \`invite_member\`, dashboard → /team_`,
-      ].join('\n');
-    }
-
-    case 'create_org': {
-      const { name: orgName, slug } = args as { name: string; slug?: string };
-      const body: Record<string, string> = { name: orgName };
-      if (slug) body.slug = slug;
-      const res = await apiFetch<{ id: string; name: string; slug: string; plan: string }>('/api/v1/orgs', {
-        method: 'POST',
-        body: JSON.stringify(body),
-      });
-      return [
-        `✅ **Organization created:** ${res.name}`,
-        `   ID: \`${res.id}\` · Slug: \`${res.slug}\` · Plan: ${res.plan}`,
-        ``,
-        `**Next steps:**`,
-        `1. Invite team members: \`invite_member(org_id="${res.id}", email="dev@example.com")\``,
-        `2. Upgrade plan: open billing portal via dashboard → /team`,
-        `   Team: €99/mo (10 seats) · Business: €299/mo (50 seats)`,
-      ].join('\n');
-    }
-
-    case 'invite_member': {
-      const { org_id, email, role = 'member' } = args as { org_id: string; email: string; role?: string };
-      await apiFetch(`/api/v1/orgs/${org_id}/members`, {
-        method: 'POST',
-        body: JSON.stringify({ email, role }),
-      });
-      return `✅ Invite sent to **${email}** as \`${role}\` in org \`${org_id}\`.\n\nThey will receive an email to join the organization.`;
-    }
-
-    case 'get_org_plan': {
-      const { org_id } = args as { org_id: string };
-      const org = await apiFetch<{
-        id: string; name: string; plan: string; max_members: number;
-        members: Array<{ role: string; invite_email: string; accepted_at?: string }>;
-        stripe_customer_id?: string;
-      }>(`/api/v1/orgs/${org_id}`);
-      const accepted = (org.members ?? []).filter(m => m.accepted_at).length;
-      const pending = (org.members ?? []).filter(m => !m.accepted_at).length;
-      const planPrice: Record<string, string> = { free: '€0', team: '€99/mo', business: '€299/mo', enterprise: 'custom' };
-      return [
-        `🏢 **${org.name}** — Plan: **${org.plan}** (${planPrice[org.plan] ?? org.plan})`,
-        `   Seats: ${accepted} active + ${pending} pending / ${org.max_members} max`,
-        ``,
-        `**Members:**`,
-        ...(org.members ?? []).map(m => `  • ${m.invite_email} (${m.role})${m.accepted_at ? '' : ' — pending'}`),
-        ``,
-        org.stripe_customer_id
-          ? `💳 Billing: managed via Stripe. Upgrade/cancel: dashboard → /billing`
-          : `💳 No payment method yet. Upgrade: dashboard → /billing → Team Plans`,
-      ].join('\n');
-    }
-
-    // ── Live cache operations ────────────────────────────────────────────
-
-    default:
-      return null;
-  }
-}
-
-export { formatInstance, buildConnectionString };

package/src/handlers/roadmap.ts

@@ -1,201 +0,0 @@
-import type { Redis } from 'ioredis';
-import { safeJsonParse } from '../utils.js';
-
-type GetConnection = (instanceId: string) => Promise<Redis>;
-type ApiFetch = <T>(path: string, options?: RequestInit) => Promise<T>;
-
-export const ROADMAP_TOOL_NAMES = new Set([
-  'roadmap_add', 'roadmap_update', 'roadmap_list', 'roadmap_next',
-]);
-
-export async function handleRoadmapTool(
-  name: string,
-  args: Record<string, unknown>,
-  getConnection: GetConnection,
-  _apiFetch: ApiFetch,
-): Promise<string | null> {
-  switch (name) {
-    case 'roadmap_add': {
-      const {
-        instance_id: rid,
-        title,
-        description: desc = '',
-        priority = 'medium',
-        tags: rtags = [],
-        milestone = '',
-      } = args as {
-        instance_id: string; title: string; description?: string;
-        priority?: string; tags?: string[]; milestone?: string;
-      };
-      const redis = await getConnection(rid);
-      const id = `rm_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
-      const item = {
-        id, title, description: desc, priority, tags: rtags, milestone,
-        status: 'planned',
-        created: new Date().toISOString(),
-        updated: new Date().toISOString(),
-        notes: '',
-      };
-      await redis.hset(`cachly:roadmap:${rid}`, id, JSON.stringify(item));
-      const PRIORITY_ICON: Record<string, string> = { critical: '🔴', high: '🟠', medium: '🟡', low: '🔵' };
-      return [
-        `📋 **Roadmap item added**`,
-        ``,
-        `  ID:       \`${id}\``,
-        `  Title:    ${title}`,
-        `  Priority: ${PRIORITY_ICON[priority] ?? '⚪'} ${priority}`,
-        `  Status:   planned`,
-        milestone ? `  Milestone: ${milestone}` : '',
-        rtags.length ? `  Tags:     ${rtags.join(', ')}` : '',
-        ``,
-        `💡 Use \`roadmap_update(id: "${id}", status: "in-progress")\` when you start working on it.`,
-      ].filter(Boolean).join('\n');
-    }
-
-    case 'roadmap_update': {
-      const {
-        instance_id: rid,
-        id: itemId,
-        status: newStatus,
-        priority: newPriority,
-        notes: newNotes,
-        title: newTitle,
-        description: newDesc,
-      } = args as {
-        instance_id: string; id: string; status?: string; priority?: string;
-        notes?: string; title?: string; description?: string;
-      };
-      const redis = await getConnection(rid);
-      const raw = await redis.hget(`cachly:roadmap:${rid}`, itemId);
-      if (!raw) return `⚠️ **roadmap_update** – Item \`${itemId}\` not found. Use \`roadmap_list\` to see all items.`;
-      const item = safeJsonParse<Record<string, unknown> | null>(raw, null);
-      if (!item) return `⚠️ **roadmap_update** – Item \`${itemId}\` data is corrupted. Re-add with \`roadmap_add\`.`;
-      const oldStatus = item.status as string;
-      if (newStatus) item.status = newStatus;
-      if (newPriority) item.priority = newPriority;
-      if (newTitle) item.title = newTitle;
-      if (newDesc) item.description = newDesc;
-      if (newNotes) item.notes = item.notes ? `${item.notes}\n[${new Date().toISOString().slice(0, 10)}] ${newNotes}` : `[${new Date().toISOString().slice(0, 10)}] ${newNotes}`;
-      item.updated = new Date().toISOString();
-      await redis.hset(`cachly:roadmap:${rid}`, itemId, JSON.stringify(item));
-      const statusEmoji: Record<string, string> = { planned: '📋', 'in-progress': '⚡', done: '✅', blocked: '🚫', cancelled: '🗑️' };
-      return [
-        `${statusEmoji[newStatus ?? oldStatus] ?? '📋'} **Roadmap updated** \`${itemId}\``,
-        ``,
-        `  Title:  ${item.title}`,
-        oldStatus !== newStatus ? `  Status: ${oldStatus} → ${newStatus}` : `  Status: ${item.status}`,
-        newNotes ? `  Notes:  ${newNotes}` : '',
-      ].filter(Boolean).join('\n');
-    }
-
-    case 'roadmap_list': {
-      const {
-        instance_id: rid,
-        status: filterStatus = 'open',
-        tag: filterTag,
-        milestone: filterMilestone,
-        priority: filterPriority,
-      } = args as {
-        instance_id: string; status?: string; tag?: string;
-        milestone?: string; priority?: string;
-      };
-      const redis = await getConnection(rid);
-      const all = await redis.hgetall(`cachly:roadmap:${rid}`);
-      if (!all || Object.keys(all).length === 0) {
-        return '📋 **Roadmap is empty.**\n\nUse `roadmap_add` to create your first item.';
-      }
-      const PRIORITY_ORDER: Record<string, number> = { critical: 0, high: 1, medium: 2, low: 3 };
-      const PRIORITY_ICON: Record<string, string> = { critical: '🔴', high: '🟠', medium: '🟡', low: '🔵' };
-      const STATUS_ICON: Record<string, string> = { planned: '📋', 'in-progress': '⚡', done: '✅', blocked: '🚫', cancelled: '🗑️' };
-      const openStatuses = new Set(['planned', 'in-progress', 'blocked']);
-      let items = Object.values(all).flatMap(v => {
-        const item = safeJsonParse<Record<string, string | string[]> | null>(v as string, null);
-        return item ? [item] : [];
-      });
-      // Filter
-      if (filterStatus === 'open') items = items.filter(i => openStatuses.has(i.status as string));
-      else if (filterStatus) items = items.filter(i => i.status === filterStatus);
-      if (filterTag) items = items.filter(i => (i.tags as string[]).includes(filterTag));
-      if (filterMilestone) items = items.filter(i => i.milestone === filterMilestone);
-      if (filterPriority) items = items.filter(i => (PRIORITY_ORDER[i.priority as string] ?? 99) <= (PRIORITY_ORDER[filterPriority] ?? 99));
-      // Sort: priority asc, then created asc
-      items.sort((a, b) => {
-        const pa = PRIORITY_ORDER[a.priority as string] ?? 99;
-        const pb = PRIORITY_ORDER[b.priority as string] ?? 99;
-        return pa !== pb ? pa - pb : (a.created as string).localeCompare(b.created as string);
-      });
-      if (items.length === 0) return `📋 **No roadmap items** match the current filter (status: ${filterStatus}).`;
-      const grouped: Record<string, typeof items> = {};
-      for (const it of items) {
-        const st = it.status as string;
-        if (!grouped[st]) grouped[st] = [];
-        grouped[st].push(it);
-      }
-      const lines: string[] = [`📋 **Roadmap** (${items.length} item${items.length !== 1 ? 's' : ''})`, ''];
-      for (const [st, grp] of Object.entries(grouped)) {
-        lines.push(`**${STATUS_ICON[st] ?? '•'} ${st.toUpperCase()}** (${grp.length})`);
-        for (const it of grp) {
-          const tags = (it.tags as string[]).length ? ` [${(it.tags as string[]).join(', ')}]` : '';
-          const milestone = it.milestone ? ` · ${it.milestone}` : '';
-          lines.push(`  ${PRIORITY_ICON[it.priority as string] ?? '⚪'} \`${it.id}\` **${it.title}**${tags}${milestone}`);
-          if (it.description) lines.push(`      ${(it.description as string).slice(0, 120)}`);
-          if (it.notes) lines.push(`      📝 ${(it.notes as string).split('\n').pop()?.slice(0, 100)}`);
-        }
-        lines.push('');
-      }
-      lines.push(`💡 \`roadmap_update(id, status: "in-progress")\` to start · \`roadmap_next\` for top priority item`);
-      return lines.join('\n');
-    }
-
-    case 'roadmap_next': {
-      const { instance_id: rid, tag: filterTag } = args as { instance_id: string; tag?: string };
-      const redis = await getConnection(rid);
-      const all = await redis.hgetall(`cachly:roadmap:${rid}`);
-      if (!all || Object.keys(all).length === 0) {
-        return '📋 **Roadmap is empty.** Use `roadmap_add` to plan your first task.';
-      }
-      const PRIORITY_ORDER: Record<string, number> = { critical: 0, high: 1, medium: 2, low: 3 };
-      const PRIORITY_ICON: Record<string, string> = { critical: '🔴', high: '🟠', medium: '🟡', low: '🔵' };
-      const items = Object.values(all)
-        .flatMap(v => {
-          const item = safeJsonParse<Record<string, unknown> | null>(v as string, null);
-          return item ? [item] : [];
-        })
-        .filter(i => i.status === 'in-progress' || i.status === 'planned')
-        .filter(i => !filterTag || (Array.isArray(i.tags) ? i.tags : []).includes(filterTag));
-      if (items.length === 0) return '🎉 **No open roadmap items!** All tasks are done (or use `roadmap_list` to check).';
-      // in-progress first, then by priority
-      items.sort((a, b) => {
-        if (a.status === 'in-progress' && b.status !== 'in-progress') return -1;
-        if (b.status === 'in-progress' && a.status !== 'in-progress') return 1;
-        return (PRIORITY_ORDER[a.priority as string] ?? 99) - (PRIORITY_ORDER[b.priority as string] ?? 99);
-      });
-      const next = items[0];
-      const remaining = items.length - 1;
-      const nextTags = Array.isArray(next.tags) ? next.tags as string[] : [];
-      const tags = nextTags.length ? `\nTags:      ${nextTags.join(', ')}` : '';
-      const milestone = next.milestone ? `\nMilestone: ${next.milestone}` : '';
-      const notes = next.notes ? `\nNotes:     ${(next.notes as string).split('\n').pop()?.slice(0, 120)}` : '';
-      return [
-        `${next.status === 'in-progress' ? '⚡' : '📋'} **Next up: ${next.title}**`,
-        ``,
-        `ID:        \`${next.id}\``,
-        `Priority:  ${PRIORITY_ICON[next.priority as string] ?? '⚪'} ${next.priority}`,
-        `Status:    ${next.status}`,
-        next.description ? `\nWhat to do:\n${next.description}` : '',
-        tags, milestone, notes,
-        ``,
-        remaining > 0 ? `(+${remaining} more open item${remaining !== 1 ? 's' : ''} in roadmap)` : '(last open item)',
-        ``,
-        next.status === 'planned'
-          ? `💡 Start with: \`roadmap_update(id: "${next.id}", status: "in-progress")\``
-          : `💡 Finish with: \`roadmap_update(id: "${next.id}", status: "done", notes: "...")\``,
-      ].filter(s => s !== undefined).join('\n');
-    }
-
-    // ── v0.6 Cognitive Cache: memory_consolidate ─────────────────────────────
-
-    default:
-      return null;
-  }
-}