@p8ec/shared 2.6.1 → 3.0.3

package/README.md

@@ -69,3 +69,5 @@ p8-cli [command] [options]
     - Example: `p8-cli run build` - returns the `build` script using the detected package manager.
     - Example: `p8-cli run test auto par` - returns the `test` script using the detected
       package manager in parallel mode for workspaces.
+- `pm` - Returns the detected package manager (`npm`, `yarn`, or `pnpm`).
+- `ws` - Returns `true` if the project is a workspace, `false` otherwise.

package/dist/assets/lefthook.yml

@@ -7,10 +7,34 @@ pre-commit:
   commands:
     git:
       run: |
-          if [[ $(git rev-parse --abbrev-ref HEAD) =~ ^(main|master|release)$ ]]; then
-            echo "Direct commits to main, master, and release branches are not allowed."
-            exit 1
+        if [[ $(git rev-parse --abbrev-ref HEAD) =~ ^(main|master|release)$ ]]; then
+          # Allow direct commits on protected branches ONLY if the staged changes are package.json
+          STAGED_FILES=$(git diff --cached --name-only)
+        
+          if [[ -z "$STAGED_FILES" ]]; then
+            exit 0
           fi
+        
+          ALLOWED_FILES=${ALLOWED_FILES:-"package.json"}
+          IFS=',' read -r -a ALLOWED_ARRAY <<< "$ALLOWED_FILES"
+        
+          # Check every staged file; if any differs from the allowed files, block the commit
+          for f in $STAGED_FILES; do
+            MATCHED=false
+            for allowed in "${ALLOWED_ARRAY[@]}"; do
+              if [[ "$f" == "$allowed" || "$f" == */"$allowed" ]]; then
+                MATCHED=true
+                break
+              fi
+            done
+        
+            if [[ "$MATCHED" == "false" ]]; then
+              echo "Direct commits to main, master, and release branches are not allowed, except for: $ALLOWED_FILES"
+              exit 1
+            fi
+          done
+        fi
+
 
 ### Commit message hook ###
 # 1. Allow only commit messages that follow a conventional commit format

package/dist/cjs/bin/cmds/dirn.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * 2026 Copyright P8 Enterprise Components, Inc.
+ * All Rights Reserved.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dirn = void 0;
+const path = __importStar(require("node:path"));
+/**
+ * Returns the directory name of the caller, optionally returns a directory name specified levels up.
+ */
+const dirn = (levelsUp) => {
+    const DEFAULT_LEVELS_UP = 0;
+    levelsUp !== null && levelsUp !== void 0 ? levelsUp : (levelsUp = `${DEFAULT_LEVELS_UP}`);
+    const levels = parseInt(levelsUp) || DEFAULT_LEVELS_UP;
+    return process.cwd().split(path.sep).reverse()[levels];
+};
+exports.dirn = dirn;

