@artyfacts/mcp-server 1.1.4 → 1.2.0

package/dist/server.cjs

@@ -98,6 +98,7 @@ var ARTYFACTS_TOOLS = [
         title: { type: "string", description: "Artifact title" },
         type: { type: "string", description: "Artifact type: goal, spec, research, report, experiment, decision, doc" },
         content: { type: "string", description: "Markdown content" },
+        goal_id: { type: "string", description: "The goal UUID this artifact belongs to \u2014 always pass this when working on a task" },
         parent_id: { type: "string", description: "Parent artifact ID for nested artifacts" },
         tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" }
       },
@@ -251,6 +252,19 @@ var ARTYFACTS_TOOLS = [
       required: ["task_id", "reason"]
     }
   },
+  {
+    name: "report_progress",
+    description: 'Report what you are currently doing on a task. Call this at meaningful milestones so your work is visible in the platform (e.g., "Analyzed 12 PRs, now writing the summary section", "Completed API design, starting implementation"). This is how your progress appears to humans watching the work.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        task_id: { type: "string", description: "Task ID" },
+        message: { type: "string", description: "What you are doing right now \u2014 be specific and human-readable" },
+        metadata: { type: "object", description: "Optional extra context (step number, percentage, etc.)" }
+      },
+      required: ["task_id", "message"]
+    }
+  },
   {
     name: "create_task",
     description: "Create a new task under a goal. Use this to create actionable tasks \u2014 NOT create_artifact or create_section.",
@@ -475,6 +489,7 @@ var toolHandlers = {
         title: args.title,
         type: args.type || "document/sectioned",
         artifact_type: args.artifact_type || args.type || "doc",
+        goal_id: args.goal_id,
         parent_id: args.parent_id,
         tags: args.tags
       },
@@ -522,6 +537,14 @@ var toolHandlers = {
     const { task_id, ...body } = args;
     return client.post(`/tasks/${task_id}/block`, body);
   },
+  report_progress: (client, args) => {
+    const { task_id, message, metadata } = args;
+    return client.post(`/tasks/${task_id}/activity`, {
+      type: "progress",
+      content: message,
+      metadata: metadata ?? {}
+    });
+  },
   create_task: (client, args) => {
     const { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes } = args;
     return client.post("/tasks", { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes });

package/dist/server.js

@@ -2,7 +2,7 @@ import {
   ArtyfactsMcpServer,
   createMcpServer,
   startServer
-} from "./chunk-GOOQPNGV.js";
+} from "./chunk-MQM6RARV.js";
 export {
   ArtyfactsMcpServer,
   createMcpServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artyfacts/mcp-server",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "MCP server exposing Artyfacts tools for Claude Code",
   "type": "module",
   "main": "dist/index.js",

package/src/server.ts

@@ -106,6 +106,7 @@ const ARTYFACTS_TOOLS: Tool[] = [
         title: { type: 'string', description: 'Artifact title' },
         type: { type: 'string', description: 'Artifact type: goal, spec, research, report, experiment, decision, doc' },
         content: { type: 'string', description: 'Markdown content' },
+        goal_id: { type: 'string', description: 'The goal UUID this artifact belongs to — always pass this when working on a task' },
         parent_id: { type: 'string', description: 'Parent artifact ID for nested artifacts' },
         tags: { type: 'array', items: { type: 'string' }, description: 'Tags for categorization' },
       },
@@ -261,6 +262,19 @@ const ARTYFACTS_TOOLS: Tool[] = [
       required: ['task_id', 'reason'],
     },
   },
+  {
+    name: 'report_progress',
+    description: 'Report what you are currently doing on a task. Call this at meaningful milestones so your work is visible in the platform (e.g., "Analyzed 12 PRs, now writing the summary section", "Completed API design, starting implementation"). This is how your progress appears to humans watching the work.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        task_id: { type: 'string', description: 'Task ID' },
+        message: { type: 'string', description: 'What you are doing right now — be specific and human-readable' },
+        metadata: { type: 'object', description: 'Optional extra context (step number, percentage, etc.)' },
+      },
+      required: ['task_id', 'message'],
+    },
+  },
   {
     name: 'create_task',
     description: 'Create a new task under a goal. Use this to create actionable tasks — NOT create_artifact or create_section.',
@@ -500,6 +514,7 @@ const toolHandlers: Record<string, ToolHandler> = {
         title: args.title,
         type: args.type || 'document/sectioned',
         artifact_type: args.artifact_type || args.type || 'doc',
+        goal_id: args.goal_id,
         parent_id: args.parent_id,
         tags: args.tags,
       },
@@ -550,6 +565,14 @@ const toolHandlers: Record<string, ToolHandler> = {
     const { task_id, ...body } = args;
     return client.post(`/tasks/${task_id}/block`, body);
   },
+  report_progress: (client, args) => {
+    const { task_id, message, metadata } = args;
+    return client.post(`/tasks/${task_id}/activity`, {
+      type: 'progress',
+      content: message,
+      metadata: metadata ?? {},
+    });
+  },
   create_task: (client, args) => {
     const { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes } = args;
     return client.post('/tasks', { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes });