@tukuyomil032/broom 1.0.0

package/dist/utils/paths.js

@@ -0,0 +1,142 @@
+/**
+ * Path definitions for cleanup operations
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+const HOME = homedir();
+export const paths = {
+    // User caches
+    userCache: join(HOME, 'Library/Caches'),
+    userLogs: join(HOME, 'Library/Logs'),
+    // System caches (requires sudo)
+    systemCache: '/Library/Caches',
+    systemLogs: '/Library/Logs',
+    // Trash
+    trash: join(HOME, '.Trash'),
+    // Downloads
+    downloads: join(HOME, 'Downloads'),
+    // Browser caches
+    browserCache: {
+        chrome: join(HOME, 'Library/Caches/Google/Chrome'),
+        chromeProfile: join(HOME, 'Library/Application Support/Google/Chrome/Default/Cache'),
+        safari: join(HOME, 'Library/Caches/com.apple.Safari'),
+        firefox: join(HOME, 'Library/Caches/Firefox'),
+        firefoxProfile: join(HOME, 'Library/Application Support/Firefox/Profiles'),
+        edge: join(HOME, 'Library/Caches/Microsoft Edge'),
+        edgeProfile: join(HOME, 'Library/Application Support/Microsoft Edge/Default/Cache'),
+        brave: join(HOME, 'Library/Caches/BraveSoftware/Brave-Browser'),
+        braveProfile: join(HOME, 'Library/Application Support/BraveSoftware/Brave-Browser/Default/Cache'),
+        arc: join(HOME, 'Library/Caches/company.thebrowser.Browser'),
+        arcProfile: join(HOME, 'Library/Application Support/Arc/User Data/Default/Cache'),
+    },
+    // Development caches
+    devCache: {
+        npm: join(HOME, '.npm'),
+        npmCache: join(HOME, '.npm/_cacache'),
+        yarn: join(HOME, '.yarn/cache'),
+        pnpm: join(HOME, '.pnpm-store'),
+        bun: join(HOME, '.bun'),
+        pip: join(HOME, 'Library/Caches/pip'),
+        pipCache: join(HOME, '.cache/pip'),
+        cargo: join(HOME, '.cargo/registry/cache'),
+        rustup: join(HOME, '.rustup/downloads'),
+        go: join(HOME, 'go/pkg/mod/cache'),
+        gradle: join(HOME, '.gradle/caches'),
+        maven: join(HOME, '.m2/repository'),
+        cocoapods: join(HOME, 'Library/Caches/CocoaPods'),
+        carthage: join(HOME, 'Library/Caches/org.carthage.CarthageKit'),
+        composer: join(HOME, '.composer/cache'),
+    },
+    // Xcode caches
+    xcode: {
+        derivedData: join(HOME, 'Library/Developer/Xcode/DerivedData'),
+        archives: join(HOME, 'Library/Developer/Xcode/Archives'),
+        deviceSupport: join(HOME, 'Library/Developer/Xcode/iOS DeviceSupport'),
+        simulatorCache: join(HOME, 'Library/Developer/CoreSimulator/Caches'),
+        simulatorDevices: join(HOME, 'Library/Developer/CoreSimulator/Devices'),
+        modulesCache: join(HOME, 'Library/Developer/Xcode/ModuleCache'),
+        previewsCache: join(HOME, 'Library/Developer/Xcode/UserData/Previews'),
+    },
+    // Homebrew
+    homebrew: {
+        cache: join(HOME, 'Library/Caches/Homebrew'),
+        logs: join(HOME, 'Library/Logs/Homebrew'),
+        downloads: '/opt/homebrew/var/homebrew/cache', // Apple Silicon
+    },
+    // Docker
+    docker: {
+        data: join(HOME, 'Library/Containers/com.docker.docker/Data'),
+        vmDisk: join(HOME, 'Library/Containers/com.docker.docker/Data/vms'),
+    },
+    // iOS backups
+    iosBackups: join(HOME, 'Library/Application Support/MobileSync/Backup'),
+    // Temp files
+    tempFiles: {
+        userTemp: join(HOME, 'Library/Caches/TemporaryItems'),
+        systemTemp: '/private/tmp',
+        varTmp: '/var/tmp',
+    },
+    // Spotlight
+    spotlight: {
+        index: '/.Spotlight-V100',
+    },
+    // Time Machine local snapshots
+    timeMachine: '/.MobileBackups',
+    // Application Support
+    applicationSupport: join(HOME, 'Library/Application Support'),
+    // Preferences
+    preferences: join(HOME, 'Library/Preferences'),
+    // Saved Application State
+    savedState: join(HOME, 'Library/Saved Application State'),
+    // Applications
+    applications: '/Applications',
+    userApplications: join(HOME, 'Applications'),
+};
+// Common app data patterns
+export const appDataPatterns = [
+    // General caches
+    'Library/Caches/*',
+    'Library/Application Support/*',
+    'Library/Preferences/*',
+    'Library/Saved Application State/*',
+    'Library/Logs/*',
+    // Launch agents/daemons
+    'Library/LaunchAgents/*',
+    'Library/LaunchDaemons/*',
+    // Containers
+    'Library/Containers/*',
+    'Library/Group Containers/*',
+];
+// Files to exclude from cleanup
+export const excludePatterns = [
+    // System essentials
+    'com.apple.*',
+    // Active browser profiles
+    '**/Cookies',
+    '**/Bookmarks',
+    '**/History',
+    '**/Login Data',
+    // Development essentials
+    'node_modules/.package-lock.json',
+    '.git',
+    // User data
+    '**/LocalStorage',
+    '**/IndexedDB',
+];
+// Category paths mapping
+export const categoryPaths = {
+    'user-cache': [paths.userCache],
+    'system-cache': [paths.systemCache],
+    'user-logs': [paths.userLogs],
+    'system-logs': [paths.systemLogs],
+    trash: [paths.trash],
+    downloads: [paths.downloads],
+    'browser-cache': Object.values(paths.browserCache),
+    'dev-cache': Object.values(paths.devCache),
+    xcode: Object.values(paths.xcode),
+    homebrew: [paths.homebrew.cache, paths.homebrew.logs],
+    docker: [paths.docker.data],
+    'ios-backups': [paths.iosBackups],
+    'temp-files': Object.values(paths.tempFiles),
+};
+export default paths;

