@artyfacts/claude 1.3.23 → 1.3.25

package/dist/index.js

@@ -290,12 +290,13 @@ You have access to Artyfacts MCP tools. USE THEM to complete your task:
 - **create_artifact** - Create new artifacts (documents, specs, reports)
 - **create_section** - Add sections to artifacts (content, tasks, decisions)
 - **update_section** - Update existing sections
-- **create_agent** - Create new AI agents with specific roles
-- **list_artifacts** - Query existing artifacts
-- **list_sections** - Query sections within an artifact
-- **complete_task** - Mark a task as complete
+- **create_task** - Create new tasks under a goal
+- **claim_task** - Claim a task for execution
+- **complete_task** - Mark a task as complete (returns unblocked tasks)
 - **block_task** - Block a task with a reason
-- **create_blocker** - Create a decision blocker
+- **list_tasks** - Query tasks from the queue
+- **list_inbox** - Check pending decisions/approvals
+- **resolve_inbox** - Resolve an inbox item
 
 IMPORTANT: When asked to create agents or update artifacts, USE THE TOOLS. Don't just describe what you would do - actually do it with the tools.
 
@@ -304,7 +305,7 @@ IMPORTANT: When asked to create agents or update artifacts, USE THE TOOLS. Don't
 - Be thorough but concise
 - USE THE TOOLS to take action, don't just analyze
 - If the task requires creating something, use create_artifact or create_section
-- If the task requires creating agents, use create_agent
+- If you complete a task, check the response for unblocked_tasks to see follow-up work
 - If you cannot complete the task, explain why
 
 Format your response as follows:
@@ -328,37 +329,69 @@ Format your response as follows:
     }
     parts.push("");
   }