package/dist/cjs/bin/cmds/init.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * 2026 Copyright P8 Enterprise Components, Inc.
+ * All Rights Reserved.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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 });
+exports.init = exports.initCleanup = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const yesno_1 = __importDefault(require("../utils/yesno"));
+const detect_1 = require("../utils/detect");
+const p8_shared_cli_1 = require("../p8-shared-cli");
+const writeLn = console.log;
+const initCleanup = (packageJson) => {
+    writeLn('Removing eslintConfig and prettier from package.json...');
+    const configBackup = {};
+    const configBackupFile = 'p8-package-backup.json';
+    const configBackupSections = ['eslintConfig', 'prettier', 'commitlint'];
+    configBackupSections.forEach((section) => {
+        if (packageJson[section]) {
+            writeLn(`Backing up ${section} to ${section}.${configBackupFile}...`);
+            configBackup[section] = packageJson[section];
+            delete packageJson[section];
+        }
+    });
+    p8_shared_cli_1.cliUtils.writeFile(`${configBackupFile}`, JSON.stringify(configBackup, null, 2));
+    p8_shared_cli_1.cliUtils.writeFile('package.json', JSON.stringify(packageJson, null, 2));
+};
+exports.initCleanup = initCleanup;
+/**
+ * Initializes a TypeScript project with P8 shared configurations.
+ */
+const init = (option_1, ...args_1) => __awaiter(void 0, [option_1, ...args_1], void 0, function* (option, pm = 'auto') {
+    const packageJsonData = fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8');
+    const packageJson = JSON.parse(packageJsonData);
+    const moduleType = packageJson['type'] === 'module' ? 'mjs' : 'cjs';
+    const packageManager = pm === 'auto' ? (0, detect_1.detectPackageManager)() : pm;
+    writeLn(`Creating eslint.config.${moduleType}...`);
+    p8_shared_cli_1.cliUtils.copyAsset(`eslint.config.${moduleType}`);
+    writeLn(`Creating prettier.config.${moduleType}...`);
+    p8_shared_cli_1.cliUtils.copyAsset(`prettier.config.${moduleType}`);
+    const scripts = [
+        {
+            name: 'reset',
+            command: {
+                pnpm: 'rm -rf ./**/node_modules && rm -rf ./**/pnpm-lock.yaml && pnpm install',
+                yarn: 'rm -rf ./**/node_modules && rm -rf ./**/yarn.lock && yarn install',
+                npm: 'rm -rf ./**/node_modules && rm -rf ./**/package-lock.json && npm install',
+            },
+        },
+        {
+            name: 'audit',
+            command: {
+                pnpm: 'pnpm audit',
+                yarn: 'yarn npm audit',
+                npm: 'npm audit --audit-level=moderate',
+            },
+        },
+    ];
+    scripts.forEach((script) => {
+        var _a;
+        (_a = packageJson.scripts) !== null && _a !== void 0 ? _a : (packageJson.scripts = {});
+        packageJson.scripts[`${packageManager}:${script.name}`] = script.command[packageManager];
+    });
+    const lefthook = yield (0, yesno_1.default)({
+        question: 'Do you want to use commitlint/lefthook? [y]n',
+        defaultValue: true,
+        yesValues: ['yes', 'y'],
+        noValues: ['no', 'n'],
+    });
+    if (lefthook) {
+        writeLn(`Creating commitlint.config.${moduleType}...`);
+        p8_shared_cli_1.cliUtils.copyAsset(`commitlint.config.${moduleType}`);
+        writeLn('Creating lefthook.yml...');
+        p8_shared_cli_1.cliUtils.copyAsset('lefthook.yml');
+        writeLn('Adding lefthook install to postinstall...');
+        const lefthookInstall = 'lefthook install';
+        packageJson.scripts.postinstall = lefthookInstall;
+        const installCommands = {
+            npm: 'npm install --save-dev @commitlint/{config-conventional,cli} commitlint lefthook',
+            pnpm: 'pnpm install -D @commitlint/{config-conventional,cli} commitlint lefthook',
+            yarn: 'yarn add -D @commitlint/config-conventional @commitlint/cli commitlint lefthook',
+        };
+        const installCommand = installCommands[packageManager];
+        if (yield (0, yesno_1.default)({
+            question: `Do you want to run "${installCommand}" now? [y]n`,
+            defaultValue: true,
+            yesValues: ['yes', 'y'],
+            noValues: ['no', 'n'],
+        })) {
+            writeLn(`Executing ${installCommand}...`);
+            p8_shared_cli_1.cliUtils.execShell(installCommand);
+        }
+        else {
+            writeLn('You could run the following command to install needed dependencies:');
+            writeLn(installCommand);
+        }
+        if (yield (0, yesno_1.default)({
+            question: `Do you want to run "${lefthookInstall}" now? [y]n`,
+            defaultValue: true,
+            yesValues: ['yes', 'y'],
+            noValues: ['no', 'n'],
+        })) {
+            writeLn(`Executing ${lefthookInstall}...`);
+            p8_shared_cli_1.cliUtils.execShell(lefthookInstall);
+        }
+    }
+    if (option === null || option === void 0 ? void 0 : option.split(',').includes('cleanup')) {
+        (0, exports.initCleanup)(packageJson);
+    }
+    else {
+        writeLn('Skipping cleanup...');
+        p8_shared_cli_1.cliUtils.writeFile('package.json', JSON.stringify(packageJson, null, 2));
+    }
+});
+exports.init = init;

package/dist/cjs/bin/cmds/root.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * 2026 Copyright P8 Enterprise Components, Inc.
+ * All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.root = void 0;
+const detect_1 = require("../utils/detect");
+/**
+ * Returns the root directory of the project.
+ */
+const root = (cwd = process.cwd()) => {
+    return (0, detect_1.detectRoot)(cwd);
+};
+exports.root = root;

