{"_id":"@andikhadian/tanjiro","name":"@andikhadian/tanjiro","dist-tags":{"latest":"1.2.0"},"versions":{"1.2.0":{"name":"@andikhadian/tanjiro","version":"1.2.0","description":"🗡️ CLI tool yang powerful untuk menganalisis dan membandingkan perubahan code migration antara branch Git dengan output terstruktur dalam format CSV atau Markdown","main":"dist/index.js","bin":{"tanjiro":"dist/index.js"},"scripts":{"build":"tsc","dev":"ts-node src/index.ts","start":"node dist/index.js","prepare":"npm run build","prepublishOnly":"npm run build && npm run lint","postpublish":"git push && git push --tags","test":"echo \"Error: no test specified\" && exit 1","lint":"echo \"Linting completed\"","clean":"rm -rf dist","watch":"tsc --watch","type-check":"tsc --noEmit","publish:patch":"npm version patch && npm publish && npm run post-publish","publish:minor":"npm version minor && npm publish && npm run post-publish","publish:major":"npm version major && npm publish && npm run post-publish","post-publish":"git push origin main --tags && echo 'Published successfully!'"},"keywords":["git","migration","cli","typescript","branch-comparison","csv","markdown","diff","developer-tools","git-analysis","code-migration","branch-diff","git-tools","command-line"],"author":{"name":"Tanjiro Development Team","email":"tanjiro@example.com","url":"https://github.com/tanjiro-dev"},"license":"MIT","dependencies":{"commander":"^11.1.0","simple-git":"^3.20.0","chalk":"^4.1.2","ora":"^5.4.1","fs-extra":"^11.1.1"},"devDependencies":{"@types/node":"^20.8.0","@types/fs-extra":"^11.0.4","typescript":"^5.2.2","ts-node":"^10.9.1"},"engines":{"node":">=16.0.0","npm":">=8.0.0"},"repository":{"type":"git","url":"git+https://github.com/tanjiro-dev/tanjiro.git"},"bugs":{"url":"https://github.com/tanjiro-dev/tanjiro/issues"},"homepage":"https://github.com/tanjiro-dev/tanjiro#readme","preferGlobal":true,"os":["darwin","linux","win32"],"cpu":["x64","arm64"],"_id":"@andikhadian/tanjiro@1.2.0","gitHead":"8a261c5f5fce0d2d50ceb1a4777f4e34c53473e4","types":"./dist/index.d.ts","_nodeVersion":"20.19.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-79FiI4iqFe6ss/jwKCVv5cL5lRrr7zcGvFIRn6G+7ulLsXOKA5i47e4mosZVpKBcoo+zh7mfM//UWQ4410eTKw==","shasum":"ef1bcccac6a3d8dffc01f64a2984491beb6bb017","tarball":"https://registry.npmjs.org/@andikhadian/tanjiro/-/tanjiro-1.2.0.tgz","fileCount":44,"unpackedSize":103059,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC7L3majXW1EahHQ4u9GpeYnAywCO+rIMTtxg+MwUOqxQIgJKhn4M/h8P/aNyOkeiz1hUybUhWsLvyr9/iIbcGNiPo="}]},"_npmUser":{"name":"andikhadian","email":"andikha.dian1@gmail.com"},"directories":{},"maintainers":[{"name":"andikhadian","email":"andikha.dian1@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tanjiro_1.2.0_1759907917319_0.8975697857549496"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-08T07:18:37.259Z","1.2.0":"2025-10-08T07:18:37.501Z","modified":"2025-10-08T07:18:38.048Z"},"maintainers":[{"name":"andikhadian","email":"andikha.dian1@gmail.com"}],"description":"🗡️ CLI tool yang powerful untuk menganalisis dan membandingkan perubahan code migration antara branch Git dengan output terstruktur dalam format CSV atau Markdown","homepage":"https://github.com/tanjiro-dev/tanjiro#readme","keywords":["git","migration","cli","typescript","branch-comparison","csv","markdown","diff","developer-tools","git-analysis","code-migration","branch-diff","git-tools","command-line"],"repository":{"type":"git","url":"git+https://github.com/tanjiro-dev/tanjiro.git"},"author":{"name":"Tanjiro Development Team","email":"tanjiro@example.com","url":"https://github.com/tanjiro-dev"},"bugs":{"url":"https://github.com/tanjiro-dev/tanjiro/issues"},"license":"MIT","readme":"# 🗡️ Tanjiro\n\n**Tanjiro** adalah CLI tool yang powerful untuk menganalisis dan membandingkan perubahan code migration antara branch Git dengan output yang terstruktur dalam format CSV atau Markdown.\n\n## 📋 Deskripsi Tools\n\n### Apa itu Tanjiro?\nTanjiro adalah tool command-line yang dirancang khusus untuk membantu developer dalam menganalisis perubahan kode antara branch Git. Tool ini menghasilkan laporan migration yang terstruktur, memudahkan tracking perubahan file, dan memberikan insight yang jelas tentang evolusi codebase.\n\n### Teknologi Utama\n- **TypeScript** - Bahasa pemrograman utama\n- **Node.js** - Runtime environment\n- **Commander.js** - CLI framework\n- **Simple-git** - Git operations\n- **Chalk** - Terminal styling\n- **Ora** - Loading spinners\n- **fs-extra** - Enhanced file system operations\n\n### Fitur Utama\n- 🔍 **Perbandingan Branch**: Analisis perubahan antara dua branch Git\n- 📊 **Multiple Output Format**: Mendukung CSV dan Markdown\n- 🎯 **Format Tabel Terstruktur**: Output sesuai standar migration table\n- 🌐 **Universal Compatibility**: Dapat digunakan pada berbagai project Git\n- 🛠️ **Easy Installation**: Install global via npm atau gunakan npx\n- 🎨 **Beautiful CLI**: Interface user-friendly dengan colors dan progress indicators\n- 📈 **Single Branch Analysis**: Analisis perubahan pada branch tertentu\n- 🔄 **Real-time Git Integration**: Integrasi langsung dengan Git repository\n\n## 🏗️ Arsitektur Sistem\n\n### Struktur Project\n```\ntanjiro/\n├── src/\n│   ├── index.ts           # Entry point aplikasi\n│   ├── cli.ts             # CLI interface dan command handling\n│   ├── git-service.ts     # Git operations dan repository management\n│   ├── migration-parser.ts # Data parsing dan transformation\n│   ├── output-formatter.ts # Output generation (CSV/Markdown)\n│   ├── error-handler.ts   # Error handling utilities\n│   └── types.ts           # Type definitions\n├── dist/                  # Compiled JavaScript output\n├── package.json           # Package configuration\n├── tsconfig.json          # TypeScript configuration\n└── README.md              # Dokumentasi\n```\n\n### Komponen Utama\n\n#### 1. CLI Interface (`cli.ts`)\n- Menangani command-line arguments\n- Mengatur routing command\n- Menampilkan help dan usage information\n- Mengelola user interaction\n\n#### 2. Git Service (`git-service.ts`)\n- Validasi Git repository\n- Branch operations (list, validate, compare)\n- Git diff analysis\n- File status tracking\n\n#### 3. Migration Parser (`migration-parser.ts`)\n- Parsing Git diff output\n- Transformasi data ke format migration\n- File path processing\n- Metadata extraction\n\n#### 4. Output Formatter (`output-formatter.ts`)\n- Generate output dalam format CSV/Markdown\n- Console table formatting\n- File writing operations\n- Template rendering\n\n## 📦 Dependensi\n\n### Production Dependencies\n```json\n{\n  \"commander\": \"^11.1.0\",      // CLI framework\n  \"simple-git\": \"^3.20.0\",    // Git operations\n  \"chalk\": \"^4.1.2\",          // Terminal colors\n  \"ora\": \"^5.4.1\",            // Loading spinners\n  \"fs-extra\": \"^11.1.1\"       // File system utilities\n}\n```\n\n### Development Dependencies\n```json\n{\n  \"@types/node\": \"^20.8.0\",\n  \"@types/fs-extra\": \"^11.0.4\",\n  \"typescript\": \"^5.2.2\",\n  \"ts-node\": \"^10.9.1\"\n}\n```\n\n### System Requirements\n- **Node.js**: >= 16.0.0\n- **Git**: Installed dan accessible via command line\n- **Operating System**: macOS, Linux, Windows\n\n## 🚀 Instalasi\n\n### Global Installation\n```bash\nnpm install -g tanjiro\n```\n\n### Menggunakan npx (Tanpa Instalasi)\n```bash\nnpx tanjiro <command>\n```\n\n### Verifikasi Instalasi\n```bash\ntanjiro --version\ntanjiro --help\n```\n\n## 📖 Petunjuk Penggunaan\n\n### Command Dasar\n\n#### 1. Membandingkan Branch\n```bash\n# Format dasar\ntanjiro compare -f <branch-asal> -t <branch-tujuan>\n\n# Contoh\ntanjiro compare -f main -t develop\ntanjiro compare -f feature/login -t develop\n```\n\n#### 2. Analisis Single Branch\n```bash\n# Melihat perubahan pada branch tertentu\ntanjiro changes -b <branch-name>\n\n# Contoh\ntanjiro changes -b develop\ntanjiro changes -b feature/user-management\n```\n\n#### 3. Output ke File\n```bash\n# Output Markdown (default)\ntanjiro compare -f main -t develop -o migration-report.md\n\n# Output CSV\ntanjiro compare -f main -t develop --format csv -o migration-report.csv\ntanjiro changes -b develop --format csv -o changes.csv\n```\n\n#### 4. Utility Commands\n```bash\n# Melihat daftar branch\ntanjiro branches\n# atau\ntanjiro br\n\n# Status repository\ntanjiro status\n\n# Bantuan\ntanjiro help\ntanjiro <command> --help\n```\n\n### Options Lengkap\n\n| Option | Alias | Description | Default |\n|--------|-------|-------------|---------|\n| `--from <branch>` | `-f` | Branch asal untuk perbandingan | Required |\n| `--to <branch>` | `-t` | Branch tujuan untuk perbandingan | Required |\n| `--branch <branch>` | `-b` | Branch untuk analisis single branch | Required |\n| `--output <file>` | `-o` | File output untuk menyimpan hasil | Optional |\n| `--format <format>` | | Format output: `csv` atau `markdown` | `markdown` |\n| `--no-console` | | Tidak menampilkan hasil di console | `false` |\n\n### Format Output\n\n#### Tabel Migration\nOutput mengikuti format standar migration table:\n\n| No | Library/Object | Type | Compile/Promote Date | Size (KBytes) | No | Library/Object | Type | Compile/Promote Date | Size (KBytes) | Remark |\n|----|----------------|------|----------------------|---------------|----|--------------------|------|----------------------|---------------|--------|\n| 1  | src/auth.ts    | TS   | 2024-01-15          | 2.45          | 1  | src/auth.ts       | TS   | 2024-01-15          | 2.67          | src    |\n\n#### Keterangan Remark\n- `new`: File baru yang ditambahkan\n- `src`: File yang dimodifikasi\n- `other`: File yang dihapus atau status lainnya\n\n## 💡 Contoh Penggunaan\n\n### Scenario 1: Basic Comparison\n```bash\n# Membandingkan main dengan develop branch\ntanjiro compare -f main -t develop\n```\n\n### Scenario 2: Export ke CSV untuk Deployment\n```bash\n# Generate CSV report untuk deployment tracking\ntanjiro compare -f staging -t production --format csv -o deployment-migration.csv\n```\n\n### Scenario 3: Feature Branch Analysis\n```bash\n# Analisis perubahan feature branch\ntanjiro compare -f develop -t feature/user-management -o feature-analysis.md\n```\n\n### Scenario 4: Silent Mode\n```bash\n# Generate report tanpa output console\ntanjiro compare -f main -t develop -o report.md --no-console\n```\n\n### Scenario 5: Single Branch Changes\n```bash\n# Melihat semua perubahan pada branch develop\ntanjiro changes -b develop --format csv -o develop-changes.csv\n```\n\n## 🔧 Troubleshooting\n\n### Error: \"Direktori ini bukan repository Git yang valid\"\n**Solusi:**\n- Pastikan Anda berada di dalam direktori Git repository\n- Jalankan `git status` untuk memverifikasi\n- Inisialisasi Git repository jika belum ada: `git init`\n\n### Error: \"Branch tidak ditemukan\"\n**Solusi:**\n- Gunakan `tanjiro branches` untuk melihat daftar branch yang tersedia\n- Pastikan nama branch sudah benar (case-sensitive)\n- Untuk remote branch, pastikan sudah di-fetch: `git fetch origin`\n\n### Error: \"Permission denied\"\n**Solusi:**\n- Pastikan Anda memiliki akses read ke repository\n- Check file permissions pada direktori project\n- Untuk repository private, pastikan authentication sudah benar\n\n### Performance Issues\n**Solusi:**\n- Untuk repository besar, pertimbangkan untuk menggunakan `--no-console` untuk output yang lebih cepat\n- Pastikan Git repository dalam kondisi clean (tidak ada uncommitted changes yang banyak)\n\n## 📊 Output Examples\n\n### Console Output\n```\n📊 Migration Report: main → develop\n═══════════════════════════════════════════════════════════════════════════════════════════\n| No | Library/Object      | Type  | Date       | Size  | No | Library/Object      | Type  | Date       | Size  | Remark |\n|----|--------------------|----- -|------------|-------|----|--------------------|-------|------------|-------|--------|\n| 1  | src/auth.service.ts | TS    | 2024-01-15 | 2.45  | 1  | src/auth.service.ts | TS    | 2024-01-15 | 2.67  | src    |\n| 2  | src/user.model.ts   | TS    | 2024-01-15 | 1.23  | 2  | src/user.model.ts   | TS    | 2024-01-15 | 1.23  | new    |\n═══════════════════════════════════════════════════════════════════════════════════════════\n📈 Summary: 2 → 2 files (4 total changes)\n```\n\n### CSV Output\n```csv\nFrom: main\nTo: develop\n\nNo,Library / Object,Type,Compile / Promote Date,Size (KBytes),No,Library / Object,Type,Compile / Promote Date,Size (KBytes),Remark\n1,\"src/auth.service.ts\",TS,2024-01-15,2.45,1,\"src/auth.service.ts\",TS,2024-01-15,2.67,src\n2,\"src/user.model.ts\",TS,2024-01-15,1.23,2,\"src/user.model.ts\",TS,2024-01-15,1.23,new\n```\n\n## 🤝 Kontribusi\n\nKami menyambut kontribusi dari komunitas! Silakan baca [CONTRIBUTING.md](CONTRIBUTING.md) untuk panduan lengkap tentang cara berkontribusi.\n\n### Quick Start untuk Kontributor\n1. Fork repository ini\n2. Clone fork Anda: `git clone <your-fork-url>`\n3. Install dependencies: `npm install`\n4. Buat branch feature: `git checkout -b feature/amazing-feature`\n5. Develop dan test perubahan Anda\n6. Commit: `git commit -m 'Add amazing feature'`\n7. Push: `git push origin feature/amazing-feature`\n8. Buat Pull Request\n\n## 📄 License\n\nMIT License - lihat file [LICENSE](LICENSE) untuk detail lengkap.\n\n## 🙋‍♂️ Support\n\nJika Anda mengalami masalah atau memiliki pertanyaan:\n\n1. Cek [Issues](https://github.com/your-username/tanjiro/issues) yang sudah ada\n2. Buat issue baru jika diperlukan\n3. Sertakan informasi:\n   - Versi Node.js (`node --version`)\n   - Versi Tanjiro (`tanjiro --version`)\n   - Operating System\n   - Error message lengkap\n   - Steps to reproduce\n\n## 🚀 Roadmap\n\n- [ ] Support untuk Git hooks integration\n- [ ] Export ke format Excel\n- [ ] Integration dengan CI/CD pipelines\n- [ ] Web dashboard untuk visualisasi\n- [ ] Support untuk multiple repository comparison\n- [ ] Plugin system untuk custom formatters\n- [ ] Configuration file support\n- [ ] Advanced filtering options\n\n## 📈 Changelog\n\n### v1.2.0\n- ✨ Renamed from GitFlow Migrator to Tanjiro\n- 🐛 Fixed file path prefix slash issue\n- 🔄 Synchronized CLI version with package.json\n- 📝 Updated documentation and help text\n\n### v1.1.0\n- ✨ Added `changes` command for single branch analysis\n- 🐛 Fixed output formatting issues\n- 📊 Improved console table display\n\n### v1.0.0\n- 🎉 Initial release\n- ✨ Basic branch comparison functionality\n- 📊 CSV and Markdown output support\n- 🎨 Beautiful CLI interface\n\n---\n\n**Made with ❤️ for developers who love clean migration reports**\n\n*Tanjiro - Slicing through Git diffs with precision* ⚔️","readmeFilename":"README.md","_rev":"1-d8d24ecf76cd1d5e7622e3e823f387ed"}