@amirdaraee/namewise 0.4.0 → 0.4.1

package/src/services/claude-service.ts

@@ -1,7 +1,8 @@
 import Anthropic from '@anthropic-ai/sdk';
 import { AIProvider, FileInfo } from '../types/index.js';
-import { applyNamingConvention, getNamingInstructions, NamingConvention } from '../utils/naming-conventions.js';
-import { getTemplateInstructions, FileCategory } from '../utils/file-templates.js';
+import { applyNamingConvention, NamingConvention } from '../utils/naming-conventions.js';
+import { FileCategory } from '../utils/file-templates.js';
+import { buildFileNamePrompt } from '../utils/ai-prompts.js';
 
 export class ClaudeService implements AIProvider {
   name = 'Claude';
@@ -16,53 +17,14 @@ export class ClaudeService implements AIProvider {
   async generateFileName(content: string, originalName: string, namingConvention: string = 'kebab-case', category: string = 'general', fileInfo?: FileInfo): Promise<string> {
     const convention = namingConvention as NamingConvention;
     const fileCategory = category as FileCategory;
-    const namingInstructions = getNamingInstructions(convention);
-    const templateInstructions = getTemplateInstructions(fileCategory);
     
-    // Build comprehensive context from all metadata
-    let metadataContext = '';
-    if (fileInfo) {
-      metadataContext += `File Information:
-- Original filename: ${originalName}
-- File size: ${Math.round(fileInfo.size / 1024)}KB
-- Created: ${fileInfo.createdAt.toLocaleDateString()}
-- Modified: ${fileInfo.modifiedAt.toLocaleDateString()}
-- Parent folder: ${fileInfo.parentFolder}
-- Folder path: ${fileInfo.folderPath.join(' > ')}`;
-
-      if (fileInfo.documentMetadata) {
-        const meta = fileInfo.documentMetadata;
-        metadataContext += `
-Document Properties:`;
-        if (meta.title) metadataContext += `\n- Title: ${meta.title}`;
-        if (meta.author) metadataContext += `\n- Author: ${meta.author}`;
-        if (meta.creator) metadataContext += `\n- Creator: ${meta.creator}`;
-        if (meta.subject) metadataContext += `\n- Subject: ${meta.subject}`;
-        if (meta.keywords?.length) metadataContext += `\n- Keywords: ${meta.keywords.join(', ')}`;
-        if (meta.creationDate) metadataContext += `\n- Created: ${meta.creationDate.toLocaleDateString()}`;
-        if (meta.modificationDate) metadataContext += `\n- Modified: ${meta.modificationDate.toLocaleDateString()}`;
-        if (meta.pages) metadataContext += `\n- Pages: ${meta.pages}`;
-        if (meta.wordCount) metadataContext += `\n- Word count: ${meta.wordCount}`;
-      }
-    }
-
-    const prompt = `Based on the following document information, generate a descriptive filename that captures the main topic/purpose of the document. The filename should be:
-- Descriptive and meaningful
-- Professional and clean
-- Between 3-8 words
-- ${namingInstructions}
-- ${templateInstructions}
-- Do not include file extension
-- Do not include personal names, dates, or template variables - just the core content description
-- Only use letters, numbers, and appropriate separators for the naming convention
-- Use all available context (metadata, folder context, document properties) to create the most accurate filename
-
-${metadataContext}
-
-Document content (first 2000 characters):
-${content.substring(0, 2000)}
-
-Respond with only the core filename (without personal info or dates) using the specified naming convention, no explanation.`;
+    const prompt = buildFileNamePrompt({
+      content,
+      originalName,
+      namingConvention: convention,
+      category: fileCategory,
+      fileInfo
+    });
 
     try {
       const response = await this.client.messages.create({

package/src/services/lmstudio-service.ts

@@ -1,4 +1,7 @@
 import { AIProvider, FileInfo } from '../types/index.js';
+import { buildFileNamePrompt, AI_SYSTEM_PROMPT } from '../utils/ai-prompts.js';
+import { NamingConvention } from '../utils/naming-conventions.js';
+import { FileCategory } from '../utils/file-templates.js';
 
 interface OpenAICompatibleResponse {
   choices: Array<{
@@ -55,7 +58,7 @@ export class LMStudioService implements AIProvider {
         messages: [
           {
             role: 'system',
-            content: 'You are a helpful assistant that generates descriptive filenames based on document content. Always respond with just the filename, no explanation or additional text.'
+            content: AI_SYSTEM_PROMPT
           },
           {
             role: 'user',
@@ -85,25 +88,13 @@ export class LMStudioService implements AIProvider {
     category: string,
     fileInfo?: FileInfo
   ): string {
-    let prompt = `Based on the following document content, generate a descriptive filename using ${namingConvention} naming convention. `;
-    prompt += `The file category is: ${category}. `;
-    
-    if (fileInfo?.documentMetadata) {
-      const meta = fileInfo.documentMetadata;
-      if (meta.title) prompt += `Document title: "${meta.title}". `;
-      if (meta.author) prompt += `Author: "${meta.author}". `;
-      if (meta.subject) prompt += `Subject: "${meta.subject}". `;
-    }
-    
-    if (fileInfo?.parentFolder && fileInfo.parentFolder !== '.') {
-      prompt += `Located in folder: "${fileInfo.parentFolder}". `;
-    }
-
-    prompt += `\nOriginal filename: ${originalName}\n`;
-    prompt += `\nDocument content (first 2000 characters):\n${content.substring(0, 2000)}`;
-    prompt += `\n\nGenerate ONLY a descriptive filename (without extension) using ${namingConvention} format. Do not include any explanation or additional text.`;
-
-    return prompt;
+    return buildFileNamePrompt({
+      content,
+      originalName,
+      namingConvention: namingConvention as NamingConvention,
+      category: category as FileCategory,
+      fileInfo
+    });
   }
 
   private sanitizeFilename(filename: string): string {

package/src/services/ollama-service.ts

@@ -1,4 +1,7 @@
 import { AIProvider, FileInfo } from '../types/index.js';
+import { buildFileNamePrompt, AI_SYSTEM_PROMPT } from '../utils/ai-prompts.js';
+import { NamingConvention } from '../utils/naming-conventions.js';
+import { FileCategory } from '../utils/file-templates.js';
 
 interface OllamaResponse {
   model: string;
@@ -43,7 +46,7 @@ export class OllamaService implements AIProvider {
         messages: [
           {
             role: 'system',
-            content: 'You are a helpful assistant that generates descriptive filenames based on document content. Always respond with just the filename, no explanation or additional text.'
+            content: AI_SYSTEM_PROMPT
           },
           {
             role: 'user',
@@ -71,25 +74,13 @@ export class OllamaService implements AIProvider {
     category: string,
     fileInfo?: FileInfo
   ): string {
-    let prompt = `Based on the following document content, generate a descriptive filename using ${namingConvention} naming convention. `;
-    prompt += `The file category is: ${category}. `;
-    
-    if (fileInfo?.documentMetadata) {
-      const meta = fileInfo.documentMetadata;
-      if (meta.title) prompt += `Document title: "${meta.title}". `;
-      if (meta.author) prompt += `Author: "${meta.author}". `;
-      if (meta.subject) prompt += `Subject: "${meta.subject}". `;
-    }
-    
-    if (fileInfo?.parentFolder && fileInfo.parentFolder !== '.') {
-      prompt += `Located in folder: "${fileInfo.parentFolder}". `;
-    }
-
-    prompt += `\nOriginal filename: ${originalName}\n`;
-    prompt += `\nDocument content (first 2000 characters):\n${content.substring(0, 2000)}`;
-    prompt += `\n\nGenerate ONLY a descriptive filename (without extension) using ${namingConvention} format. Do not include any explanation or additional text.`;
-
-    return prompt;
+    return buildFileNamePrompt({
+      content,
+      originalName,
+      namingConvention: namingConvention as NamingConvention,
+      category: category as FileCategory,
+      fileInfo
+    });
   }
 
   private sanitizeFilename(filename: string): string {

package/src/services/openai-service.ts

@@ -1,7 +1,8 @@
 import OpenAI from 'openai';
 import { AIProvider, FileInfo } from '../types/index.js';
-import { applyNamingConvention, getNamingInstructions, NamingConvention } from '../utils/naming-conventions.js';
-import { getTemplateInstructions, FileCategory } from '../utils/file-templates.js';
+import { applyNamingConvention, NamingConvention } from '../utils/naming-conventions.js';
+import { FileCategory } from '../utils/file-templates.js';
+import { buildFileNamePrompt } from '../utils/ai-prompts.js';
 
 export class OpenAIService implements AIProvider {
   name = 'OpenAI';
@@ -16,53 +17,14 @@ export class OpenAIService implements AIProvider {
   async generateFileName(content: string, originalName: string, namingConvention: string = 'kebab-case', category: string = 'general', fileInfo?: FileInfo): Promise<string> {
     const convention = namingConvention as NamingConvention;
     const fileCategory = category as FileCategory;
-    const namingInstructions = getNamingInstructions(convention);
-    const templateInstructions = getTemplateInstructions(fileCategory);
     
-    // Build comprehensive context from all metadata
-    let metadataContext = '';
-    if (fileInfo) {
-      metadataContext += `File Information:
-- Original filename: ${originalName}
-- File size: ${Math.round(fileInfo.size / 1024)}KB
-- Created: ${fileInfo.createdAt.toLocaleDateString()}
-- Modified: ${fileInfo.modifiedAt.toLocaleDateString()}
-- Parent folder: ${fileInfo.parentFolder}
-- Folder path: ${fileInfo.folderPath.join(' > ')}`;
-
-      if (fileInfo.documentMetadata) {
-        const meta = fileInfo.documentMetadata;
-        metadataContext += `
-Document Properties:`;
-        if (meta.title) metadataContext += `\n- Title: ${meta.title}`;
-        if (meta.author) metadataContext += `\n- Author: ${meta.author}`;
-        if (meta.creator) metadataContext += `\n- Creator: ${meta.creator}`;
-        if (meta.subject) metadataContext += `\n- Subject: ${meta.subject}`;
-        if (meta.keywords?.length) metadataContext += `\n- Keywords: ${meta.keywords.join(', ')}`;
-        if (meta.creationDate) metadataContext += `\n- Created: ${meta.creationDate.toLocaleDateString()}`;
-        if (meta.modificationDate) metadataContext += `\n- Modified: ${meta.modificationDate.toLocaleDateString()}`;
-        if (meta.pages) metadataContext += `\n- Pages: ${meta.pages}`;
-        if (meta.wordCount) metadataContext += `\n- Word count: ${meta.wordCount}`;
-      }
-    }
-
-    const prompt = `Based on the following document information, generate a descriptive filename that captures the main topic/purpose of the document. The filename should be:
-- Descriptive and meaningful
-- Professional and clean
-- Between 3-8 words
-- ${namingInstructions}
-- ${templateInstructions}
-- Do not include file extension
-- Do not include personal names, dates, or template variables - just the core content description
-- Only use letters, numbers, and appropriate separators for the naming convention
-- Use all available context (metadata, folder context, document properties) to create the most accurate filename
-
-${metadataContext}
-
-Document content (first 2000 characters):
-${content.substring(0, 2000)}
-
-Respond with only the core filename (without personal info or dates) using the specified naming convention, no explanation.`;
+    const prompt = buildFileNamePrompt({
+      content,
+      originalName,
+      namingConvention: convention,
+      category: fileCategory,
+      fileInfo
+    });
 
     try {
       const response = await this.client.chat.completions.create({

package/src/utils/ai-prompts.ts

@@ -0,0 +1,76 @@
+import { FileInfo } from '../types/index.js';
+import { getNamingInstructions, NamingConvention } from './naming-conventions.js';
+import { getTemplateInstructions, FileCategory } from './file-templates.js';
+
+export interface PromptContext {
+  content: string;
+  originalName: string;
+  namingConvention: NamingConvention;
+  category: FileCategory;
+  fileInfo?: FileInfo;
+}
+
+/**
+ * Builds a standardized prompt for AI filename generation
+ * This prompt is used across all AI providers (Claude, OpenAI, LMStudio, Ollama)
+ */
+export function buildFileNamePrompt(context: PromptContext): string {
+  const { content, originalName, namingConvention, category, fileInfo } = context;
+  
+  const namingInstructions = getNamingInstructions(namingConvention);
+  const templateInstructions = getTemplateInstructions(category);
+  
+  // Build comprehensive context from all metadata
+  let metadataContext = '';
+  if (fileInfo) {
+    metadataContext += `File Information:
+- Original filename: ${originalName}
+- File size: ${Math.round(fileInfo.size / 1024)}KB
+- Created: ${fileInfo.createdAt.toLocaleDateString()}
+- Modified: ${fileInfo.modifiedAt.toLocaleDateString()}
+- Parent folder: ${fileInfo.parentFolder}
+- Folder path: ${fileInfo.folderPath.join(' > ')}`;
+
+    if (fileInfo.documentMetadata) {
+      const meta = fileInfo.documentMetadata;
+      metadataContext += `
+Document Properties:`;
+      if (meta.title) metadataContext += `\n- Title: ${meta.title}`;
+      if (meta.author) metadataContext += `\n- Author: ${meta.author}`;
+      if (meta.creator) metadataContext += `\n- Creator: ${meta.creator}`;
+      if (meta.subject) metadataContext += `\n- Subject: ${meta.subject}`;
+      if (meta.keywords?.length) metadataContext += `\n- Keywords: ${meta.keywords.join(', ')}`;
+      if (meta.creationDate) metadataContext += `\n- Created: ${meta.creationDate.toLocaleDateString()}`;
+      if (meta.modificationDate) metadataContext += `\n- Modified: ${meta.modificationDate.toLocaleDateString()}`;
+      if (meta.pages) metadataContext += `\n- Pages: ${meta.pages}`;
+      if (meta.wordCount) metadataContext += `\n- Word count: ${meta.wordCount}`;
+    }
+  }
+
+  return `Based on the following document information, generate a descriptive filename that captures the main topic/purpose of the document. The filename should be:
+- Descriptive and meaningful
+- Professional and clean
+- Between 3-10 words
+- ${namingInstructions}
+- ${templateInstructions}
+- Do not include file extension
+- If the document is specifically for/about a person (based on content), include their name at the beginning
+- Include dates only if they are essential to the document's identity (e.g., contracts, certificates)
+- Ignore irrelevant folder names that don't describe the document content
+- Only use letters, numbers, and appropriate separators for the naming convention
+- Focus on the document's actual content and purpose, not just metadata
+
+${metadataContext}
+
+Document content (first 2000 characters):
+${content.substring(0, 2000)}
+
+Important: If this document is specifically for or about a particular person mentioned in the content, start the filename with their name. Otherwise, focus on the document's main purpose and content.
+
+Respond with only the filename using the specified naming convention, no explanation.`;
+}
+
+/**
+ * System prompt for AI models that need a separate system message
+ */
+export const AI_SYSTEM_PROMPT = 'You are a helpful assistant that generates descriptive filenames based on document content. Always respond with just the filename, no explanation or additional text.';