@amirdaraee/namewise 0.3.0

package/dist/utils/file-templates.d.ts

@@ -0,0 +1,18 @@
+import { NamingConvention, FileInfo } from '../types/index.js';
+export type FileCategory = 'document' | 'movie' | 'music' | 'series' | 'photo' | 'book' | 'general' | 'auto';
+export interface TemplateOptions {
+    personalName?: string;
+    dateFormat?: 'YYYY-MM-DD' | 'YYYY' | 'YYYYMMDD' | 'none';
+    category?: FileCategory;
+}
+export interface FileTemplate {
+    category: FileCategory;
+    pattern: string;
+    description: string;
+    examples: string[];
+}
+export declare const FILE_TEMPLATES: Record<Exclude<FileCategory, 'auto'>, FileTemplate>;
+export declare function categorizeFile(filePath: string, content?: string, fileInfo?: FileInfo): FileCategory;
+export declare function applyTemplate(aiGeneratedName: string, category: FileCategory, templateOptions: TemplateOptions, namingConvention: NamingConvention): string;
+export declare function getTemplateInstructions(category: FileCategory): string;
+//# sourceMappingURL=file-templates.d.ts.map

package/dist/utils/file-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-templates.d.ts","sourceRoot":"","sources":["../../src/utils/file-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG/D,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7G,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACzD,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,YAAY,CAuE9E,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,YAAY,CAiHpG;AAED,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,YAAY,EACtB,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,gBAAgB,GACjC,MAAM,CA2BR;AA8BD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMtE"}

package/dist/utils/file-templates.js

