@hasna/skills 0.1.27 → 0.1.30

package/skills/generate-mock-data/src/logger.ts

@@ -0,0 +1,37 @@
+import { appendFileSync, existsSync, mkdirSync } from "fs";
+import { randomUUID } from "crypto";
+import { join } from "path";
+
+export const SKILL_NAME = "generate-mock-data";
+export const SESSION_ID = randomUUID().slice(0, 8);
+
+// Use SKILLS_OUTPUT_DIR from CLI if available, otherwise fall back to cwd
+export const SKILLS_OUTPUT_DIR = process.env.SKILLS_OUTPUT_DIR || join(process.cwd(), ".skills");
+export const EXPORTS_DIR = join(SKILLS_OUTPUT_DIR, "exports", SKILL_NAME);
+export const LOGS_DIR = join(SKILLS_OUTPUT_DIR, "logs", SKILL_NAME);
+
+// Session timestamp for log filename
+export const SESSION_TIMESTAMP = new Date().toISOString().replace(/[:.]/g, "_").replace(/-/g, "_").slice(0, 19).toLowerCase();
+
+// Ensure directories exist
+export function ensureDir(dir: string) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+// Logger
+export function log(message: string, level: "info" | "error" | "success" = "info") {
+  const timestamp = new Date().toISOString();
+  const logFile = join(LOGS_DIR, `log_${SESSION_TIMESTAMP}_${SESSION_ID}.log`);
+
+  ensureDir(LOGS_DIR);
+
+  const logEntry = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
+  appendFileSync(logFile, logEntry);
+
+  const prefix = level === "error" ? "❌" : level === "success" ? "✅" : "ℹ️";
+  console.log(`${prefix} ${message}`);
+}
+
+// Preset schemas

package/skills/generate-mock-data/src/presets.ts

@@ -0,0 +1,110 @@
+import type { Preset, SchemaField } from "./types";
+
+export const PRESET_SCHEMAS: Record<Preset, SchemaField> = {
+  users: {
+    id: "uuid",
+    firstName: "firstName",
+    lastName: "lastName",
+    email: "email",
+    phone: "phone",
+    dateOfBirth: "date",
+    username: "username",
+    avatarUrl: "avatarUrl",
+    address: "address",
+    city: "city",
+    state: "state",
+    zipCode: "zipCode",
+    country: "country",
+  },
+  products: {
+    id: "uuid",
+    name: "productName",
+    description: "paragraph",
+    price: "price",
+    category: "category",
+    sku: "sku",
+    stock: "number",
+    brand: "company",
+    imageUrl: "imageUrl",
+    rating: "rating",
+  },
+  orders: {
+    orderId: "uuid",
+    customerId: "uuid",
+    customerName: "name",
+    customerEmail: "email",
+    orderDate: "date",
+    items: "orderItems",
+    subtotal: "price",
+    tax: "price",
+    shipping: "price",
+    total: "price",
+    status: "orderStatus",
+    trackingNumber: "trackingNumber",
+  },
+  companies: {
+    id: "uuid",
+    name: "company",
+    industry: "industry",
+    employees: "number",
+    foundedYear: "year",
+    revenue: "price",
+    website: "url",
+    description: "paragraph",
+    logoUrl: "imageUrl",
+    address: "address",
+    city: "city",
+    country: "country",
+  },
+  articles: {
+    id: "uuid",
+    title: "title",
+    author: "name",
+    content: "paragraph",
+    excerpt: "sentence",
+    publishedDate: "date",
+    tags: "tags",
+    category: "category",
+    readingTime: "number",
+    viewCount: "number",
+    imageUrl: "imageUrl",
+  },
+  reviews: {
+    id: "uuid",
+    reviewerName: "name",
+    rating: "rating",
+    title: "sentence",
+    text: "paragraph",
+    date: "date",
+    verifiedPurchase: "boolean",
+    helpfulCount: "number",
+    productId: "uuid",
+  },
+  events: {
+    id: "uuid",
+    name: "title",
+    description: "paragraph",
+    startDate: "date",
+    endDate: "date",
+    location: "address",
+    organizer: "name",
+    category: "category",
+    attendees: "number",
+    ticketPrice: "price",
+    status: "eventStatus",
+  },
+  transactions: {
+    transactionId: "uuid",
+    amount: "price",
+    currency: "currency",
+    type: "transactionType",
+    date: "date",
+    description: "sentence",
+    fromAccount: "accountNumber",
+    toAccount: "accountNumber",
+    status: "transactionStatus",
+    balance: "price",
+  },
+};
+
+// Seeded random number generator

