@artyfacts/claude 1.1.2 → 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.2",
+  "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

@@ -269,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();
@@ -292,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
@@ -309,7 +314,9 @@ async function runAgent(options: {
           console.log('👂 Listening for tasks...\n');
           
           // Check for existing claimable tasks on connect
-          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('🔄 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);
+}

package/src/executor.ts

@@ -3,9 +3,13 @@
  * 
  * 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.
  */
 
 import { spawn } from 'child_process';
+import { ContextFetcher, createContextFetcher, buildPromptWithContext, TaskFullContext } from './context';
 
 // ============================================================================
 // Types
@@ -37,6 +41,8 @@ export interface ExecutionResult {
   summary: string;
   /** Any error message if failed */
   error?: string;
+  /** The prompt that was used (for debugging) */
+  promptUsed?: string;
 }
 
 export interface ExecutorConfig {
@@ -46,6 +52,12 @@ export 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;
 }
 
 // ============================================================================
@@ -78,6 +90,7 @@ Format your response as follows:
 
 export class ClaudeExecutor {
   private config: Required<Pick<ExecutorConfig, 'timeout'>> & ExecutorConfig;
+  private contextFetcher: ContextFetcher | null = null;
 
   constructor(config: ExecutorConfig = {}) {
     this.config = {
@@ -85,15 +98,43 @@ export class ClaudeExecutor {
       timeout: config.timeout || DEFAULT_TIMEOUT,
       claudePath: config.claudePath || 'claude',
     };
+
+    // Initialize context fetcher if API credentials provided
+    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: TaskContext): Promise<ExecutionResult> {
     try {
-      // Build the prompt
-      const prompt = this.buildTaskPrompt(task);
+      let prompt: string;
+      let fullContext: TaskFullContext | null = null;
+
+      // Try to fetch full context if configured
+      const useFullContext = this.config.useFullContext !== false && this.contextFetcher;
+      
+      if (useFullContext) {
+        try {
+          fullContext = await this.contextFetcher!.fetchTaskContext(task.taskId);
+          prompt = buildPromptWithContext(fullContext);
+          console.log('  📚 Using full context (org, project, artifact, related sections)');
+        } catch (contextError) {
+          console.warn('  ⚠️  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);
+      }
 
       // Execute via Claude Code CLI
       const output = await this.runClaude(prompt);
@@ -105,6 +146,7 @@ export class ClaudeExecutor {
         success: true,
         output: content,
         summary,
+        promptUsed: prompt,
       };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);

package/src/index.ts

@@ -84,3 +84,20 @@ export {
   ArtyfactsListener,
   createListener,
 } from './listener';
+
+// Context Fetcher - Types
+export type {
+  TaskFullContext,
+  OrganizationContext,
+  ProjectContext,
+  ArtifactContext,
+  SectionContext,
+  ContextFetcherConfig,
+} from './context';
+
+// Context Fetcher - Functions
+export {
+  ContextFetcher,
+  createContextFetcher,
+  buildPromptWithContext,
+} from './context';