@@ -0,0 +1,232 @@
+import { applyNamingConvention } from './naming-conventions.js';
+export const FILE_TEMPLATES = {
+    document: {
+        category: 'document',
+        pattern: '{content}-{personalName}-{date}',
+        description: 'Personal documents with name and date',
+        examples: [
+            'driving-license-amirhossein-20250213.pdf',
+            'dennemeyer-working-contract-amirhossein-20240314.pdf',
+            'university-diploma-sarah-20220615.pdf'
+        ]
+    },
+    movie: {
+        category: 'movie',
+        pattern: '{content}-{year}',
+        description: 'Movies with release year',
+        examples: [
+            'the-dark-knight-2008.mkv',
+            'inception-2010.mp4',
+            'pulp-fiction-1994.avi'
+        ]
+    },
+    music: {
+        category: 'music',
+        pattern: '{artist}-{content}',
+        description: 'Music files with artist name',
+        examples: [
+            'the-beatles-hey-jude.mp3',
+            'queen-bohemian-rhapsody.flac',
+            'pink-floyd-wish-you-were-here.wav'
+        ]
+    },
+    series: {
+        category: 'series',
+        pattern: '{content}-s{season}e{episode}',
+        description: 'TV series with season and episode',
+        examples: [
+            'breaking-bad-s01e01.mkv',
+            'game-of-thrones-s04e09.mp4',
+            'the-office-s02e01.avi'
+        ]
+    },
+    photo: {
+        category: 'photo',
+        pattern: '{content}-{personalName}-{date}',
+        description: 'Photos with personal name and date',
+        examples: [
+            'vacation-paris-john-20240715.jpg',
+            'wedding-ceremony-maria-20231009.png',
+            'birthday-party-alex-20240320.heic'
+        ]
+    },
+    book: {
+        category: 'book',
+        pattern: '{author}-{content}',
+        description: 'Books with author name',
+        examples: [
+            'george-orwell-1984.pdf',
+            'j-k-rowling-harry-potter-philosophers-stone.epub',
+            'stephen-king-the-shining.mobi'
+        ]
+    },
+    general: {
+        category: 'general',
+        pattern: '{content}',
+        description: 'General files without special formatting',
+        examples: [
+            'meeting-notes-q4-2024.txt',
+            'project-requirements.docx',
+            'financial-report.xlsx'
+        ]
+    }
+};
+export function categorizeFile(filePath, content, fileInfo) {
+    const extension = getFileExtension(filePath).toLowerCase();
+    const fileName = getFileName(filePath).toLowerCase();
+    const contentLower = content?.toLowerCase() || '';
+    // Use metadata for enhanced categorization
+    let metadataHints = [];
+    if (fileInfo?.documentMetadata) {
+        const meta = fileInfo.documentMetadata;
+        if (meta.title)
+            metadataHints.push(meta.title.toLowerCase());
+        if (meta.author)
+            metadataHints.push(meta.author.toLowerCase());
+        if (meta.creator)
+            metadataHints.push(meta.creator.toLowerCase());
+        if (meta.subject)
+            metadataHints.push(meta.subject.toLowerCase());
+        if (meta.keywords)
+            metadataHints.push(...meta.keywords.map(k => k.toLowerCase()));
+    }
+    // Use folder context for better categorization
+    let folderHints = [];
+    if (fileInfo?.folderPath) {
+        folderHints = fileInfo.folderPath.map(f => f.toLowerCase());
+    }
+    if (fileInfo?.parentFolder) {
+        folderHints.push(fileInfo.parentFolder.toLowerCase());
+    }
+    const allHints = [...metadataHints, ...folderHints, contentLower, fileName].join(' ');
+    // Document types
+    const documentExtensions = ['.pdf', '.docx', '.doc', '.txt', '.rtf'];
+    const documentKeywords = ['contract', 'agreement', 'license', 'certificate', 'diploma', 'invoice', 'receipt', 'report', 'application', 'form', 'resume', 'cv', 'letter'];
+    // Media types
+    const movieExtensions = ['.mp4', '.mkv', '.avi', '.mov', '.wmv', '.flv', '.webm'];
+    const musicExtensions = ['.mp3', '.flac', '.wav', '.aac', '.ogg', '.m4a'];
+    const photoExtensions = ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.tiff', '.heic', '.webp'];
+    const bookExtensions = ['.epub', '.mobi', '.azw', '.azw3'];
+    // Enhanced series detection
+    const seriesKeywords = ['s01', 's02', 's03', 's04', 's05', 'season', 'episode', 'e01', 'e02', 'e03', 'series', 'show', 'tv'];
+    // Enhanced movie keywords
+    const movieKeywords = ['movie', 'film', 'cinema', '1080p', '720p', '4k', 'bluray', 'dvdrip', 'webrip'];
+    // Book keywords
+    const bookKeywords = ['chapter', 'author', 'book', 'novel', 'ebook', 'isbn', 'publisher', 'edition'];
+    // Music keywords  
+    const musicKeywords = ['album', 'track', 'artist', 'band', 'singer', 'song', 'music'];
+    // Photo keywords
+    const photoKeywords = ['photo', 'image', 'picture', 'vacation', 'wedding', 'birthday', 'selfie', 'portrait'];
+    // Folder-based hints
+    const folderMovieHints = ['movies', 'films', 'cinema', 'video'];
+    const folderSeriesHints = ['series', 'shows', 'tv', 'television'];
+    const folderMusicHints = ['music', 'audio', 'songs', 'albums'];
+    const folderPhotoHints = ['photos', 'images', 'pictures', 'gallery'];
+    const folderBookHints = ['books', 'ebooks', 'library', 'reading'];
+    const folderDocumentHints = ['documents', 'docs', 'papers', 'files'];
+    // Check folder context first for strong hints
+    if (folderHints.some(hint => folderSeriesHints.includes(hint)))
+        return 'series';
+    if (folderHints.some(hint => folderMovieHints.includes(hint)))
+        return 'movie';
+    if (folderHints.some(hint => folderMusicHints.includes(hint)))
+        return 'music';
+    if (folderHints.some(hint => folderPhotoHints.includes(hint)))
+        return 'photo';
+    if (folderHints.some(hint => folderBookHints.includes(hint)))
+        return 'book';
+    if (folderHints.some(hint => folderDocumentHints.includes(hint)))
+        return 'document';
+    // Check for series first (before movies)
+    if (movieExtensions.includes(extension) && (seriesKeywords.some(keyword => allHints.includes(keyword)))) {
+        return 'series';
+    }
+    // Check by extension with enhanced keyword matching
+    if (documentExtensions.includes(extension)) {
+        // Check if it's a book
+        if (bookExtensions.includes(extension) || bookKeywords.some(keyword => allHints.includes(keyword))) {
+            return 'book';
+        }
+        // Check if it's likely a personal document
+        if (documentKeywords.some(keyword => allHints.includes(keyword))) {
+            return 'document';
+        }
+        return 'document'; // Default for document extensions
+    }
+    // Enhanced media type detection
+    if (movieExtensions.includes(extension)) {
+        if (movieKeywords.some(keyword => allHints.includes(keyword))) {
+            return 'movie';
+        }
+        return 'movie'; // Default for movie extensions
+    }
+    if (musicExtensions.includes(extension)) {
+        if (musicKeywords.some(keyword => allHints.includes(keyword))) {
+            return 'music';
+        }
+        return 'music';
+    }
+    if (photoExtensions.includes(extension)) {
+        if (photoKeywords.some(keyword => allHints.includes(keyword))) {
+            return 'photo';
+        }
+        return 'photo';
+    }
+    if (bookExtensions.includes(extension))
+        return 'book';
+    return 'general';
+}
+export function applyTemplate(aiGeneratedName, category, templateOptions, namingConvention) {
+    if (category === 'auto') {
+        throw new Error('Cannot apply template for "auto" category. Category should be resolved before calling applyTemplate.');
+    }
+    const template = FILE_TEMPLATES[category];
+    let result = template.pattern;
+    // Replace template variables
+    result = result.replace('{content}', aiGeneratedName);
+    if (templateOptions.personalName) {
+        result = result.replace('{personalName}', templateOptions.personalName);
+    }
+    if (templateOptions.dateFormat && templateOptions.dateFormat !== 'none') {
+        const date = formatDate(new Date(), templateOptions.dateFormat);
+        result = result.replace('{date}', date);
+    }
+    // Clean up any remaining unreplaced variables
+    result = result.replace(/\{[^}]+\}/g, '');
+    // Clean up multiple hyphens or other separators
+    result = result.replace(/-+/g, '-').replace(/^-|-$/g, '');
+    // Apply naming convention
+    return applyNamingConvention(result, namingConvention);
+}
+function formatDate(date, format) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    switch (format) {
+        case 'YYYY-MM-DD':
+            return `${year}-${month}-${day}`;
+        case 'YYYY':
+            return `${year}`;
+        case 'YYYYMMDD':
+            return `${year}${month}${day}`;
+        default:
+            return `${year}${month}${day}`;
+    }
+}
+function getFileExtension(filePath) {
+    const parts = filePath.split('.');
+    return parts.length > 1 ? '.' + parts[parts.length - 1] : '';
+}
+function getFileName(filePath) {
+    const pathParts = filePath.split(/[/\\]/);
+    const fileName = pathParts[pathParts.length - 1];
+    return fileName.replace(/\.[^.]*$/, ''); // Remove extension
+}
+export function getTemplateInstructions(category) {
+    if (category === 'auto') {
+        return 'Generate appropriate filename based on detected file type and content.';
+    }
+    const template = FILE_TEMPLATES[category];
+    return `Generate filename for ${category} type files. ${template.description}. Examples: ${template.examples.join(', ')}`;
+}
+//# sourceMappingURL=file-templates.js.map