package/skills/generate-mock-data/src/types.ts

@@ -0,0 +1,21 @@
+export type Preset = "users" | "products" | "orders" | "companies" | "articles" | "reviews" | "events" | "transactions";
+export type OutputFormat = "json" | "csv" | "sql" | "typescript";
+export type Locale = "en-US" | "de-DE" | "ja-JP" | "fr-FR" | "es-ES" | "pt-BR" | "it-IT" | "nl-NL" | "sv-SE" | "pl-PL";
+
+export interface GenerateOptions {
+  preset?: Preset;
+  count: number;
+  schema?: string;
+  format: OutputFormat;
+  locale: Locale;
+  seed?: string;
+  realistic: boolean;
+  output?: string;
+  table: string;
+}
+
+export interface SchemaField {
+  [key: string]: string;
+}
+
+// Constants

package/skills/generate-pr-description/src/ai.ts

@@ -0,0 +1,144 @@
+import type { CommitInfo, GitDiffResult, Options, PRDescription } from "./types";
+
+export async function analyzeWithAI(
+  diff: string,
+  commits: CommitInfo[],
+  files: GitDiffResult['files'],
+  options: Options
+): Promise<PRDescription> {
+  const apiKey = process.env.ANTHROPIC_API_KEY;
+
+  if (!apiKey) {
+    if (options.verbose) {
+      console.log('⚠️  ANTHROPIC_API_KEY not set, using basic template');
+    }
+    return generateBasicDescription(diff, commits, files);
+  }
+
+  try {
+    const prompt = buildAnalysisPrompt(diff, commits, files);
+
+    const response = await fetch('https://api.anthropic.com/v1/messages', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': apiKey,
+        'anthropic-version': '2023-06-01',
+      },
+      body: JSON.stringify({
+        model: options.model,
+        max_tokens: 4096,
+        messages: [
+          {
+            role: 'user',
+            content: prompt,
+          },
+        ],
+      }),
+    });
+
+    if (!response.ok) {
+      throw new Error(`API request failed: ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    const content = data.content[0].text;
+
+    return parseAIResponse(content, files);
+  } catch (error) {
+    if (options.verbose) {
+      console.error('AI analysis failed:', error);
+      console.log('Falling back to basic template');
+    }
+    return generateBasicDescription(diff, commits, files);
+  }
+}
+
+function buildAnalysisPrompt(
+  diff: string,
+  commits: CommitInfo[],
+  files: GitDiffResult['files']
+): string {
+  // Truncate diff if too large
+  const maxDiffLength = 50000;
+  const truncatedDiff = diff.length > maxDiffLength
+    ? diff.substring(0, maxDiffLength) + '\n\n[... diff truncated ...]'
+    : diff;
+
+  const commitMessages = commits.map(c => `- ${c.message} (${c.hash})`).join('\n');
+
+  return `Analyze the following git changes and generate a comprehensive pull request description.
+
+FILES CHANGED:
+Added: ${files.added.join(', ') || 'none'}
+Modified: ${files.modified.join(', ') || 'none'}
+Deleted: ${files.deleted.join(', ') || 'none'}
+
+COMMIT HISTORY:
+${commitMessages || 'No commits'}
+
+GIT DIFF:
+${truncatedDiff}
+
+Please provide a PR description in the following JSON format:
+{
+  "summary": "Brief 1-2 sentence overview of what this PR does",
+  "changes": ["List of key changes made (3-7 items)"],
+  "whyChanged": "Detailed explanation of why these changes were needed and the approach taken",
+  "breakingChanges": ["List any breaking changes, or empty array if none"],
+  "testPlan": ["Suggested testing steps"],
+  "additionalNotes": ["Any other relevant notes"]
+}
+
+Focus on:
+1. What problem is being solved
+2. Key technical changes
+3. Any breaking changes or migration notes
+4. Testing recommendations
+
+Return only the JSON, no additional text.`;
+}
+
+function parseAIResponse(content: string, files: GitDiffResult['files']): PRDescription {
+  try {
+    // Extract JSON from markdown code blocks if present
+    const jsonMatch = content.match(/\`\`\`(?:json)?\s*(\{[\s\S]*\})\s*\`\`\`/);
+    const jsonStr = jsonMatch ? jsonMatch[1] : content;
+
+    const parsed = JSON.parse(jsonStr);
+
+    return {
+      summary: parsed.summary || 'Changes made to the codebase',
+      changes: parsed.changes || [],
+      whatChanged: files,
+      whyChanged: parsed.whyChanged || 'No detailed explanation provided',
+      breakingChanges: parsed.breakingChanges || [],
+      testPlan: parsed.testPlan || [],
+      additionalNotes: parsed.additionalNotes || [],
+    };
+  } catch (error) {
+    throw new Error(`Failed to parse AI response: ${error}`);
+  }
+}
+
+export function generateBasicDescription(
+  diff: string,
+  commits: CommitInfo[],
+  files: GitDiffResult['files']
+): PRDescription {
+  const summary = commits.length > 0
+    ? commits[0].message
+    : 'Changes to the codebase';
+
+  const changes = commits.map(c => c.message);
+
+  return {
+    summary,
+    changes: changes.length > 0 ? changes : ['Various code changes'],
+    whatChanged: files,
+    whyChanged: 'Please add context about why these changes were made.',
+    breakingChanges: [],
+    testPlan: ['Run existing test suite', 'Manual testing as needed'],
+    additionalNotes: [],
+  };
+}

package/skills/generate-pr-description/src/cli.ts

@@ -0,0 +1,80 @@
+import type { Options } from "./types";
+
+export function parseArguments(): Options {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(`generate-pr-description
+
+Usage:
+  generate-pr-description [options]
+
+Options:
+  --base <branch>       Base branch, default main
+  --head <branch>       Head branch
+  --format <format>     github, gitlab, bitbucket, or plain
+  --output <path>       Output file
+  --include-files       Include changed file list
+  --staged              Use staged changes
+  --unstaged            Use unstaged changes
+  --no-ai               Generate a basic non-AI template
+  --copy                Copy output to clipboard`);
+    process.exit(0);
+  }
+
+  const options: Options = {
+    base: 'main',
+    format: 'github',
+    includeFiles: false,
+    staged: false,
+    unstaged: false,
+    noAi: false,
+    model: 'claude-3-5-sonnet-20241022',
+    copy: false,
+    verbose: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    switch (arg) {
+      case '--base':
+        options.base = args[++i];
+        break;
+      case '--head':
+        options.head = args[++i];
+        break;
+      case '--format':
+        options.format = args[++i] as Options['format'];
+        break;
+      case '--output':
+        options.output = args[++i];
+        break;
+      case '--include-files':
+        options.includeFiles = true;
+        break;
+      case '--template':
+        options.template = args[++i];
+        break;
+      case '--staged':
+        options.staged = true;
+        break;
+      case '--unstaged':
+        options.unstaged = true;
+        break;
+      case '--no-ai':
+        options.noAi = true;
+        break;
+      case '--model':
+        options.model = args[++i];
+        break;
+      case '--copy':
+        options.copy = true;
+        break;
+      case '--verbose':
+        options.verbose = true;
+        break;
+    }
+  }
+
+  return options;
+}

package/skills/generate-pr-description/src/clipboard.ts

@@ -0,0 +1,30 @@
+import { spawnSync } from "child_process";
+
+export function copyToClipboard(text: string): boolean {
+  try {
+    // Try pbcopy (macOS)
+    const pbcopy = spawnSync('pbcopy', [], {
+      input: text,
+      encoding: 'utf-8',
+    });
+    if (pbcopy.status === 0) return true;
+
+    // Try xclip (Linux)
+    const xclip = spawnSync('xclip', ['-selection', 'clipboard'], {
+      input: text,
+      encoding: 'utf-8',
+    });
+    if (xclip.status === 0) return true;
+
+    // Try wl-copy (Wayland)
+    const wlcopy = spawnSync('wl-copy', [], {
+      input: text,
+      encoding: 'utf-8',
+    });
+    if (wlcopy.status === 0) return true;
+
+    return false;
+  } catch {
+    return false;
+  }
+}

package/skills/generate-pr-description/src/formatters.ts

@@ -0,0 +1,231 @@
+import type { Options, PRDescription } from "./types";
+
+function formatGitHub(description: PRDescription, options: Options): string {
+  let output = '## Summary\n\n';
+  output += `${description.summary}\n\n`;
+
+  if (description.changes.length > 0) {
+    output += '## Changes\n\n';
+    description.changes.forEach(change => {
+      output += `- ${change}\n`;
+    });
+    output += '\n';
+  }
+
+  if (options.includeFiles) {
+    output += '## What Changed\n\n';
+
+    if (description.whatChanged.added.length > 0) {
+      output += '### Added\n';
+      description.whatChanged.added.forEach(file => {
+        output += `- \`${file}\`\n`;
+      });
+      output += '\n';
+    }
+
+    if (description.whatChanged.modified.length > 0) {
+      output += '### Modified\n';
+      description.whatChanged.modified.forEach(file => {
+        output += `- \`${file}\`\n`;
+      });
+      output += '\n';
+    }
+
+    if (description.whatChanged.deleted.length > 0) {
+      output += '### Deleted\n';
+      description.whatChanged.deleted.forEach(file => {
+        output += `- \`${file}\`\n`;
+      });
+      output += '\n';
+    }
+  }
+
+  output += '## Why These Changes\n\n';
+  output += `${description.whyChanged}\n\n`;
+
+  if (description.breakingChanges.length > 0) {
+    output += '## Breaking Changes\n\n';
+    description.breakingChanges.forEach(change => {
+      output += `- 🚨 ${change}\n`;
+    });
+    output += '\n';
+  }
+
+  if (description.testPlan.length > 0) {
+    output += '## Testing\n\n';
+    output += '### Test Plan\n';
+    description.testPlan.forEach(test => {
+      output += `- [ ] ${test}\n`;
+    });
+    output += '\n';
+  }
+
+  if (description.additionalNotes.length > 0) {
+    output += '## Additional Notes\n\n';
+    description.additionalNotes.forEach(note => {
+      output += `- ${note}\n`;
+    });
+    output += '\n';
+  }
+
+  return output;
+}
+
+function formatGitLab(description: PRDescription, options: Options): string {
+  let output = '## What does this MR do?\n\n';
+  output += `${description.summary}\n\n`;
+
+  if (description.changes.length > 0) {
+    output += '## Changes Made\n\n';
+    description.changes.forEach(change => {
+      output += `- ${change}\n`;
+    });
+    output += '\n';
+  }
+
+  output += '## Why was this MR needed?\n\n';
+  output += `${description.whyChanged}\n\n`;
+
+  if (description.breakingChanges.length > 0) {
+    output += '## Breaking Changes\n\n';
+    description.breakingChanges.forEach(change => {
+      output += `- ⚠️ ${change}\n`;
+    });
+    output += '\n';
+  }
+
+  output += '## Does this MR meet the acceptance criteria?\n\n';
+  if (description.testPlan.length > 0) {
+    description.testPlan.forEach(test => {
+      output += `- [ ] ${test}\n`;
+    });
+  } else {
+    output += '- [ ] Tests added/updated\n';
+    output += '- [ ] Documentation updated\n';
+    output += '- [ ] Code reviewed\n';
+    output += '- [ ] All pipelines pass\n';
+  }
+  output += '\n';
+
+  if (options.includeFiles) {
+    output += '## Files Changed\n\n';
+    const totalFiles =
+      description.whatChanged.added.length +
+      description.whatChanged.modified.length +
+      description.whatChanged.deleted.length;
+    output += `${totalFiles} files changed\n\n`;
+  }
+
+  return output;
+}
+
+function formatBitbucket(description: PRDescription, options: Options): string {
+  let output = '# Description\n\n';
+  output += `${description.summary}\n\n`;
+
+  if (description.changes.length > 0) {
+    output += '## Changes\n\n';
+    description.changes.forEach(change => {
+      output += `* ${change}\n`;
+    });
+    output += '\n';
+  }
+
+  output += '## Context\n\n';
+  output += `${description.whyChanged}\n\n`;
+
+  if (description.breakingChanges.length > 0) {
+    output += '## Breaking Changes\n\n';
+    description.breakingChanges.forEach(change => {
+      output += `* ${change}\n`;
+    });
+    output += '\n';
+  }
+
+  output += '## Testing\n\n';
+  if (description.testPlan.length > 0) {
+    description.testPlan.forEach(test => {
+      output += `* [ ] ${test}\n`;
+    });
+  } else {
+    output += '* [ ] Tests pass\n';
+    output += '* [ ] Code reviewed\n';
+  }
+  output += '\n';
+
+  return output;
+}
+
+function formatPlain(description: PRDescription, options: Options): string {
+  let output = `# ${description.summary}\n\n`;
+
+  if (description.changes.length > 0) {
+    output += '## Changes\n\n';
+    description.changes.forEach(change => {
+      output += `- ${change}\n`;
+    });
+    output += '\n';
+  }
+
+  if (options.includeFiles) {
+    const totalFiles =
+      description.whatChanged.added.length +
+      description.whatChanged.modified.length +
+      description.whatChanged.deleted.length;
+    output += `## Files Changed: ${totalFiles}\n\n`;
+  }
+
+  output += '## Details\n\n';
+  output += `${description.whyChanged}\n\n`;
+
+  if (description.breakingChanges.length > 0) {
+    output += '## Breaking Changes\n\n';
+    description.breakingChanges.forEach(change => {
+      output += `- ${change}\n`;
+    });
+    output += '\n';
+  }
+
+  return output;
+}
+
+export function formatOutput(description: PRDescription, options: Options): string {
+  switch (options.format) {
+    case 'gitlab':
+      return formatGitLab(description, options);
+    case 'bitbucket':
+      return formatBitbucket(description, options);
+    case 'plain':
+      return formatPlain(description, options);
+    case 'github':
+    default:
+      return formatGitHub(description, options);
+  }
+}
+
+export function applyTemplate(template: string, description: PRDescription): string {
+  let output = template;
+
+  output = output.replace(/\{\{summary\}\}/g, description.summary);
+  output = output.replace(/\{\{changes\}\}/g, description.changes.join('\n- '));
+  output = output.replace(/\{\{why_changed\}\}/g, description.whyChanged);
+  output = output.replace(
+    /\{\{breaking_changes\}\}/g,
+    description.breakingChanges.join('\n- ')
+  );
+  output = output.replace(/\{\{test_plan\}\}/g, description.testPlan.join('\n- [ ] '));
+  output = output.replace(
+    /\{\{files_added\}\}/g,
+    description.whatChanged.added.join('\n- ')
+  );
+  output = output.replace(
+    /\{\{files_modified\}\}/g,
+    description.whatChanged.modified.join('\n- ')
+  );
+  output = output.replace(
+    /\{\{files_deleted\}\}/g,
+    description.whatChanged.deleted.join('\n- ')
+  );
+
+  return output;
+}