package/dist/utils/report.js

@@ -0,0 +1,404 @@
+/**
+ * HTML Report Generator
+ */
+import Handlebars from 'handlebars';
+import { formatSize } from '../utils/fs.js';
+import { writeFile, mkdir } from 'fs/promises';
+import { dirname } from 'path';
+// Register Handlebars helpers
+Handlebars.registerHelper('formatSize', (bytes) => {
+    return formatSize(bytes);
+});
+Handlebars.registerHelper('formatDate', (date) => {
+    return new Date(date).toLocaleString('ja-JP');
+});
+Handlebars.registerHelper('formatDuration', (ms) => {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}時間${minutes % 60}分${seconds % 60}秒`;
+    }
+    else if (minutes > 0) {
+        return `${minutes}分${seconds % 60}秒`;
+    }
+    else {
+        return `${seconds}秒`;
+    }
+});
+Handlebars.registerHelper('toFixed', (num, decimals) => {
+    return num.toFixed(decimals);
+});
+Handlebars.registerHelper('json', (obj) => {
+    return JSON.stringify(obj);
+});
+// Comparison helper
+Handlebars.registerHelper('eq', (a, b) => {
+    return a === b;
+});
+// Greater than helper
+Handlebars.registerHelper('gt', (a, b) => {
+    return a > b;
+});
+// Map helper - extract property from array
+Handlebars.registerHelper('map', (array, property) => {
+    if (!Array.isArray(array))
+        return [];
+    return array.map((item) => item[property]);
+});
+const HTML_TEMPLATE = `<!DOCTYPE html>
+<html lang="ja">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Broom Cleanup Report - {{formatDate metadata.generatedAt}}</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+    <style>
+        @media print {
+            .no-print { display: none; }
+            body { background: white; }
+        }
+        @page {
+            margin: 2cm;
+        }
+    </style>
+</head>
+<body class="bg-gray-50">
+    <!-- Header -->
+    <header class="bg-gradient-to-r from-cyan-500 to-blue-500 text-white py-8 no-print">
+        <div class="container mx-auto px-4">
+            <h1 class="text-4xl font-bold flex items-center gap-2">
+                🧹 Broom Cleanup Report
+            </h1>
+            <p class="text-cyan-100 mt-2">{{formatDate metadata.generatedAt}}</p>
+        </div>
+    </header>
+
+    <!-- Summary Cards -->
+    <section class="container mx-auto px-4 py-8">
+        <div class="grid grid-cols-1 md:grid-cols-4 gap-6">
+            <!-- Space Freed -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <div class="text-gray-600 text-sm font-medium">回収した容量</div>
+                <div class="text-3xl font-bold text-green-600 mt-2">{{formatSize summary.totalSpaceFreed}}</div>
+                <div class="text-gray-500 text-xs mt-1">{{summary.totalFilesDeleted}} ファイル</div>
+            </div>
+
+            <!-- Files Deleted -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <div class="text-gray-600 text-sm font-medium">削除ファイル数</div>
+                <div class="text-3xl font-bold text-blue-600 mt-2">{{summary.totalFilesDeleted}}</div>
+                <div class="text-gray-500 text-xs mt-1">合計</div>
+            </div>
+
+            <!-- Time Elapsed -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <div class="text-gray-600 text-sm font-medium">処理時間</div>
+                <div class="text-3xl font-bold text-purple-600 mt-2">{{formatDuration summary.timeElapsed}}</div>
+                <div class="text-gray-500 text-xs mt-1">経過時間</div>
+            </div>
+
+            <!-- Status -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <div class="text-gray-600 text-sm font-medium">ステータス</div>
+                <div class="text-3xl font-bold {{#if (eq summary.status 'success')}}text-green-600{{else}}text-yellow-600{{/if}} mt-2">
+                    {{#if (eq summary.status 'success')}}✓ 成功{{else}}⚠ 部分的{{/if}}
+                </div>
+                <div class="text-gray-500 text-xs mt-1">完了</div>
+            </div>
+        </div>
+    </section>
+
+    <!-- Charts -->
+    <section class="container mx-auto px-4 py-8">
+        <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
+            <!-- Category Breakdown -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <h3 class="text-xl font-semibold mb-4">カテゴリ別内訳</h3>
+                <div class="h-64">
+                    <canvas id="categoryChart"></canvas>
+                </div>
+            </div>
+
+            <!-- Disk Comparison -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <h3 class="text-xl font-semibold mb-4">ディスク使用量の変化</h3>
+                <div class="h-64">
+                    <canvas id="diskChart"></canvas>
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <!-- Files Table -->
+    <section class="container mx-auto px-4 py-8">
+        <div class="bg-white rounded-lg shadow-md p-6">
+            <h3 class="text-xl font-semibold mb-4">削除されたファイル</h3>
+            <div class="overflow-x-auto">
+                <table class="min-w-full table-auto">
+                    <thead class="bg-gray-50">
+                        <tr>
+                            <th class="px-4 py-2 text-left text-xs font-medium text-gray-500 uppercase">パス</th>
+                            <th class="px-4 py-2 text-left text-xs font-medium text-gray-500 uppercase">サイズ</th>
+                            <th class="px-4 py-2 text-left text-xs font-medium text-gray-500 uppercase">カテゴリ</th>
+                            <th class="px-4 py-2 text-left text-xs font-medium text-gray-500 uppercase">削除時刻</th>
+                        </tr>
+                    </thead>
+                    <tbody class="divide-y divide-gray-200">
+                        {{#each files}}
+                        <tr class="hover:bg-gray-50">
+                            <td class="px-4 py-3 font-mono text-xs text-gray-800">{{this.path}}</td>
+                            <td class="px-4 py-3 text-sm">{{formatSize this.size}}</td>
+                            <td class="px-4 py-3">
+                                <span class="px-2 py-1 rounded text-xs bg-blue-100 text-blue-800">
+                                    {{this.category}}
+                                </span>
+                            </td>
+                            <td class="px-4 py-3 text-sm text-gray-600">{{formatDate this.deletedAt}}</td>
+                        </tr>
+                        {{/each}}
+                    </tbody>
+                </table>
+            </div>
+        </div>
+    </section>
+
+    <!-- Metadata -->
+    <section class="container mx-auto px-4 py-8">
+        <div class="bg-white rounded-lg shadow-md p-6">
+            <h3 class="text-xl font-semibold mb-4">実行情報</h3>
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-4 text-sm">
+                <div>
+                    <span class="text-gray-600">コマンド:</span>
+                    <code class="ml-2 px-2 py-1 bg-gray-100 rounded">{{metadata.command}}</code>
+                </div>
+                <div>
+                    <span class="text-gray-600">Broomバージョン:</span>
+                    <span class="ml-2 font-mono">{{metadata.broomVersion}}</span>
+                </div>
+                <div>
+                    <span class="text-gray-600">ホスト名:</span>
+                    <span class="ml-2 font-mono">{{metadata.hostname}}</span>
+                </div>
+                <div>
+                    <span class="text-gray-600">ユーザー:</span>
+                    <span class="ml-2 font-mono">{{metadata.username}}</span>
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <!-- Export Button -->
+    <div class="container mx-auto px-4 py-8 no-print">
+        <button onclick="window.print()"
+                class="bg-blue-500 hover:bg-blue-600 text-white font-bold py-3 px-6 rounded-lg shadow transition">
+            📄 PDFとして保存
+        </button>
+    </div>
+
+    <!-- Chart Scripts -->
+    <script>
+        // Category Pie Chart
+        const categoryCtx = document.getElementById('categoryChart').getContext('2d');
+        new Chart(categoryCtx, {
+            type: 'doughnut',
+            data: {
+                labels: {{{json (map categories 'name')}}},
+                datasets: [{
+                    data: {{{json (map categories 'spaceFreed')}}},
+                    backgroundColor: {{{json (map categories 'color')}}}
+                }]
+            },
+            options: {
+                responsive: true,
+                maintainAspectRatio: false,
+                plugins: {
+                    legend: {
+                        position: 'bottom',
+                        labels: {
+                            padding: 15,
+                            font: { size: 12 }
+                        }
+                    },
+                    tooltip: {
+                        callbacks: {
+                            label: function(context) {
+                                const label = context.label || '';
+                                const value = context.parsed || 0;
+                                const size = (value / 1024 / 1024 / 1024).toFixed(2) + ' GB';
+                                return label + ': ' + size;
+                            }
+                        }
+                    }
+                }
+            }
+        });
+
+        // Disk Comparison Bar Chart
+        const diskCtx = document.getElementById('diskChart').getContext('2d');
+        new Chart(diskCtx, {
+            type: 'bar',
+            data: {
+                labels: ['削除前', '削除後'],
+                datasets: [
+                    {
+                        label: '使用中',
+                        data: [
+                            {{diskComparison.before.used}},
+                            {{diskComparison.after.used}}
+                        ],
+                        backgroundColor: 'rgba(239, 68, 68, 0.8)'
+                    },
+                    {
+                        label: '空き容量',
+                        data: [
+                            {{diskComparison.before.free}},
+                            {{diskComparison.after.free}}
+                        ],
+                        backgroundColor: 'rgba(16, 185, 129, 0.8)'
+                    }
+                ]
+            },
+            options: {
+                responsive: true,
+                maintainAspectRatio: false,
+                scales: {
+                    x: { stacked: true },
+                    y: {
+                        stacked: true,
+                        ticks: {
+                            callback: function(value) {
+                                return (value / 1024 / 1024 / 1024 / 1024).toFixed(1) + ' TB';
+                            }
+                        }
+                    }
+                },
+                plugins: {
+                    tooltip: {
+                        callbacks: {
+                            label: function(context) {
+                                const label = context.dataset.label || '';
+                                const value = context.parsed.y || 0;
+                                const size = (value / 1024 / 1024 / 1024).toFixed(2) + ' GB';
+                                return label + ': ' + size;
+                            }
+                        }
+                    }
+                }
+            }
+        });
+
+        // Helper for mapping arrays
+        Handlebars.registerHelper('map', function(array, property) {
+            return array.map(item => item[property]);
+        });
+
+        Handlebars.registerHelper('eq', function(a, b) {
+            return a === b;
+        });
+    </script>
+
+    <footer class="container mx-auto px-4 py-8 text-center text-gray-600 text-sm">
+        <p>Generated by Broom v{{metadata.broomVersion}} - macOS Disk Cleanup Tool</p>
+    </footer>
+</body>
+</html>`;
+export class ReportGenerator {
+    constructor() {
+        this.deletedFiles = [];
+        this.categories = new Map();
+        this.beforeDisk = null;
+        this.startTime = new Date();
+    }
+    /**
+     * Record disk state before cleanup
+     */
+    recordDiskBefore(disk) {
+        this.beforeDisk = disk;
+    }
+    /**
+     * Record a file deletion
+     */
+    recordDeletion(file, size, category) {
+        this.deletedFiles.push({
+            path: file,
+            size,
+            category,
+            deletedAt: new Date(),
+        });
+        // Update category stats
+        const existing = this.categories.get(category) || {
+            filesDeleted: 0,
+            spaceFreed: 0,
+            color: this.getCategoryColor(category),
+        };
+        existing.filesDeleted++;
+        existing.spaceFreed += size;
+        this.categories.set(category, existing);
+    }
+    /**
+     * Get color for category
+     */
+    getCategoryColor(category) {
+        const colors = {
+            'User Cache': '#3B82F6',
+            'Browser Cache': '#10B981',
+            Logs: '#F59E0B',
+            Trash: '#EF4444',
+            'Dev Cache': '#8B5CF6',
+            Xcode: '#EC4899',
+            Installer: '#6366F1',
+            Downloads: '#F97316',
+        };
+        return colors[category] || '#6B7280';
+    }
+    /**
+     * Generate HTML report
+     */
+    async generate(outputPath, afterDisk) {
+        const { hostname } = await import('os');
+        const { execSync } = await import('child_process');
+        const username = execSync('whoami').toString().trim();
+        // Calculate summary
+        const totalSpaceFreed = this.deletedFiles.reduce((sum, f) => sum + f.size, 0);
+        const timeElapsed = Date.now() - this.startTime.getTime();
+        // Prepare category data
+        const categoryData = Array.from(this.categories.entries()).map(([name, data]) => ({
+            name,
+            filesDeleted: data.filesDeleted,
+            spaceFreed: data.spaceFreed,
+            percentage: (data.spaceFreed / totalSpaceFreed) * 100,
+            color: data.color,
+        }));
+        const report = {
+            metadata: {
+                generatedAt: new Date(),
+                broomVersion: '1.0.0',
+                command: process.argv.slice(2).join(' '),
+                hostname: hostname(),
+                username,
+            },
+            summary: {
+                totalFilesDeleted: this.deletedFiles.length,
+                totalSpaceFreed,
+                timeElapsed,
+                status: 'success',
+                errors: [],
+            },
+            categories: categoryData,
+            files: this.deletedFiles,
+            diskComparison: {
+                before: this.beforeDisk || afterDisk,
+                after: afterDisk,
+            },
+        };
+        // Compile template
+        const template = Handlebars.compile(HTML_TEMPLATE);
+        const html = template(report);
+        // Ensure directory exists
+        await mkdir(dirname(outputPath), { recursive: true });
+        // Write HTML file
+        await writeFile(outputPath, html, 'utf-8');
+    }
+}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@tukuyomil032/broom",
+  "private": false,
+  "version": "1.0.0",
+  "description": "🧹 macOS Disk Cleanup CLI - Clean up caches, logs, trash, browser data, dev artifacts, and more",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "bin": {
+    "broom": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
+    "prepare": "husky",
+    "prepublishOnly": "bun run build",
+    "dev": "bun run src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "lint-staged": "lint-staged",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
+  },
+  "keywords": [
+    "cli",
+    "macos",
+    "cleanup",
+    "disk-space",
+    "cache-cleaner",
+    "system-maintenance",
+    "typescript"
+  ],
+  "author": "tukuyomil032",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tukuyomil032/broom.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tukuyomil032/broom/issues"
+  },
+  "homepage": "https://github.com/tukuyomil032/broom#readme",
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
+    "@types/handlebars": "^4.1.0",
+    "blessed": "^0.1.81",
+    "blessed-contrib": "^4.11.0",
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.2",
+    "fast-glob": "^3.3.3",
+    "handlebars": "^4.7.8",
+    "inquirer": "^13.2.1",
+    "ora": "^9.1.0",
+    "p-limit": "^7.2.0",
+    "systeminformation": "^5.30.6",
+    "yargs": "^18.0.0"
+  },
+  "devDependencies": {
+    "@eslint/json": "^0.14.0",
+    "@types/blessed": "^0.1.27",
+    "@types/node": "^25.0.10",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "globals": "^17.1.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "packageManager": "bun@1.3.6"
+}