binary-collections 2.0.12 → 2.0.14

package/docs-src/clean-github-actions-caches.md

@@ -0,0 +1,115 @@
+## GitHub Actions Cache Cleaner
+
+Removes outdated GitHub Actions caches in the current repository, keeping only the newest cache for each prefix. Ensures safe cleanup by retaining the latest cache per group and authenticates using tokens from your .env file.
+
+### Usage
+
+```bash
+# use npx
+npx --yes binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz clean-github-actions-caches
+
+# use yarn dlx
+yarn dlx binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz clean-github-actions-caches
+
+# keep the first 3 cache key segments as the grouping prefix
+clean-github-actions-caches --prefix-depth 3
+```
+
+### Aliases
+
+This command is available under several aliases (all invoke the same CLI):
+
+- `clean-github-actions-cache`
+- `clear-github-actions-cache`
+- `clear-github-actions-caches`
+- `clear-gh-caches`
+
+
+### Features
+- Authenticates using `ACCESS_TOKEN` or `GITHUB_TOKEN` from your `.env` file
+- Groups caches by the first N key segments split on `-` or `_` and deletes all but the latest for each group
+- Operates on the current repository (origin remote) and matches the working directory of your terminal
+- Safe: Only deletes caches older than the most recent per prefix
+- Accepts `--repo owner/repo` to target a specific repository and `--prefix-depth <n>` to control grouping
+
+### Environment Setup
+1. Add `ACCESS_TOKEN` or `GITHUB_TOKEN` to your `.env` file
+2. Ensure you have access to the repository's cache management
+
+### Source
+See [`src/github-workflows/clean-github-actions-caches-cli.cjs`](../src/github-workflows/clean-github-actions-caches-cli.cjs).
+
+### Github CI Examples
+
+```yaml
+name: Clean GitHub Actions Cache
+
+on:
+  # Trigger this workflow when the specified workflows complete (e.g., after build and test workflows)
+  workflow_run:
+    workflows:
+      - Node.js Package Build
+      - Node.js Package Test
+    types:
+      - completed
+
+  # Allow manual triggering of this workflow from the GitHub Actions UI
+  workflow_dispatch:
+
+  # Uncomment the following lines to enable scheduled cache cleaning (e.g., every hour)
+  # schedule:
+  #   - cron: '0 * * * *'
+
+  # Uncomment the following lines to enable cache cleaning on pushes to the master branch
+  # push:
+  #   branches:
+  #     - master
+
+  # Allow this workflow to be called by other workflows, passing the ACCESS_TOKEN secret
+  workflow_call:
+    secrets:
+      ACCESS_TOKEN:
+        required: true
+
+concurrency:
+  group: clean-cache
+  cancel-in-progress: true
+
+jobs:
+  clean-cache:
+    # if: contains(github.repository, 'php-proxy-hunter')
+    runs-on: windows-latest
+
+    env:
+      PIP_CACHE_DIR: "${{ github.workspace }}/project/tmp/pip"
+      NUITKA_CACHE_DIR: "${{ github.workspace }}/project/tmp/nuitka-cache"
+      NODE_OPTIONS: "--max_old_space_size=4096"
+      YARN_ENABLE_IMMUTABLE_INSTALLS: false
+      ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+      GH_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+      YARN_CHECKSUM_BEHAVIOR: update
+
+    steps:
+      - name: 📥 Checkout Repository
+        uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+
+      - name: 🐍 Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          architecture: "x64"
+
+      - name: 🟢 Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20.x
+
+      - name: 🧹 Clean GitHub Actions Cache ${{ github.event.workflow_run.head_sha }}
+        env:
+          GH_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+        run: |
+          npx --legacy-peer-deps -y binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz clean-github-actions-caches --repo ${{ github.repository }} --sha ${{ github.event.workflow_run.head_sha }}
+        shell: bash
+```

package/docs-src/copy-move-file.md

