binary-collections 2.0.13 → 2.0.15

package/lib/vscode-cli.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const minimist_1 = __importDefault(require("minimist"));
+const storage_js_1 = require("./vscode/storage.js");
+const argv = (0, minimist_1.default)(process.argv.slice(2), {
+    alias: { h: 'help', 'copilot-memory': ['copilotMemory', 'cm'] }
+});
+function printHelp() {
+    console.log(`
+Usage: vscode-cli <command> [options]
+
+Commands:
+  list project            List all workspace projects
+  list project --copilot-memory
+                          List only projects with Copilot memory tool directories
+
+Options:
+  -h, --help              Show this help message
+  --copilot-memory        Filter to projects with Copilot memory tool
+`);
+}
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (argv.help || argv._.length === 0) {
+            printHelp();
+            return;
+        }
+        const command = argv._[0];
+        if (command === 'list') {
+            const sub = argv._[1];
+            if (sub === 'project') {
+                const all = yield (0, storage_js_1.listWorkspaceProjects)();
+                let projects = all;
+                if (argv['copilot-memory']) {
+                    projects = all.filter((p) => p.copilotMemoryDir);
+                }
+                console.log(`Projects (${projects.length}):\n`);
+                if (!projects.length)
+                    return;
+                const rows = projects.map((p) => ({
+                    id: p.storageId.slice(0, 8),
+                    folder: p.folder,
+                    hasMemory: p.copilotMemoryDir ? 'yes' : ''
+                }));
+                const idWidth = Math.max(2, ...rows.map((r) => r.id.length));
+                const folderWidth = Math.max(6, ...rows.map((r) => r.folder.length));
+                const sep = '─'.repeat(idWidth + folderWidth + 12);
+                console.log(`  ${'ID'.padEnd(idWidth)}  ${'Folder'.padEnd(folderWidth)}  Memory`);
+                console.log(`  ${sep}`);
+                for (const r of rows) {
+                    console.log(`  ${r.id.padEnd(idWidth)}  ${r.folder.padEnd(folderWidth)}  ${r.hasMemory}`);
+                }
+            }
+            else {
+                console.error(`Unknown subcommand: list ${sub || ''}`);
+                printHelp();
+                process.exit(1);
+            }
+        }
+        else {
+            console.error(`Unknown command: ${command}`);
+            printHelp();
+            process.exit(1);
+        }
+    });
+}
+main();