package/dist/utils/file-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-templates.js","sourceRoot":"","sources":["../../src/utils/file-templates.ts"],"names":[],"mappings":"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"}

package/dist/utils/naming-conventions.d.ts

@@ -0,0 +1,4 @@
+export type NamingConvention = 'kebab-case' | 'snake_case' | 'camelCase' | 'PascalCase' | 'lowercase' | 'UPPERCASE';
+export declare function applyNamingConvention(text: string, convention: NamingConvention): string;
+export declare function getNamingInstructions(convention: NamingConvention): string;
+//# sourceMappingURL=naming-conventions.d.ts.map

package/dist/utils/naming-conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-conventions.d.ts","sourceRoot":"","sources":["../../src/utils/naming-conventions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;AAEpH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAmDxF;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAW1E"}

package/dist/utils/naming-conventions.js

@@ -0,0 +1,55 @@
+export function applyNamingConvention(text, convention) {
+    // First, normalize the text by removing special characters and extra spaces
+    const normalized = text
+        .replace(/[^\w\s-]/g, '') // Remove special characters except hyphens
+        .replace(/\s+/g, ' ') // Normalize spaces
+        .trim();
+    switch (convention) {
+        case 'kebab-case':
+            return normalized
+                .toLowerCase()
+                .replace(/\s+/g, '-')
+                .replace(/[_]/g, '-');
+        case 'snake_case':
+            return normalized
+                .toLowerCase()
+                .replace(/\s+/g, '_')
+                .replace(/[-]/g, '_');
+        case 'camelCase':
+            return normalized
+                .split(/[\s\-_]+/)
+                .map((word, index) => index === 0
+                ? word.toLowerCase()
+                : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+                .join('');
+        case 'PascalCase':
+            return normalized
+                .split(/[\s\-_]+/)
+                .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+                .join('');
+        case 'lowercase':
+            return normalized
+                .toLowerCase()
+                .replace(/\s+/g, '')
+                .replace(/[-_]/g, '');
+        case 'UPPERCASE':
+            return normalized
+                .toUpperCase()
+                .replace(/\s+/g, '')
+                .replace(/[-_]/g, '');
+        default:
+            return normalized.replace(/\s+/g, '-').toLowerCase(); // Default to kebab-case
+    }
+}
+export function getNamingInstructions(convention) {
+    const instructions = {
+        'kebab-case': 'Use lowercase with hyphens between words (e.g., "meeting-notes-2024")',
+        'snake_case': 'Use lowercase with underscores between words (e.g., "meeting_notes_2024")',
+        'camelCase': 'Use camelCase format starting with lowercase (e.g., "meetingNotes2024")',
+        'PascalCase': 'Use PascalCase format starting with uppercase (e.g., "MeetingNotes2024")',
+        'lowercase': 'Use single lowercase word with no separators (e.g., "meetingnotes2024")',
+        'UPPERCASE': 'Use single uppercase word with no separators (e.g., "MEETINGNOTES2024")'
+    };
+    return instructions[convention];
+}
+//# sourceMappingURL=naming-conventions.js.map

package/dist/utils/naming-conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-conventions.js","sourceRoot":"","sources":["../../src/utils/naming-conventions.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,UAA4B;IAC9E,4EAA4E;IAC5E,MAAM,UAAU,GAAG,IAAI;SACpB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,2CAA2C;SACpE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM,mBAAmB;SAC7C,IAAI,EAAE,CAAC;IAEV,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,UAAU;iBACd,WAAW,EAAE;iBACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;iBACpB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAE1B,KAAK,YAAY;YACf,OAAO,UAAU;iBACd,WAAW,EAAE;iBACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;iBACpB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAE1B,KAAK,WAAW;YACd,OAAO,UAAU;iBACd,KAAK,CAAC,UAAU,CAAC;iBACjB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnB,KAAK,KAAK,CAAC;gBACT,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;gBACpB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAC/D;iBACA,IAAI,CAAC,EAAE,CAAC,CAAC;QAEd,KAAK,YAAY;YACf,OAAO,UAAU;iBACd,KAAK,CAAC,UAAU,CAAC;iBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;iBACvE,IAAI,CAAC,EAAE,CAAC,CAAC;QAEd,KAAK,WAAW;YACd,OAAO,UAAU;iBACd,WAAW,EAAE;iBACb,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;iBACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAE1B,KAAK,WAAW;YACd,OAAO,UAAU;iBACd,WAAW,EAAE;iBACb,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;iBACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAE1B;YACE,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,wBAAwB;IAClF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAA4B;IAChE,MAAM,YAAY,GAAG;QACnB,YAAY,EAAE,uEAAuE;QACrF,YAAY,EAAE,2EAA2E;QACzF,WAAW,EAAE,yEAAyE;QACtF,YAAY,EAAE,0EAA0E;QACxF,WAAW,EAAE,yEAAyE;QACtF,WAAW,EAAE,yEAAyE;KACvF,CAAC;IAEF,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@amirdaraee/namewise",
+  "version": "0.3.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "namewise": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest --watch",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "release": "npm run build && npm run test:run && npm version patch",
+    "release:minor": "npm run build && npm run test:run && npm version minor",
+    "release:major": "npm run build && npm run test:run && npm version major",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run test:run"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai",
+    "rename",
+    "files",
+    "smart",
+    "content",
+    "cli",
+    "automation",
+    "organization",
+    "claude",
+    "openai"
+  ],
+  "author": "ai-rename contributors",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amirdaraee/namewise.git"
+  },
+  "bugs": {
+    "url": "https://github.com/amirdaraee/namewise/issues"
+  },
+  "homepage": "https://github.com/amirdaraee/namewise#readme",
+  "license": "MIT",
+  "description": "AI-powered CLI tool that intelligently renames files based on their content using Claude or OpenAI",
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^24.3.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.61.0",
+    "commander": "^14.0.0",
+    "fs-extra": "^11.3.1",
+    "inquirer": "^12.9.4",
+    "mammoth": "^1.10.0",
+    "openai": "^5.19.1",
+    "pdf-extraction": "^1.0.2",
+    "xlsx": "^0.18.5"
+  }
+}