-  parts.push(`## Artifact: ${context.artifact.title}`);
-  if (context.artifact.summary) {
-    parts.push(context.artifact.summary);
-  }
-  if (context.artifact.description) {
-    parts.push("");
-    parts.push(context.artifact.description);
-  }
-  parts.push("");
-  const relatedSections = context.artifact.sections.filter(
-    (s) => s.id !== context.task.id
-  );
-  if (relatedSections.length > 0) {
-    parts.push("### Related Sections:");
-    for (const section of relatedSections) {
-      const preview = section.content ? section.content.substring(0, 200) + (section.content.length > 200 ? "..." : "") : "No content";
-      const statusBadge = section.task_status ? ` [${section.task_status}]` : "";
-      parts.push(`- **${section.heading}**${statusBadge}: ${preview}`);
+  const goal = context.goal || context.artifact;
+  if (goal) {
+    parts.push(`## Goal: ${goal.title}`);
+    if (goal.objective) {
+      parts.push(`**Objective:** ${goal.objective}`);
+    }
+    if (goal.summary) {
+      parts.push(goal.summary);
+    }
+    if (goal.description) {
+      parts.push("");
+      parts.push(goal.description);
     }
     parts.push("");
+    if (goal.tasks && goal.tasks.length > 0) {
+      const relatedTasks = goal.tasks.filter((t) => t.id !== context.task.id);
+      if (relatedTasks.length > 0) {
+        parts.push("### Related Tasks:");
+        for (const task of relatedTasks) {
+          const statusEmoji = {
+            pending: "\u23F3",
+            in_progress: "\u{1F504}",
+            blocked: "\u{1F6AB}",
+            done: "\u2705"
+          }[task.status] || "\u2753";
+          const priorityBadge = task.priority ? ` [${task.priority}]` : "";
+          parts.push(`- ${statusEmoji} **${task.title}**${priorityBadge}`);
+        }
+        parts.push("");
+      }
+    }
+    if (goal.sections && goal.sections.length > 0) {
+      const relatedSections = goal.sections.filter((s) => s.id !== context.task.id);
+      if (relatedSections.length > 0) {
+        parts.push("### Related Sections:");
+        for (const section of relatedSections) {
+          const preview = section.content ? section.content.substring(0, 200) + (section.content.length > 200 ? "..." : "") : "No content";
+          const statusBadge = section.task_status ? ` [${section.task_status}]` : "";
+          parts.push(`- **${section.heading}**${statusBadge}: ${preview}`);
+        }
+        parts.push("");
+      }
+    }
   }
   parts.push("---");
   parts.push("");
-  parts.push(`## Your Task: ${context.task.heading}`);
+  const taskTitle = context.task.title || context.task.heading;
+  parts.push(`## Your Task: ${taskTitle}`);
   if (context.task.priority) {
-    const priorityLabels = ["\u{1F534} High", "\u{1F7E1} Medium", "\u{1F7E2} Low"];
-    parts.push(`**Priority:** ${priorityLabels[context.task.priority - 1] || "Medium"}`);
+    const priorityEmoji = {
+      high: "\u{1F534} High",
+      medium: "\u{1F7E1} Medium",
+      low: "\u{1F7E2} Low"
+    }[context.task.priority] || "\u{1F7E1} Medium";
+    parts.push(`**Priority:** ${priorityEmoji}`);
+  }
+  if (context.task.depends_on && context.task.depends_on.length > 0) {
+    parts.push(`**Dependencies:** ${context.task.depends_on.length} task(s)`);
   }
   parts.push("");
   parts.push("### Description");
-  parts.push(context.task.content || "No additional description provided.");
+  const taskDescription = context.task.description || context.task.content;
+  parts.push(taskDescription || "No additional description provided.");
   parts.push("");
   if (context.task.expected_output) {
     parts.push("### Expected Output");
@@ -475,9 +508,13 @@ var ClaudeExecutor = class {
       const useFullContext = this.config.useFullContext !== false && this.contextFetcher;
       if (useFullContext) {
         try {
-          fullContext = await this.contextFetcher.fetchTaskContext(task.taskId);
+          const taskId = task.id || task.taskId;
+          if (!taskId) {
+            throw new Error("Task ID required for context fetch");
+          }
+          fullContext = await this.contextFetcher.fetchTaskContext(taskId);
           prompt = buildPromptWithContext(fullContext);
-          console.log("  \u{1F4DA} Using full context (org, project, artifact, related sections)");
+          console.log("  \u{1F4DA} Using full context (org, project, goal, related tasks)");
         } catch (contextError) {
           console.warn("  \u26A0\uFE0F  Could not fetch full context, using minimal prompt");
           console.warn(`     ${contextError instanceof Error ? contextError.message : contextError}`);
@@ -487,7 +524,8 @@ var ClaudeExecutor = class {
         prompt = this.buildTaskPrompt(task);
       }
       const output = await this.runClaude(prompt);
-      const { content, summary } = this.parseResponse(output, task.heading);
+      const taskTitle = task.title || task.heading || "Task";
+      const { content, summary } = this.parseResponse(output, taskTitle);
       return {
         success: true,
         output: content,
@@ -562,7 +600,7 @@ var ClaudeExecutor = class {
     });
   }
   /**
-   * Build the task prompt
+   * Build the task prompt (v2)
    */
   buildTaskPrompt(task) {
     const parts = [];
@@ -573,18 +611,25 @@ ${DEFAULT_SYSTEM_PROMPT}` : DEFAULT_SYSTEM_PROMPT;
     parts.push("");
     parts.push("---");
     parts.push("");
-    parts.push(`# Task: ${task.heading}`);
+    const taskTitle = task.title || task.heading;
+    parts.push(`# Task: ${taskTitle}`);
     parts.push("");
-    if (task.artifactTitle) {
-      parts.push(`**Artifact:** ${task.artifactTitle}`);
+    const goalTitle = task.goalTitle || task.artifactTitle;
+    if (goalTitle) {
+      parts.push(`**Goal:** ${goalTitle}`);
     }
     if (task.priority) {
-      const priorityLabels = ["High", "Medium", "Low"];
-      parts.push(`**Priority:** ${priorityLabels[task.priority - 1] || "Medium"}`);
+      const priorityEmoji = {
+        high: "\u{1F534} High",
+        medium: "\u{1F7E1} Medium",
+        low: "\u{1F7E2} Low"
+      }[task.priority] || "\u{1F7E1} Medium";
+      parts.push(`**Priority:** ${priorityEmoji}`);
     }
     parts.push("");
     parts.push("## Description");
-    parts.push(task.content || "No additional description provided.");
+    const taskDescription = task.description || task.content;
+    parts.push(taskDescription || "No additional description provided.");
     parts.push("");
     if (task.context && Object.keys(task.context).length > 0) {
       parts.push("## Additional Context");
@@ -774,16 +819,22 @@ var ArtyfactsListener = class {
     try {
       const data = JSON.parse(event.data);
       const rawData = data.data || data;
-      const normalizedData = rawData.task_id ? {
-        taskId: rawData.task_id,
-        sectionId: rawData.section_id,
-        artifactId: rawData.artifact_id,
-        artifactTitle: rawData.artifact_title,
-        heading: rawData.heading,
-        content: rawData.content,
+      const normalizedData = rawData.id || rawData.task_id ? {
+        // v2 fields (primary)
+        id: rawData.id || rawData.task_id,
+        goalId: rawData.goal_id || rawData.artifact_id,
+        goalTitle: rawData.goal_title || rawData.artifact_title,
+        title: rawData.title || rawData.heading,
+        description: rawData.description || rawData.content,
+        priority: rawData.priority,
         assignedTo: rawData.assigned_to,
         assignedAt: rawData.assigned_at,
-        priority: rawData.priority,
+        // Deprecated fields for backwards compatibility
+        taskId: rawData.id || rawData.task_id,
+        artifactId: rawData.goal_id || rawData.artifact_id,
+        artifactTitle: rawData.goal_title || rawData.artifact_title,
+        heading: rawData.title || rawData.heading,
+        content: rawData.description || rawData.content,
         ...rawData
         // Keep original fields too
       } : rawData;
@@ -5058,7 +5109,7 @@ var schemas = {
     }
   },
   // ---------------------------------------------------------------------------
-  // Task Tools
+  // Task Tools (v2 - tasks are first-class entities)
   // ---------------------------------------------------------------------------
   get_task: {
     name: "get_task",
@@ -5068,7 +5119,7 @@ var schemas = {
       properties: {
         task_id: {
           type: "string",
-          description: "The task UUID or section_id"
+          description: "The task UUID"
         }
       },
       required: ["task_id"]
@@ -5076,13 +5127,13 @@ var schemas = {
   },
   list_tasks: {
     name: "list_tasks",
-    description: "List tasks with optional filters.",
+    description: "List tasks from the queue. Returns tasks from the tasks table with goal context.",
     input_schema: {
       type: "object",
       properties: {
-        artifact_id: {
+        goal_id: {
           type: "string",
-          description: "Filter by artifact"
+          description: "Filter by goal ID"
         },
         status: {
           type: "string",
@@ -5104,19 +5155,19 @@ var schemas = {
   },
   create_task: {
     name: "create_task",
-    description: "Create a new task on an artifact.",
+    description: "Create a new task under a goal.",
     input_schema: {
       type: "object",
       properties: {
-        artifact_id: {
+        goal_id: {
           type: "string",
-          description: "The artifact to add the task to"
+          description: "The goal UUID to add the task to"
         },
-        heading: {
+        title: {
           type: "string",
-          description: "Task title/heading"
+          description: "Task title"
         },
-        content: {
+        description: {
           type: "string",
           description: "Task description and requirements"
         },
@@ -5127,26 +5178,41 @@ var schemas = {
         depends_on: {
           type: "array",
           items: { type: "string" },
-          description: "Optional: section_ids of tasks this depends on"
+          description: "Optional: task IDs this depends on"
         },
         priority: {
-          type: "number",
-          enum: [1, 2, 3],
-          description: "Optional: priority (1=high, 2=medium, 3=low)"
+          type: "string",
+          enum: ["low", "medium", "high"],
+          default: "medium",
+          description: "Optional: priority level"
         }
       },
-      required: ["artifact_id", "heading", "content"]
+      required: ["goal_id", "title"]
+    }
+  },
+  claim_task: {
+    name: "claim_task",
+    description: "Claim a task for execution. Sets status to in_progress.",
+    input_schema: {
+      type: "object",
+      properties: {
+        task_id: {
+          type: "string",
+          description: "The task UUID to claim"
+        }
+      },
+      required: ["task_id"]
     }
   },
   complete_task: {
     name: "complete_task",
-    description: "Mark a task as completed with output.",
+    description: "Mark a task as completed. Returns list of unblocked tasks that can now be worked on.",
     input_schema: {
       type: "object",
       properties: {
         task_id: {
           type: "string",
-          description: "The task UUID or section_id"
+          description: "The task UUID"
         },
         output: {
           type: "string",
@@ -5172,7 +5238,7 @@ var schemas = {
       properties: {
         task_id: {
           type: "string",
-          description: "The task UUID or section_id"
+          description: "The task UUID"
         },
         reason: {
           type: "string",
@@ -5188,6 +5254,56 @@ var schemas = {
     }
   },
   // ---------------------------------------------------------------------------
+  // Inbox Tools (v2)
+  // ---------------------------------------------------------------------------
+  list_inbox: {
+    name: "list_inbox",
+    description: "List pending inbox items (decisions, approvals, reviews).",
+    input_schema: {
+      type: "object",
+      properties: {
+        status: {
+          type: "string",
+          enum: ["pending", "resolved"],
+          description: "Filter by status"
+        },
+        kind: {
+          type: "string",
+          enum: ["decision", "approval", "review"],
+          description: "Filter by type"
+        },
+        limit: {
+          type: "number",
+          default: 20,
+          description: "Max results"
+        }
+      },
+      required: []
+    }
+  },
+  resolve_inbox: {
+    name: "resolve_inbox",
+    description: "Resolve an inbox item with a decision. May trigger auto-execution.",
+    input_schema: {
+      type: "object",
+      properties: {
+        inbox_id: {
+          type: "string",
+          description: "The inbox item UUID"
+        },
+        decision: {
+          type: "string",
+          description: "The decision/resolution"
+        },
+        notes: {
+          type: "string",
+          description: "Optional: additional notes"
+        }
+      },
+      required: ["inbox_id", "decision"]
+    }
+  },
+  // ---------------------------------------------------------------------------
   // Blocker Tools
   // ---------------------------------------------------------------------------
   get_blocker: {
@@ -5342,7 +5458,9 @@ var permissionToTools = {
   "agents:read": ["get_agent", "list_agents"],
   "agents:write": ["create_agent", "update_agent"],
   "tasks:read": ["get_task", "list_tasks"],
-  "tasks:write": ["create_task", "complete_task", "block_task"],
+  "tasks:write": ["create_task", "claim_task", "complete_task", "block_task"],
+  "inbox:read": ["list_inbox"],
+  "inbox:write": ["resolve_inbox"],
   "blockers:read": ["get_blocker", "list_blockers"],
   "blockers:write": ["create_blocker", "resolve_blocker"],
   "org:read": ["get_org_context", "get_project", "list_projects"]
@@ -5575,12 +5693,12 @@ var getTaskHandler = async (args, client) => {
 var listTasksHandler = async (args, client) => {
   try {
     const params = new URLSearchParams();
-    if (args.artifact_id) params.set("artifact_id", String(args.artifact_id));
+    if (args.goal_id) params.set("goal_id", String(args.goal_id));
     if (args.status) params.set("status", String(args.status));
     if (args.assignee) params.set("assignee", String(args.assignee));
     if (args.limit) params.set("limit", String(args.limit));
     const query = params.toString();
-    const path3 = `/tasks${query ? `?${query}` : ""}`;
+    const path3 = `/tasks/queue${query ? `?${query}` : ""}`;
     const data = await client.get(path3);
     return { success: true, data };
   } catch (error) {
@@ -5589,23 +5707,27 @@ var listTasksHandler = async (args, client) => {
 };
 var createTaskHandler = async (args, client) => {
   try {
-    const data = await client.post(`/artifacts/${args.artifact_id}/sections`, {
-      section_id: `task-${Date.now()}`,
-      heading: args.heading,
-      content: args.content,
-      type: "task",
-      task_status: "pending",
+    const data = await client.post("/tasks", {
+      goal_id: args.goal_id,
+      title: args.title,
+      description: args.description,
       assignee_agent_id: args.assignee,
       depends_on: args.depends_on,
-      priority: args.priority,
-      agent_id: "system",
-      agent_name: "System"
+      priority: args.priority || "medium"
     });
     return { success: true, data };
   } catch (error) {
     return { success: false, error: String(error) };
   }
 };
+var claimTaskHandler = async (args, client) => {
+  try {
+    const data = await client.post(`/tasks/${args.task_id}/claim`, {});
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
 var completeTaskHandler = async (args, client) => {
   try {
     const data = await client.post(`/tasks/${args.task_id}/complete`, {
@@ -5620,7 +5742,7 @@ var completeTaskHandler = async (args, client) => {
 };
 var blockTaskHandler = async (args, client) => {
   try {
-    const data = await client.post(`/tasks/${args.task_id}/fail`, {
+    const data = await client.post(`/tasks/${args.task_id}/block`, {
       reason: args.reason,
       blocker_type: args.blocker_type
     });
@@ -5629,6 +5751,31 @@ var blockTaskHandler = async (args, client) => {
     return { success: false, error: String(error) };
   }
 };
+var listInboxHandler = async (args, client) => {
+  try {
+    const params = new URLSearchParams();
+    if (args.status) params.set("status", String(args.status));
+    if (args.kind) params.set("kind", String(args.kind));
+    if (args.limit) params.set("limit", String(args.limit));
+    const query = params.toString();
+    const path3 = `/inbox${query ? `?${query}` : ""}`;
+    const data = await client.get(path3);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+var resolveInboxHandler = async (args, client) => {
+  try {
+    const data = await client.post(`/inbox/${args.inbox_id}/resolve`, {
+      decision: args.decision,
+      notes: args.notes
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
 var getBlockerHandler = async (args, client) => {
   try {
     const data = await client.get(`/blockers/${args.blocker_id}`);
@@ -5724,13 +5871,17 @@ var handlers = {
   list_agents: listAgentsHandler,
   create_agent: createAgentHandler,
   update_agent: updateAgentHandler,
-  // Tasks
+  // Tasks (v2)
   get_task: getTaskHandler,
   list_tasks: listTasksHandler,
   create_task: createTaskHandler,
+  claim_task: claimTaskHandler,
   complete_task: completeTaskHandler,
   block_task: blockTaskHandler,
-  // Blockers
+  // Inbox (v2)
+  list_inbox: listInboxHandler,
+  resolve_inbox: resolveInboxHandler,
+  // Blockers (legacy - kept for compatibility)
   get_blocker: getBlockerHandler,
   list_blockers: listBlockersHandler,
   create_blocker: createBlockerHandler,