@zibby/core 0.4.5 → 0.5.0

package/templates/code-analysis/nodes/analyze-ticket-node.js

@@ -1,204 +0,0 @@
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-import { randomBytes } from 'crypto';
-import { z } from 'zod';
-import { adfToText } from '@zibby/core/utils/adf-converter.js';
-
-const generateId = () => randomBytes(16).toString('hex');
-
-const SuggestedChangeSchema = z.object({
-  field: z.enum(['summary', 'description', 'labels'])
-    .describe('Which ticket field this change applies to'),
-  
-  original: z.string()
-    .describe('The original value of the field'),
-  
-  suggested: z.string()
-    .describe('The suggested new value for the field'),
-  
-  reasoning: z.string()
-    .describe('Explanation of why this change improves the ticket')
-});
-
-// Shared validation schema (used by both AI agent output and node output)
-const ValidationSchema = z.object({
-  canProceed: z.boolean()
-    .describe('Whether the ticket has enough information to proceed with implementation'),
-  
-  status: z.enum(['valid', 'insufficient_context', 'unclear_requirements', 'invalid_ticket', 'needs_clarification'])
-    .describe('Status indicating why we can or cannot proceed'),
-  
-  reasoning: z.string()
-    .describe('Explanation of the validation decision - why the ticket is valid or what is missing'),
-  
-  blockers: z.array(z.string())
-    .nullable()
-    .describe('Specific blockers preventing implementation (if canProceed is false), null if none')
-});
-
-const AnalysisOutputSchema = z.object({
-  validation: ValidationSchema
-    .describe('Validation of whether ticket is ready for implementation'),
-  
-  suggestedChanges: z.array(SuggestedChangeSchema)
-    .describe('Array of suggested changes to ticket fields'),
-  
-  technicalAnalysis: z.object({
-    requirements: z.array(z.string())
-      .describe('Key requirements extracted from the ticket'),
-    
-    affectedFiles: z.array(z.string())
-      .nullable()
-      .describe('Files that will likely need changes (null if unknown). Each path MUST start with a top-level repo directory name (e.g. "my-api/src/...")'),
-    
-    complexity: z.enum(['simple', 'medium', 'complex', 'unknown'])
-      .describe('Estimated complexity of the implementation'),
-    
-    risks: z.array(z.string())
-      .nullable()
-      .describe('Potential risks or challenges, null if none')
-  }).describe('Technical analysis of the implementation'),
-  
-  overallSummary: z.string()
-    .describe('Brief summary of the analysis findings'),
-  
-  implementationPlan: z.string()
-    .describe('Markdown implementation plan for the code generation agent. Include: 1) A brief summary of what to build, 2) Which top-level repositories need changes — MUST be the exact directory names from Repository Information, NEVER internal sub-modules or Maven modules, 3) An ordered TODO checklist where every file path starts with a top-level repo name (e.g. "In my-api/src/.../Foo.java" NOT "src/.../Foo.java"), 4) Key technical details like function signatures, patterns to follow, and gotchas. This will be passed directly to the coding agent as its instructions.')
-});
-
-// Node output schema (what this node returns to state)
-const AnalyzeTicketNodeOutputSchema = z.object({
-  success: z.boolean(),
-  analysis: z.object({
-    raw: z.string(),
-    structured: z.object({
-      validation: ValidationSchema,
-      suggestedChanges: z.array(z.any()),
-      technicalAnalysis: z.any(),
-      overallSummary: z.string(),
-      implementationPlan: z.string()
-    }),
-    timestamp: z.string()
-  }),
-  validation: ValidationSchema  // Exposed at root for easy access by conditional logic
-});
-
-export const analyzeTicketNode = {
-  name: 'analyze_ticket',
-  outputSchema: AnalyzeTicketNodeOutputSchema,
-  
-  execute: async (context) => {
-    console.log('\n🔍 Analyzing ticket with Cursor Agent...');
-    
-    // Extract from context (new unified signature)
-    const { state, invokeAgent } = context;
-    const { workspace, ticketContext, repos, model } = state.getAll();
-    const aiModel = model || ticketContext.model || 'auto';
-    
-    // Prepare description text
-    let descriptionText = ticketContext.description || 'No description provided';
-    if (typeof descriptionText === 'object') {
-      descriptionText = adfToText(descriptionText);
-      console.log('⚠️  Description is in ADF format, converted to plain text');
-    }
-    
-    // Build prompt values for template rendering
-    const promptValues = {
-      ticketKey: ticketContext.ticketKey,
-      ticketSummary: ticketContext.summary,
-      ticketDescription: descriptionText,
-      ticketType: ticketContext.type || 'Task',
-      ticketPriority: ticketContext.priority || 'Medium',
-      ticketLabels: Array.isArray(ticketContext.labels) ? ticketContext.labels.join(', ') : (ticketContext.labels || 'None'),
-      ticketComponents: Array.isArray(ticketContext.components) 
-        ? ticketContext.components.map(c => c.name || c).join(', ') || 'None'
-        : (ticketContext.components || 'None'),
-      additionalContext: ticketContext.additionalContext || null,
-      repositories: Array.isArray(repos) ? repos.map(r => ({
-        name: r.name,
-        ...detectProjectInfo(join(workspace, r.name))
-      })) : []
-    };
-    
-    const images = (ticketContext.imageAttachments || [])
-      .filter(att => att.base64)
-      .map(att => ({ mimeType: att.mimeType, base64: att.base64, filename: att.filename }));
-
-    if (images.length > 0) {
-      console.log(`🖼️  Including ${images.length} image attachment(s) for vision analysis`);
-    }
-
-    console.log(`🚀 Running AI Agent to analyze ticket with model: ${aiModel}...`);
-    
-    // Use context.invokeAgent - template rendering handled by framework
-    const validatedOutput = await invokeAgent(promptValues, { 
-      model: aiModel,
-      schema: AnalysisOutputSchema,
-      images
-    });
-    
-    // Handle both structured response and raw response scenarios
-    const output = validatedOutput?.structured || validatedOutput;
-    
-    const suggestedChanges = (output?.suggestedChanges || []).map(change => ({
-      id: generateId(),
-      ...change,
-      status: 'pending'
-    }));
-    
-    const analysis = {
-      raw: JSON.stringify(output),
-      structured: {
-        validation: output?.validation || { canProceed: false, status: 'invalid_ticket', reasoning: 'Failed to parse validation' },
-        suggestedChanges,
-        technicalAnalysis: output?.technicalAnalysis || { requirements: [], complexity: 'unknown' },
-        overallSummary: output?.overallSummary || 'Analysis failed',
-        implementationPlan: output?.implementationPlan || 'No plan generated'
-      },
-      timestamp: new Date().toISOString()
-    };
-    
-    console.log(`✅ Parsed ${suggestedChanges.length} suggested changes`);
-    
-    if (!output?.validation?.canProceed) {
-      console.log(`⚠️  Ticket validation failed: ${output?.validation?.status || 'unknown'}`);
-      console.log(`   Reasoning: ${output?.validation?.reasoning || 'No reasoning provided'}`);
-      if (output?.validation?.blockers) {
-        console.log(`   Blockers:`);
-        output.validation.blockers.forEach(blocker => {
-          console.log(`     - ${blocker}`);
-        });
-      }
-    }
-    
-    return {
-      success: true,
-      analysis,
-      validation: output?.validation || { canProceed: false, status: 'invalid_ticket', reasoning: 'No validation data' }
-    };
-  }
-};
-
-function detectProjectInfo(repoPath) {
-  const info = {
-    framework: 'Unknown',
-    language: 'Unknown',
-    packageManager: 'Unknown'
-  };
-  
-  if (existsSync(join(repoPath, 'package.json'))) {
-    info.language = 'JavaScript/TypeScript';
-    const pkg = JSON.parse(readFileSync(join(repoPath, 'package.json'), 'utf-8'));
-    
-    if (pkg.dependencies?.react) info.framework = 'React';
-    if (pkg.dependencies?.next) info.framework = 'Next.js';
-    if (pkg.dependencies?.vue) info.framework = 'Vue';
-    if (pkg.dependencies?.express) info.framework = 'Express';
-    
-    if (existsSync(join(repoPath, 'yarn.lock'))) info.packageManager = 'yarn';
-    else if (existsSync(join(repoPath, 'pnpm-lock.yaml'))) info.packageManager = 'pnpm';
-    else info.packageManager = 'npm';
-  }
-  
-  return info;
-}

