@astramindapp/mcp-server 0.17.0 → 0.18.0

package/dist/server.js

@@ -453,7 +453,7 @@ function createMindMcpServer(client) {
     // ─── mind_life ──────────────────────────────────────────
     // Read/write goals, projects, tasks, calendar events, stats.
     // Enhanced: calendar CRUD, stats, move, get.
-    server.tool("mind_life", "Manage goals, projects, tasks, and calendar events in MIND Life. Use for tracking work, creating action items, updating progress, completing tasks, managing calendar, and viewing stats.", {
+    server.tool("mind_life", "Manage Focus → Project → Outcome hierarchy + calendar in MIND Life. Items are either projects (top-level domain/client buckets that live inside a Focus) or outcomes (deliverables that live under a parent project). Use `item_type` + `parent_id` + `focus_id` on create/update to wire the hierarchy. Use list filters (item_type, parent_id, focus_id, top_level_only) to slice the board.", {
         action: zod_1.z
             .enum([
             "list", "create", "update", "complete", "delete", "bulk_delete", "move", "get",
@@ -484,17 +484,61 @@ function createMindMcpServer(client) {
             .optional()
             .describe("Left-border color stripe on the board card. Use to group items (e.g. Astra=red, Atlas=blue)."),
         target_date: zod_1.z.string().optional().describe("Target completion date in YYYY-MM-DD format — when the project should be done. Powers the countdown badge on the card."),
-    }, async ({ action, title, description, status, priority, due_date, item_id, item_ids, start_time, end_time, event_id, all_day, tags, color, target_date }) => {
+        item_type: zod_1.z
+            .enum(["project", "outcome"])
+            .optional()
+            .describe("'project' (top-level domain/client bucket; lives inside a Focus) or 'outcome' (deliverable under a parent project). Defaults to 'outcome' on create. Pass on list to filter."),
+        parent_id: zod_1.z
+            .string()
+            .optional()
+            .describe("For outcomes — the item_id of the parent project. Pass empty string on update to detach (make top-level). On list, pass an item_id to fetch its outcomes, or 'none' for items with no parent."),
+        focus_id: zod_1.z
+            .string()
+            .optional()
+            .describe("For projects — the focus_id this project belongs to. Pass empty string on update to detach (No Focus). On list, pass a focus_id to filter to that focus, or 'none' for unfiled projects."),
+        agent_ids: zod_1.z.array(zod_1.z.string()).optional().describe("Agents bound to this project (project only). On update, REPLACES the existing list."),
+        workflow_ids: zod_1.z.array(zod_1.z.string()).optional().describe("Workflows bound to this project (project only). On update, REPLACES the existing list."),
+        top_level_only: zod_1.z.boolean().optional().describe("On list — true returns only items with no parent (board roots: projects + unassigned outcomes)."),
+        include_completed: zod_1.z.boolean().optional().describe("On list — false hides completed items. Defaults true."),
+        limit: zod_1.z.number().int().min(1).max(500).optional().describe("On list — max items to return (1–500, default 30)."),
+    }, async ({ action, title, description, status, priority, due_date, item_id, item_ids, start_time, end_time, event_id, all_day, tags, color, target_date, item_type, parent_id, focus_id, agent_ids, workflow_ids, top_level_only, include_completed, limit }) => {
         try {
             switch (action) {
                 case "list": {
-                    const result = await client.listLifeItems(status);
+                    const result = await client.listLifeItems({
+                        status,
+                        item_type,
+                        parent_id,
+                        focus_id,
+                        top_level_only,
+                        include_completed,
+                        limit,
+                    });
                     const items = result.items ?? [];
                     if (items.length === 0) {
                         return { content: [{ type: "text", text: "No life items found." }] };
                     }
-                    const lines = items.map((i) => `• [${i.priority ?? "—"}] ${i.title} (status: ${i.status ?? "—"}${i.due_date ? `, due: ${i.due_date}` : ""}) — id: ${i.item_id}`);
-                    return { content: [{ type: "text", text: lines.join("\n") }] };
+                    const lines = items.map((i) => {
+                        const tag = i.item_type === "project" ? "📁 project" : "🎯 outcome";
+                        const parts = [`[${i.priority ?? "—"}] ${tag} ${i.title}`];
+                        parts.push(`status: ${i.status ?? "—"}`);
+                        if (i.due_date)
+                            parts.push(`due: ${i.due_date}`);
+                        if (i.item_type === "project") {
+                            if (i.focus_id)
+                                parts.push(`focus: ${i.focus_id}`);
+                            if (typeof i.subtask_count === "number")
+                                parts.push(`outcomes: ${i.subtasks_completed ?? 0}/${i.subtask_count}`);
+                        }
+                        else if (i.parent_id) {
+                            parts.push(`parent: ${i.parent_id}`);
+                        }
+                        return `• ${parts.join(" · ")} — id: ${i.item_id}`;
+                    });
+                    const header = typeof result.total === "number" ? `Showing ${items.length} of ${result.total} items.` : null;
+                    return {
+                        content: [{ type: "text", text: [header, ...lines].filter(Boolean).join("\n") }],
+                    };
                 }
                 case "create": {
                     if (!title) {
@@ -512,8 +556,19 @@ function createMindMcpServer(client) {
                         tags,
                         color,
                         target_date,
+                        item_type,
+                        parent_id,
+                        focus_id,
+                        agent_ids,
+                        workflow_ids,
                     });
                     const extras = [];
+                    if (result.item_type)
+                        extras.push(`type: ${result.item_type}`);
+                    if (result.parent_id)
+                        extras.push(`parent: ${result.parent_id}`);
+                    if (result.focus_id)
+                        extras.push(`focus: ${result.focus_id}`);
                     if (result.tags && result.tags.length > 0)
                         extras.push(`tags: ${result.tags.join(", ")}`);
                     if (result.color && result.color !== "default")
@@ -539,22 +594,39 @@ function createMindMcpServer(client) {
                     const patch = {};
                     if (title)
                         patch.title = title;
-                    if (description)
+                    if (description !== undefined)
                         patch.description = description;
                     if (status)
                         patch.status = status;
                     if (priority)
                         patch.priority = priority;
-                    if (due_date)
+                    if (due_date !== undefined)
                         patch.due_date = due_date;
                     if (tags)
                         patch.tags = tags;
                     if (color)
                         patch.color = color;
-                    if (target_date)
+                    if (target_date !== undefined)
                         patch.target_date = target_date;
+                    if (item_type !== undefined)
+                        patch.item_type = item_type;
+                    // parent_id / focus_id: pass empty string explicitly to clear; pass undefined to leave unchanged
+                    if (parent_id !== undefined)
+                        patch.parent_id = parent_id;
+                    if (focus_id !== undefined)
+                        patch.focus_id = focus_id;
+                    if (agent_ids !== undefined)
+                        patch.agent_ids = agent_ids;
+                    if (workflow_ids !== undefined)
+                        patch.workflow_ids = workflow_ids;
                     const result = await client.updateLifeItem(item_id, patch);
                     const extras = [];
+                    if (result.item_type)
+                        extras.push(`type: ${result.item_type}`);
+                    if (result.parent_id)
+                        extras.push(`parent: ${result.parent_id}`);
+                    if (result.focus_id)
+                        extras.push(`focus: ${result.focus_id}`);
                     if (result.tags && result.tags.length > 0)
                         extras.push(`tags: ${result.tags.join(", ")}`);
                     if (result.color && result.color !== "default")
@@ -625,16 +697,25 @@ function createMindMcpServer(client) {
                         };
                     }
                     const result = await client.getLifeItem(item_id);
+                    const r = result;
                     const lines = [
-                        `**${result.title}**`,
+                        `**${result.title}** (id: ${result.item_id})`,
                         `Status: ${result.status ?? "—"} | Priority: ${result.priority ?? "—"} | Due: ${result.due_date ?? "none"}`,
+                        `Type: ${r.item_type ?? "outcome"}${r.parent_id ? ` | Parent: ${r.parent_id}` : ""}${r.focus_id ? ` | Focus: ${r.focus_id}` : ""}`,
                     ];
-                    if (result.color && result.color !== "default")
-                        lines.push(`Color: ${result.color}`);
-                    if (result.target_date)
-                        lines.push(`Target: ${result.target_date}`);
-                    if (result.tags && result.tags.length > 0)
-                        lines.push(`Tags: ${result.tags.join(", ")}`);
+                    if (r.item_type === "project" && typeof r.subtask_count === "number") {
+                        lines.push(`Outcomes: ${r.subtasks_completed ?? 0}/${r.subtask_count} complete`);
+                    }
+                    if (r.agent_ids && r.agent_ids.length > 0)
+                        lines.push(`Agents: ${r.agent_ids.join(", ")}`);
+                    if (r.workflow_ids && r.workflow_ids.length > 0)
+                        lines.push(`Workflows: ${r.workflow_ids.join(", ")}`);
+                    if (r.color && r.color !== "default")
+                        lines.push(`Color: ${r.color}`);
+                    if (r.target_date)
+                        lines.push(`Target: ${r.target_date}`);
+                    if (r.tags && r.tags.length > 0)
+                        lines.push(`Tags: ${r.tags.join(", ")}`);
                     if (result.description)
                         lines.push(`\n${result.description}`);
                     return { content: [{ type: "text", text: lines.join("\n") }] };
@@ -729,6 +810,129 @@ function createMindMcpServer(client) {
             };
         }
     });
+    // ─── mind_focuses ──────────────────────────────────────
+    // Top of the Focus → Project → Outcome → Task hierarchy.
+    // A Focus is a per-user bucket that groups multiple Life Projects, and
+    // can carry shared agents/workflows that apply to every project inside.
+    server.tool("mind_focuses", "Manage Focuses — the top-level buckets that group Life Projects. Every project lives inside one focus (or 'No Focus'). Use list to see all focuses + their project counts, create to add a new bucket (e.g. 'Astra', 'Atlas', 'Fundraising'), update/delete to maintain them. Pass the returned focus_id to mind_life when creating projects.", {
+        action: zod_1.z
+            .enum(["list", "get", "create", "update", "delete"])
+            .describe("list/get/create/update/delete focuses. 'delete' soft-archives by default; pass hard=true to remove permanently."),
+        focus_id: zod_1.z.string().optional().describe("Focus id — required for get/update/delete"),
+        name: zod_1.z.string().optional().describe("Display name — required for create"),
+        description: zod_1.z.string().optional().describe("Long-form description"),
+        color: zod_1.z
+            .enum(["default", "red", "orange", "yellow", "green", "blue", "purple", "pink"])
+            .optional()
+            .describe("Color stripe used in the UI"),
+        icon: zod_1.z.string().optional().describe("Lucide icon name (e.g. 'briefcase', 'rocket'). Defaults to 'folder'."),
+        position: zod_1.z.number().int().optional().describe("Sort position (lower = earlier)"),
+        agent_ids: zod_1.z.array(zod_1.z.string()).optional().describe("Agents bound to every project inside this focus. On update, REPLACES the existing list."),
+        workflow_ids: zod_1.z.array(zod_1.z.string()).optional().describe("Workflows bound to every project inside this focus. On update, REPLACES the existing list."),
+        include_archived: zod_1.z.boolean().optional().describe("On list — true to include archived focuses (default false)"),
+        hard: zod_1.z.boolean().optional().describe("On delete — true to remove permanently (default false = soft archive)"),
+    }, async ({ action, focus_id, name, description, color, icon, position, agent_ids, workflow_ids, include_archived, hard }) => {
+        try {
+            switch (action) {
+                case "list": {
+                    const result = await client.listFocuses(include_archived ?? false);
+                    const focuses = result.focuses ?? [];
+                    if (focuses.length === 0 && (result.unfiled_project_count ?? 0) === 0) {
+                        return { content: [{ type: "text", text: "No focuses yet. Create one with action='create'." }] };
+                    }
+                    const lines = focuses.map((f) => {
+                        const c = f.color && f.color !== "default" ? ` (${f.color})` : "";
+                        const counts = `${f.project_count_active ?? 0} active / ${f.project_count ?? 0} total`;
+                        return `• 📁 ${f.name}${c} — ${counts} projects — id: ${f.focus_id}`;
+                    });
+                    if (typeof result.unfiled_project_count === "number" && result.unfiled_project_count > 0) {
+                        lines.push(`• 🗂  No Focus — ${result.unfiled_project_count} unfiled project(s)`);
+                    }
+                    return { content: [{ type: "text", text: lines.join("\n") }] };
+                }
+                case "get": {
+                    if (!focus_id) {
+                        return { content: [{ type: "text", text: "Error: focus_id is required for get" }], isError: true };
+                    }
+                    const f = await client.getFocus(focus_id);
+                    const lines = [
+                        `**${f.name}** (id: ${f.focus_id})`,
+                        `Color: ${f.color ?? "default"} | Icon: ${f.icon ?? "folder"} | Position: ${f.position ?? 0}`,
+                        `Projects: ${f.project_count_active ?? 0} active / ${f.project_count_completed ?? 0} completed / ${f.project_count ?? 0} total`,
+                    ];
+                    if (f.agent_ids && f.agent_ids.length > 0)
+                        lines.push(`Agents: ${f.agent_ids.join(", ")}`);
+                    if (f.workflow_ids && f.workflow_ids.length > 0)
+                        lines.push(`Workflows: ${f.workflow_ids.join(", ")}`);
+                    if (f.archived_at)
+                        lines.push(`Archived at: ${f.archived_at}`);
+                    if (f.description)
+                        lines.push(`\n${f.description}`);
+                    return { content: [{ type: "text", text: lines.join("\n") }] };
+                }
+                case "create": {
+                    if (!name) {
+                        return { content: [{ type: "text", text: "Error: name is required to create a focus" }], isError: true };
+                    }
+                    const f = await client.createFocus({
+                        name,
+                        description,
+                        color,
+                        icon,
+                        position,
+                        agent_ids,
+                        workflow_ids,
+                    });
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Created focus: "${f.name}" (id: ${f.focus_id}, color: ${f.color ?? "default"}, icon: ${f.icon ?? "folder"})`,
+                            },
+                        ],
+                    };
+                }
+                case "update": {
+                    if (!focus_id) {
+                        return { content: [{ type: "text", text: "Error: focus_id is required for update" }], isError: true };
+                    }
+                    const patch = {};
+                    if (name !== undefined)
+                        patch.name = name;
+                    if (description !== undefined)
+                        patch.description = description;
+                    if (color !== undefined)
+                        patch.color = color;
+                    if (icon !== undefined)
+                        patch.icon = icon;
+                    if (position !== undefined)
+                        patch.position = position;
+                    if (agent_ids !== undefined)
+                        patch.agent_ids = agent_ids;
+                    if (workflow_ids !== undefined)
+                        patch.workflow_ids = workflow_ids;
+                    const f = await client.updateFocus(focus_id, patch);
+                    return {
+                        content: [{ type: "text", text: `✅ Updated focus: "${f.name}" (id: ${f.focus_id})` }],
+                    };
+                }
+                case "delete": {
+                    if (!focus_id) {
+                        return { content: [{ type: "text", text: "Error: focus_id is required for delete" }], isError: true };
+                    }
+                    const r = await client.deleteFocus(focus_id, hard ?? false);
+                    const verb = r.deleted ? "Deleted" : "Archived";
+                    return { content: [{ type: "text", text: `✅ ${verb} focus ${r.focus_id} (projects inside detached to 'No Focus').` }] };
+                }
+            }
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error in mind_focuses: ${err}` }],
+                isError: true,
+            };
+        }
+    });
     // ─── mind_tasks ─────────────────────────────────────────
     // Site-wide tasks: assignable, completable work items that attach to a
     // Life project, a CRM contact, an agent, or stand alone.