@artyfacts/claude 1.1.1 → 1.2.0

package/dist/index.js

@@ -32,7 +32,10 @@ var index_exports = {};
 __export(index_exports, {
   ArtyfactsListener: () => ArtyfactsListener,
   ClaudeExecutor: () => ClaudeExecutor,
+  ContextFetcher: () => ContextFetcher,
+  buildPromptWithContext: () => buildPromptWithContext,
   clearCredentials: () => clearCredentials,
+  createContextFetcher: () => createContextFetcher,
   createExecutor: () => createExecutor,
   createListener: () => createListener,
   getCredentials: () => getCredentials,
@@ -233,6 +236,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.
 
@@ -253,25 +403,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);
@@ -601,7 +777,10 @@ function createListener(config) {
 0 && (module.exports = {
   ArtyfactsListener,
   ClaudeExecutor,
+  ContextFetcher,
+  buildPromptWithContext,
   clearCredentials,
+  createContextFetcher,
   createExecutor,
   createListener,
   getCredentials,

package/dist/index.mjs

@@ -1,7 +1,10 @@
 import {
   ArtyfactsListener,
   ClaudeExecutor,
+  ContextFetcher,
+  buildPromptWithContext,
   clearCredentials,
+  createContextFetcher,
   createExecutor,
   createListener,
   getCredentials,
@@ -9,11 +12,14 @@ import {
   promptForApiKey,
   runDeviceAuth,
   saveCredentials
-} from "./chunk-4RRGLYN6.mjs";
+} from "./chunk-EROV5RIA.mjs";
 export {
   ArtyfactsListener,
   ClaudeExecutor,
+  ContextFetcher,
+  buildPromptWithContext,
   clearCredentials,
+  createContextFetcher,
   createExecutor,
   createListener,
   getCredentials,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artyfacts/claude",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Claude adapter for Artyfacts - Execute tasks using Claude Code CLI",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/cli.ts

@@ -126,6 +126,130 @@ program
     }
   });
 
+// ============================================================================
+// Task Queue Polling
+// ============================================================================
+
+/**
+ * Check for claimable tasks and process them
+ */
+async function checkAndClaimTasks(
+  baseUrl: string,
+  apiKey: string,
+  agentId: string,
+  activeTasks: Set<string>,
+  executor: ClaudeExecutor,
+  dryRun: boolean
+): Promise<void> {
+  try {
+    // Fetch claimable tasks from queue
+    const response = await fetch(`${baseUrl}/tasks/queue?limit=5`, {
+      headers: {
+        'Authorization': `Bearer ${apiKey}`,
+      },
+    });
+
+    if (!response.ok) {
+      console.log('⚠️  Could not fetch task queue');
+      return;
+    }
+
+    const data = await response.json() as { tasks?: Array<{
+      id: string;
+      section_id: string;
+      heading: string;
+      content: string;
+      artifact_id: string;
+      artifact_title?: string;
+      priority?: number;
+    }> };
+
+    const tasks = data.tasks || [];
+    
+    if (tasks.length === 0) {
+      console.log('📭 No claimable tasks in queue');
+      return;
+    }
+
+    console.log(`📬 Found ${tasks.length} claimable task(s)`);
+
+    // Process first available task
+    for (const task of tasks) {
+      if (activeTasks.has(task.section_id)) {
+        continue; // Already processing
+      }
+
+      // Try to claim the task
+      console.log(`\n[Claiming] ${task.heading}`);
+      
+      const claimResponse = await fetch(`${baseUrl}/tasks/${task.section_id}/claim`, {
+        method: 'POST',
+        headers: {
+          'Authorization': `Bearer ${apiKey}`,
+          'Content-Type': 'application/json',
+        },
+      });
+
+      if (!claimResponse.ok) {
+        const error = await claimResponse.json().catch(() => ({})) as { error?: string };
+        console.log(`  ⚠️  Could not claim: ${error.error || 'Unknown error'}`);
+        continue;
+      }
+
+      // Successfully claimed - now execute
+      activeTasks.add(task.section_id);
+      console.log('  ✓ Claimed!');
+
+      if (dryRun) {
+        console.log('  📋 Dry run - not executing');
+        activeTasks.delete(task.section_id);
+        continue;
+      }
+
+      console.log('  → Executing with Claude...');
+
+      try {
+        const result = await executor.execute({
+          taskId: task.section_id,
+          heading: task.heading,
+          content: task.content,
+          artifactId: task.artifact_id,
+          artifactTitle: task.artifact_title,
+          priority: task.priority,
+        });
+
+        if (result.success) {
+          await completeTask({
+            baseUrl,
+            apiKey,
+            taskId: task.section_id,
+            output: result.output,
+            summary: result.summary,
+          });
+          console.log(`  → ✅ Completed! ${result.summary}`);
+        } else {
+          console.log(`  → ❌ Failed: ${result.error}`);
+          await blockTask({
+            baseUrl,
+            apiKey,
+            taskId: task.section_id,
+            reason: result.error || 'Execution failed',
+          });
+        }
+      } catch (error) {
+        console.error(`  → ❌ Error:`, error instanceof Error ? error.message : error);
+      } finally {
+        activeTasks.delete(task.section_id);
+      }
+
+      // Only process one task at a time for now
+      break;
+    }
+  } catch (error) {
+    console.error('Error checking task queue:', error instanceof Error ? error.message : error);
+  }
+}
+
 // ============================================================================
 // Main Agent Loop
 // ============================================================================
@@ -145,10 +269,14 @@ async function runAgent(options: {
     process.exit(1);
   }
 
-  // Create executor (uses Claude Code CLI)
+  // Create executor (uses Claude Code CLI + Artyfacts context API)
   let executor: ClaudeExecutor | null = null;
   if (!options.dryRun) {
-    executor = createExecutor();
+    executor = createExecutor({
+      // Pass API credentials so executor can fetch full context
+      baseUrl: options.baseUrl,
+      apiKey: credentials.apiKey,
+    });
 
     // Check if Claude Code is installed
     const installed = await executor.isInstalled();
@@ -168,6 +296,7 @@ async function runAgent(options: {
       process.exit(1);
     }
     console.log('✅ Claude Code connected');
+    console.log('📚 Context fetching enabled (will fetch org/project/artifact context)');
   }
 
   // Create listener
@@ -183,6 +312,11 @@ async function runAgent(options: {
         case 'connected':
           console.log(`✅ Connected as ${credentials.agentId}`);
           console.log('👂 Listening for tasks...\n');
+          
+          // Check for existing claimable tasks on connect
+          if (!options.dryRun) {
+            checkAndClaimTasks(options.baseUrl, credentials.apiKey, credentials.agentId, activeTasks, executor!, options.dryRun);
+          }
           break;
         case 'reconnecting':
           console.log('🔄 Reconnecting...');

package/src/context.ts

@@ -0,0 +1,260 @@
+/**
+ * Context fetcher for Artyfacts tasks
+ * 
+ * Fetches full context including organization, project, artifact, and related sections.
+ */
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface OrganizationContext {
+  id: string;
+  name: string;
+  context?: string;
+}
+
+export interface ProjectContext {
+  id: string;
+  name: string;
+  description?: string;
+}
+
+export interface SectionContext {
+  id: string;
+  heading: string;
+  content?: string;
+  section_type?: string;
+  task_status?: string;
+}
+
+export interface ArtifactContext {
+  id: string;
+  title: string;
+  summary?: string;
+  description?: string;
+  artifact_type?: string;
+  sections: SectionContext[];
+}
+
+export interface TaskFullContext {
+  task: {
+    id: string;
+    heading: string;
+    content: string;
+    expected_output?: {
+      format?: string;
+      requirements?: string[];
+    };
+    priority?: number;
+  };
+  artifact: ArtifactContext;
+  project?: ProjectContext;
+  organization: OrganizationContext;
+}
+
+export interface ContextFetcherConfig {
+  baseUrl: string;
+  apiKey: string;
+}
+
+// ============================================================================
+// Context Fetcher
+// ============================================================================
+
+export class ContextFetcher {
+  private config: ContextFetcherConfig;
+
+  constructor(config: ContextFetcherConfig) {
+    this.config = config;
+  }
+
+  /**
+   * Fetch full context for a task
+   */
+  async fetchTaskContext(taskId: string): Promise<TaskFullContext> {
+    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 as TaskFullContext;
+  }
+}
+
+// ============================================================================
+// Prompt Builder
+// ============================================================================
+
+/**
+ * Build a rich prompt with full context
+ */
+export function buildPromptWithContext(context: TaskFullContext): string {
+  const parts: string[] = [];
+
+  // System instruction
+  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('');
+
+  // Organization context
+  parts.push('## Organization Context');
+  parts.push(`**${context.organization.name}**`);
+  if (context.organization.context) {
+    parts.push('');
+    parts.push(formatOrgContext(context.organization.context));
+  }
+  parts.push('');
+
+  // Project context (if available)
+  if (context.project) {
+    parts.push(`## Project: ${context.project.name}`);
+    if (context.project.description) {
+      parts.push(context.project.description);
+    }
+    parts.push('');
+  }
+
+  // Artifact context
+  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('');
+
+  // Related sections (non-task sections for context, or other tasks for awareness)
+  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('');
+  }
+
+  // The task itself
+  parts.push('---');
+  parts.push('');
+  parts.push(`## Your Task: ${context.task.heading}`);
+  
+  if (context.task.priority) {
+    const priorityLabels = ['🔴 High', '🟡 Medium', '🟢 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('');
+
+  // Expected output
+  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('');
+  }
+
+  // Final instruction
+  parts.push('---');
+  parts.push('');
+  parts.push('Complete this task and provide your output below.');
+
+  return parts.join('\n');
+}
+
+/**
+ * Format organization context (may contain markdown or JSON)
+ */
+function formatOrgContext(context: string): string {
+  // If it looks like JSON, try to parse and format it nicely
+  const trimmed = context.trim();
+  if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      // Convert to readable bullet points
+      return formatContextObject(parsed);
+    } catch {
+      // Not valid JSON, return as-is
+      return context;
+    }
+  }
+  return context;
+}
+
+/**
+ * Format a context object into readable bullet points
+ */
+function formatContextObject(obj: unknown, indent = ''): string {
+  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: string[] = [];
+  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');
+}
+
+// ============================================================================
+// Factory
+// ============================================================================
+
+export function createContextFetcher(config: ContextFetcherConfig): ContextFetcher {
+  return new ContextFetcher(config);
+}