youmd 0.8.0 → 0.8.5

package/dist/mcp/registry.js

@@ -12,7 +12,7 @@
  *
  * ─── MIGRATION STATUS ───────────────────────────────────────────────────────
  *
- * MIGRATED (17 tools):
+ * MIGRATED (22 tools):
  *   whoami              — local bundle read, no auth required
  *   get_identity        — local bundle read, compact/full/json/markdown
  *   list_skills         — pure local dir scan
@@ -31,6 +31,10 @@
  *   get_remote_status   — conditional auth branch + ctx.apiRequest
  *   use_skill           — ctx.getInstalledSkills()
  *   get_activity_log    — auth-gated fetch via ctx.fetchActivityLog
+ *   upsert_portfolio_task — authenticated write via ctx.apiRequest
+ *   update_portfolio_task — authenticated task triage via ctx.apiRequest
+ *   hydrate_portfolio_graph — authenticated portfolio hydration via ctx.apiRequest
+ *   record_brain_dump   — authenticated write via ctx.apiRequest
  *
  * DEFERRED (4 tools — write-ops and dynamic-import tools):
  *   get_agent_brief     — >50 lines; delegates to buildAgentBrief() in server.ts
@@ -84,6 +88,7 @@ const config_1 = require("../lib/config");
 const project_1 = require("../lib/project");
 const projectContext_1 = require("../lib/projectContext");
 const youstack_1 = require("../lib/youstack");
+const portfolio_graph_1 = require("../lib/portfolio-graph");
 // ─── Shared config/helpers (duplicated here to avoid circular server.ts dep) ──
 function _getLocalBundleDir2() { return (0, config_1.getLocalBundleDir)(); }
 function _getHomeBundleDir2() { return (0, config_1.getHomeBundleDir)(); }
@@ -221,6 +226,19 @@ function tryLoadStack(inputPath) {
         return null;
     }
 }
+async function getProjectPortfolioSlice(projectName, ctx) {
+    if (ctx.authenticated) {
+        try {
+            const snapshot = await ctx.apiRequest("/api/v1/me/portfolio/graph?includeTasks=1");
+            const brief = (0, portfolio_graph_1.portfolioGraphBriefFromSnapshot)(snapshot);
+            return (0, portfolio_graph_1.getPortfolioGraphProjectSlice)(projectName, brief);
+        }
+        catch {
+            // Use the bundled fallback when the local agent is offline or unauthenticated.
+        }
+    }
+    return (0, portfolio_graph_1.getPortfolioGraphProjectSlice)(projectName);
+}
 // ─── Registry ─────────────────────────────────────────────────────────────────
 exports.CLI_MCP_TOOLS = [
     // ── whoami ──────────────────────────────────────────────────────────────────
@@ -362,11 +380,13 @@ exports.CLI_MCP_TOOLS = [
             });
             if (projectName) {
                 const ctx2 = readMergedProjectContext({ projectName });
+                const portfolioGraph = await getProjectPortfolioSlice(projectName, ctx);
                 if (!ctx2) {
                     const result = {
                         readiness: readiness("not_found", `Project context for ${projectName} was not found or is incomplete.`, "Use local repo instructions, project-context files, or confirm the named project exists before retrying."),
                         project: { name: projectName, source: "named" },
                         projectContext: null,
+                        portfolioGraph,
                     };
                     ctx.logActivity("read", "project/" + projectName);
                     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], isError: true };
@@ -375,6 +395,7 @@ exports.CLI_MCP_TOOLS = [
                     readiness: readiness("ready", `Project context for ${projectName} is available.`, "None needed."),
                     project: { name: projectName, source: "named" },
                     projectContext: ctx2,
+                    portfolioGraph,
                 };
                 ctx.logActivity("read", "project/" + projectName);
                 return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -392,16 +413,19 @@ exports.CLI_MCP_TOOLS = [
             }
             const finalCtx = merged;
             const name = finalCtx?.meta?.name || current?.name || null;
+            const portfolioGraph = await getProjectPortfolioSlice(name, ctx);
             const result = finalCtx
                 ? {
                     readiness: readiness("ready", `Project context for ${name} is available.`, "None needed."),
                     project: { name, source: "current" },
                     projectContext: finalCtx,
+                    portfolioGraph,
                 }
                 : {
                     readiness: readiness("not_found", "Project context could not be read.", "Use repo-local instructions and project-context markdown files directly."),
                     project: { name, source: "current" },
                     projectContext: null,
+                    portfolioGraph,
                 };
             ctx.logActivity("read", "project/current");
             return {
@@ -642,6 +666,406 @@ exports.CLI_MCP_TOOLS = [
             }
         },
     },