package/src/cli/commands.ts

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import { renameFiles } from './rename.js';
+
+export function setupCommands(program: Command): void {
+  program
+    .command('rename')
+    .description('Rename files in a directory based on their content')
+    .argument('<directory>', 'Directory containing files to rename')
+    .option('-p, --provider <provider>', 'AI provider (claude|openai)', 'claude')
+    .option('-k, --api-key <key>', 'API key for the AI provider')
+    .option('-c, --case <convention>', 'Naming convention (kebab-case|snake_case|camelCase|PascalCase|lowercase|UPPERCASE)', 'kebab-case')
+    .option('-t, --template <category>', 'File category template (document|movie|music|series|photo|book|general|auto)', 'general')
+    .option('-n, --name <personalName>', 'Personal name to include in filenames')
+    .option('-d, --date <format>', 'Date format (YYYY-MM-DD|YYYY|YYYYMMDD|none)', 'none')
+    .option('--dry-run', 'Preview changes without renaming files', false)
+    .option('--max-size <size>', 'Maximum file size in MB', '10')
+    .action(async (directory, options) => {
+      await renameFiles(directory, options);
+    });
+}

package/src/cli/rename.ts

@@ -0,0 +1,157 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import inquirer from 'inquirer';
+import { FileInfo, Config, RenameResult, FileCategory, DateFormat } from '../types/index.js';
+import { DocumentParserFactory } from '../parsers/factory.js';
+import { AIServiceFactory } from '../services/ai-factory.js';
+import { FileRenamer } from '../services/file-renamer.js';
+
+export async function renameFiles(directory: string, options: any): Promise<void> {
+  try {
+    // Validate directory exists
+    const stats = await fs.stat(directory);
+    if (!stats.isDirectory()) {
+      throw new Error(`${directory} is not a directory`);
+    }
+
+    // Get API key
+    let apiKey = options.apiKey;
+    if (!apiKey) {
+      const keyPrompt = await inquirer.prompt([
+        {
+          type: 'password',
+          name: 'apiKey',
+          message: `Enter your ${options.provider} API key:`,
+          mask: '*'
+        }
+      ]);
+      apiKey = keyPrompt.apiKey;
+    }
+
+    // Create config
+    const config: Config = {
+      aiProvider: options.provider,
+      apiKey,
+      maxFileSize: parseInt(options.maxSize) * 1024 * 1024, // Convert MB to bytes
+      supportedExtensions: ['.pdf', '.docx', '.doc', '.xlsx', '.xls', '.txt'],
+      dryRun: options.dryRun,
+      namingConvention: options.case,
+      templateOptions: {
+        category: options.template as FileCategory,
+        personalName: options.name,
+        dateFormat: options.date as DateFormat
+      }
+    };
+
+    // Initialize services
+    const parserFactory = new DocumentParserFactory();
+    const aiService = AIServiceFactory.create(config.aiProvider, apiKey);
+    const fileRenamer = new FileRenamer(parserFactory, aiService, config);
+
+    // Get files to process
+    const files = await getFilesToProcess(directory, config.supportedExtensions);
+    
+    if (files.length === 0) {
+      console.log('No supported files found in the directory.');
+      return;
+    }
+
+    console.log(`Found ${files.length} files to process:`);
+    files.forEach(file => console.log(`  - ${file.name}`));
+
+    // Confirm before processing
+    if (!config.dryRun) {
+      const confirm = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'proceed',
+          message: 'Do you want to proceed with renaming these files?',
+          default: false
+        }
+      ]);
+
+      if (!confirm.proceed) {
+        console.log('Operation cancelled.');
+        return;
+      }
+    }
+
+    // Process files
+    console.log('\nProcessing files...');
+    const results = await fileRenamer.renameFiles(files);
+
+    // Display results
+    displayResults(results, config.dryRun);
+
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : 'Unknown error');
+    process.exit(1);
+  }
+}
+
+async function getFilesToProcess(directory: string, supportedExtensions: string[]): Promise<FileInfo[]> {
+  const files: FileInfo[] = [];
+  const entries = await fs.readdir(directory, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (entry.isFile()) {
+      const filePath = path.join(directory, entry.name);
+      const extension = path.extname(entry.name).toLowerCase();
+      
+      if (supportedExtensions.includes(extension)) {
+        const stats = await fs.stat(filePath);
+        
+        // Extract folder context
+        const parentFolder = path.basename(directory);
+        const fullPath = path.resolve(filePath);
+        const folderPath = path.dirname(fullPath).split(path.sep).filter(p => p);
+        
+        files.push({
+          path: filePath,
+          name: entry.name,
+          extension,
+          size: stats.size,
+          // File system metadata
+          createdAt: stats.birthtime,
+          modifiedAt: stats.mtime,
+          accessedAt: stats.atime,
+          // Context metadata
+          parentFolder,
+          folderPath: folderPath.slice(-3), // Last 3 folder levels for context
+          // Document metadata will be populated by parsers
+          documentMetadata: undefined
+        });
+      }
+    }
+  }
+
+  return files;
+}
+
+function displayResults(results: RenameResult[], dryRun: boolean): void {
+  const successful = results.filter(r => r.success);
+  const failed = results.filter(r => !r.success);
+
+  console.log(`\n${dryRun ? 'Preview' : 'Results'}:`);
+  console.log(`✅ ${successful.length} files ${dryRun ? 'would be' : 'successfully'} renamed`);
+  
+  if (failed.length > 0) {
+    console.log(`❌ ${failed.length} files failed`);
+  }
+
+  console.log('\nDetails:');
+  results.forEach(result => {
+    const status = result.success ? '✅' : '❌';
+    const originalName = path.basename(result.originalPath);
+    const newName = path.basename(result.newPath);
+    
+    if (result.success) {
+      console.log(`${status} ${originalName} → ${newName}`);
+    } else {
+      console.log(`${status} ${originalName} (failed)`);
+      if (result.error) {
+        console.log(`   Error: ${result.error}`);
+      }
+    }
+  });
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { setupCommands } from './cli/commands.js';
+
+async function main() {
+  program
+    .name('namewise')
+    .description('AI-powered tool to intelligently rename files based on their content')
+    .version('0.3.0');
+
+  setupCommands(program);
+  
+  await program.parseAsync(process.argv);
+}
+
+main().catch(console.error);

package/src/parsers/excel-parser.ts

@@ -0,0 +1,49 @@
+import fs from 'fs';
+import path from 'path';
+import * as XLSX from 'xlsx';
+import { DocumentParser, ParseResult, DocumentMetadata } from '../types/index.js';
+
+export class ExcelParser implements DocumentParser {
+  supports(filePath: string): boolean {
+    const ext = path.extname(filePath).toLowerCase();
+    return ext === '.xlsx' || ext === '.xls';
+  }
+
+  async parse(filePath: string): Promise<ParseResult> {
+    try {
+      const workbook = XLSX.readFile(filePath);
+      const sheets: string[] = [];
+      const metadata: DocumentMetadata = {};
+
+      workbook.SheetNames.forEach(sheetName => {
+        const sheet = workbook.Sheets[sheetName];
+        const csvData = XLSX.utils.sheet_to_csv(sheet);
+        if (csvData.trim()) {
+          sheets.push(`Sheet: ${sheetName}\\n${csvData}`);
+        }
+      });
+
+      const content = sheets.join('\\n\\n').trim();
+      
+      // Extract metadata from workbook properties
+      if (workbook.Props) {
+        const props = workbook.Props as any;
+        metadata.title = props.Title;
+        metadata.author = props.Author;
+        metadata.subject = props.Subject;
+        metadata.keywords = props.Keywords ? [props.Keywords] : undefined;
+        metadata.creationDate = props.CreatedDate;
+        metadata.modificationDate = props.ModifiedDate;
+      }
+      
+      // Estimate word count from content
+      if (content) {
+        metadata.wordCount = content.split(/\\s+/).filter(word => word.length > 0).length;
+      }
+
+      return { content, metadata };
+    } catch (error) {
+      throw new Error(`Failed to parse Excel file: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+  }
+}