@involvex/bun-sweep 0.0.0-stage → 0.0.1

package/.prettierignore

@@ -0,0 +1,41 @@
+# AI Agent Directories
+.agent
+.agents
+.kilo
+.claude
+.gemini
+.kilocode
+.opencode
+
+# Build & Dependency Directories
+node_modules
+dist
+build
+coverage
+.next
+.nuxt
+.cache
+
+# Version Control & Config
+.git
+.vscode
+.idea
+
+# Lock Files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+bun.lockb
+
+# Minified & Generated Files
+*.min.js
+*.min.css
+*.min.js.map
+*.min.css.map
+
+# System Files
+.DS_Store
+Thumbs.db
+*.log
+*.tgz
+*.tar.gz

package/AGENTS.md

@@ -0,0 +1,93 @@
+# AGENTS.md
+
+## Project Overview
+
+**bun-sweep** is a CLI tool for cleaning project directories. It provides commands to remove common build output directories and node_modules recursively.
+
+## Useful Commands
+
+### Installation
+
+```bash
+bun install
+```
+
+### Development
+
+```bash
+bun run dev        # Run the CLI in development mode
+```
+
+### Building
+
+```bash
+bun run build      # Build the CLI to dist/ directory
+```
+
+### Type Checking
+
+```bash
+bun run typecheck  # Run TypeScript type checking with bun check
+```
+
+### Linting & Formatting
+
+```bash
+bun run lint       # Run linter on src/
+bun run format     # Format code with prettier
+```
+
+### CLI Usage
+
+```bash
+bun run index.ts # Run directly
+
+bun-sweep # If installed globally
+```
+
+```bash
+bun-sweep clean # Remove dist, build, out, coverage, .cache
+bun-sweep clean:node_modules # Remove node_modules in current directory
+bun-sweep clean:node_modules --path <dir> -r # Remove specific directory recursively
+bun-sweep --help # Show available commands
+```
+
+## Technologies
+
+- **Runtime**: [Bun](https://bun.com) v1.4.4+ (fast all-in-one JavaScript runtime)
+- **Language**: TypeScript (ESNext, strict mode)
+- **CLI Dependencies**:
+  - @involvex/del-cli - For recursive deletion
+  - has-flag - For parsing CLI flags
+- **Build Target**: Bun (native)
+- **Code Quality**:
+  - Prettier with @involvex/prettier-config
+  - ESLint with TypeScript plugin (type-aware linting enabled)
+- **Module System**: ES Modules ("type": "module")
+
+## Best Practices
+
+- **Type Safety**: Uses strict TypeScript configuration with additional checks (
+  oUncheckedIndexedAccess,
+  oImplicitOverride, etc.)
+- **Error Handling**: Validates paths exist before attempting deletion operations
+- **CLI Design**: Uses flag parsing for flexible command options
+- **Cross-platform**: Works on Windows, macOS, and Linux via Bun
+- **Clean Output**: Provides informative console messages for user feedback
+
+## Guidelines
+
+- **Code Style**: Follow the Prettier configuration from @involvex/prettier-config - imports are sorted
+- **Linting Rules**:
+  - qeqeq with smart mode enforced
+  -
+
+o-unused-vars is an error
+
+- @typescript-eslint/no-explicit-any is an error
+- Type-aware linting is enabled
+- **Build Process**: The prebuild script runs format, lint with auto-fix, and typecheck before building
+- **File Structure**: Keep source code in src/, built output in dist/
+- **Adding Commands**: New commands should be added to the commands object in src/index.ts with async functions
+- **Dependencies**: Use Bun as the package manager (see global instructions) - prefer bun add/bun remove
+- **Type Checking**: Use bun check (built-in Rust checker) as specified in global instructions

package/README.md

@@ -1,3 +1,119 @@
-# Temporary Holding Version
+# bun-sweep
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A CLI tool for cleaning project directories. Removes `node_modules` and build output folders recursively, inspired by [cargo-sweep](https://github.com/holmgr/cargo-sweep).
+
+## Installation
+
+```bash
+bun install
+```
+
+## Usage
+
+```bash
+bun-sweep [options] [path]
+```
+
+### Options
+
+| Flag                | Alias | Description                                                    |
+| ------------------- | ----- | -------------------------------------------------------------- |
+| `-r`, `--recursive` |       | Recursively clean `node_modules` in subdirectories             |
+| `--dry-run`         |       | Preview what would be deleted without deleting                 |
+| `--build-outputs`   |       | Clear `dist`, `out`, `dist-electron` instead of `node_modules` |
+| `--version`, `-v`   |       | Show version number                                            |
+| `--help`, `-h`      |       | Show help message                                              |
+
+### Arguments
+
+| Argument | Description                                                |
+| -------- | ---------------------------------------------------------- |
+| `path`   | Directory to clean (defaults to current working directory) |
+
+### Examples
+
+Clean `node_modules` in the current directory:
+
+```bash
+bun-sweep
+```
+
+Preview what would be deleted (dry-run):
+
+```bash
+bun-sweep --dry-run
+```
+
+Clean `node_modules` in a specific directory:
+
+```bash
+bun-sweep D:\repos\my-project
+```
+
+Recursively clean `node_modules` in all subdirectories:
+
+```bash
+bun-sweep -r D:\repos\
+```
+
+Clean build output folders (`dist`, `out`, `dist-electron`):
+
+```bash
+bun-sweep --build-outputs
+```
+
+Show help:
+
+```bash
+bun-sweep --help
+```
+
+## Development
+
+### Install dependencies
+
+```bash
+bun install
+```
+
+### Run in development mode
+
+```bash
+bun run dev
+```
+
+### Build
+
+```bash
+bun run build
+```
+
+### Type check
+
+```bash
+bun run typecheck
+```
+
+### Lint
+
+```bash
+bun run lint
+```
+
+### Format
+
+```bash
+bun run format
+```
+
+## Technologies
+
+- **Runtime**: [Bun](https://bun.com) v1.4.4+
+- **Language**: TypeScript (ESNext, strict mode)
+- **CLI Dependencies**:
+  - [`@involvex/del-cli`](https://www.npmjs.com/package/@involvex/del-cli) - For recursive deletion
+  - [`has-flag`](https://www.npmjs.com/package/has-flag) - For parsing CLI flags
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,35 @@
 {
-  "name": "@involvex/bun-sweep",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@involvex/bun-sweep",
+	"version": "0.0.1",
+	"author": "involvex",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/involvex/bun-sweep.git"
+	},
+	"bin": {
+		"bun-sweep": "src/index.ts"
+	},
+	"type": "module",
+	"module": "src/index.ts",
+	"scripts": {
+		"build": "bun build src/index.ts --outdir dist --target bun",
+		"dev": "bun src/index.ts",
+		"typecheck": "bun check",
+		"prebuild": "bun run format && bun run lint --fix && bun run typecheck",
+		"lint": "bun lint src",
+		"format": "bun fmt",
+		"prepublishOnly": "bun run build"
+	},
+	"dependencies": {
+		"@involvex/del-cli": "^7.0.1",
+		"has-flag": "^5.0.1"
+	},
+	"devDependencies": {
+		"@involvex/prettier-config": "^0.0.6",
+		"@types/bun": "latest"
+	},
+	"peerDependencies": {
+		"typescript": "^7"
+	},
+	"prettier": "@involvex/prettier-config"
+}

package/src/index.ts

@@ -0,0 +1,128 @@
+#!/usr/bin/env bun
+import {existsSync, readdirSync} from 'fs'
+import {isAbsolute, join} from 'path'
+
+import {$} from 'bun'
+import hasflag from 'has-flag'
+
+import pkg from '../package.json' with {type: 'json'}
+
+const args = process.argv.slice(2)
+
+// Parse flags
+const help =
+	hasflag('help') || hasflag('h') || hasflag('-h') || hasflag('--help')
+const dryRun = hasflag('--dry-run')
+const recursive = hasflag('--recursive') || hasflag('-r')
+const buildOutputs = hasflag('--build-outputs')
+const version = hasflag('--version') || hasflag('-v')
+const repo = pkg.repository?.url || ''
+if (version) {
+	console.log('Repository: ', repo)
+	console.log('@involvex/bun-sweep version: ', pkg.version)
+	process.exit(0)
+}
+// Positional path argument (first non-flag argument)
+const pathArg = args.find(a => !a.startsWith('-'))
+
+const targetDir = pathArg
+	? isAbsolute(pathArg)
+		? pathArg
+		: join(process.cwd(), pathArg)
+	: process.cwd()
+
+const actionLabel = dryRun ? 'Would clean' : 'Cleaning'
+
+const deletePaths = async (paths: string[], label: string) => {
+	if (dryRun) {
+		console.log(`${label}: ${paths.join(', ')}`)
+		return
+	}
+	console.log(`${label}: ${paths.join(', ')}`)
+	await $`del-cli ${paths}`
+}
+
+const cleanBuildOutputs = async (dir: string) => {
+	const folders = ['dist', 'out', 'dist-electron']
+	const existing: string[] = []
+	for (const folder of folders) {
+		const fullPath = join(dir, folder)
+		if (existsSync(fullPath)) {
+			existing.push(fullPath)
+		}
+	}
+	if (existing.length === 0) {
+		console.log(`No build output folders found in ${dir}`)
+		return
+	}
+	await deletePaths(existing, `${actionLabel} build outputs in ${dir}`)
+}
+
+const cleanNodeModules = async (dir: string) => {
+	const nodeModules = join(dir, 'node_modules')
+	if (existsSync(nodeModules)) {
+		await deletePaths([nodeModules], `${actionLabel} node_modules in ${dir}`)
+	} else {
+		console.log(`No node_modules found in ${dir}`)
+	}
+}
+
+const processDir = async (dir: string) => {
+	if (buildOutputs) {
+		await cleanBuildOutputs(dir)
+	} else {
+		await cleanNodeModules(dir)
+	}
+
+	if (recursive) {
+		try {
+			const entries = readdirSync(dir, {withFileTypes: true})
+			for (const entry of entries) {
+				if (entry.isDirectory() && entry.name !== 'node_modules') {
+					await processDir(join(dir, entry.name))
+				}
+			}
+		} catch (e) {
+			console.error(`Failed to read directory ${dir}: ${String(e)}`)
+		}
+	}
+}
+
+if (help) {
+	console.log('Usage: bun-sweep [options] [path]')
+	console.log('')
+	console.log('Options:')
+	console.log(
+		'  -r, --recursive    Recursively clean node_modules in subdirectories',
+	)
+	console.log(
+		'  --dry-run          Preview what would be deleted without deleting',
+	)
+	console.log(
+		'  --build-outputs    Clear dist, out, dist-electron instead of node_modules',
+	)
+	console.log('  --help, -h         Show this help message')
+	console.log('')
+	console.log('Examples:')
+	console.log(
+		'  bun-sweep                    Clean node_modules in current directory',
+	)
+	console.log('  bun-sweep --dry-run          Preview node_modules cleanup')
+	console.log(
+		'  bun-sweep D:/repos/          Clean node_modules in specific directory',
+	)
+	console.log(
+		'  bun-sweep -r D:/repos/       Recursively clean node_modules in all subdirs',
+	)
+	console.log(
+		'  bun-sweep --build-outputs    Clean dist, out, dist-electron folders',
+	)
+	process.exit(0)
+}
+
+if (!existsSync(targetDir)) {
+	console.log(`Path not found: ${targetDir}`)
+	process.exit(1)
+}
+
+await processDir(targetDir)

package/tsconfig.json

@@ -0,0 +1,32 @@
+{
+	"compilerOptions": {
+		// Environment setup & latest features
+		"lib": ["ESNext"],
+		"target": "ESNext",
+		"module": "Preserve",
+		"moduleDetection": "force",
+		"jsx": "react-jsx",
+		"allowJs": true,
+		"types": ["bun"],
+
+		// Bundler mode
+		"moduleResolution": "bundler",
+		"allowImportingTsExtensions": true,
+		"verbatimModuleSyntax": true,
+		"noEmit": true,
+		"rewriteRelativeImportExtensions": true,
+		// Best practices
+		"strict": true,
+		"skipLibCheck": true,
+		"noFallthroughCasesInSwitch": true,
+		"noUncheckedIndexedAccess": true,
+		"noImplicitOverride": true,
+		"noUncheckedSideEffectImports": true,
+		"allowArbitraryExtensions": true,
+
+		// Some stricter flags (disabled by default)
+		"noUnusedLocals": false,
+		"noUnusedParameters": false,
+		"noPropertyAccessFromIndexSignature": false
+	}
+}