package/dist/cjs/bin/cmds/run.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * 2026 Copyright P8 Enterprise Components, Inc.
+ * All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = void 0;
+const detect_1 = require("../utils/detect");
+const run = (script, packageManager, workspaceMode) => {
+    var _a;
+    if (!workspaceMode || workspaceMode === 'auto') {
+        workspaceMode = (0, detect_1.detectWorkspace)() ? 'seq' : 'none';
+    }
+    if (!packageManager || packageManager === 'auto') {
+        packageManager = (0, detect_1.detectPackageManager)();
+    }
+    const pnpmWorkspaceSeq = '-r --workspace-concurrency=1 --if-present --reporter-hide-prefix';
+    const pnpmWorkspacePar = '-r --if-present --parallel';
+    const yarnWorkspaceSeq = 'workspaces foreach -A';
+    const yarnWorkspacePar = 'workspaces foreach -A -p';
+    const commands = {
+        npm: {
+            none: `npm run ${script}`,
+            seq: `npm run ${script} --workspaces --if-present`,
+        },
+        yarn: {
+            none: `yarn run ${script}`,
+            seq: `yarn ${yarnWorkspaceSeq} run ${script}`,
+            par: `yarn ${yarnWorkspacePar} run ${script}`,
+        },
+        pnpm: {
+            none: `pnpm run ${script}`,
+            seq: `pnpm ${pnpmWorkspaceSeq} run ${script}`,
+            par: `pnpm ${pnpmWorkspacePar} run ${script}`,
+        },
+    };
+    if (!commands[packageManager]) {
+        throw new Error(`Unknown package manager: ${packageManager}`);
+    }
+    if (!((_a = commands[packageManager]) === null || _a === void 0 ? void 0 : _a[workspaceMode])) {
+        throw new Error(`Unknown workspace mode: ${workspaceMode}`);
+    }
+    return commands[packageManager][workspaceMode];
+};
+exports.run = run;

package/dist/cjs/bin/p8-shared-cli.js