+    // ── upsert_portfolio_task ───────────────────────────────────────────────────
+    {
+        name: "upsert_portfolio_task",
+        description: "Create a project-associated or personal portfolio task for the user. Use when a local agent needs to assign work to the human or to agents and sync the task into You.md's portfolio graph/repo snapshot. Requires authentication.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "Task title." },
+                project: { type: "string", description: "Optional project slug/name. Omit or use personal for uncategorized personal tasks." },
+                description: { type: "string", description: "Optional task details." },
+                owner_type: { type: "string", enum: ["human", "agent"], description: "Who owns this task: human or agent." },
+                owner_label: { type: "string", description: "Optional owner label, such as Houston, Codex, Claude, or You Agent." },
+                status: { type: "string", description: "Task status: proposed, open, in_progress, done, snoozed, cancelled." },
+                priority: { type: "string", description: "Priority: low, normal, high, urgent." },
+                tags: { type: "array", items: { type: "string" }, description: "Optional searchable tags." },
+                sync_repo: { type: "boolean", description: "Whether to publish and sync the GitHub repo snapshot. Defaults true." },
+            },
+            required: ["title", "owner_type"],
+        },
+        handler: async (args, ctx) => {
+            if (!ctx.authenticated) {
+                return { content: [{ type: "text", text: "not authenticated — run youmd login first" }], isError: true };
+            }
+            const title = typeof args.title === "string" ? args.title.trim() : "";
+            if (!title) {
+                return { content: [{ type: "text", text: "missing required argument: title" }], isError: true };
+            }
+            const ownerType = args.owner_type === "human" ? "human" : "agent";
+            const body = {
+                title,
+                projectSlug: typeof args.project === "string" ? args.project : undefined,
+                description: typeof args.description === "string" ? args.description : undefined,
+                ownerType,
+                ownerLabel: typeof args.owner_label === "string" ? args.owner_label : ctx.resolveAgentName(),
+                status: typeof args.status === "string" ? args.status : "open",
+                priority: typeof args.priority === "string" ? args.priority : "normal",
+                tags: Array.isArray(args.tags) ? args.tags.filter((tag) => typeof tag === "string") : [],
+                syncRepo: args.sync_repo !== false,
+                sourceType: "mcp",
+                agentName: ctx.resolveAgentName(),
+            };
+            try {
+                const result = await ctx.apiRequest("/api/v1/me/portfolio/tasks", {
+                    method: "POST",
+                    body,
+                });
+                const ok = result.success === true;
+                ctx.logActivity("write", "portfolio/task", { title, project: body.projectSlug ?? "personal" });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                    isError: !ok,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `failed to save portfolio task: ${err instanceof Error ? err.message : "unknown error"}` }],
+                    isError: true,
+                };
+            }
+        },
+    },
+    // ── update_portfolio_task ───────────────────────────────────────────────────
+    {
+        name: "update_portfolio_task",
+        description: "Update an existing portfolio task's triage, owner, project scope, title, details, due date, or tags. Use after an agent starts, finishes, reassigns, routes, or enriches a task in You.md's persisted project graph. Requires authentication.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: { type: "string", description: "Existing portfolio task id." },
+                title: { type: "string", description: "Updated task title." },
+                project: { type: ["string", "null"], description: "Updated project slug/name. Use null or personal to move to uncategorized personal tasks." },
+                description: { type: ["string", "null"], description: "Updated task details. Use null to clear." },
+                owner_type: { type: "string", enum: ["human", "agent"], description: "Who owns this task: human or agent." },
+                owner_label: { type: ["string", "null"], description: "Optional owner label, such as Houston, Codex, Claude, or You Agent. Use null to clear." },
+                status: { type: "string", enum: ["proposed", "open", "in_progress", "done", "snoozed", "cancelled"], description: "New task status." },
+                priority: { type: "string", enum: ["low", "normal", "high", "urgent"], description: "New task priority." },
+                due_at: { type: ["number", "null"], description: "Due timestamp in milliseconds. Use null to clear." },
+                tags: { type: "array", items: { type: "string" }, description: "Replacement tag list." },
+                sync_repo: { type: "boolean", description: "Whether to publish and sync the GitHub repo snapshot. Defaults true." },
+            },
+            required: ["task_id"],
+        },
+        handler: async (args, ctx) => {
+            if (!ctx.authenticated) {
+                return { content: [{ type: "text", text: "not authenticated — run youmd login first" }], isError: true };
+            }
+            const taskId = typeof args.task_id === "string" ? args.task_id.trim() : "";
+            if (!taskId) {
+                return { content: [{ type: "text", text: "missing required argument: task_id" }], isError: true };
+            }
+            const status = typeof args.status === "string" ? args.status.trim() : undefined;
+            const priority = typeof args.priority === "string" ? args.priority.trim() : undefined;
+            const body = {
+                taskId,
+                syncRepo: args.sync_repo !== false,
+                agentName: ctx.resolveAgentName(),
+            };
+            if (typeof args.title === "string")
+                body.title = args.title.trim();
+            if ("project" in args)
+                body.projectSlug = args.project === null ? null : args.project;
+            if ("description" in args)
+                body.description = args.description === null ? null : args.description;
+            if (args.owner_type === "human" || args.owner_type === "agent")
+                body.ownerType = args.owner_type;
+            if ("owner_label" in args)
+                body.ownerLabel = args.owner_label === null ? null : args.owner_label;
+            if (status)
+                body.status = status;
+            if (priority)
+                body.priority = priority;
+            if ("due_at" in args)
+                body.dueAt = args.due_at === null ? null : args.due_at;
+            if (Array.isArray(args.tags))
+                body.tags = args.tags.filter((tag) => typeof tag === "string");
+            if (Object.keys(body).length <= 3) {
+                return { content: [{ type: "text", text: "at least one task field is required" }], isError: true };
+            }
+            try {
+                const result = await ctx.apiRequest("/api/v1/me/portfolio/tasks/update", {
+                    method: "POST",
+                    body,
+                });
+                const ok = result.success === true;
+                ctx.logActivity("write", "portfolio/task-update", { taskId, fields: Object.keys(body).filter((field) => !["taskId", "syncRepo", "agentName"].includes(field)) });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                    isError: !ok,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `failed to update portfolio task: ${err instanceof Error ? err.message : "unknown error"}` }],
+                    isError: true,
+                };
+            }
+        },
+    },
+    // ── hydrate_portfolio_graph ────────────────────────────────────────────────
+    {
+        name: "hydrate_portfolio_graph",
+        description: "Hydrate the persisted You.md Portfolio Graph from the authenticated recent GitHub project catalog. Use after refreshing/analyzing active projects so the Portfolio Graph is not stuck on bootstrap seed rows.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                days: { type: "number", description: "Recent activity window in days. Defaults to 90." },
+                limit: { type: "number", description: "Maximum tracked projects to hydrate. Defaults to 80." },
+                include_github: { type: "boolean", description: "Whether to hydrate from tracked GitHub projects. Defaults true." },
+            },
+        },
+        handler: async (args, ctx) => {
+            if (!ctx.authenticated) {
+                return { content: [{ type: "text", text: "not authenticated — run youmd login first" }], isError: true };
+            }
+            const days = typeof args.days === "number" && Number.isFinite(args.days) ? args.days : 90;
+            const limit = typeof args.limit === "number" && Number.isFinite(args.limit) ? args.limit : 80;
+            try {
+                const result = await ctx.apiRequest("/api/v1/me/portfolio/projects/hydrate", {
+                    method: "POST",
+                    body: {
+                        includeTracked: args.include_github !== false,
+                        days,
+                        limit,
+                        projects: [],
+                        source: "mcp-portfolio-hydrate",
+                        agentName: ctx.resolveAgentName(),
+                    },
+                });
+                const ok = result.success === true;
+                ctx.logActivity("write", "portfolio/projects", { days, limit });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                    isError: !ok,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `failed to hydrate portfolio graph: ${err instanceof Error ? err.message : "unknown error"}` }],
+                    isError: true,
+                };
+            }
+        },
+    },
+    // ── upsert_portfolio_project ───────────────────────────────────────────────
+    {
+        name: "upsert_portfolio_project",
+        description: "Create or update a project strategy/intelligence record in You.md's persisted Portfolio Graph. Use before adding APIs/MCPs/stacks/tasks so agents share the same goal, vision, pain points, constraints, non-goals, metrics, repo, and docs context.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Project display name." },
+                slug: { type: "string", description: "Stable project slug." },
+                stack_name: { type: "string", description: "Associated stack name, such as YouStack or BAMFStack." },
+                status: { type: "string", description: "Project status, such as active, build, research, template, or audit." },
+                summary: { type: "string", description: "Short AI/human summary." },
+                detailed_description: { type: "string", description: "Longer project description." },
+                goal: { type: "string", description: "High-level goal." },
+                vision: { type: "string", description: "North-star vision." },
+                focus: { type: "string", description: "Current focus." },
+                positioning: { type: "string", description: "Positioning/category." },
+                audience: { type: "string", description: "Who this is for." },
+                pain_points: { type: "array", items: { type: "string" }, description: "Pain points solved." },
+                solution: { type: "string", description: "Solution summary." },
+                why_this_solution: { type: "string", description: "Why this solution is right." },
+                north_star: { type: "string", description: "North-star metric or guiding outcome." },
+                metrics: { type: "array", items: { type: "string" }, description: "Metrics to track." },
+                constraints: { type: "array", items: { type: "string" }, description: "Constraints/guardrails." },
+                not_building: { type: "array", items: { type: "string" }, description: "Explicit non-goals." },
+                competitors: {
+                    type: "array",
+                    description: "Alternatives or competitors to track.",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                            url: { type: "string" },
+                            note: { type: "string" },
+                        },
+                        required: ["name"],
+                    },
+                },
+                repo_full_name: { type: "string", description: "GitHub repo full name, owner/repo." },
+                repo_url: { type: "string", description: "Repository URL." },
+                product_url: { type: "string", description: "Product/site URL." },
+                docs: { type: "array", items: { type: "string" }, description: "Important docs paths or URLs." },
+                environments: { type: "array", items: { type: "string" }, description: "Known environments." },
+                tags: { type: "array", items: { type: "string" }, description: "Search/routing tags." },
+                repo_path: { type: "string", description: "Local repo path or directory name." },
+            },
+            required: ["name"],
+        },
+        handler: async (args, ctx) => {
+            if (!ctx.authenticated) {
+                return { content: [{ type: "text", text: "not authenticated — run youmd login first" }], isError: true };
+            }
+            const name = typeof args.name === "string" ? args.name.trim() : "";
+            if (!name) {
+                return { content: [{ type: "text", text: "missing required argument: name" }], isError: true };
+            }
+            const stringArray = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+            const competitors = Array.isArray(args.competitors)
+                ? args.competitors.flatMap((item) => {
+                    if (!item || typeof item !== "object")
+                        return [];
+                    const row = item;
+                    const competitorName = typeof row.name === "string" ? row.name.trim() : "";
+                    if (!competitorName)
+                        return [];
+                    return [{
+                            name: competitorName,
+                            url: typeof row.url === "string" ? row.url : undefined,
+                            note: typeof row.note === "string" ? row.note : undefined,
+                        }];
+                })
+                : [];
+            const project = {
+                name,
+                slug: typeof args.slug === "string" ? args.slug : undefined,
+                stackName: typeof args.stack_name === "string" ? args.stack_name : undefined,
+                status: typeof args.status === "string" ? args.status : "active",
+                summary: typeof args.summary === "string" ? args.summary : undefined,
+                detailedDescription: typeof args.detailed_description === "string" ? args.detailed_description : undefined,
+                goal: typeof args.goal === "string" ? args.goal : undefined,
+                vision: typeof args.vision === "string" ? args.vision : undefined,
+                focus: typeof args.focus === "string" ? args.focus : undefined,
+                positioning: typeof args.positioning === "string" ? args.positioning : undefined,
+                audience: typeof args.audience === "string" ? args.audience : undefined,
+                painPoints: stringArray(args.pain_points),
+                solution: typeof args.solution === "string" ? args.solution : undefined,
+                whyThisSolution: typeof args.why_this_solution === "string" ? args.why_this_solution : undefined,
+                northStar: typeof args.north_star === "string" ? args.north_star : undefined,
+                metrics: stringArray(args.metrics),
+                constraints: stringArray(args.constraints),
+                notBuilding: stringArray(args.not_building),
+                competitors,
+                repoFullName: typeof args.repo_full_name === "string" ? args.repo_full_name : undefined,
+                repoUrl: typeof args.repo_url === "string" ? args.repo_url : undefined,
+                productUrl: typeof args.product_url === "string" ? args.product_url : undefined,
+                docs: stringArray(args.docs),
+                environments: stringArray(args.environments),
+                tags: stringArray(args.tags),
+                path: typeof args.repo_path === "string" ? args.repo_path : undefined,
+            };
+            try {
+                const result = await ctx.apiRequest("/api/v1/me/portfolio/projects/hydrate", {
+                    method: "POST",
+                    body: {
+                        includeTracked: false,
+                        projects: [project],
+                        source: "mcp-project-enrichment",
+                        agentName: ctx.resolveAgentName(),
+                    },
+                });
+                const ok = result.success === true;
+                ctx.logActivity("write", "portfolio/project", { name, slug: project.slug });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                    isError: !ok,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `failed to upsert portfolio project: ${err instanceof Error ? err.message : "unknown error"}` }],
+                    isError: true,
+                };
+            }
+        },
+    },
+    // ── record_brain_dump ───────────────────────────────────────────────────────
+    {
+        name: "record_brain_dump",
+        description: "Save a raw brain dump, route it to projects/tags, and optionally create proposed human/agent tasks. Use for pasted notes, terminal thoughts, SMS/watch transcripts, and local-agent research that should not die in one-off files. Requires authentication.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                raw_text: { type: "string", description: "Raw unedited brain dump or transcript text." },
+                summary: { type: "string", description: "Short summary. Omit to let the API derive one." },
+                projects: { type: "array", items: { type: "string" }, description: "Related project slugs/names." },
+                tags: { type: "array", items: { type: "string" }, description: "Topic tags." },
+                insights: { type: "array", items: { type: "string" }, description: "Interesting insights or through-lines." },
+                source: { type: "string", description: "Capture source: mcp, cli, sms, watch, badapp, shell, manual." },
+                tasks: {
+                    type: "array",
+                    description: "Optional proposed tasks extracted from the dump.",
+                    items: {
+                        type: "object",
+                        properties: {
+                            title: { type: "string" },
+                            projectSlug: { type: "string" },
+                            description: { type: "string" },
+                            ownerType: { type: "string", enum: ["human", "agent"] },
+                            ownerLabel: { type: "string" },
+                            priority: { type: "string" },
+                            tags: { type: "array", items: { type: "string" } },
+                        },
+                        required: ["title", "ownerType"],
+                    },
+                },
+                sync_repo: { type: "boolean", description: "Whether to publish and sync the GitHub repo snapshot. Defaults true." },
+            },
+            required: ["raw_text"],
+        },
+        handler: async (args, ctx) => {
+            if (!ctx.authenticated) {
+                return { content: [{ type: "text", text: "not authenticated — run youmd login first" }], isError: true };
+            }
+            const rawText = typeof args.raw_text === "string" ? args.raw_text.trim() : "";
+            if (!rawText) {
+                return { content: [{ type: "text", text: "missing required argument: raw_text" }], isError: true };
+            }
+            const arrayOfStrings = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+            const tasks = Array.isArray(args.tasks)
+                ? args.tasks
+                    .map((task) => typeof task === "object" && task !== null ? task : null)
+                    .filter((task) => task !== null && typeof task.title === "string")
+                    .map((task) => ({
+                    title: String(task.title),
+                    projectSlug: typeof task.projectSlug === "string" ? task.projectSlug : undefined,
+                    description: typeof task.description === "string" ? task.description : undefined,
+                    ownerType: task.ownerType === "human" ? "human" : "agent",
+                    ownerLabel: typeof task.ownerLabel === "string" ? task.ownerLabel : ctx.resolveAgentName(),
+                    priority: typeof task.priority === "string" ? task.priority : "normal",
+                    tags: arrayOfStrings(task.tags),
+                }))
+                : [];
+            const body = {
+                rawText,
+                summary: typeof args.summary === "string" ? args.summary : undefined,
+                projectSlugs: arrayOfStrings(args.projects),
+                tags: arrayOfStrings(args.tags),
+                insights: arrayOfStrings(args.insights),
+                source: typeof args.source === "string" ? args.source : "mcp",
+                tasks,
+                syncRepo: args.sync_repo !== false,
+                agentName: ctx.resolveAgentName(),
+                metadata: {
+                    command: "record_brain_dump",
+                    savedFrom: "cli-mcp",
+                },
+            };
+            try {
+                const result = await ctx.apiRequest("/api/v1/me/portfolio/brain-dumps", {
+                    method: "POST",
+                    body,
+                });
+                const ok = result.success === true;
+                ctx.logActivity("write", "portfolio/brain-dump", { projects: body.projectSlugs, taskCount: tasks.length });
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                    isError: !ok,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `failed to save brain dump: ${err instanceof Error ? err.message : "unknown error"}` }],
+                    isError: true,
+                };
+            }
+        },
+    },
     // ── add_source ───────────────────────────────────────────────────────────────
     {
         name: "add_source",
@@ -760,7 +1184,7 @@ exports.CLI_MCP_TOOLS = [
             properties: {
                 name: {
                     type: "string",
-                    description: "Skill name: youstack-start, youstack-maintainer, voice-sync, claude-md-generator, project-context-init, meta-improve, proactive-context-fill, you-logs",
+                    description: "Skill name: youstack-start, youstack-maintainer, machine-bootstrap, portfolio-graph-auditor, voice-sync, claude-md-generator, project-context-init, meta-improve, proactive-context-fill, you-logs",
                 },
             },
             required: ["name"],