package/lib/vscode-cli.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+import {
+  listWorkspaceProjects
+} from "./chunk-UDZBVKXH.mjs";
+import {
+  init_esm_shims
+} from "./chunk-QQ4A6DLD.mjs";
+
+// src/vscode-cli.ts
+init_esm_shims();
+import minimist from "minimist";
+var argv = minimist(process.argv.slice(2), {
+  alias: { h: "help", "copilot-memory": ["copilotMemory", "cm"] }
+});
+function printHelp() {
+  console.log(`
+Usage: vscode-cli <command> [options]
+
+Commands:
+  list project            List all workspace projects
+  list project --copilot-memory
+                          List only projects with Copilot memory tool directories
+
+Options:
+  -h, --help              Show this help message
+  --copilot-memory        Filter to projects with Copilot memory tool
+`);
+}
+async function main() {
+  if (argv.help || argv._.length === 0) {
+    printHelp();
+    return;
+  }
+  const command = argv._[0];
+  if (command === "list") {
+    const sub = argv._[1];
+    if (sub === "project") {
+      const all = await listWorkspaceProjects();
+      let projects = all;
+      if (argv["copilot-memory"]) {
+        projects = all.filter((p) => p.copilotMemoryDir);
+      }
+      console.log(`Projects (${projects.length}):
+`);
+      if (!projects.length) return;
+      const rows = projects.map((p) => ({
+        id: p.storageId.slice(0, 8),
+        folder: p.folder,
+        hasMemory: p.copilotMemoryDir ? "yes" : ""
+      }));
+      const idWidth = Math.max(2, ...rows.map((r) => r.id.length));
+      const folderWidth = Math.max(6, ...rows.map((r) => r.folder.length));
+      const sep = "\u2500".repeat(idWidth + folderWidth + 12);
+      console.log(`  ${"ID".padEnd(idWidth)}  ${"Folder".padEnd(folderWidth)}  Memory`);
+      console.log(`  ${sep}`);
+      for (const r of rows) {
+        console.log(`  ${r.id.padEnd(idWidth)}  ${r.folder.padEnd(folderWidth)}  ${r.hasMemory}`);
+      }
+    } else {
+      console.error(`Unknown subcommand: list ${sub || ""}`);
+      printHelp();
+      process.exit(1);
+    }
+  } else {
+    console.error(`Unknown command: ${command}`);
+    printHelp();
+    process.exit(1);
+  }
+}
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "binary-collections",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "description": "Utility to clean any programming caches and more",
   "keywords": [
     "cache",
@@ -34,12 +34,13 @@
   },
   "types": "lib/index.d.ts",
   "files": [
-    "binaries",
-    "lib",
-    "docs-src",
+    "binaries/**/*",
+    "lib/**/*",
+    "docs-src/*.md",
     "readme.md",
     ".puppeterrc.cjs",
-    "requirements.txt"
+    "requirements.txt",
+    ".github/**/*"
   ],
   "scripts": {
     "build": "tsc -b tsconfig.build.json && npm run build-tsup && npm run build-exports",
@@ -51,13 +52,16 @@
     "pack": "node package.cjs --yarn --filename=bin",
     "prepare": "husky",
     "puppeteer:browser": "npx -y puppeteer browsers install chrome",
-    "test": "test-cjs",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand --forceExit --testTimeout=120000 --detectOpenHandles",
     "test-coverage": "npm test --coverage --detectOpenHandles",
     "test-esm": "test-esm",
     "test-nrs": "npm test -- nrs build-**",
     "test-watch": "npm test --watch",
     "update:ncu": "npx npm-check-updates -u --enginesNode --root -x jest -x @types/jest -x babel-jest -x @babel/core -x @babel/preset-env -x @babel/preset-typescript -x ts-jest -x eslint -x @eslint/eslintrc -x @eslint/js -x @typescript-eslint/eslint-plugin -x @typescript-eslint/parser -x eslint-config-prettier -x eslint-plugin-prettier -x typescript-eslint -x prettier -x typescript -x ts-node -x @yarnpkg/core",
-    "update:packer": "curl -L https://github.com/dimaslanjaka/nodejs-package-types/raw/main/packer.js > packer.cjs"
+    "update:packer": "curl -L https://github.com/dimaslanjaka/nodejs-package-types/raw/main/packer.js > packer.cjs",
+    "serve": "php -S 0.0.0.0:8490",
+    "upload": "node scripts/upload-backend.mjs",
+    "mkdocs-serve": "mkdocs serve -a \"0.0.0.0:5173\" --livereload"
   },
   "repository": {
     "type": "git",
@@ -67,6 +71,8 @@
     "@yarnpkg/core": "^4.7.0",
     "ansi-colors": "^4.1.3",
     "axios": "^1.16.1",
+    "better-sqlite3": "^12.10.0",
+    "cosmiconfig": "^9.0.1",
     "cross-spawn": "https://github.com/dimaslanjaka/node-cross-spawn/raw/78b09a1f799430fb251c1b438ec56ce7957674f4/release/cross-spawn.tgz",
     "crypto-js": "^4.2.0",
     "dotenv": "^17.4.2",
@@ -75,6 +81,8 @@
     "glob": "^13.0.6",
     "minimatch": "^10.2.5",
     "minimist": "^1.2.8",
+    "openai": "^6.41.0",
+    "proxy-agent": "^8.0.1",
     "ps-node": "^0.1.6",
     "puppeteer": "^25.0.4",
     "puppeteer-extra": "^3.3.6",
@@ -84,21 +92,23 @@
     "upath": "^3.0.7",
     "which": "^7.0.0",
     "yaml": "^2.9.0",
-    "yarn": "^1.22.22",
-    "zlib": "^1.0.5"
+    "yarn": "^1.22.22"
   },
   "devDependencies": {
     "@babel/core": "^7.29.0",
     "@babel/plugin-syntax-import-assertions": "^7.28.6",
     "@babel/preset-env": "^7.29.2",
     "@babel/preset-typescript": "^7.28.5",
-    "@dimaslanjaka/eslint-base-config": "^1.0.1",
+    "@dimaslanjaka/eslint-base-config": "^1.0.2",
+    "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-babel": "^7.0.0",
-    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
     "@types/babel__core": "^7",
     "@types/babel__preset-env": "^7",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/crypto-js": "^4",
     "@types/fs-extra": "^11",
     "@types/jest": "^30.0.0",
@@ -115,10 +125,11 @@
     "gulp": "^5.0.1",
     "husky": "^9.1.7",
     "jest": "^30.4.2",
-    "lint-staged": "^17.0.5",
+    "lint-staged": "^17.0.7",
     "marked": "^18.0.4",
     "rimraf": "^6.1.3",
-    "rollup": "^4.60.4",
+    "rollup": "^4.0.0",
+    "ssh2-sftp-client": "^12.1.1",
     "ts-jest": "^29.4.9",
     "ts-node": "^10.9.2",
     "tsup": "^8.5.1",
@@ -134,12 +145,13 @@
   "packageManager": "yarn@4.9.2",
   "resolutions": {
     "@types/through2": "https://github.com/dimaslanjaka/nodejs-package-types/raw/refs/heads/through2/release/types-through2.tgz",
-    "cross-spawn": "https://github.com/dimaslanjaka/node-cross-spawn/raw/78b09a1f799430fb251c1b438ec56ce7957674f4/release/cross-spawn.tgz",
-    "git-command-helper": "https://github.com/dimaslanjaka/git-command-helper/raw/dd8c8ef596083f367c592f97a2439f9fc8ab33b2/release/git-command-helper.tgz",
+    "cross-spawn": "https://github.com/dimaslanjaka/node-cross-spawn/raw/eb82c8e0e60ce425fdf6e89cd53f4391bb8c77cd/release/cross-spawn.tgz",
+    "git-command-helper": "https://github.com/dimaslanjaka/git-command-helper/raw/7a28dad83c17abfc4b6ccd2b7327c39ff67adfe5/release/git-command-helper.tgz",
     "sbg-utility": "https://github.com/dimaslanjaka/static-blog-generator/raw/44e5c7b79b4e60f8c2d34857c27b8ce677d7493e/packages/sbg-utility/release/sbg-utility.tgz",
-    "@dimaslanjaka/eslint-base-config": "https://github.com/dimaslanjaka/eslint-base-config/raw/9741b4feac89f303ea585e3ecac2b0e768434135/release/dimaslanjaka-eslint-base-config.tgz"
+    "@dimaslanjaka/eslint-base-config": "https://github.com/dimaslanjaka/eslint-base-config/raw/822b872f18985462f0da358579cd6493472a2ee0/release/dimaslanjaka-eslint-base-config.tgz"
   },
   "bin": {
+    "actions-badge": "lib/github-workflows/workflow-badge-cli.cjs",
     "binary-collections": "lib/binary-collections.cjs",
     "binary-executor": "binaries/binary-executor.cjs",
     "build-package": "lib/node-package-packer-cli.cjs",
@@ -147,13 +159,14 @@
     "build-tarball": "lib/node-package-packer-cli.cjs",
     "changelog": "lib/changelog.cjs",
     "chatgpt": "lib/free-chatgpt.cjs",
-    "clean-github-actions-cache": "lib/clean-github-actions-caches-cli.cjs",
-    "clean-github-actions-caches": "lib/clean-github-actions-caches-cli.cjs",
+    "clean-github-actions-cache": "lib/github-workflows/clean-github-actions-caches-cli.cjs",
+    "clean-github-actions-caches": "lib/github-workflows/clean-github-actions-caches-cli.cjs",
     "clean-nodemodule": "binaries/clean-nodemodule.cjs",
     "clean-nodemodules": "binaries/clean-nodemodules.cjs",
-    "clear-gh-caches": "lib/clean-github-actions-caches-cli.cjs",
-    "clear-github-actions-cache": "lib/clean-github-actions-caches-cli.cjs",
-    "clear-github-actions-caches": "lib/clean-github-actions-caches-cli.cjs",
+    "clear-gh-caches": "lib/github-workflows/clean-github-actions-caches-cli.cjs",
+    "clear-github-actions-cache": "lib/github-workflows/clean-github-actions-caches-cli.cjs",
+    "clear-github-actions-caches": "lib/github-workflows/clean-github-actions-caches-cli.cjs",
+    "composer": "binaries/composer.cjs",
     "copy": "lib/file/copy-cli.cjs",
     "copy-file": "lib/file/copy-cli.cjs",
     "del-gradle": "lib/del-gradle.cjs",
@@ -174,15 +187,20 @@
     "file-downloader": "lib/downloader-cli.cjs",
     "find-node-modules": "lib/find-node-modules-cli.cjs",
     "free-chatgpt": "lib/free-chatgpt.cjs",
-    "git-diff": "lib/git-diff-cli.cjs",
-    "git-fix": "lib/git-fix.cjs",
-    "git-purge": "lib/git-purge.cjs",
+    "generate-test-ci": "src/github-workflows/generate-test-ci-step-cli.mjs",
+    "get-latest-workflow": "lib/github-workflows/get-latest-workflow-status-cli.cjs",
+    "get-latest-workflow-status": "lib/github-workflows/get-latest-workflow-status-cli.cjs",
+    "gh-status-badge": "lib/github-workflows/workflow-badge-cli.cjs",
+    "git-diff": "lib/git/git-diff-cli.cjs",
+    "git-fix": "lib/git/git-fix.cjs",
+    "git-purge": "lib/git/git-purge.cjs",
     "git-reduce-size": "binaries/git-reduce-size.cjs",
     "git-undo-commit": "lib/git/undo-commit.cjs",
     "git-undo-staged": "lib/git/undo-staged.cjs",
     "javakill": "binaries/javakill.cjs",
     "kill-night-crows": "lib/kill-night-crows.cjs",
     "kill-process": "binaries/kill-process.cjs",
+    "latest-workflow": "lib/github-workflows/get-latest-workflow-status-cli.cjs",
     "move": "lib/file/move-cli.cjs",
     "move-file": "lib/file/move-cli.cjs",
     "node-cache-cleaner": "lib/node-cache-cleaner-cli.cjs",
@@ -194,6 +212,8 @@
     "nodekill": "binaries/nodekill.cjs",
     "npm-run-series": "lib/npm-run-series.cjs",
     "nrs": "lib/npm-run-series.cjs",
+    "opc": "lib/opencode-cli.cjs",
+    "opencode-cli": "lib/opencode-cli.cjs",
     "pack-node-package": "lib/node-package-packer-cli.cjs",
     "pack-tarball": "lib/node-package-packer-cli.cjs",
     "package-resolutions-updater": "lib/package-resolutions-updater-cli.cjs",
@@ -201,7 +221,7 @@
     "pkg-res-updater": "lib/package-resolutions-updater-cli.cjs",
     "pkg-resolutions-updater": "lib/package-resolutions-updater-cli.cjs",
     "print-directory-tree": "lib/print-directory-tree.cjs",
-    "print-tarball-tree": "lib/print-tarball-tree.cjs",
+    "print-tarball-tree": "lib/print-tarball-tree-cli.cjs",
     "print-tree": "lib/print-directory-tree.cjs",
     "prod": "binaries/prod.cjs",
     "py": "binaries/py.cjs",
@@ -222,12 +242,16 @@
     "submodule-remove": "lib/submodule-remove-cli.cjs",
     "submodule-token": "binaries/submodule-token.cjs",
     "tarball-packer": "lib/node-package-packer-cli.cjs",
-    "tarball-tree": "lib/print-tarball-tree.cjs",
+    "tarball-tree": "lib/print-tarball-tree-cli.cjs",
     "test-cjs": "binaries/test-cjs.cjs",
     "test-esm": "binaries/test-esm.cjs",
     "undo-commit": "lib/git/undo-commit.cjs",
     "undo-last-commit": "lib/git/undo-commit.cjs",
     "undo-staged": "lib/git/undo-staged.cjs",
+    "vscode-cli": "lib/vscode-cli.cjs",
+    "wf-badge": "lib/github-workflows/workflow-badge-cli.cjs",
+    "wf-status": "lib/github-workflows/get-latest-workflow-status-cli.cjs",
+    "workflow-badge": "lib/github-workflows/workflow-badge-cli.cjs",
     "y-install": "lib/yarn-per-branch-lock-installer.cjs",
     "yarn-clean": "binaries/yarn-clean.cjs",
     "yarn-install": "lib/yarn-per-branch-lock-installer.cjs",

package/readme.md

@@ -1,8 +1,29 @@
 # 🚀 Binary Collections
 
+<details>
+<summary>Build Release CI</summary>
+
+![Build Release](http://sh.webmanajemen.com/php_backend/workflow-badge.php?owner=dimaslanjaka&repo=bin&workflow=build-release.yml)
+
+</details>
+
+<details>
+<summary>Pages CI</summary>
+
+![Pages](http://sh.webmanajemen.com/php_backend/workflow-badge.php?owner=dimaslanjaka&repo=bin&workflow=pages.yml)
+
+</details>
+
+<details>
+<summary>Test CI</summary>
+
+![Test](http://sh.webmanajemen.com/php_backend/workflow-badge.php?owner=dimaslanjaka&repo=bin&workflow=test.yml)
+
+</details>
+
 A comprehensive toolkit of Node.js CLI utilities designed to streamline everyday development workflows.
 
-It provides fast, lightweight commands for common tasks like git operations, dependency management, submodule handling, and running npm scripts in sequence or parallel—helping you reduce repetitive work and improve terminal productivity.
+It provides fast, lightweight commands for common tasks like git operations, dependency management, submodule handling, conditional execution, CI workflow generation, and running npm scripts in sequence or parallel—helping you reduce repetitive work and improve terminal productivity.
 
 ## ✨ Features
 
@@ -15,14 +36,23 @@ It provides fast, lightweight commands for common tasks like git operations, dep
 * 🔁 **Task Orchestration**
   Run npm scripts sequentially or in parallel with improved control and execution clarity.
 
+* 🔐 **Conditional Execution**
+  Run commands only when file contents change — uses SHA-256 checksums to detect modifications and skip unnecessary re-executions.
+
 * 📁 **Repository & Submodule Automation**
   Simplify initialization, syncing, and maintenance of Git submodules and multi-repository setups.
 
 * 📦 **Build & Package Utilities**
-  Enhance NPM workflows with improved script execution, dependency handling, and resolution helpers.
+  Enhance NPM workflows with improved script execution, dependency handling, resolution helpers, and automatic tarball packaging.
 
 * 🛠️ **Development Helpers**
-  General-purpose utilities for process management, environment setup, and file system operations.
+  General-purpose utilities for process management, environment setup, file system operations, downloads, and archive inspection.
+
+* 🤖 **AI & IDE Tooling**
+  Inspect and manage OpenCode databases, browse VS Code workspace storage, and list Copilot memory tool directories.
+
+* 🔄 **CI/CD Automation**
+  Generate GitHub Actions workflow YAML from test file detection, query latest workflow run status, generate live SVG status badges, and clean up stale action caches automatically.
 
 * 🚀 **Performance-Focused CLI Design**
   Lightweight, fast-executing commands designed to reduce friction and speed up everyday development tasks.
@@ -61,6 +91,69 @@ For development or manual setup.
 git clone -b master https://github.com/dimaslanjaka/bin bin
 ```
 
+## Configuration
+
+Binary Collections supports project-level configuration via a `binary-collections.config` file in your project root. Only the name `binary-collections.config` is supported — no `.rc`, JSON, or YAML variants.
+
+### Supported Extensions
+
+| Extension | Module System |
+|-----------|---------------|
+| `.js`     | ESM (project must have `"type": "module"` in `package.json`) |
+| `.cjs`    | CommonJS (always works) |
+| `.mjs`    | ESM (always works) |
+
+### Boilerplate Config
+
+A ready-to-use example is provided in the project root:
+
+```
+binary-collections.config-example.js
+```
+
+Copy and rename it to start configuring:
+
+```bash
+cp binary-collections.config-example.js binary-collections.config.js
+```
+
+### Example — CJS Config (`binary-collections.config.cjs`)
+
+```js
+module.exports = {
+  tempDir: './.my-cache'
+};
+```
+
+### Example — ESM Config (`binary-collections.config.mjs`)
+
+```js
+export default {
+  tempDir: './.my-cache'
+};
+```
+
+### Example — `package.json`
+
+Add a `binary-collections` property to your `package.json`:
+
+```json
+{
+  "name": "my-project",
+  "binary-collections": {
+    "tempDir": "./.my-cache"
+  }
+}
+```
+
+### Configurable Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `tempDir` | `string` | Base directory for temporary files |
+| `githubToken` | `string` | GitHub API token override |
+| `opencode.keys` | `Array<{name, key}>` | OpenCode API keys for `auth rotate` and other commands |
+
 ## VSCode Integration
 
 To make these tools available directly in your VSCode terminal, create or update `.vscode/settings.json`:
@@ -136,16 +229,19 @@ binary-collections list
 
 | Category | Commands | Description | Docs |
 |---|---|---|---|
-| **Git** | `git-purge`, `git-diff`, `git-fix`, `git-reduce-size`, `git-undo` | Git repository management and optimization | [`git-purge.md`](./docs-src/git-purge.md), [`git-diff.md`](./docs-src/git-diff.md), [`git-fix.md`](./docs-src/git-fix.md), [`git-reduce-size.md`](./docs-src/git-reduce-size.md), [`git-undo.md`](./docs-src/git-undo.md) |
-| **Submodules** | `submodule`, `submodule-install`, `submodule-remove`, `submodule-token` | Git submodule operations | [`submodule-install.md`](./docs-src/submodule-install.md), [`submodule-remove.md`](./docs-src/submodule-remove.md), [`submodule-token.md`](./docs-src/submodule-token.md) |
+| **Git** | `git-purge`, `git-diff`, `git-fix`, `git-reduce-size`, `git-undo-commit`, `git-undo-staged` | Git repository management, diff enhancements, undo helpers, and optimization | [`git-purge.md`](./docs-src/git-purge.md), [`git-diff.md`](./docs-src/git-diff.md), [`git-fix.md`](./docs-src/git-fix.md), [`git-reduce-size.md`](./docs-src/git-reduce-size.md), [`git-undo.md`](./docs-src/git-undo.md) |
+| **Submodules** | `submodule-install`, `submodule-remove`, `submodule-token` | Git submodule operations with authentication token injection | [`submodule-install.md`](./docs-src/submodule-install.md), [`submodule-remove.md`](./docs-src/submodule-remove.md), [`submodule-token.md`](./docs-src/submodule-token.md) |
 | **NPM Scripts** | `nrs`, `run-s`, `run-series`, `npm-run-series` | Run npm scripts in series with pattern matching | [`npm-run-series.md`](./docs-src/npm-run-series.md) |
+| **Conditional Execution** | `run-by-checksum`, `run-checksum`, `run-c` | Run commands only when file checksums change (SHA-256 based) | [`run-by-checksum.md`](./docs-src/run-by-checksum.md) |
+| **Build & Package** | `node-package-packer`, `tarball-packer`, `pack-tarball`, `build-tarball`, `build-package` | Automated tarball creation, release packaging, and metadata generation | [`node-package-packer.md`](./docs-src/node-package-packer.md) |
 | **Package Mgmt** | `yarn-reinstall`, `pkg-resolutions-updater`, `pkg-res-updater`, `yarn-install`, `yarn-clean` | Yarn/package resolutions management utilities | [`yarn-reinstall.md`](./docs-src/yarn-reinstall.md), [`yarn-install.md`](./docs-src/yarn-install.md), [`node-cache-cleaner.md`](./docs-src/node-cache-cleaner.md), [`package-resolutions-updater.md`](./docs-src/package-resolutions-updater.md) |
 | **Node.js Dev** | `find-node-modules`, `find-nodemodules`, `dev`, `prod`, `empty`, `node-cache-cleaner`, `node-executor`, `py` | Node.js development helpers | [`find-node-modules.md`](./docs-src/find-node-modules.md), [`env-helpers.md`](./docs-src/env-helpers.md), [`node-cache-cleaner.md`](./docs-src/node-cache-cleaner.md), [`node-executor.md`](./docs-src/node-executor.md), [`py.md`](./docs-src/py.md) |
 | **Process Mgmt** | `kill-process`, `nodekill`, `javakill`, `del-ps`, `kill-night-crows` | Process management and termination | [`del-ps.md`](./docs-src/del-ps.md), [`kill-night-crows.md`](./docs-src/kill-night-crows.md) |
-| **File System** | `rmfind`, `rmpath`, `rmx`, `print-tree`, `dir-tree`, `copy`, `move`, `remove-module` | File system operations | [`copy-move-file.md`](./docs-src/copy-move-file.md), [`rmpath.md`](./docs-src/rmpath.md), [`rmfind-rmx.md`](./docs-src/rmfind-rmx.md), [`print-directory-tree.md`](./docs-src/print-directory-tree.md), [`remove-module.md`](./docs-src/remove-module.md) |
+| **File System** | `rmfind`, `rmx`, `rmpath`, `print-tree`, `dir-tree`, `copy`, `move`, `remove-module`, `downloader`, `download`, `fetch-file`, `print-tarball-tree`, `tarball-tree` | File system operations, URL downloads, archive tree inspection | [`copy-move-file.md`](./docs-src/copy-move-file.md), [`rmpath.md`](./docs-src/rmpath.md), [`rmfind-rmx.md`](./docs-src/rmfind-rmx.md), [`print-directory-tree.md`](./docs-src/print-directory-tree.md), [`remove-module.md`](./docs-src/remove-module.md), [`downloader.md`](./docs-src/downloader.md), [`print-tarball-tree.md`](./docs-src/print-tarball-tree.md) |
 | **Cleanup** | `del-nodemodules`, `del-yarncaches`, `del-gradle`, `del-yarn-caches`, `yarn-clean` | Cache and build directory cleanup | [`node-cache-cleaner.md`](./docs-src/node-cache-cleaner.md), [`del-gradle.md`](./docs-src/del-gradle.md) |
-| **GitHub Actions** | `clean-github-actions-caches`, `clean-github-actions-cache`, `clear-github-actions-cache`, `clear-github-actions-caches`, `clear-gh-caches` | Remove old GitHub Actions caches, keep only latest | [`clean-github-actions-caches.md`](./docs-src/clean-github-actions-caches.md) |
-| **Other** | `binary-collections`, `changelog`, `php-cs-fixer-staged`, `free-chatgpt`, `test-runners` | Miscellaneous utilities and documentation | [`binary-collections.md`](./docs-src/binary-collections.md), [`changelog.md`](./docs-src/changelog.md), [`php-cs-fixer-staged.md`](./docs-src/php-cs-fixer-staged.md), [`free-chatgpt.md`](./docs-src/free-chatgpt.md), [`test-runners.md`](./docs-src/test-runners.md) |
+| **CI/GitHub Actions** | `clean-github-actions-caches`, `clear-gh-caches`, `generate-test-ci`, `get-latest-workflow-status`, `get-latest-workflow`, `latest-workflow`, `wf-status`, `workflow-badge`, `wf-badge`, `gh-status-badge`, `actions-badge` | GitHub Actions cache cleanup, automated CI workflow generation, workflow status inspection, and live SVG badge generation | [`clean-github-actions-caches.md`](./docs-src/clean-github-actions-caches.md), [`generate-test-ci.md`](./docs-src/generate-test-ci.md), [`get-latest-workflow-status.md`](./docs-src/get-latest-workflow-status.md), [`workflow-badge.md`](./docs-src/workflow-badge.md) |
+| **AI & IDE Tooling** | `opc`, `opencode-cli`, `vscode-cli` | OpenCode database management (list/delete sessions and projects) and VS Code workspace inspection with Copilot memory detection | [`opencode-cli.md`](./docs-src/opencode-cli.md), [`vscode-cli.md`](./docs-src/vscode-cli.md) |
+| **Other** | `binary-collections`, `changelog`, `php-cs-fixer-staged`, `free-chatgpt`, `test-runners` | Main dispatcher, changelog generation, PHP CS fixer for staged files, ChatGPT client, and Jest runners for CJS/ESM | [`binary-collections.md`](./docs-src/binary-collections.md), [`changelog.md`](./docs-src/changelog.md), [`php-cs-fixer-staged.md`](./docs-src/php-cs-fixer-staged.md), [`free-chatgpt.md`](./docs-src/free-chatgpt.md), [`test-runners.md`](./docs-src/test-runners.md) |
 
 ---
 

package/releases/readme.md

@@ -2,7 +2,7 @@
 ## Releases
 | version | tarball url |
 | :--- | :--- |
-| latest | https://github.com/dimaslanjaka/bin/raw/f9d6d4b/releases/bin.tgz |
+| latest | https://github.com/dimaslanjaka/bin/raw/53834fc/releases/bin.tgz |
 | latest | https://github.com/dimaslanjaka/bin/raw/master/releases/bin.tgz |
 
 use this tarball with `resolutions`:

package/src/github-workflows/generate-test-ci-step-cli.mjs

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+import fs from 'fs-extra';
+import path from 'upath';
+import { fileURLToPath } from 'url';
+import yaml from 'yaml';
+import { execSync } from 'child_process';
+import { glob } from 'glob';
+import minimist from 'minimist';
+import actionObject from './workflow-test-data.cjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+let actionFile = path.resolve(process.cwd(), '.github/workflows/test.yml');
+
+const DEFAULT_PATTERNS = [
+  'test/**/*.test.{js,cjs,mjs,ts}',
+  'test/**/*.spec.{js,cjs,mjs,ts}',
+  'tests/**/*.test.{js,cjs,mjs,ts}',
+  'tests/**/*.spec.{js,cjs,mjs,ts}'
+];
+
+function showHelp() {
+  console.log(`\
+Usage: generate-test-ci-step.mjs [options]
+
+Options:
+  -p, --pattern <glob>   Test file patterns to search for (can be specified multiple times)
+      --ignore, --ex <glob>  Ignore patterns to exclude from results (can be specified multiple times)
+  -o, --output <file>    Output YAML file path (default: .github/workflows/test.yml)
+  -h, --help             Show this help message
+
+Examples:
+  $ node src/github-workflows/generate-test-ci-step.mjs
+  $ node src/github-workflows/generate-test-ci-step.mjs -p "test/**/*.test.js"
+  $ node src/github-workflows/generate-test-ci-step.mjs --pattern "test/**/*.test.js" --ignore "**/fixtures/**"
+  $ node src/github-workflows/generate-test-ci-step.mjs -o .github/workflows/ci.yml -p "src/**/*.test.ts" --ignore "**/node_modules/**"
+`);
+}
+
+async function collectTests(patterns, ignorePatterns) {
+  const entries = await glob(patterns, {
+    onlyFiles: true,
+    cwd: process.cwd(),
+    ignore: ignorePatterns
+  });
+  return entries.map((p) => p.replace(/\\/g, '/')).sort();
+}
+
+async function main() {
+  const argv = minimist(process.argv.slice(2), {
+    string: ['pattern', 'ignore', 'ex', 'output'],
+    alias: {
+      p: 'pattern',
+      o: 'output',
+      h: 'help'
+    }
+  });
+
+  // Merge --ex into --ignore so both flags work
+  if (argv.ex) {
+    const exList = Array.isArray(argv.ex) ? argv.ex : [argv.ex];
+    argv.ignore = argv.ignore ? [].concat(argv.ignore).concat(exList) : exList;
+  }
+
+  if (argv.help) {
+    showHelp();
+    process.exit(0);
+  }
+
+  if (argv.output) {
+    actionFile = path.resolve(process.cwd(), argv.output);
+  }
+
+  const patterns = argv.pattern ? (Array.isArray(argv.pattern) ? argv.pattern : [argv.pattern]) : DEFAULT_PATTERNS;
+
+  const ignorePatterns = argv.ignore ? (Array.isArray(argv.ignore) ? argv.ignore : [argv.ignore]) : [];
+
+  const files = await collectTests(patterns, ignorePatterns);
+  for (const file of files) {
+    const ext = (path.extname(file) || '').toLowerCase();
+    const filename = path.basename(file);
+    let runCmd;
+    if (ext === '.mjs') {
+      runCmd = `if [ -f "${file}" ]; then\n  bash bin/test-esm --testPathPatterns="${filename}"\nelse\n  echo "Skipping missing test file: ${file}"\nfi`;
+    } else if (ext === '.cjs') {
+      runCmd = `if [ -f "${file}" ]; then\n  bash bin/test-cjs --testPathPatterns="${filename}"\nelse\n  echo "Skipping missing test file: ${file}"\nfi`;
+    } else if (ext === '.ts') {
+      runCmd = `if [ -f "${file}" ]; then\n  node node_modules/jest/bin/jest.js --runInBand --forceExit --testTimeout=120000 --detectOpenHandles --testPathPatterns="${filename}"\nelse\n  echo "Skipping missing test file: ${file}"\nfi`;
+    } else {
+      runCmd = `if [ -f "${file}" ]; then\n  npm test -- --testPathPatterns="${filename}"\nelse\n  echo "Skipping missing test file: ${file}"\nfi`;
+    }
+
+    // Skip files that are not tracked by git (untracked files shouldn't be included in committed actions)
+    try {
+      execSync(`git ls-files --error-unmatch -- "${file}"`, { cwd: process.cwd(), stdio: 'ignore' });
+    } catch {
+      console.warn(`Skipping untracked test file: ${file}`);
+      continue;
+    }
+
+    const rawId = file;
+    let safeId = rawId.replace(/[^A-Za-z0-9_-]+/g, '-');
+    if (!/^[A-Za-z_]/.test(safeId)) safeId = `_${safeId}`;
+    safeId = (safeId.slice(0, 90) || `test-${Math.random().toString(36).slice(2, 8)}`).replace(/-(test|spec)$/, '');
+
+    actionObject.jobs.ci.steps.push({
+      name: `🧪 Run tests in ${file}`,
+      id: `run-${safeId}`,
+      shell: 'bash',
+      run: runCmd
+    });
+  }
+
+  const yamlContent = yaml.stringify(actionObject);
+  fs.ensureDirSync(path.dirname(actionFile));
+  fs.writeFileSync(actionFile, yamlContent, 'utf-8');
+  try {
+    execSync(`npx -y prettier@latest -w "${actionFile}"`, { stdio: 'inherit', cwd: process.cwd() });
+  } catch {
+    // prettier is optional — skip formatting if unavailable
+  }
+  console.log(`Generated ${actionFile} with ${files.length} test steps.`);
+}
+
+main();