@amirdaraee/namewise 0.3.0

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,82 @@
+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

@@ -0,0 +1,61 @@
+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

@@ -0,0 +1,78 @@
+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/ci.yml

@@ -0,0 +1,78 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x, 22.x]
+    
+    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: Run coverage
+      run: npm run test:coverage
+    
+    - name: Build project
+      run: npm run build
+    
+    - name: Test CLI
+      run: |
+        node dist/index.js --help
+        node dist/index.js --version
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20.x'
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Build project
+      run: npm run build
+    
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: build-artifacts
+        path: |
+          dist/
+          package.json
+          README.md
+          LICENSE
+          CHANGELOG.md
+        retention-days: 30

package/.github/workflows/publish.yml

@@ -0,0 +1,43 @@
+name: Publish Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  publish-npm:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: https://registry.npmjs.org/
+      - run: npm ci
+      - run: npm run build
+      - run: npm run test:run
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  publish-gpr:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: https://npm.pkg.github.com/
+      - run: npm ci
+      - run: npm run build
+      - run: npm run test:run
+      - name: Publish to GitHub Packages
+        run: |
+          echo "registry=https://npm.pkg.github.com/" > .npmrc
+          echo "//npm.pkg.github.com/:_authToken=${{ secrets.GITHUB_TOKEN }}" >> .npmrc
+          npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Test
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+
+    steps:
+      - 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: Build project
+        run: npm run build
+      
+      - name: Run tests
+        run: npm run test:run
+      
+      - name: Run coverage
+        run: npm run test:coverage
+        if: matrix.node-version == '22'

package/CHANGELOG.md

@@ -0,0 +1,128 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.3.0] - 2025-09-05
+
+### Added
+- **🎯 Personal File Templates**: Customizable templates for different file categories
+  - `document`: Personal docs with name and date (e.g., `driving-license-amirhossein-20250213.pdf`)
+  - `movie`: Movies with release year (e.g., `the-dark-knight-2008.mkv`)
+  - `music`: Music with artist names (e.g., `the-beatles-hey-jude.mp3`)
+  - `series`: TV series with season/episode (e.g., `breaking-bad-s01e01.mkv`)
+  - `photo`: Photos with personal info (e.g., `vacation-paris-john-20240715.jpg`)
+  - `book`: Books with author names (e.g., `george-orwell-1984.pdf`)
+  - `general`: General files without special formatting
+- **🤖 Smart File Categorization**: Automatically detects file type based on extension and content
+- **👤 Personal Name Integration**: `-n, --name` option to include your name in documents
+- **📅 Flexible Date Formats**: `-d, --date` option with formats:
+  - `YYYY-MM-DD`: 2025-09-05
+  - `YYYY`: 2025
+  - `YYYYMMDD`: 20250905
+  - `none`: No date (default)
+- **📂 Category Templates**: `-t, --template` option to specify file category or use auto-detection
+
+### Enhanced
+- AI prompts now include category-specific instructions for better filename generation
+- File processing pipeline includes template application after AI generation
+- Comprehensive test coverage with 131 tests (23 new tests for templates)
+
+### Examples
+```bash
+# Personal documents with your name and date
+namewise rename ./documents -t document -n "amirhossein" -d "YYYYMMDD" --dry-run
+# Result: driving-license-amirhossein-20250905.pdf
+
+# Movies with auto-detection
+namewise rename ./movies --dry-run
+# Result: the-dark-knight-2008.mkv
+
+# Series with season/episode detection
+namewise rename ./shows --dry-run  
+# Result: breaking-bad-s01e01.mkv
+
+# Music with artist names
+namewise rename ./music -t music --dry-run
+# Result: the-beatles-hey-jude.mp3
+```
+
+## [0.2.0] - 2025-09-05
+
+### Added
+- **Naming Convention Customization**: Added `-c, --case` option to choose naming convention
+  - `kebab-case`: lowercase-with-hyphens (default)
+  - `snake_case`: lowercase_with_underscores  
+  - `camelCase`: camelCaseFormat
+  - `PascalCase`: PascalCaseFormat
+  - `lowercase`: lowercaseformat
+  - `UPPERCASE`: UPPERCASEFORMAT
+- AI services now receive naming convention instructions and generate appropriately formatted filenames
+- Enhanced filename sanitization with convention-aware processing
+
+### Example Usage
+```bash
+# Use snake_case naming
+namewise rename ./docs --case snake_case --dry-run
+
+# Use camelCase naming  
+namewise rename ./docs --case camelCase --provider openai
+```
+
+## [0.1.5] - 2025-09-05
+
+### Improved
+- Enhanced CLI user experience with single-line progress display that updates in place
+- Improved results output format: clear `original-name → new-name` display instead of confusing double checkmarks
+- Added progress counter showing current file being processed `(3/7)`
+- Cleaner console output with proper line clearing after processing
+
+## [0.1.4] - 2025-09-05
+
+### Fixed
+- Fixed console output formatting where `\n` was displayed as literal text instead of newlines
+- Console output now properly displays line breaks for better readability
+
+## [0.1.3] - 2025-09-05
+
+### Changed
+- Package renamed from `ai-rename` to `namewise` (clearer branding and avoids confusion with existing ai-renamer package)
+- CLI binary name changed from `ai-rename` to `namewise`
+- All documentation and references updated to reflect new name
+
+## [0.1.1] - 2025-09-05
+
+### Changed
+- Package renamed from `smart-rename` to `ai-rename` (original name was taken on NPM)
+- CLI binary name changed from `smart-rename` to `ai-rename`
+- All documentation and references updated to reflect new name
+
+## [0.1.0] - 2025-09-05
+
+### Added
+- Initial beta release of AI Rename
+- AI-powered file renaming using Claude or OpenAI
+- Support for PDF, Word, Excel, and text files
+- Dry-run mode for safe previewing
+- File conflict detection and prevention
+- Configurable file size limits
+- Interactive API key prompts
+- Comprehensive test suite (65 tests, 90%+ branch coverage)
+- CLI with intuitive commands and options
+
+### Features
+- **Document Parsers**: PDF, DOCX, DOC, XLSX, XLS, TXT, MD, RTF
+- **AI Providers**: Claude (Anthropic) and OpenAI support
+- **Safety Features**: Dry-run mode, conflict detection, error handling
+- **Configuration**: Flexible options for provider, API keys, and file sizes
+
+### Technical
+- TypeScript implementation with strict typing
+- ESM module support
+- Node.js 18+ compatibility
+- Vitest testing framework
+- Commander.js CLI framework

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 smart-rename
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.