@@ -50,7 +50,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.run = exports.dirn = exports.init = exports.detectWorkspace = exports.detectPackageManager = exports.initCleanup = exports.cliUtils = exports.IS_DEV = void 0;
+exports.main = exports.cliUtils = exports.IS_DEV = exports.detectWorkspace = exports.detectPackageManager = exports.root = exports.run = exports.dirn = exports.initCleanup = exports.init = void 0;
 /**
  * P8 Shared CLI tool.
  *
@@ -60,20 +60,37 @@ exports.run = exports.dirn = exports.init = exports.detectWorkspace = exports.de
 const path = __importStar(require("node:path"));
 const fs = __importStar(require("node:fs"));
 const ferramenta_1 = require("ferramenta");
-const yesno_1 = __importDefault(require("./utils/yesno"));
 const prompt_1 = __importDefault(require("./utils/prompt"));
+const args_1 = __importDefault(require("./utils/args"));
 const child_process = __importStar(require("node:child_process"));
+const init_1 = require("./cmds/init");
+Object.defineProperty(exports, "init", { enumerable: true, get: function () { return init_1.init; } });
+Object.defineProperty(exports, "initCleanup", { enumerable: true, get: function () { return init_1.initCleanup; } });
+const dirn_1 = require("./cmds/dirn");
+Object.defineProperty(exports, "dirn", { enumerable: true, get: function () { return dirn_1.dirn; } });
+const run_1 = require("./cmds/run");
+Object.defineProperty(exports, "run", { enumerable: true, get: function () { return run_1.run; } });
+const root_1 = require("./cmds/root");
+Object.defineProperty(exports, "root", { enumerable: true, get: function () { return root_1.root; } });
+const detect_1 = require("./utils/detect");
+Object.defineProperty(exports, "detectPackageManager", { enumerable: true, get: function () { return detect_1.detectPackageManager; } });
+Object.defineProperty(exports, "detectWorkspace", { enumerable: true, get: function () { return detect_1.detectWorkspace; } });
 exports.IS_DEV = process.env.NODE_ENV === 'development';
 let args = ferramenta_1.processArgs.args;
 const self = path.parse(ferramenta_1.processArgs.name).name;
-const writeLn = console.log;
+const writeLn = (...args) => {
+    console.log(...args);
+};
 exports.cliUtils = {
-    execShell: (command) => exports.IS_DEV ? writeLn(`DEV: execShell ${command}`) : child_process.execSync(command).toString(),
+    writeLn: (...args) => {
+        writeLn(...args);
+    },
+    execShell: (command) => exports.IS_DEV ? exports.cliUtils.writeLn(`DEV: execShell ${command}`) : child_process.execSync(command).toString(),
     writeFile: (name, data) => exports.IS_DEV
-        ? writeLn(`DEV: writeFile name=${name} data=${data}`)
+        ? console.log(`DEV: writeFile name=${name} data=${data}`)
         : fs.writeFileSync(path.join(process.cwd(), name), data),
     copyAsset: (name) => exports.IS_DEV
-        ? writeLn(`DEV: copyAsset name=${name}`)
+        ? console.log(`DEV: copyAsset name=${name}`)
         : fs.copyFileSync(path.join(__dirname, '..', '..', 'assets', name), path.join(process.cwd(), name)),
 };
 if (args.length === 0 && !exports.IS_DEV && require.main === module) {
@@ -81,223 +98,69 @@ if (args.length === 0 && !exports.IS_DEV && require.main === module) {
 Usage: ${self} {command} [options]
 
 Commands:
-	init [cleanup]
+	init [options]
 		Initializes a new P8 repo.
 			Options:
-				cleanup: Removes redundant configurations from package.json.
+				--cleanup: Flag to remove redundant configurations from package.json.
 	dirn [levelsUp]
 		Returns the directory name of the caller.
-			Options:
+			Arguments:
 				levelsUp: The number of levels up to return the directory name.
-	run [script [packageManager [workspaceMode]]]
+	run script [options]
 		Returns a command to run a script with the specified package manager.
-			Options:
+			Arguments:
 				script: The script to run.
-				packageManager: The package manager to use ('npm', 'yarn', 'pnpm' or 'auto'). Defaults to npm.
-				workspaceMode: Whether to run in workspace mode ('seq', 'par', 'auto' for pnpm and yarn, and 'seq' for npm). Defaults to none.
+			Options:
+				-p {value}, --packageManager={value}: The package manager to use, where {value} is one of 'npm', 'pnpm', 'yarn', or 'auto' (defaults to 'auto').
+				-w {value}, --workspaceMode={value}: The workspace mode to use, where {value} is one of 'none', 'seq', 'par', or 'auto' (defaults to 'auto').
+	root
+		Returns path to the root of the repo.
+	pm
+		Returns the detected package manager.
+	ws
+		Returns true or false for detected workspace.
 `);
     if (exports.IS_DEV) {
         writeLn(`DEVELOPMENT MODE`);
     }
     process.exit(1);
 }
-const initCleanup = (packageJson) => {
-    writeLn('Removing eslintConfig and prettier from package.json...');
-    const configBackup = {};
-    const configBackupFile = 'p8-package-backup.json';
-    const configBackupSections = ['eslintConfig', 'prettier', 'commitlint'];
-    configBackupSections.forEach((section) => {
-        if (packageJson[section]) {
-            writeLn(`Backing up ${section} to ${section}.${configBackupFile}...`);
-            configBackup[section] = packageJson[section];
-            delete packageJson[section];
-        }
-    });
-    exports.cliUtils.writeFile(`${configBackupFile}`, JSON.stringify(configBackup, null, 2));
-    exports.cliUtils.writeFile('package.json', JSON.stringify(packageJson, null, 2));
-};
-exports.initCleanup = initCleanup;
-/**
- * Detects the package manager used in the project.
- */
-const detectPackageManager = (cwd = process.cwd()) => {
-    if (fs.existsSync(path.join(cwd, 'pnpm-lock.yaml'))) {
-        return 'pnpm';
-    }
-    if (fs.existsSync(path.join(cwd, 'yarn.lock'))) {
-        return 'yarn';
-    }
-    return 'npm';
-};
-exports.detectPackageManager = detectPackageManager;
-/**
- * Detects if the project is a workspace.
- */
-const detectWorkspace = (cwd = process.cwd()) => {
-    if (fs.existsSync(path.join(cwd, 'pnpm-workspace.yaml'))) {
-        return true;
-    }
-    const packageJsonPath = path.join(cwd, 'package.json');
-    if (fs.existsSync(packageJsonPath)) {
-        try {
-            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-            if (packageJson.workspaces) {
-                return true;
-            }
-        }
-        catch (_a) {
-            return false;
-        }
-    }
-    return false;
-};
-exports.detectWorkspace = detectWorkspace;
-/**
- * Initializes a TypeScript project with P8 shared configurations.
- */
-const init = (option_1, ...args_1) => __awaiter(void 0, [option_1, ...args_1], void 0, function* (option, packageManager = (0, exports.detectPackageManager)()) {
-    var _a;
-    const packageJsonData = fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8');
-    const packageJson = JSON.parse(packageJsonData);
-    const moduleType = packageJson['type'] === 'module' ? 'mjs' : 'cjs';
-    writeLn(`Creating eslint.config.${moduleType}...`);
-    exports.cliUtils.copyAsset(`eslint.config.${moduleType}`);
-    writeLn(`Creating prettier.config.${moduleType}...`);
-    exports.cliUtils.copyAsset(`prettier.config.${moduleType}`);
-    (_a = packageJson.scripts) !== null && _a !== void 0 ? _a : (packageJson.scripts = {});
-    packageJson.scripts[`${packageManager}:reset`] =
-        packageManager === 'pnpm'
-            ? 'rm -rf ./**/node_modules && rm -rf ./**/pnpm-lock.yaml && pnpm install'
-            : packageManager === 'yarn'
-                ? 'rm -rf ./**/node_modules && rm -rf ./**/yarn.lock && yarn install'
-                : 'rm -rf ./**/node_modules && rm -rf ./**/package-lock.json && npm install';
-    packageJson.scripts[`${packageManager}:audit`] =
-        packageManager === 'pnpm'
-            ? 'pnpm audit'
-            : packageManager === 'yarn'
-                ? 'yarn npm audit'
-                : 'npm audit --audit-level=moderate';
-    const lefthook = yield (0, yesno_1.default)({
-        question: 'Do you want to use commitlint/lefthook? [y]n',
-        defaultValue: true,
-        yesValues: ['yes', 'y'],
-        noValues: ['no', 'n'],
-    });
-    if (lefthook) {
-        writeLn(`Creating commitlint.config.${moduleType}...`);
-        exports.cliUtils.copyAsset(`commitlint.config.${moduleType}`);
-        writeLn('Creating lefthook.yml...');
-        exports.cliUtils.copyAsset('lefthook.yml');
-        writeLn('Adding lefthook install to postinstall...');
-        const lefthookInstall = 'lefthook install';
-        packageJson.scripts.postinstall = lefthookInstall;
-        const installCommands = {
-            npm: 'npm install --save-dev @commitlint/{config-conventional,cli} commitlint lefthook',
-            pnpm: 'pnpm install -D @commitlint/{config-conventional,cli} commitlint lefthook',
-            yarn: 'yarn add -D @commitlint/config-conventional @commitlint/cli commitlint lefthook',
-        };
-        const installCommand = installCommands[packageManager];
-        if (yield (0, yesno_1.default)({
-            question: `Do you want to run "${installCommand}" now? [y]n`,
-            defaultValue: true,
-            yesValues: ['yes', 'y'],
-            noValues: ['no', 'n'],
-        })) {
-            writeLn(`Executing ${installCommand}...`);
-            exports.cliUtils.execShell(installCommand);
-        }
-        else {
-            writeLn('You could run the following command to install needed dependencies:');
-            writeLn(installCommand);
-        }
-        if (yield (0, yesno_1.default)({
-            question: `Do you want to run "${lefthookInstall}" now? [y]n`,
-            defaultValue: true,
-            yesValues: ['yes', 'y'],
-            noValues: ['no', 'n'],
-        })) {
-            writeLn(`Executing ${lefthookInstall}...`);
-            exports.cliUtils.execShell(lefthookInstall);
-        }
-    }
-    if (option === null || option === void 0 ? void 0 : option.split(',').includes('cleanup')) {
-        (0, exports.initCleanup)(packageJson);
-    }
-    else {
-        writeLn('Skipping cleanup...');
-        exports.cliUtils.writeFile('package.json', JSON.stringify(packageJson, null, 2));
-    }
-});
-exports.init = init;
-/**
- * Returns the directory name of the caller, optionally returns a directory name specified levels up.
- */
-const dirn = (levelsUp) => {
-    const DEFAULT_LEVELS_UP = 0;
-    levelsUp !== null && levelsUp !== void 0 ? levelsUp : (levelsUp = `${DEFAULT_LEVELS_UP}`);
-    const levels = parseInt(levelsUp) || DEFAULT_LEVELS_UP;
-    return process.cwd().split(path.sep).reverse()[levels];
-};
-exports.dirn = dirn;
-const run = (script, packageManager, workspaceMode) => {
-    var _a;
-    if (!workspaceMode || workspaceMode === 'auto') {
-        workspaceMode = (0, exports.detectWorkspace)() ? 'seq' : 'none';
-    }
-    if (!packageManager || packageManager === 'auto') {
-        packageManager = (0, exports.detectPackageManager)();
-    }
-    const pnpmWorkspaceSeq = '-r --workspace-concurrency=1 --if-present --reporter-hide-prefix';
-    const pnpmWorkspacePar = '-r --if-present --parallel';
-    const yarnWorkspaceSeq = 'workspaces foreach -A';
-    const yarnWorkspacePar = 'workspaces foreach -A -p';
-    const commands = {
-        npm: {
-            none: `npm run ${script}`,
-            seq: `npm run ${script} --workspaces --if-present`,
-        },
-        yarn: {
-            none: `yarn run ${script}`,
-            seq: `yarn ${yarnWorkspaceSeq} run ${script}`,
-            par: `yarn ${yarnWorkspacePar} run ${script}`,
-        },
-        pnpm: {
-            none: `pnpm run ${script}`,
-            seq: `pnpm ${pnpmWorkspaceSeq} run ${script}`,
-            par: `pnpm ${pnpmWorkspacePar} run ${script}`,
-        },
-    };
-    if (!commands[packageManager]) {
-        throw new Error(`Unknown package manager: ${packageManager}`);
-    }
-    if (!((_a = commands[packageManager]) === null || _a === void 0 ? void 0 : _a[workspaceMode])) {
-        throw new Error(`Unknown workspace mode: ${workspaceMode}`);
-    }
-    return commands[packageManager][workspaceMode];
-};
-exports.run = run;
-const main = () => __awaiter(void 0, void 0, void 0, function* () {
+const main = (customArgs) => __awaiter(void 0, void 0, void 0, function* () {
     // Ask the user for arguments if IS_DEV is true
-    if (exports.IS_DEV) {
+    if (exports.IS_DEV && !customArgs) {
         args = (yield (0, prompt_1.default)('Enter arguments:')).split(' ');
     }
-    switch (args[0]) {
+    else if (customArgs) {
+        args = customArgs;
+    }
+    const parsed = (0, args_1.default)(args);
+    switch (parsed.command) {
         case 'init':
-            yield (0, exports.init)(args[1]);
+            yield (0, init_1.init)(parsed.positional[0] || (parsed.options.cleanup ? 'cleanup' : ''));
             break;
         case 'dirn':
-            writeLn((0, exports.dirn)(args[1]));
+            exports.cliUtils.writeLn((0, dirn_1.dirn)(parsed.positional[0]));
             break;
         case 'run':
-            writeLn((0, exports.run)(args[1], args[2], args[3]));
+            exports.cliUtils.writeLn((0, run_1.run)(parsed.positional[0], (parsed.positional[1] || parsed.options.p || parsed.options.packageManager), (parsed.positional[2] || parsed.options.w || parsed.options.workspaceMode)));
+            break;
+        case 'root':
+            exports.cliUtils.writeLn((0, root_1.root)());
+            break;
+        case 'pm':
+            exports.cliUtils.writeLn((0, detect_1.detectPackageManager)());
+            break;
+        case 'ws':
+            exports.cliUtils.writeLn((0, detect_1.detectWorkspace)());
             break;
         default:
-            console.error(`Unknown command: ${args[0]}`);
+            console.error(`Unknown command: ${parsed.command}`);
             process.exit(1);
     }
 });
+exports.main = main;
 if (require.main === module) {
-    main()
+    (0, exports.main)()
         .then((r) => {
         if (exports.IS_DEV) {
             writeLn(`DEV: setup completed successfully with result: ${JSON.stringify(r)}`);

package/dist/cjs/bin/utils/args.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * 2026 Copyright P8 Enterprise Components, Inc.
+ * All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = void 0;
+/**
+ * Robust command line argument parser.
+ *
+ * @param args - Array of command line arguments.
+ * @returns An object containing parsed commands, options, and positional arguments.
+ * @example
+ * ```ts
+ * const args = ['build', '--env=production', '-f', 'config.json', 'input.txt'];
+ * const parsed = parseArgs(args);
+ * // parsed = {
+ * //	  command: 'build',
+ * //   options: { env: 'production', f: 'config.json' },
+ * //   positional: ['input.txt']
+ * // }
+ * ```
+ */
+const parseArgs = (args) => {
+    const result = {
+        command: '',
+        options: {},
+        positional: [],
+    };
+    let isCommandSet = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const [key, value] = arg.slice(2).split('=');
+            if (value !== undefined) {
+                result.options[key] = value;
+            }
+            else {
+                const nextArg = args[i + 1];
+                if (nextArg && !nextArg.startsWith('-')) {
+                    result.options[key] = nextArg;
+                    i++;
+                }
+                else {
+                    result.options[key] = true;
+                }
+            }
+        }
+        else if (arg.startsWith('-')) {
+            const keys = arg.slice(1).split('');
+            keys.forEach((key, index) => {
+                if (index === keys.length - 1) {
+                    const nextArg = args[i + 1];
+                    if (nextArg && !nextArg.startsWith('-')) {
+                        result.options[key] = nextArg;
+                        i++;
+                    }
+                    else {
+                        result.options[key] = true;
+                    }
+                }
+                else {
+                    result.options[key] = true;
+                }
+            });
+        }
+        else {
+            if (!isCommandSet) {
+                result.command = arg;
+                isCommandSet = true;
+            }
+            else {
+                result.positional.push(arg);
+            }
+        }
+    }
+    return result;
+};
+exports.parseArgs = parseArgs;
+exports.default = exports.parseArgs;

package/dist/cjs/bin/utils/detect.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * 2026 Copyright P8 Enterprise Components, Inc.
+ * All Rights Reserved.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectWorkspace = exports.detectPackageManager = exports.detectRoot = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Finds the TOPMOST directory containing package.json
+ * by walking up the directory tree.
+ * @param startDir Directory to start from (defaults to cwd)
+ * @returns Absolute path to monorepo root, or null if none found
+ */
+const detectRoot = (startDir = process.cwd()) => {
+    let currentDir = path.resolve(startDir);
+    // Avoid symlink loops
+    try {
+        currentDir = fs.realpathSync(currentDir);
+    }
+    catch (_a) {
+        // ignore
+    }
+    let lastMatch = startDir;
+    while (true) {
+        const pkgPath = path.join(currentDir, 'package.json');
+        try {
+            if (fs.existsSync(pkgPath)) {
+                lastMatch = currentDir;
+            }
+        }
+        catch (_b) {
+            // ignore fs errors and continue walking up
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            break; // filesystem root reached
+        }
+        currentDir = parentDir;
+    }
+    return lastMatch;
+};
+exports.detectRoot = detectRoot;
+/**
+ * Detects the package manager used in the project.
+ */
+const detectPackageManager = (cwd = process.cwd()) => {
+    const root = (0, exports.detectRoot)(cwd);
+    if (fs.existsSync(path.join(root, 'pnpm-lock.yaml'))) {
+        return 'pnpm';
+    }
+    if (fs.existsSync(path.join(root, 'yarn.lock'))) {
+        return 'yarn';
+    }
+    return 'npm';
+};
+exports.detectPackageManager = detectPackageManager;
+/**
+ * Detects if the project is a workspace.
+ */
+const detectWorkspace = (cwd = process.cwd()) => {
+    const root = (0, exports.detectRoot)(cwd);
+    if (fs.existsSync(path.join(root, 'pnpm-workspace.yaml'))) {
+        return true;
+    }
+    const packageJsonPath = path.join(root, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+            if (packageJson.workspaces) {
+                return true;
+            }
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    return false;
+};
+exports.detectWorkspace = detectWorkspace;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@p8ec/shared",
-	"version": "2.6.1",
+	"version": "3.0.3",
 	"description": "P(8) Global Shared Library for Javascript",
 	"repository": {
 		"type": "git",
@@ -29,7 +29,7 @@
 		"docs:clean": "rm -rf docs"
 	},
 	"bin": {
-		"p8-cli": "dist/cjs/bin/p8-shared-cli.js"
+		"p8cli": "dist/cjs/bin/p8-shared-cli.js"
 	},
 	"main": "dist/cjs/index.js",
 	"module": "dist/esm/index.js",