@@ -0,0 +1,56 @@
+## Copy & Move File
+
+Copies or moves files/directories via CLI.
+
+### Usage
+
+```bash
+copy <src> <dest>
+move <src> <dest>
+````
+
+### Behavior
+
+* If `src` is a **file** and `dest` is a **directory**, the file will be placed inside that directory using its original filename.
+* If `src` is a **file** and `dest` is a **file path**, it will be copied/moved directly to that path.
+* If `src` is a **directory**, the entire directory will be copied/moved into the destination.
+
+### Aliases
+
+The copy command is available under several aliases (all invoke the same CLI):
+
+* `copy` (default)
+* `node-copy`
+* `copy-file`
+
+The move command is available under several aliases (all invoke the same CLI):
+
+* `move` (default)
+* `node-move`
+* `move-file`
+
+### Options
+
+| Option       | Description       |
+| ------------ | ----------------- |
+| `-h, --help` | Show help message |
+
+### Examples
+
+```bash
+# file → file
+copy file.txt backup/file.txt
+move file.txt backup/file.txt
+
+# file → directory (auto-append filename)
+copy file.txt backup/
+move file.txt backup/
+
+# directory → directory
+copy ./src ./dist
+move ./src ./dist
+```
+
+### Source
+
+See [`src/file/copy-cli.mjs`](../src/file/copy-cli.mjs) and [`src/file/move-cli.mjs`](../src/file/move-cli.mjs).

package/docs-src/del-gradle.md

@@ -0,0 +1,17 @@
+## Gradle Build Cleaner
+
+Deletes Gradle `build/` directories.
+
+### Usage
+
+```bash
+del-gradle
+```
+
+### Description
+
+Searches for `build.gradle` files and deletes the adjacent `build/` directories, ignoring `node_modules` and `vendor` directories.
+
+### Source
+
+See [`src/del-gradle.js`](../src/del-gradle.js)

package/docs-src/del-ps.md

@@ -0,0 +1,28 @@
+## Process Management
+
+Terminate processes quickly by name or type across platforms.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `del-ps <process-name>` | Kill processes by command name (cross-platform) |
+| `kill-process <name>` | Kill process by name (Unix `killall`) |
+| `nodekill` | Kill all Node.js processes |
+| `javakill` | Kill all Java processes (Windows `taskkill`) |
+
+### Usage
+
+```bash
+# Kill processes by name
+del-ps <process-name>
+
+# Kill specific types
+kill-process <name>    # Unix: uses killall
+nodekill               # Kill all node.exe processes
+javakill               # Kill all java.exe processes (Windows)
+```
+
+### Source
+
+See [`src/del-ps-cli.mjs`](../src/del-ps-cli.mjs) and shell wrappers in [`bin/`](../bin/).

package/docs-src/downloader.md

@@ -0,0 +1,62 @@
+# Downloader
+
+Downloads files from URLs over HTTP/HTTPS to the local filesystem. Uses `axios` with streaming to efficiently write downloaded content directly to disk, and supports up to 10 redirects.
+
+## Usage
+
+```bash
+downloader <url> [output-path]
+```
+
+### Aliases
+
+This command is available under several aliases (all invoke the same CLI):
+
+- `downloader` (default)
+- `download`
+- `download-file`
+- `file-downloader`
+- `fetch-file`
+
+### Arguments
+
+| Argument      | Description                             |
+| :------------ | :-------------------------------------- |
+| `url`         | File URL to download (required)         |
+| `output-path` | Optional destination path on disk       |
+
+### Options
+
+| Flag           | Description       |
+| :------------- | :---------------- |
+| `-h`, `--help` | Show help message |
+
+### Behavior
+
+- If no `output-path` is provided, the filename is derived from the URL's pathname (e.g., `https://example.com/file.zip` saves as `file.zip` in the current directory).
+- If the URL path ends with `/` or has no filename segment, the default name `downloaded-file` is used.
+- The output path is resolved to an absolute path, and any missing parent directories are created automatically.
+
+### Examples
+
+Download to the current directory (filename auto-derived from URL):
+
+```bash
+downloader https://example.com/file.zip
+```
+
+Download and save with a custom filename:
+
+```bash
+downloader https://example.com/file.zip downloads/custom.zip
+```
+
+Using an alias:
+
+```bash
+fetch-file https://example.com/data.json ./data/input.json
+```
+
+## Source
+
+See [`src/downloader-cli.cjs`](../src/downloader-cli.cjs).

package/docs-src/env-helpers.md