package/templates/code-analysis/nodes/create-pr-node.js

@@ -1,175 +0,0 @@
-import axios from 'axios';
-import { adfToText } from '@zibby/core/utils/adf-converter.js';
-import { z } from 'zod';
-
-const CreatePROutputSchema = z.object({
-  success: z.boolean(),
-  pullRequests: z.array(z.object({
-    number: z.number(),
-    url: z.string(),
-    title: z.string(),
-    repo: z.string(),
-    branch: z.string(),
-    timestamp: z.string()
-  })),
-  pr: z.object({
-    number: z.number(),
-    url: z.string(),
-    title: z.string(),
-    repo: z.string(),
-    branch: z.string(),
-    timestamp: z.string()
-  }).nullable()
-});
-
-export const createPRNode = {
-  name: 'create_pr',
-  outputSchema: CreatePROutputSchema,
-  execute: async (state) => {
-    console.log('\n🔀 Creating Pull Request(s)...');
-    
-    const { ticketContext, repos, githubToken } = state;
-    const codeImpl = state.implement_code_output?.codeImplementation;
-    const tests = state.generate_test_cases_output?.tests;
-    
-    if (!codeImpl) {
-      throw new Error('No code implementation found');
-    }
-    
-    if (!githubToken) {
-      console.log('⚠️  No GitHub token found, skipping PR creation');
-      return { success: true, pullRequests: [] };
-    }
-    
-    const githubRepos = (repos || []).filter(r => {
-      if (r.provider && r.provider !== 'github') return false;
-      return r.url?.includes('github.com');
-    });
-    
-    if (githubRepos.length === 0) {
-      console.log('⚠️  No GitHub repositories found, skipping PR creation');
-      return { success: true, pullRequests: [] };
-    }
-    
-    const committedRepos = new Set(codeImpl.committedRepos || []);
-    const prBody = buildPRBody(ticketContext, codeImpl, tests);
-    const pullRequests = [];
-    const errors = [];
-    
-    for (const repo of githubRepos) {
-      if (committedRepos.size > 0 && !committedRepos.has(repo.name)) {
-        console.log(`⏭️ No changes committed in ${repo.name}, skipping PR`);
-        continue;
-      }
-      
-      const match = repo.url.match(/github\.com\/([^/]+)\/([^/]+)/);
-      if (!match) {
-        console.warn(`⚠️ Invalid GitHub URL for ${repo.name}: ${repo.url}`);
-        continue;
-      }
-      
-      const [, owner, repoName] = match;
-      const cleanRepoName = repoName.replace(/\.git$/, '');
-      
-      console.log(`📤 Creating PR in ${owner}/${cleanRepoName}...`);
-      
-      try {
-        const response = await axios.post(
-          `https://api.github.com/repos/${owner}/${cleanRepoName}/pulls`,
-          {
-            title: `${ticketContext.ticketKey}: ${ticketContext.summary}`,
-            head: codeImpl.branchName,
-            base: repo.branch || 'main',
-            body: prBody,
-            draft: false
-          },
-          {
-            headers: {
-              'Authorization': `token ${githubToken}`,
-              'Accept': 'application/vnd.github.v3+json',
-              'Content-Type': 'application/json'
-            }
-          }
-        );
-        
-        const pr = response.data;
-        console.log(`✅ PR created: ${pr.html_url} (#${pr.number})`);
-        
-        pullRequests.push({
-          number: pr.number,
-          url: pr.html_url,
-          title: pr.title,
-          repo: `${owner}/${cleanRepoName}`,
-          branch: codeImpl.branchName,
-          timestamp: new Date().toISOString()
-        });
-      } catch (error) {
-        const msg = error.response?.data?.message || error.message;
-        console.error(`❌ Failed to create PR for ${owner}/${cleanRepoName}: ${msg}`);
-        errors.push({ repo: `${owner}/${cleanRepoName}`, error: msg });
-      }
-    }
-    
-    if (pullRequests.length === 0 && errors.length > 0) {
-      throw new Error(`All PR creations failed: ${errors.map(e => `${e.repo}: ${e.error}`).join('; ')}`);
-    }
-    
-    return {
-      success: true,
-      pullRequests,
-      pr: pullRequests[0] || null
-    };
-  }
-};
-
-function buildPRBody(ticketContext, codeImpl, tests) {
-  const description = typeof ticketContext.description === 'object'
-    ? adfToText(ticketContext.description)
-    : ticketContext.description;
-  let body = `## 🎫 Ticket: ${ticketContext.ticketKey}
-
-${description || ticketContext.summary}
-
-## 📊 Changes
-
-`;
-
-  if (codeImpl.metrics) {
-    body += `### Metrics
-- **Files Changed**: ${codeImpl.metrics.filesChanged}
-- **Lines Added**: +${codeImpl.metrics.additions}
-- **Lines Deleted**: -${codeImpl.metrics.deletions}
-- **Net Change**: ${codeImpl.metrics.netChange} lines
-
-`;
-  }
-
-  body += `### Affected Files
-${codeImpl.changedFiles.map(f => `- \`${f}\``).join('\n')}
-
-`;
-
-  if (tests && tests.cases && tests.cases.length > 0) {
-    body += `## 🧪 Test Cases
-
-Generated ${tests.cases.length} test cases:
-
-${tests.cases.map((tc, i) => `### ${i + 1}. ${tc.name}
-
-${tc.description}
-
-**Steps:**
-${tc.steps.map((s, j) => `${j + 1}. ${s}`).join('\n')}
-
-**Expected:** ${tc.expected}
-
-`).join('\n')}
-`;
-  }
-
-  body += `---
-🤖 *This PR was automatically generated by [Zibby Agent](https://zibby.dev)*
-`;
-
-  return body;
-}

package/templates/code-analysis/nodes/finalize-node.js

@@ -1,118 +0,0 @@
-import { z } from 'zod';
-
-const ReportSchema = z.object({
-  status: z.enum(['completed', 'blocked', 'insufficient_context', 'failed'])
-    .describe('Final execution status'),
-
-  summary: z.string()
-    .describe('1-2 sentence human-readable summary of what was analyzed/implemented'),
-
-  storyPoints: z.object({
-    points: z.number(),
-    confidence: z.enum(['high', 'medium', 'low'])
-  }).optional()
-    .describe('Story point estimate from analysis'),
-
-  complexity: z.enum(['simple', 'medium', 'complex', 'unknown']).optional()
-    .describe('Implementation complexity from analysis'),
-
-  codeMetrics: z.object({
-    filesChanged: z.number(),
-    additions: z.number(),
-    deletions: z.number(),
-    netChange: z.number()
-  }).optional()
-    .describe('Code change metrics (only present when code was generated)'),
-
-  testCount: z.number().optional()
-    .describe('Number of test cases generated'),
-
-  risks: z.array(z.string()).optional()
-    .describe('Potential risks or challenges identified during analysis'),
-
-  blockers: z.array(z.string()).optional()
-    .describe('Blockers preventing implementation (when status is blocked/insufficient_context)')
-});
-
-const FinalizeOutputSchema = z.object({
-  success: z.boolean(),
-  report: ReportSchema
-});
-
-export const finalizeNode = {
-  name: 'finalize',
-  outputSchema: FinalizeOutputSchema,
-
-  execute: async (state) => {
-    console.log('\n📝 Finalizing...');
-
-    const { ticketContext } = state;
-
-    const analysis = state.analysis;
-    const codeImpl = state.codeImplementation;
-    const tests = state.tests;
-
-    const structured = analysis?.structured;
-    const validation = structured?.validation;
-
-    let status = 'completed';
-    let blockers;
-    if (validation && !validation.canProceed) {
-      status = validation.status === 'insufficient_context'
-        ? 'insufficient_context'
-        : 'blocked';
-      blockers = validation.blockers;
-    }
-
-    const testCases = tests?.structured?.testCases || tests?.cases || [];
-
-    const report = {
-      status,
-      summary: structured?.overallSummary || ticketContext.summary || `Analysis for ${ticketContext.ticketKey}`,
-
-      ...(structured?.storyPointEstimate && {
-        storyPoints: {
-          points: structured.storyPointEstimate.points,
-          confidence: structured.storyPointEstimate.confidence
-        }
-      }),
-
-      ...(structured?.technicalAnalysis?.complexity && {
-        complexity: structured.technicalAnalysis.complexity
-      }),
-
-      ...(codeImpl?.metrics && {
-        codeMetrics: {
-          filesChanged: codeImpl.metrics.filesChanged,
-          additions: codeImpl.metrics.additions,
-          deletions: codeImpl.metrics.deletions,
-          netChange: codeImpl.metrics.netChange
-        }
-      }),
-
-      ...(testCases.length > 0 && { testCount: testCases.length }),
-
-      ...(structured?.technicalAnalysis?.risks?.length > 0 && {
-        risks: structured.technicalAnalysis.risks
-      }),
-
-      ...(blockers?.length > 0 && { blockers })
-    };
-
-    console.log(`\n${  '='.repeat(60)}`);
-    console.log('FINALIZE SUMMARY');
-    console.log('='.repeat(60));
-    console.log(JSON.stringify(report, null, 2));
-    console.log('='.repeat(60));
-
-    if (status !== 'completed') {
-      console.log(`\n⚠️  Execution blocked: ${status}`);
-      if (validation?.reasoning) console.log(`   Reason: ${validation.reasoning}`);
-    }
-
-    return {
-      success: true,
-      report
-    };
-  }
-};