@amirdaraee/namewise 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.4] - 2026-03-31
+
+### Improved
+- **🧪 Test Coverage**: Achieved 100% coverage across all metrics (statements, branches, functions, lines)
+  - 325 tests across 26 test files
+  - Added tests for all error branches including non-Error exception paths
+  - Full coverage for scanned PDF handling, folder-based categorization, and naming convention truncation
+  - Added polyfill tests for `process.getBuiltinModule` in Node.js < 22.3.0 environments
+
 ## [0.5.0] - 2025-11-10
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amirdaraee/namewise",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -27,7 +27,7 @@
     "prepublishOnly": "npm run test:run"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "keywords": [
     "ai",

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,82 +0,0 @@
-name: Bug Report
-description: File a bug report to help us improve
-title: "[Bug]: "
-labels: ["bug", "triage"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for taking the time to fill out this bug report!
-
-  - type: input
-    id: version
-    attributes:
-      label: Version
-      description: What version of smart-rename are you using?
-      placeholder: ex. 0.1.0
-    validations:
-      required: true
-
-  - type: dropdown
-    id: os
-    attributes:
-      label: Operating System
-      description: What operating system are you using?
-      options:
-        - Windows
-        - macOS
-        - Linux
-        - Other
-    validations:
-      required: true
-
-  - type: input
-    id: node-version
-    attributes:
-      label: Node.js Version
-      description: What version of Node.js are you using?
-      placeholder: ex. 20.0.0
-    validations:
-      required: true
-
-  - type: textarea
-    id: what-happened
-    attributes:
-      label: What happened?
-      description: A clear and concise description of what the bug is.
-      placeholder: Tell us what you see!
-    validations:
-      required: true
-
-  - type: textarea
-    id: steps
-    attributes:
-      label: Steps to Reproduce
-      description: Steps to reproduce the behavior
-      placeholder: |
-        1. Run command '...'
-        2. With files '...'
-        3. See error
-    validations:
-      required: true
-
-  - type: textarea
-    id: expected
-    attributes:
-      label: Expected Behavior
-      description: What did you expect to happen?
-    validations:
-      required: true
-
-  - type: textarea
-    id: logs
-    attributes:
-      label: Error Messages/Logs
-      description: If applicable, add error messages or logs
-      render: shell
-
-  - type: textarea
-    id: additional
-    attributes:
-      label: Additional Context
-      description: Add any other context about the problem here

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,61 +0,0 @@
-name: Feature Request
-description: Suggest an idea for this project
-title: "[Feature]: "
-labels: ["enhancement", "feature-request"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for suggesting a new feature!
-
-  - type: textarea
-    id: problem
-    attributes:
-      label: Problem Description
-      description: Is your feature request related to a problem? Please describe.
-      placeholder: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-  - type: textarea
-    id: solution
-    attributes:
-      label: Proposed Solution
-      description: Describe the solution you'd like
-      placeholder: A clear and concise description of what you want to happen.
-    validations:
-      required: true
-
-  - type: textarea
-    id: alternatives
-    attributes:
-      label: Alternative Solutions
-      description: Describe alternatives you've considered
-      placeholder: A clear and concise description of any alternative solutions or features you've considered.
-
-  - type: dropdown
-    id: priority
-    attributes:
-      label: Priority
-      description: How important is this feature to you?
-      options:
-        - Low
-        - Medium
-        - High
-        - Critical
-    validations:
-      required: true
-
-  - type: checkboxes
-    id: implementation
-    attributes:
-      label: Implementation
-      description: Would you be willing to help implement this feature?
-      options:
-        - label: I would like to implement this feature
-        - label: I need help implementing this feature
-        - label: I can provide feedback during implementation
-
-  - type: textarea
-    id: additional
-    attributes:
-      label: Additional Context
-      description: Add any other context, screenshots, or examples about the feature request here.

package/.github/workflows/auto-release.yml

@@ -1,78 +0,0 @@
-name: Auto Release
-
-on:
-  push:
-    branches: [ main ]
-    paths:
-      - 'package.json'
-
-jobs:
-  check-version:
-    runs-on: ubuntu-latest
-    outputs:
-      should-release: ${{ steps.version-check.outputs.should-release }}
-      new-version: ${{ steps.version-check.outputs.new-version }}
-    
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-      with:
-        fetch-depth: 0
-    
-    - name: Check if version changed
-      id: version-check
-      run: |
-        # Get current version from package.json
-        CURRENT_VERSION=$(node -p "require('./package.json').version")
-        echo "Current version: $CURRENT_VERSION"
-        
-        # Check if tag already exists
-        if git tag --list | grep -q "^v$CURRENT_VERSION$"; then
-          echo "should-release=false" >> $GITHUB_OUTPUT
-          echo "Tag v$CURRENT_VERSION already exists"
-        else
-          echo "should-release=true" >> $GITHUB_OUTPUT
-          echo "new-version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-          echo "New version detected: $CURRENT_VERSION"
-        fi
-
-  auto-release:
-    needs: check-version
-    runs-on: ubuntu-latest
-    if: needs.check-version.outputs.should-release == 'true'
-    permissions:
-      contents: write
-    
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-    
-    - name: Setup Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '20.x'
-        cache: 'npm'
-        registry-url: 'https://registry.npmjs.org'
-    
-    - name: Install dependencies
-      run: npm ci
-    
-    - name: Run tests
-      run: npm run test:run
-    
-    - name: Build project
-      run: npm run build
-    
-    - name: Create and push tag
-      run: |
-        git config --local user.email "action@github.com"
-        git config --local user.name "GitHub Action"
-        git tag -a "v${{ needs.check-version.outputs.new-version }}" -m "Release v${{ needs.check-version.outputs.new-version }}"
-        git push origin "v${{ needs.check-version.outputs.new-version }}"
-      env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-    
-    - name: Publish to npm
-      run: npm publish
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/build.yml

@@ -1,55 +0,0 @@
-name: Build Pipeline
-
-on:
-  workflow_dispatch: # Allows manual triggering
-  push:
-    branches: [ main ]
-  workflow_call: # Allows this workflow to be called by other workflows
-
-jobs:
-  test:
-    name: Run Tests Before Build
-    uses: ./.github/workflows/test.yml
-
-  build:
-    name: Build Project
-    runs-on: ubuntu-latest
-    needs: [test]
-    if: ${{ needs.test.result == 'success' }}
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-      
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          cache: 'npm'
-      
-      - name: Install dependencies
-        run: npm ci
-      
-      - name: Build project
-        run: npm run build
-      
-      - name: Test CLI build
-        run: |
-          node dist/index.js --help
-          node dist/index.js --version
-      
-      - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: build-artifacts-${{ github.sha }}
-          path: |
-            dist/
-            package.json
-            package-lock.json
-            README.md
-            LICENSE
-            CHANGELOG.md
-          retention-days: 30
-          
-      - name: Build success notification
-        run: echo "✅ Build completed successfully for commit ${{ github.sha }}"

package/.github/workflows/publish.yml

@@ -1,134 +0,0 @@
-name: Publish Pipeline
-
-on:
-  workflow_dispatch: # Allows manual triggering
-    inputs:
-      use_artifact:
-        description: 'Use build artifact (provide artifact name or "latest")'
-        required: false
-        default: ''
-  release:
-    types: [published]
-
-jobs:
-  build:
-    name: Build for Publishing
-    uses: ./.github/workflows/build.yml
-    if: ${{ github.event.inputs.use_artifact == '' }}
-
-  publish:
-    name: Publish Package
-    runs-on: ubuntu-latest
-    needs: [build]
-    if: ${{ always() && (needs.build.result == 'success' || github.event.inputs.use_artifact != '') }}
-    environment: production # Requires environment approval for production
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-      
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'npm'
-      
-      - name: Download build artifacts (from current run)
-        if: ${{ github.event.inputs.use_artifact == '' }}
-        uses: actions/download-artifact@v4
-        with:
-          name: build-artifacts-${{ github.sha }}
-          path: ./
-      
-      - name: Download build artifacts (from specific run)
-        if: ${{ github.event.inputs.use_artifact != '' && github.event.inputs.use_artifact != 'latest' }}
-        uses: actions/download-artifact@v4
-        with:
-          name: ${{ github.event.inputs.use_artifact }}
-          path: ./
-      
-      - name: Download latest build artifacts
-        if: ${{ github.event.inputs.use_artifact == 'latest' }}
-        run: |
-          echo "Downloading latest build artifacts..."
-          gh run download --name "build-artifacts-*" --limit 1
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      
-      - name: Install dependencies (only for package.json)
-        run: npm ci --production
-      
-      - name: Publish to NPM
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      
-      - name: Publish success notification
-        run: echo "✅ Package published to NPM successfully"
-
-  publish-github:
-    name: Publish to GitHub Packages
-    runs-on: ubuntu-latest
-    needs: [build, publish]
-    if: ${{ always() && needs.publish.result == 'success' }}
-    permissions:
-      contents: read
-      packages: write
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-      
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://npm.pkg.github.com'
-          cache: 'npm'
-      
-      - name: Download build artifacts (reuse from publish job)
-        if: ${{ github.event.inputs.use_artifact == '' }}
-        uses: actions/download-artifact@v4
-        with:
-          name: build-artifacts-${{ github.sha }}
-          path: ./
-      
-      - name: Download build artifacts (from specific run)
-        if: ${{ github.event.inputs.use_artifact != '' && github.event.inputs.use_artifact != 'latest' }}
-        uses: actions/download-artifact@v4
-        with:
-          name: ${{ github.event.inputs.use_artifact }}
-          path: ./
-      
-      - name: Download latest build artifacts
-        if: ${{ github.event.inputs.use_artifact == 'latest' }}
-        run: |
-          echo "Downloading latest build artifacts..."
-          gh run download --name "build-artifacts-*" --limit 1
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      
-      - name: Install dependencies (only for package.json)
-        run: npm ci --production
-      
-      - name: Configure package for GitHub Packages
-        run: |
-          cp package.json package.json.backup
-          node -e "
-            const pkg = require('./package.json');
-            pkg.name = '@${{ github.repository_owner }}/' + pkg.name.split('/').pop();
-            require('fs').writeFileSync('package.json', JSON.stringify(pkg, null, 2));
-          "
-      
-      - name: Publish to GitHub Packages
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      
-      - name: Restore original package.json
-        run: mv package.json.backup package.json
-        if: always()
-      
-      - name: GitHub Packages success notification
-        run: echo "✅ Package published to GitHub Packages successfully"

package/.github/workflows/test.yml

@@ -1,47 +0,0 @@
-name: Test Pipeline
-
-on:
-  workflow_dispatch: # Allows manual triggering
-  workflow_call: # Allows this workflow to be called by other workflows
-  push:
-    branches: [ main, develop ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  test:
-    name: Run Tests
-    runs-on: ubuntu-latest
-    
-    strategy:
-      matrix:
-        node-version: [18, 20, 22]
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-      
-      - name: Setup Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      
-      - name: Install dependencies
-        run: npm ci
-      
-      - name: Run linter (if available)
-        run: npm run lint --if-present
-      
-      - name: Run tests
-        run: npm run test:run
-      
-      - name: Generate coverage report
-        run: npm run test:coverage
-        if: matrix.node-version == '22'
-      
-      - name: Upload coverage reports
-        uses: codecov/codecov-action@v3
-        if: matrix.node-version == '22'
-        with:
-          fail_ci_if_error: false

package/src/cli/commands.ts

@@ -1,64 +0,0 @@
-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 using AI analysis')
-    .argument('[directory]', 'Directory containing files to rename (default: current directory)', '.')
-    .option('-p, --provider <provider>', 'AI provider (claude|openai|ollama|lmstudio)', 'claude')
-    .option('-k, --api-key <key>', 'API key for cloud providers (or set CLAUDE_API_KEY/OPENAI_API_KEY)')
-    .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 (for document/photo templates)')
-    .option('-d, --date <format>', 'Date format to include (YYYY-MM-DD|YYYY|YYYYMMDD|none)', 'none')
-    .option('--dry-run', 'Preview changes without actually renaming files (RECOMMENDED first!)', false)
-    .option('--max-size <size>', 'Maximum file size in MB to process', '10')
-    .option('--base-url <url>', 'Base URL for local LLM providers (default: ollama=http://localhost:11434, lmstudio=http://localhost:1234)')
-    .option('--model <name>', 'Model name for local LLM providers (default: ollama=llama3.1, lmstudio=local-model)')
-    .addHelpText('after', `
-
-🔍 How it works:
-  1. Scans directory for supported files (PDF, DOCX, XLSX, TXT, MD, RTF)
-  2. Extracts content and metadata from each file
-  3. For scanned PDFs with no text, converts to image for AI vision analysis
-  4. Uses AI to analyze content and generate descriptive names
-  5. Applies your chosen template and naming convention
-  6. Renames files (or shows preview with --dry-run)
-
-💡 Pro Tips:
-  • Always use --dry-run first to preview changes
-  • Use 'auto' template for smart file type detection
-  • Personal templates work great for documents and photos
-  • Scanned PDFs are automatically handled via AI vision (Claude/OpenAI/Ollama)
-  • Set API keys as environment variables for cloud providers
-  • Local LLMs (Ollama/LMStudio) require running servers first
-
-🖥️  Local LLM Setup:
-  • Ollama: Start with 'ollama serve' (default: http://localhost:11434)
-  • LMStudio: Enable local server mode (default: http://localhost:1234)
-
-📝 Examples:
-  # Current directory (no directory argument needed)
-  namewise rename --dry-run
-  namewise rename --provider claude --template document --name "alice"
-
-  # Specific directory
-  namewise rename ./documents --dry-run
-
-  # Cloud providers (require API keys)
-  namewise rename ./docs --provider claude --template document --name "alice"
-  namewise rename ./media --provider openai --template auto
-
-  # Local LLMs (no API key needed)
-  namewise rename --provider ollama --model llama3.1 --dry-run
-  namewise rename ./documents --provider ollama --model llama3.1
-  namewise rename ./contracts --provider lmstudio --base-url http://localhost:1234
-
-  # Custom Ollama setup
-  namewise rename ./files --provider ollama --base-url http://192.168.1.100:11434 --model codellama
-`)
-    .action(async (directory, options) => {
-      await renameFiles(directory, options);
-    });
-}