@@ -0,0 +1,29 @@
+## Environment Helpers
+
+Set `NODE_ENV` and run a command in the configured environment.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `dev <command>` | Sets `NODE_ENV=development` and runs the command |
+| `prod <command>` | Sets `NODE_ENV=production` and runs the command |
+| `empty` | No-op utility placeholder |
+
+### Usage
+
+```bash
+dev <command> [args...]
+prod <command> [args...]
+```
+
+### Examples
+
+```bash
+dev node server.js
+prod npm start
+```
+
+### Source
+
+See [`bin/dev`](../bin/dev) & [`bin/prod`](../bin/prod)

package/docs-src/find-node-modules.md

@@ -0,0 +1,17 @@
+## Find Node Modules
+
+Locates all `node_modules` directories within a project.
+
+### Usage
+
+```bash
+find-node-modules
+```
+
+### Description
+
+Finds and prints all `node_modules` directories under the current working directory.
+
+### Source
+
+See [`src/find-node-modules-cli.cjs`](../src/find-node-modules-cli.cjs).

package/docs-src/free-chatgpt.md

@@ -0,0 +1,26 @@
+# free-chatgpt.js
+
+Automates browser interaction with ChatGPT using Puppeteer, including login, question submission, and response retrieval. Supports session persistence via cookies and flexible question input.
+
+## Usage
+
+```bash
+# use npx
+npx --yes binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz free-chatgpt
+
+# use yarn dlx
+yarn dlx binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz free-chatgpt
+```
+
+### Argument Options
+
+- `--question, -q`   The question to ask ChatGPT (default: "Hello, ChatGPT!")
+- `--qfile, -qf`     Path to a file containing the question text
+- `--help, -h`       Show help message
+
+## Notes
+
+- Cookies are stored in `./tmp/cookies` for session reuse.
+- Responses are saved to `./tmp/response.txt`.
+- Requires access to `chat.openai.com` (firewall must allow connection).
+- Uses Puppeteer with stealth plugin to avoid bot detection.

package/docs-src/generate-test-ci.md

