@artyfacts/claude 1.1.2 → 1.2.1

package/dist/cli.js

@@ -216,6 +216,153 @@ async function getCredentials(options) {
 
 // src/executor.ts
 var import_child_process = require("child_process");
+
+// src/context.ts
+var ContextFetcher = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Fetch full context for a task
+   */
+  async fetchTaskContext(taskId) {
+    const response = await fetch(
+      `${this.config.baseUrl}/tasks/${taskId}/context`,
+      {
+        headers: {
+          "Authorization": `Bearer ${this.config.apiKey}`,
+          "Accept": "application/json"
+        }
+      }
+    );
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(`Failed to fetch task context: ${response.status} - ${errorText}`);
+    }
+    const data = await response.json();
+    return data;
+  }
+};
+function buildPromptWithContext(context) {
+  const parts = [];
+  parts.push(`You are an AI agent working within the Artyfacts task management system.
+
+Your job is to complete the assigned task. You have full context about the organization, project, and related work.
+
+Guidelines:
+- Be thorough but concise
+- If the task requires code, provide working code
+- If the task requires analysis, provide structured findings
+- If the task requires a decision, explain your reasoning
+- If you cannot complete the task, explain why
+
+Format your response as follows:
+1. First, provide your main output (the task deliverable)
+2. End with a brief summary line starting with "SUMMARY:"`);
+  parts.push("");
+  parts.push("---");
+  parts.push("");
+  parts.push("## Organization Context");
+  parts.push(`**${context.organization.name}**`);
+  if (context.organization.context) {
+    parts.push("");
+    parts.push(formatOrgContext(context.organization.context));
+  }
+  parts.push("");
+  if (context.project) {
+    parts.push(`## Project: ${context.project.name}`);
+    if (context.project.description) {
+      parts.push(context.project.description);
+    }
+    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}`);
+    }
+    parts.push("");
+  }
+  parts.push("---");
+  parts.push("");
+  parts.push(`## Your Task: ${context.task.heading}`);
+  if (context.task.priority) {
+    const priorityLabels = ["\u{1F534} High", "\u{1F7E1} Medium", "\u{1F7E2} Low"];
+    parts.push(`**Priority:** ${priorityLabels[context.task.priority - 1] || "Medium"}`);
+  }
+  parts.push("");
+  parts.push("### Description");
+  parts.push(context.task.content || "No additional description provided.");
+  parts.push("");
+  if (context.task.expected_output) {
+    parts.push("### Expected Output");
+    if (context.task.expected_output.format) {
+      parts.push(`**Format:** ${context.task.expected_output.format}`);
+    }
+    if (context.task.expected_output.requirements && context.task.expected_output.requirements.length > 0) {
+      parts.push("**Requirements:**");
+      for (const req of context.task.expected_output.requirements) {
+        parts.push(`- ${req}`);
+      }
+    }
+    parts.push("");
+  }
+  parts.push("---");
+  parts.push("");
+  parts.push("Complete this task and provide your output below.");
+  return parts.join("\n");
+}
+function formatOrgContext(context) {
+  const trimmed = context.trim();
+  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      return formatContextObject(parsed);
+    } catch {
+      return context;
+    }
+  }
+  return context;
+}
+function formatContextObject(obj, indent = "") {
+  if (typeof obj !== "object" || obj === null) {
+    return String(obj);
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => `${indent}- ${formatContextObject(item, indent + "  ")}`).join("\n");
+  }
+  const lines = [];
+  for (const [key, value] of Object.entries(obj)) {
+    const label = key.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+    if (typeof value === "object" && value !== null) {
+      lines.push(`${indent}**${label}:**`);
+      lines.push(formatContextObject(value, indent + "  "));
+    } else {
+      lines.push(`${indent}- **${label}:** ${value}`);
+    }
+  }
+  return lines.join("\n");
+}
+function createContextFetcher(config) {
+  return new ContextFetcher(config);
+}
+
+// src/executor.ts
 var DEFAULT_TIMEOUT = 5 * 60 * 1e3;
 var DEFAULT_SYSTEM_PROMPT = `You are an AI agent working within the Artyfacts task management system.
 
@@ -236,25 +383,51 @@ Format your response as follows:
 2. End with a brief summary line starting with "SUMMARY:"`;
 var ClaudeExecutor = class {
   config;
+  contextFetcher = null;
   constructor(config = {}) {
     this.config = {
       ...config,
       timeout: config.timeout || DEFAULT_TIMEOUT,
       claudePath: config.claudePath || "claude"
     };
+    if (config.baseUrl && config.apiKey) {
+      this.contextFetcher = createContextFetcher({
+        baseUrl: config.baseUrl,
+        apiKey: config.apiKey
+      });
+    }
   }
   /**
    * Execute a task using Claude Code CLI
+   * 
+   * If full context is available (baseUrl + apiKey configured), fetches
+   * organization, project, artifact, and related sections for a rich prompt.
    */
   async execute(task) {
     try {
-      const prompt = this.buildTaskPrompt(task);
+      let prompt;
+      let fullContext = null;
+      const useFullContext = this.config.useFullContext !== false && this.contextFetcher;
+      if (useFullContext) {
+        try {
+          fullContext = await this.contextFetcher.fetchTaskContext(task.taskId);
+          prompt = buildPromptWithContext(fullContext);
+          console.log("  \u{1F4DA} Using full context (org, project, artifact, related sections)");
+        } catch (contextError) {
+          console.warn("  \u26A0\uFE0F  Could not fetch full context, using minimal prompt");
+          console.warn(`     ${contextError instanceof Error ? contextError.message : contextError}`);
+          prompt = this.buildTaskPrompt(task);
+        }
+      } else {
+        prompt = this.buildTaskPrompt(task);
+      }
       const output = await this.runClaude(prompt);
       const { content, summary } = this.parseResponse(output, task.heading);
       return {
         success: true,
         output: content,
-        summary
+        summary,
+        promptUsed: prompt
       };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
@@ -673,6 +846,8 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
         console.log(`  \u26A0\uFE0F  Could not claim: ${error.error || "Unknown error"}`);
         continue;
       }
+      const claimedTask = await claimResponse.json().catch(() => ({ id: task.id }));
+      const taskUuid = claimedTask.id || task.id;
       activeTasks.add(task.section_id);
       console.log("  \u2713 Claimed!");
       if (dryRun) {
@@ -683,7 +858,8 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
       console.log("  \u2192 Executing with Claude...");
       try {
         const result = await executor.execute({
-          taskId: task.section_id,
+          taskId: taskUuid,
+          // Use UUID instead of section_id
           heading: task.heading,
           content: task.content,
           artifactId: task.artifact_id,
@@ -694,7 +870,8 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
           await completeTask({
             baseUrl,
             apiKey,
-            taskId: task.section_id,
+            taskId: taskUuid,
+            // Use UUID instead of section_id
             output: result.output,
             summary: result.summary
           });
@@ -704,7 +881,8 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
           await blockTask({
             baseUrl,
             apiKey,
-            taskId: task.section_id,
+            taskId: taskUuid,
+            // Use UUID instead of section_id
             reason: result.error || "Execution failed"
           });
         }
@@ -730,7 +908,11 @@ async function runAgent(options) {
   }
   let executor = null;
   if (!options.dryRun) {
-    executor = createExecutor();
+    executor = createExecutor({
+      // Pass API credentials so executor can fetch full context
+      baseUrl: options.baseUrl,
+      apiKey: credentials.apiKey
+    });
     const installed = await executor.isInstalled();
     if (!installed) {
       console.error("\u274C Claude Code CLI not found");
@@ -746,6 +928,7 @@ async function runAgent(options) {
       process.exit(1);
     }
     console.log("\u2705 Claude Code connected");
+    console.log("\u{1F4DA} Context fetching enabled (will fetch org/project/artifact context)");
   }
   const listener = createListener({
     apiKey: credentials.apiKey,
@@ -759,7 +942,9 @@ async function runAgent(options) {
         case "connected":
           console.log(`\u2705 Connected as ${credentials.agentId}`);
           console.log("\u{1F442} Listening for tasks...\n");
-          checkAndClaimTasks(options.baseUrl, credentials.apiKey, credentials.agentId, activeTasks, executor, options.dryRun);
+          if (!options.dryRun) {
+            checkAndClaimTasks(options.baseUrl, credentials.apiKey, credentials.agentId, activeTasks, executor, options.dryRun);
+          }
           break;
         case "reconnecting":
           console.log("\u{1F504} Reconnecting...");

package/dist/cli.mjs

@@ -6,7 +6,7 @@ import {
   getCredentials,
   loadCredentials,
   promptForApiKey
-} from "./chunk-4RRGLYN6.mjs";
+} from "./chunk-EROV5RIA.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -101,6 +101,8 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
         console.log(`  \u26A0\uFE0F  Could not claim: ${error.error || "Unknown error"}`);
         continue;
       }
+      const claimedTask = await claimResponse.json().catch(() => ({ id: task.id }));
+      const taskUuid = claimedTask.id || task.id;
       activeTasks.add(task.section_id);
       console.log("  \u2713 Claimed!");
       if (dryRun) {
@@ -111,7 +113,8 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
       console.log("  \u2192 Executing with Claude...");
       try {
         const result = await executor.execute({
-          taskId: task.section_id,
+          taskId: taskUuid,
+          // Use UUID instead of section_id
           heading: task.heading,
           content: task.content,
           artifactId: task.artifact_id,
@@ -122,7 +125,8 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
           await completeTask({
             baseUrl,
             apiKey,
-            taskId: task.section_id,
+            taskId: taskUuid,
+            // Use UUID instead of section_id
             output: result.output,
             summary: result.summary
           });
@@ -132,7 +136,8 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
           await blockTask({
             baseUrl,
             apiKey,
-            taskId: task.section_id,
+            taskId: taskUuid,
+            // Use UUID instead of section_id
             reason: result.error || "Execution failed"
           });
         }
@@ -158,7 +163,11 @@ async function runAgent(options) {
   }
   let executor = null;
   if (!options.dryRun) {
-    executor = createExecutor();
+    executor = createExecutor({
+      // Pass API credentials so executor can fetch full context
+      baseUrl: options.baseUrl,
+      apiKey: credentials.apiKey
+    });
     const installed = await executor.isInstalled();
     if (!installed) {
       console.error("\u274C Claude Code CLI not found");
@@ -174,6 +183,7 @@ async function runAgent(options) {
       process.exit(1);
     }
     console.log("\u2705 Claude Code connected");
+    console.log("\u{1F4DA} Context fetching enabled (will fetch org/project/artifact context)");
   }
   const listener = createListener({
     apiKey: credentials.apiKey,
@@ -187,7 +197,9 @@ async function runAgent(options) {
         case "connected":
           console.log(`\u2705 Connected as ${credentials.agentId}`);
           console.log("\u{1F442} Listening for tasks...\n");
-          checkAndClaimTasks(options.baseUrl, credentials.apiKey, credentials.agentId, activeTasks, executor, options.dryRun);
+          if (!options.dryRun) {
+            checkAndClaimTasks(options.baseUrl, credentials.apiKey, credentials.agentId, activeTasks, executor, options.dryRun);
+          }
           break;
         case "reconnecting":
           console.log("\u{1F504} Reconnecting...");

package/dist/index.d.mts

@@ -59,6 +59,9 @@ declare function getCredentials(options?: {
  *
  * Executes tasks by shelling out to the Claude Code CLI (claude).
  * This uses the user's existing Claude Code authentication - no separate API key needed.
+ *
+ * Now supports fetching full context (organization, project, artifact, related sections)
+ * to provide Claude with the information needed to complete tasks effectively.
  */
 interface TaskContext {
     /** Task ID (section ID) */
@@ -85,6 +88,8 @@ interface ExecutionResult {
     summary: string;
     /** Any error message if failed */
     error?: string;
+    /** The prompt that was used (for debugging) */
+    promptUsed?: string;
 }
 interface ExecutorConfig {
     /** Path to claude CLI (default: 'claude') */
@@ -93,12 +98,22 @@ interface ExecutorConfig {
     timeout?: number;
     /** System prompt prefix */
     systemPromptPrefix?: string;
+    /** Artyfacts API base URL (for fetching context) */
+    baseUrl?: string;
+    /** Artyfacts API key (for fetching context) */
+    apiKey?: string;
+    /** Whether to use full context from API (default: true if apiKey provided) */
+    useFullContext?: boolean;
 }
 declare class ClaudeExecutor {
     private config;
+    private contextFetcher;
     constructor(config?: ExecutorConfig);
     /**
      * Execute a task using Claude Code CLI
+     *
+     * If full context is available (baseUrl + apiKey configured), fetches
+     * organization, project, artifact, and related sections for a rich prompt.
      */
     execute(task: TaskContext): Promise<ExecutionResult>;
     /**
@@ -238,4 +253,67 @@ declare class ArtyfactsListener {
  */
 declare function createListener(config: ListenerConfig): ArtyfactsListener;
 
-export { type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, type ConnectedEvent, type ConnectionState, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult, type ExecutorConfig, type HeartbeatEvent, type ListenerConfig, type TaskAssignedEvent, type TaskContext, type TokenResponse, clearCredentials, createExecutor, createListener, getCredentials, loadCredentials, promptForApiKey, runDeviceAuth, saveCredentials };
+/**
+ * Context fetcher for Artyfacts tasks
+ *
+ * Fetches full context including organization, project, artifact, and related sections.
+ */
+interface OrganizationContext {
+    id: string;
+    name: string;
+    context?: string;
+}
+interface ProjectContext {
+    id: string;
+    name: string;
+    description?: string;
+}
+interface SectionContext {
+    id: string;
+    heading: string;
+    content?: string;
+    section_type?: string;
+    task_status?: string;
+}
+interface ArtifactContext {
+    id: string;
+    title: string;
+    summary?: string;
+    description?: string;
+    artifact_type?: string;
+    sections: SectionContext[];
+}
+interface TaskFullContext {
+    task: {
+        id: string;
+        heading: string;
+        content: string;
+        expected_output?: {
+            format?: string;
+            requirements?: string[];
+        };
+        priority?: number;
+    };
+    artifact: ArtifactContext;
+    project?: ProjectContext;
+    organization: OrganizationContext;
+}
+interface ContextFetcherConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+declare class ContextFetcher {
+    private config;
+    constructor(config: ContextFetcherConfig);
+    /**
+     * Fetch full context for a task
+     */
+    fetchTaskContext(taskId: string): Promise<TaskFullContext>;
+}
+/**
+ * Build a rich prompt with full context
+ */
+declare function buildPromptWithContext(context: TaskFullContext): string;
+declare function createContextFetcher(config: ContextFetcherConfig): ContextFetcher;
+
+export { type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult, type ExecutorConfig, type HeartbeatEvent, type ListenerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext, type TaskFullContext, type TokenResponse, buildPromptWithContext, clearCredentials, createContextFetcher, createExecutor, createListener, getCredentials, loadCredentials, promptForApiKey, runDeviceAuth, saveCredentials };

package/dist/index.d.ts

@@ -59,6 +59,9 @@ declare function getCredentials(options?: {
  *
  * Executes tasks by shelling out to the Claude Code CLI (claude).
  * This uses the user's existing Claude Code authentication - no separate API key needed.
+ *
+ * Now supports fetching full context (organization, project, artifact, related sections)
+ * to provide Claude with the information needed to complete tasks effectively.
  */
 interface TaskContext {
     /** Task ID (section ID) */
@@ -85,6 +88,8 @@ interface ExecutionResult {
     summary: string;
     /** Any error message if failed */
     error?: string;
+    /** The prompt that was used (for debugging) */
+    promptUsed?: string;
 }
 interface ExecutorConfig {
     /** Path to claude CLI (default: 'claude') */
@@ -93,12 +98,22 @@ interface ExecutorConfig {
     timeout?: number;
     /** System prompt prefix */
     systemPromptPrefix?: string;
+    /** Artyfacts API base URL (for fetching context) */
+    baseUrl?: string;
+    /** Artyfacts API key (for fetching context) */
+    apiKey?: string;
+    /** Whether to use full context from API (default: true if apiKey provided) */
+    useFullContext?: boolean;
 }
 declare class ClaudeExecutor {
     private config;
+    private contextFetcher;
     constructor(config?: ExecutorConfig);
     /**
      * Execute a task using Claude Code CLI
+     *
+     * If full context is available (baseUrl + apiKey configured), fetches
+     * organization, project, artifact, and related sections for a rich prompt.
      */
     execute(task: TaskContext): Promise<ExecutionResult>;
     /**
@@ -238,4 +253,67 @@ declare class ArtyfactsListener {
  */
 declare function createListener(config: ListenerConfig): ArtyfactsListener;
 
-export { type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, type ConnectedEvent, type ConnectionState, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult, type ExecutorConfig, type HeartbeatEvent, type ListenerConfig, type TaskAssignedEvent, type TaskContext, type TokenResponse, clearCredentials, createExecutor, createListener, getCredentials, loadCredentials, promptForApiKey, runDeviceAuth, saveCredentials };
+/**
+ * Context fetcher for Artyfacts tasks
+ *
+ * Fetches full context including organization, project, artifact, and related sections.
+ */
+interface OrganizationContext {
+    id: string;
+    name: string;
+    context?: string;
+}
+interface ProjectContext {
+    id: string;
+    name: string;
+    description?: string;
+}
+interface SectionContext {
+    id: string;
+    heading: string;
+    content?: string;
+    section_type?: string;
+    task_status?: string;
+}
+interface ArtifactContext {
+    id: string;
+    title: string;
+    summary?: string;
+    description?: string;
+    artifact_type?: string;
+    sections: SectionContext[];
+}
+interface TaskFullContext {
+    task: {
+        id: string;
+        heading: string;
+        content: string;
+        expected_output?: {
+            format?: string;
+            requirements?: string[];
+        };
+        priority?: number;
+    };
+    artifact: ArtifactContext;
+    project?: ProjectContext;
+    organization: OrganizationContext;
+}
+interface ContextFetcherConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+declare class ContextFetcher {
+    private config;
+    constructor(config: ContextFetcherConfig);
+    /**
+     * Fetch full context for a task
+     */
+    fetchTaskContext(taskId: string): Promise<TaskFullContext>;
+}
+/**
+ * Build a rich prompt with full context
+ */
+declare function buildPromptWithContext(context: TaskFullContext): string;
+declare function createContextFetcher(config: ContextFetcherConfig): ContextFetcher;
+
+export { type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult, type ExecutorConfig, type HeartbeatEvent, type ListenerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext, type TaskFullContext, type TokenResponse, buildPromptWithContext, clearCredentials, createContextFetcher, createExecutor, createListener, getCredentials, loadCredentials, promptForApiKey, runDeviceAuth, saveCredentials };