@@ -0,0 +1,56 @@
+# Generate Test CI Step
+
+Scans the repository for test files using glob patterns and generates a GitHub Actions workflow YAML (`.github/workflows/test.yml`) with individual test steps for each detected file. Untracked (non-git) files are automatically skipped.
+
+## Usage
+
+```bash
+generate-test-ci [options]
+```
+
+### Aliases
+
+This command is available under the following binary name:
+
+- `generate-test-ci` (default)
+
+### Options
+
+| Flag | Type | Description |
+| :--- | :--- | :--- |
+| `-p`, `--pattern` | `string[]` | Test file glob pattern(s) to search for (can be repeated; defaults: `test/**/*.test.{js,cjs,mjs,ts}`, `test/**/*.spec.{js,cjs,mjs,ts}`, `tests/**/*.test.{js,cjs,mjs,ts}`, `tests/**/*.spec.{js,cjs,mjs,ts}`) |
+| `--ignore`, `--ex` | `string[]` | Glob pattern(s) to exclude from results (can be repeated) |
+| `-o`, `--output` | `string` | Output YAML file path (default: `.github/workflows/test.yml`) |
+| `-h`, `--help` | `boolean` | Show help message |
+
+### Examples
+
+Generate the default workflow YAML:
+
+```bash
+generate-test-ci
+```
+
+Search only `.test.js` files:
+
+```bash
+generate-test-ci -p "test/**/*.test.js" --ignore "**/fixtures/**"
+```
+
+Write to a custom output path:
+
+```bash
+generate-test-ci -o .github/workflows/ci.yml -p "src/**/*.test.ts" --ignore "**/node_modules/**"
+```
+
+### How it works
+
+1. **Collect**: All files matching the given glob patterns are collected using the `glob` library.
+2. **Filter**: Files not tracked by git are skipped (so untracked files don't end up in the committed action).
+3. **Classify**: Each file is categorized by extension (`.mjs` → `test-esm`, `.cjs` → `test-cjs`, `.ts` → `jest` directly, others → `npm test`).
+4. **Generate**: A GitHub Actions workflow YAML is produced, with each test file as a separate `run` step.
+5. **Write**: The YAML is written to the specified output path (default `.github/workflows/test.yml`).
+
+## Source
+
+See [`src/github-workflows/generate-test-ci-step-cli.mjs`](../src/github-workflows/generate-test-ci-step-cli.mjs).

package/docs-src/get-latest-workflow-status.md

@@ -0,0 +1,100 @@
+# Get Latest Workflow Status
+
+Fetches and displays the latest GitHub Actions workflow run from the repository — showing the run name, status, conclusion, branch, and a full job-by-job breakdown with each step's result. Useful for quickly checking CI status from the terminal without opening a browser.
+
+## Usage
+
+```bash
+get-latest-workflow-status [options]
+```
+
+### Aliases
+
+This command is available under several names (all invoke the same CLI):
+
+- `get-latest-workflow-status` (default)
+- `get-latest-workflow`
+- `latest-workflow`
+- `wf-status`
+
+### Options
+
+| Flag | Type | Description |
+| :--- | :--- | :--- |
+| `--owner` | `string` | GitHub repository owner (default: auto-detect from git remote or `GH_OWNER` env) |
+| `--repo` | `string` | GitHub repository name (default: auto-detect from git remote or `GH_REPO` env) |
+| `--workflow` | `string` | Filter by workflow filename (e.g. `"test.yml"`) or numeric workflow ID |
+| `--token` | `string` | GitHub access token (overrides `ACCESS_TOKEN` / `GITHUB_TOKEN` / `GH_TOKEN` env vars) |
+| `-h`, `--help` | `boolean` | Show help message |
+
+### Environment Variables
+
+| Variable | Description |
+| :------- | :---------- |
+| `ACCESS_TOKEN` / `GITHUB_TOKEN` / `GH_TOKEN` | GitHub personal access token with `actions:read` scope (required) |
+| `GH_OWNER` | Override repository owner (optional) |
+| `GH_REPO` | Override repository name (optional) |
+
+### Examples
+
+Show the latest workflow run for the current repository:
+
+```bash
+get-latest-workflow-status
+```
+
+Show for a specific repository:
+
+```bash
+get-latest-workflow-status --owner dimaslanjaka --repo bin
+```
+
+Filter by a specific workflow YAML file:
+
+```bash
+get-latest-workflow-status --workflow test.yml
+get-latest-workflow-status --owner dimaslanjaka --repo bin --workflow deploy.yml
+```
+
+Show help:
+
+```bash
+get-latest-workflow-status --help
+```
+
+### Output Example
+
+```
+==============================
+🚀 Latest Workflow Run
+==============================
+Name      : Node.js Package Test
+Status    : in_progress
+Conclusion: null
+Branch    : master
+Run ID    : 26797771514
+URL       : https://github.com/dimaslanjaka/bin/actions/runs/26797771514
+
+==============================
+🧩 Jobs & Steps
+==============================
+
+🧱 Job: 🔨 Build, Pack & Test
+   Status: in_progress | Conclusion: null
+   ✅ Set up job -> success (completed)
+   ✅ ⬇️ Checkout workflow repository -> success (completed)
+   ✅ ⬇️ Setup CI Environment -> success (completed)
+   ⚪ 🧪 Run tests in test/example.test.cjs -> null (in_progress)
+```
+
+### How it works
+
+1. **Authenticate** — Uses `ACCESS_TOKEN` / `GITHUB_TOKEN` / `GH_TOKEN` to call the GitHub API.
+2. **Detect repository** — Owner and repo are auto-detected from the `git remote.origin.url`, or can be overridden with `--owner`/`--repo` flags or `GH_OWNER`/`GH_REPO` environment variables.
+3. **Fetch latest run** — Calls `GET /repos/{owner}/{repo}/actions/runs?per_page=1` to get the most recent workflow run. If `--workflow` is specified, appends `&workflow_id=<name>` to filter by workflow filename or ID.
+4. **Fetch jobs** — Calls `GET /repos/{owner}/{repo}/actions/runs/{run_id}/jobs` to retrieve all jobs and their steps.
+5. **Print report** — Renders a formatted terminal report with color-coded icons (✅ success, ❌ failure, ⏭️ skipped, ⚪ pending/in progress).
+
+## Source
+
+See [`src/github-workflows/get-latest-workflow-status-cli.mjs`](../src/github-workflows/get-latest-workflow-status-cli.mjs).

package/docs-src/git-diff.md

@@ -0,0 +1,33 @@
+## Git Diff Utility
+
+Enhanced diff functionality for repository inspection. Saves diffs to temp files and optionally generates conventional commit prompts.
+
+### Usage
+
+```bash
+git-diff [options] [file]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+| `-s, -S, --staged-only` | Show all staged diffs |
+| `-u, --unstaged <file>` | Show unstaged diff for a specific file |
+| `-u, --unstaged` | Show all unstaged diffs |
+| `--ai` | Generate commit message with ChatGPT |
+
+### Examples
+
+```bash
+git-diff FILE              # Show staged diff of a file
+git-diff --staged-only     # Show all staged diffs
+git-diff --unstaged FILE   # Show unstaged diff of a file
+git-diff --unstaged        # Show all unstaged diffs
+git-diff --ai              # Generate commit message with ChatGPT
+```
+
+### Source
+
+See [`src/git/git-diff-cli.js`](../src/git/git-diff-cli.js).

package/docs-src/git-fix.md

@@ -0,0 +1,34 @@
+## Git Fix Utility
+
+A comprehensive configuration fixer for cross-platform development. Non-interactive and argument-driven.
+
+### Usage
+
+```bash
+git-fix                        # Apply all default fixes
+git-fix --lf-only              # Force LF line endings only
+git-fix --permissions          # Ignore file permissions only
+git-fix --normalize            # Normalize existing files only
+git-fix --user                 # Configure Git user from env vars
+git-fix --user NAME EMAIL      # Configure Git user with specific values
+```
+
+Options can be combined: `git-fix --lf-only --permissions`
+
+### Features
+
+- Forces LF line endings (`core.autocrlf = false`)
+- Ignores file permission changes (`core.filemode = false`)
+- Sets pull strategy to prevent auto-rebase
+- Creates/updates `.gitattributes`
+- Normalizes existing line endings
+
+### User Configuration
+
+- Uses environment variables: `GITHUB_USER`, `GITHUB_EMAIL` (if no args provided)
+- Use `--user NAME EMAIL` to specify credentials directly
+- Precedence: CLI arguments > environment variables > skip
+
+### Source
+
+See [`src/git/git-fix.cjs`](../src/git/git-fix.cjs).

package/docs-src/git-purge.md

@@ -0,0 +1,17 @@
+## Git Repository Purge
+
+Cleans and optimizes git repositories by pruning reflogs aggressively.
+
+### Usage
+
+```bash
+git-purge
+```
+
+### Description
+
+Aggressively prunes the git reflog in all `.git` directories, helping reduce repository size and improve performance.
+
+### Source
+
+See [`src/git/git-purge.cjs`](../src/git/git-purge.cjs)

package/docs-src/git-reduce-size.md

@@ -0,0 +1,17 @@
+## Git Repository Size Reducer
+
+Reduces repository size by cleaning up history.
+
+### Usage
+
+```bash
+git-reduce-size
+```
+
+### Description
+
+Aggressively prunes git reflog and runs garbage collection to reduce the repository size on disk.
+
+### Source
+
+See [`bin/git-reduce-size`](../bin/git-reduce-size)

package/docs-src/git-undo.md

@@ -0,0 +1,21 @@
+## Git Undo Commands
+
+Utilities to undo recent git operations while preserving your changes.
+
+### Available Commands
+
+| Command | Aliases | Description |
+|---------|---------|-------------|
+| `undo-commit` | `undo-last-commit`, `git-undo-commit` | Soft-resets the last commit (`git reset --soft HEAD~1`) |
+| `undo-staged` | `git-undo-staged` | Unstages all staged changes (`git reset HEAD .`) |
+
+### Usage
+
+```bash
+undo-commit    # Undo the last commit, keep changes staged
+undo-staged    # Unstage all staged changes
+```
+
+### Source
+
+See [`src/git/undo-commit.cjs`](../src/git/undo-commit.cjs), [`src/git/undo-staged.cjs`](../src/git/undo-staged.cjs)

package/docs-src/kill-night-crows.md

@@ -0,0 +1,26 @@
+## Night Crows Process Killer
+
+Kills the Night Crows game launcher process tree when the shipping process hangs.
+
+### Usage
+
+```bash
+kill-night-crows
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+
+### Description
+
+- Launches `kill-night-crows.ps1` PowerShell script
+- Watches for Night Crows processes and kills the launcher tree
+- **Windows only**
+- Available as a standalone utility for game development environments
+
+### Source
+
+See [`src/kill-night-crows.mjs`](../src/kill-night-crows.mjs) & [`bin/kill-night-crows.ps1`](../bin/kill-night-crows.ps1).