@qlover/fe-release 2.3.5 → 3.1.0

package/dist/cli.js

@@ -2877,116 +2877,65 @@ var require_set = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackClear.js
-var require_stackClear = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackClear.js"(exports, module) {
-    "use strict";
-    var ListCache = require_ListCache();
-    function stackClear() {
-      this.__data__ = new ListCache();
-      this.size = 0;
-    }
-    module.exports = stackClear;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackDelete.js
-var require_stackDelete = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackDelete.js"(exports, module) {
-    "use strict";
-    function stackDelete(key) {
-      var data = this.__data__, result = data["delete"](key);
-      this.size = data.size;
-      return result;
-    }
-    module.exports = stackDelete;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackGet.js
-var require_stackGet = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackGet.js"(exports, module) {
-    "use strict";
-    function stackGet(key) {
-      return this.__data__.get(key);
-    }
-    module.exports = stackGet;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackHas.js
-var require_stackHas = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackHas.js"(exports, module) {
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseGet.js
+var require_baseGet = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseGet.js"(exports, module) {
     "use strict";
-    function stackHas(key) {
-      return this.__data__.has(key);
+    var castPath = require_castPath();
+    var toKey = require_toKey();
+    function baseGet(object, path) {
+      path = castPath(path, object);
+      var index = 0, length = path.length;
+      while (object != null && index < length) {
+        object = object[toKey(path[index++])];
+      }
+      return index && index == length ? object : void 0;
     }
-    module.exports = stackHas;
+    module.exports = baseGet;
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackSet.js
-var require_stackSet = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackSet.js"(exports, module) {
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/get.js
+var require_get = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/get.js"(exports, module) {
     "use strict";
-    var ListCache = require_ListCache();
-    var Map2 = require_Map();
-    var MapCache = require_MapCache();
-    var LARGE_ARRAY_SIZE = 200;
-    function stackSet(key, value) {
-      var data = this.__data__;
-      if (data instanceof ListCache) {
-        var pairs = data.__data__;
-        if (!Map2 || pairs.length < LARGE_ARRAY_SIZE - 1) {
-          pairs.push([key, value]);
-          this.size = ++data.size;
-          return this;
-        }
-        data = this.__data__ = new MapCache(pairs);
-      }
-      data.set(key, value);
-      this.size = data.size;
-      return this;
+    var baseGet = require_baseGet();
+    function get2(object, path, defaultValue) {
+      var result = object == null ? void 0 : baseGet(object, path);
+      return result === void 0 ? defaultValue : result;
     }
-    module.exports = stackSet;
+    module.exports = get2;
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Stack.js
-var require_Stack = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Stack.js"(exports, module) {
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isString.js
+var require_isString = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isString.js"(exports, module) {
     "use strict";
-    var ListCache = require_ListCache();
-    var stackClear = require_stackClear();
-    var stackDelete = require_stackDelete();
-    var stackGet = require_stackGet();
-    var stackHas = require_stackHas();
-    var stackSet = require_stackSet();
-    function Stack(entries) {
-      var data = this.__data__ = new ListCache(entries);
-      this.size = data.size;
+    var baseGetTag = require_baseGetTag();
+    var isArray = require_isArray();
+    var isObjectLike = require_isObjectLike();
+    var stringTag = "[object String]";
+    function isString2(value) {
+      return typeof value == "string" || !isArray(value) && isObjectLike(value) && baseGetTag(value) == stringTag;
     }
-    Stack.prototype.clear = stackClear;
-    Stack.prototype["delete"] = stackDelete;
-    Stack.prototype.get = stackGet;
-    Stack.prototype.has = stackHas;
-    Stack.prototype.set = stackSet;
-    module.exports = Stack;
+    module.exports = isString2;
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_assignMergeValue.js
-var require_assignMergeValue = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_assignMergeValue.js"(exports, module) {
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_arrayAggregator.js
+var require_arrayAggregator = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_arrayAggregator.js"(exports, module) {
     "use strict";
-    var baseAssignValue = require_baseAssignValue();
-    var eq = require_eq2();
-    function assignMergeValue(object, key, value) {
-      if (value !== void 0 && !eq(object[key], value) || value === void 0 && !(key in object)) {
-        baseAssignValue(object, key, value);
+    function arrayAggregator(array, setter, iteratee, accumulator) {
+      var index = -1, length = array == null ? 0 : array.length;
+      while (++index < length) {
+        var value = array[index];
+        setter(accumulator, value, iteratee(value), array);
       }
+      return accumulator;
     }
-    module.exports = assignMergeValue;
+    module.exports = arrayAggregator;
   }
 });
 
@@ -3020,154 +2969,18 @@ var require_baseFor = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_cloneBuffer.js
-var require_cloneBuffer = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_cloneBuffer.js"(exports, module) {
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseTimes.js
+var require_baseTimes = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseTimes.js"(exports, module) {
     "use strict";
-    var root = require_root();
-    var freeExports = typeof exports == "object" && exports && !exports.nodeType && exports;
-    var freeModule = freeExports && typeof module == "object" && module && !module.nodeType && module;
-    var moduleExports = freeModule && freeModule.exports === freeExports;
-    var Buffer2 = moduleExports ? root.Buffer : void 0;
-    var allocUnsafe = Buffer2 ? Buffer2.allocUnsafe : void 0;
-    function cloneBuffer(buffer, isDeep) {
-      if (isDeep) {
-        return buffer.slice();
+    function baseTimes(n, iteratee) {
+      var index = -1, result = Array(n);
+      while (++index < n) {
+        result[index] = iteratee(index);
       }
-      var length = buffer.length, result = allocUnsafe ? allocUnsafe(length) : new buffer.constructor(length);
-      buffer.copy(result);
       return result;
     }
-    module.exports = cloneBuffer;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Uint8Array.js
-var require_Uint8Array = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Uint8Array.js"(exports, module) {
-    "use strict";
-    var root = require_root();
-    var Uint8Array2 = root.Uint8Array;
-    module.exports = Uint8Array2;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_cloneArrayBuffer.js
-var require_cloneArrayBuffer = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_cloneArrayBuffer.js"(exports, module) {
-    "use strict";
-    var Uint8Array2 = require_Uint8Array();
-    function cloneArrayBuffer(arrayBuffer) {
-      var result = new arrayBuffer.constructor(arrayBuffer.byteLength);
-      new Uint8Array2(result).set(new Uint8Array2(arrayBuffer));
-      return result;
-    }
-    module.exports = cloneArrayBuffer;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_cloneTypedArray.js
-var require_cloneTypedArray = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_cloneTypedArray.js"(exports, module) {
-    "use strict";
-    var cloneArrayBuffer = require_cloneArrayBuffer();
-    function cloneTypedArray(typedArray, isDeep) {
-      var buffer = isDeep ? cloneArrayBuffer(typedArray.buffer) : typedArray.buffer;
-      return new typedArray.constructor(buffer, typedArray.byteOffset, typedArray.length);
-    }
-    module.exports = cloneTypedArray;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_copyArray.js
-var require_copyArray = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_copyArray.js"(exports, module) {
-    "use strict";
-    function copyArray(source, array) {
-      var index = -1, length = source.length;
-      array || (array = Array(length));
-      while (++index < length) {
-        array[index] = source[index];
-      }
-      return array;
-    }
-    module.exports = copyArray;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseCreate.js
-var require_baseCreate = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseCreate.js"(exports, module) {
-    "use strict";
-    var isObject = require_isObject();
-    var objectCreate = Object.create;
-    var baseCreate = /* @__PURE__ */ function() {
-      function object() {
-      }
-      return function(proto) {
-        if (!isObject(proto)) {
-          return {};
-        }
-        if (objectCreate) {
-          return objectCreate(proto);
-        }
-        object.prototype = proto;
-        var result = new object();
-        object.prototype = void 0;
-        return result;
-      };
-    }();
-    module.exports = baseCreate;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_overArg.js
-var require_overArg = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_overArg.js"(exports, module) {
-    "use strict";
-    function overArg(func, transform) {
-      return function(arg) {
-        return func(transform(arg));
-      };
-    }
-    module.exports = overArg;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_getPrototype.js
-var require_getPrototype = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_getPrototype.js"(exports, module) {
-    "use strict";
-    var overArg = require_overArg();
-    var getPrototype = overArg(Object.getPrototypeOf, Object);
-    module.exports = getPrototype;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_isPrototype.js
-var require_isPrototype = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_isPrototype.js"(exports, module) {
-    "use strict";
-    var objectProto = Object.prototype;
-    function isPrototype(value) {
-      var Ctor = value && value.constructor, proto = typeof Ctor == "function" && Ctor.prototype || objectProto;
-      return value === proto;
-    }
-    module.exports = isPrototype;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_initCloneObject.js
-var require_initCloneObject = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_initCloneObject.js"(exports, module) {
-    "use strict";
-    var baseCreate = require_baseCreate();
-    var getPrototype = require_getPrototype();
-    var isPrototype = require_isPrototype();
-    function initCloneObject(object) {
-      return typeof object.constructor == "function" && !isPrototype(object) ? baseCreate(getPrototype(object)) : {};
-    }
-    module.exports = initCloneObject;
+    module.exports = baseTimes;
   }
 });
 
@@ -3203,44 +3016,6 @@ var require_isArguments = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isLength.js
-var require_isLength = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isLength.js"(exports, module) {
-    "use strict";
-    var MAX_SAFE_INTEGER = 9007199254740991;
-    function isLength(value) {
-      return typeof value == "number" && value > -1 && value % 1 == 0 && value <= MAX_SAFE_INTEGER;
-    }
-    module.exports = isLength;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isArrayLike.js
-var require_isArrayLike = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isArrayLike.js"(exports, module) {
-    "use strict";
-    var isFunction = require_isFunction();
-    var isLength = require_isLength();
-    function isArrayLike(value) {
-      return value != null && isLength(value.length) && !isFunction(value);
-    }
-    module.exports = isArrayLike;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isArrayLikeObject.js
-var require_isArrayLikeObject = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isArrayLikeObject.js"(exports, module) {
-    "use strict";
-    var isArrayLike = require_isArrayLike();
-    var isObjectLike = require_isObjectLike();
-    function isArrayLikeObject(value) {
-      return isObjectLike(value) && isArrayLike(value);
-    }
-    module.exports = isArrayLikeObject;
-  }
-});
-
 // ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/stubFalse.js
 var require_stubFalse = __commonJS({
   "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/stubFalse.js"(exports, module) {
@@ -3268,31 +3043,15 @@ var require_isBuffer = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isPlainObject.js
-var require_isPlainObject = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isPlainObject.js"(exports, module) {
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isLength.js
+var require_isLength = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isLength.js"(exports, module) {
     "use strict";
-    var baseGetTag = require_baseGetTag();
-    var getPrototype = require_getPrototype();
-    var isObjectLike = require_isObjectLike();
-    var objectTag = "[object Object]";
-    var funcProto = Function.prototype;
-    var objectProto = Object.prototype;
-    var funcToString = funcProto.toString;
-    var hasOwnProperty = objectProto.hasOwnProperty;
-    var objectCtorString = funcToString.call(Object);
-    function isPlainObject(value) {
-      if (!isObjectLike(value) || baseGetTag(value) != objectTag) {
-        return false;
-      }
-      var proto = getPrototype(value);
-      if (proto === null) {
-        return true;
-      }
-      var Ctor = hasOwnProperty.call(proto, "constructor") && proto.constructor;
-      return typeof Ctor == "function" && Ctor instanceof Ctor && funcToString.call(Ctor) == objectCtorString;
+    var MAX_SAFE_INTEGER = 9007199254740991;
+    function isLength(value) {
+      return typeof value == "number" && value > -1 && value % 1 == 0 && value <= MAX_SAFE_INTEGER;
     }
-    module.exports = isPlainObject;
+    module.exports = isLength;
   }
 });
 
@@ -3386,66 +3145,6 @@ var require_isTypedArray = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_safeGet.js
-var require_safeGet = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_safeGet.js"(exports, module) {
-    "use strict";
-    function safeGet(object, key) {
-      if (key === "constructor" && typeof object[key] === "function") {
-        return;
-      }
-      if (key == "__proto__") {
-        return;
-      }
-      return object[key];
-    }
-    module.exports = safeGet;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_copyObject.js
-var require_copyObject = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_copyObject.js"(exports, module) {
-    "use strict";
-    var assignValue = require_assignValue();
-    var baseAssignValue = require_baseAssignValue();
-    function copyObject(source, props, object, customizer) {
-      var isNew = !object;
-      object || (object = {});
-      var index = -1, length = props.length;
-      while (++index < length) {
-        var key = props[index];
-        var newValue = customizer ? customizer(object[key], source[key], key, object, source) : void 0;
-        if (newValue === void 0) {
-          newValue = source[key];
-        }
-        if (isNew) {
-          baseAssignValue(object, key, newValue);
-        } else {
-          assignValue(object, key, newValue);
-        }
-      }
-      return object;
-    }
-    module.exports = copyObject;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseTimes.js
-var require_baseTimes = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseTimes.js"(exports, module) {
-    "use strict";
-    function baseTimes(n, iteratee) {
-      var index = -1, result = Array(n);
-      while (++index < n) {
-        result[index] = iteratee(index);
-      }
-      return result;
-    }
-    module.exports = baseTimes;
-  }
-});
-
 // ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_arrayLikeKeys.js
 var require_arrayLikeKeys = __commonJS({
   "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_arrayLikeKeys.js"(exports, module) {
@@ -3462,449 +3161,42 @@ var require_arrayLikeKeys = __commonJS({
       var isArr = isArray(value), isArg = !isArr && isArguments(value), isBuff = !isArr && !isArg && isBuffer(value), isType = !isArr && !isArg && !isBuff && isTypedArray(value), skipIndexes = isArr || isArg || isBuff || isType, result = skipIndexes ? baseTimes(value.length, String) : [], length = result.length;
       for (var key in value) {
         if ((inherited || hasOwnProperty.call(value, key)) && !(skipIndexes && // Safari 9 has enumerable `arguments.length` in strict mode.
-        (key == "length" || // Node.js 0.10 has enumerable non-index properties on buffers.
-        isBuff && (key == "offset" || key == "parent") || // PhantomJS 2 has enumerable non-index properties on typed arrays.
-        isType && (key == "buffer" || key == "byteLength" || key == "byteOffset") || // Skip index properties.
-        isIndex(key, length)))) {
-          result.push(key);
-        }
-      }
-      return result;
-    }
-    module.exports = arrayLikeKeys;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_nativeKeysIn.js
-var require_nativeKeysIn = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_nativeKeysIn.js"(exports, module) {
-    "use strict";
-    function nativeKeysIn(object) {
-      var result = [];
-      if (object != null) {
-        for (var key in Object(object)) {
-          result.push(key);
-        }
-      }
-      return result;
-    }
-    module.exports = nativeKeysIn;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseKeysIn.js
-var require_baseKeysIn = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseKeysIn.js"(exports, module) {
-    "use strict";
-    var isObject = require_isObject();
-    var isPrototype = require_isPrototype();
-    var nativeKeysIn = require_nativeKeysIn();
-    var objectProto = Object.prototype;
-    var hasOwnProperty = objectProto.hasOwnProperty;
-    function baseKeysIn(object) {
-      if (!isObject(object)) {
-        return nativeKeysIn(object);
-      }
-      var isProto = isPrototype(object), result = [];
-      for (var key in object) {
-        if (!(key == "constructor" && (isProto || !hasOwnProperty.call(object, key)))) {
-          result.push(key);
-        }
-      }
-      return result;
-    }
-    module.exports = baseKeysIn;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/keysIn.js
-var require_keysIn = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/keysIn.js"(exports, module) {
-    "use strict";
-    var arrayLikeKeys = require_arrayLikeKeys();
-    var baseKeysIn = require_baseKeysIn();
-    var isArrayLike = require_isArrayLike();
-    function keysIn(object) {
-      return isArrayLike(object) ? arrayLikeKeys(object, true) : baseKeysIn(object);
-    }
-    module.exports = keysIn;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/toPlainObject.js
-var require_toPlainObject = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/toPlainObject.js"(exports, module) {
-    "use strict";
-    var copyObject = require_copyObject();
-    var keysIn = require_keysIn();
-    function toPlainObject(value) {
-      return copyObject(value, keysIn(value));
-    }
-    module.exports = toPlainObject;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseMergeDeep.js
-var require_baseMergeDeep = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseMergeDeep.js"(exports, module) {
-    "use strict";
-    var assignMergeValue = require_assignMergeValue();
-    var cloneBuffer = require_cloneBuffer();
-    var cloneTypedArray = require_cloneTypedArray();
-    var copyArray = require_copyArray();
-    var initCloneObject = require_initCloneObject();
-    var isArguments = require_isArguments();
-    var isArray = require_isArray();
-    var isArrayLikeObject = require_isArrayLikeObject();
-    var isBuffer = require_isBuffer();
-    var isFunction = require_isFunction();
-    var isObject = require_isObject();
-    var isPlainObject = require_isPlainObject();
-    var isTypedArray = require_isTypedArray();
-    var safeGet = require_safeGet();
-    var toPlainObject = require_toPlainObject();
-    function baseMergeDeep(object, source, key, srcIndex, mergeFunc, customizer, stack) {
-      var objValue = safeGet(object, key), srcValue = safeGet(source, key), stacked = stack.get(srcValue);
-      if (stacked) {
-        assignMergeValue(object, key, stacked);
-        return;
-      }
-      var newValue = customizer ? customizer(objValue, srcValue, key + "", object, source, stack) : void 0;
-      var isCommon = newValue === void 0;
-      if (isCommon) {
-        var isArr = isArray(srcValue), isBuff = !isArr && isBuffer(srcValue), isTyped = !isArr && !isBuff && isTypedArray(srcValue);
-        newValue = srcValue;
-        if (isArr || isBuff || isTyped) {
-          if (isArray(objValue)) {
-            newValue = objValue;
-          } else if (isArrayLikeObject(objValue)) {
-            newValue = copyArray(objValue);
-          } else if (isBuff) {
-            isCommon = false;
-            newValue = cloneBuffer(srcValue, true);
-          } else if (isTyped) {
-            isCommon = false;
-            newValue = cloneTypedArray(srcValue, true);
-          } else {
-            newValue = [];
-          }
-        } else if (isPlainObject(srcValue) || isArguments(srcValue)) {
-          newValue = objValue;
-          if (isArguments(objValue)) {
-            newValue = toPlainObject(objValue);
-          } else if (!isObject(objValue) || isFunction(objValue)) {
-            newValue = initCloneObject(srcValue);
-          }
-        } else {
-          isCommon = false;
-        }
-      }
-      if (isCommon) {
-        stack.set(srcValue, newValue);
-        mergeFunc(newValue, srcValue, srcIndex, customizer, stack);
-        stack["delete"](srcValue);
-      }
-      assignMergeValue(object, key, newValue);
-    }
-    module.exports = baseMergeDeep;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseMerge.js
-var require_baseMerge = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseMerge.js"(exports, module) {
-    "use strict";
-    var Stack = require_Stack();
-    var assignMergeValue = require_assignMergeValue();
-    var baseFor = require_baseFor();
-    var baseMergeDeep = require_baseMergeDeep();
-    var isObject = require_isObject();
-    var keysIn = require_keysIn();
-    var safeGet = require_safeGet();
-    function baseMerge(object, source, srcIndex, customizer, stack) {
-      if (object === source) {
-        return;
-      }
-      baseFor(source, function(srcValue, key) {
-        stack || (stack = new Stack());
-        if (isObject(srcValue)) {
-          baseMergeDeep(object, source, key, srcIndex, baseMerge, customizer, stack);
-        } else {
-          var newValue = customizer ? customizer(safeGet(object, key), srcValue, key + "", object, source, stack) : void 0;
-          if (newValue === void 0) {
-            newValue = srcValue;
-          }
-          assignMergeValue(object, key, newValue);
-        }
-      }, keysIn);
-    }
-    module.exports = baseMerge;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/identity.js
-var require_identity = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/identity.js"(exports, module) {
-    "use strict";
-    function identity(value) {
-      return value;
-    }
-    module.exports = identity;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_apply.js
-var require_apply = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_apply.js"(exports, module) {
-    "use strict";
-    function apply(func, thisArg, args) {
-      switch (args.length) {
-        case 0:
-          return func.call(thisArg);
-        case 1:
-          return func.call(thisArg, args[0]);
-        case 2:
-          return func.call(thisArg, args[0], args[1]);
-        case 3:
-          return func.call(thisArg, args[0], args[1], args[2]);
-      }
-      return func.apply(thisArg, args);
-    }
-    module.exports = apply;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_overRest.js
-var require_overRest = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_overRest.js"(exports, module) {
-    "use strict";
-    var apply = require_apply();
-    var nativeMax = Math.max;
-    function overRest(func, start, transform) {
-      start = nativeMax(start === void 0 ? func.length - 1 : start, 0);
-      return function() {
-        var args = arguments, index = -1, length = nativeMax(args.length - start, 0), array = Array(length);
-        while (++index < length) {
-          array[index] = args[start + index];
-        }
-        index = -1;
-        var otherArgs = Array(start + 1);
-        while (++index < start) {
-          otherArgs[index] = args[index];
-        }
-        otherArgs[start] = transform(array);
-        return apply(func, this, otherArgs);
-      };
-    }
-    module.exports = overRest;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/constant.js
-var require_constant = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/constant.js"(exports, module) {
-    "use strict";
-    function constant(value) {
-      return function() {
-        return value;
-      };
-    }
-    module.exports = constant;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseSetToString.js
-var require_baseSetToString = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseSetToString.js"(exports, module) {
-    "use strict";
-    var constant = require_constant();
-    var defineProperty = require_defineProperty();
-    var identity = require_identity();
-    var baseSetToString = !defineProperty ? identity : function(func, string) {
-      return defineProperty(func, "toString", {
-        "configurable": true,
-        "enumerable": false,
-        "value": constant(string),
-        "writable": true
-      });
-    };
-    module.exports = baseSetToString;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_shortOut.js
-var require_shortOut = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_shortOut.js"(exports, module) {
-    "use strict";
-    var HOT_COUNT = 800;
-    var HOT_SPAN = 16;
-    var nativeNow = Date.now;
-    function shortOut(func) {
-      var count = 0, lastCalled = 0;
-      return function() {
-        var stamp = nativeNow(), remaining = HOT_SPAN - (stamp - lastCalled);
-        lastCalled = stamp;
-        if (remaining > 0) {
-          if (++count >= HOT_COUNT) {
-            return arguments[0];
-          }
-        } else {
-          count = 0;
-        }
-        return func.apply(void 0, arguments);
-      };
-    }
-    module.exports = shortOut;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_setToString.js
-var require_setToString = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_setToString.js"(exports, module) {
-    "use strict";
-    var baseSetToString = require_baseSetToString();
-    var shortOut = require_shortOut();
-    var setToString = shortOut(baseSetToString);
-    module.exports = setToString;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseRest.js
-var require_baseRest = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseRest.js"(exports, module) {
-    "use strict";
-    var identity = require_identity();
-    var overRest = require_overRest();
-    var setToString = require_setToString();
-    function baseRest(func, start) {
-      return setToString(overRest(func, start, identity), func + "");
-    }
-    module.exports = baseRest;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_isIterateeCall.js
-var require_isIterateeCall = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_isIterateeCall.js"(exports, module) {
-    "use strict";
-    var eq = require_eq2();
-    var isArrayLike = require_isArrayLike();
-    var isIndex = require_isIndex();
-    var isObject = require_isObject();
-    function isIterateeCall(value, index, object) {
-      if (!isObject(object)) {
-        return false;
-      }
-      var type = typeof index;
-      if (type == "number" ? isArrayLike(object) && isIndex(index, object.length) : type == "string" && index in object) {
-        return eq(object[index], value);
-      }
-      return false;
-    }
-    module.exports = isIterateeCall;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_createAssigner.js
-var require_createAssigner = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_createAssigner.js"(exports, module) {
-    "use strict";
-    var baseRest = require_baseRest();
-    var isIterateeCall = require_isIterateeCall();
-    function createAssigner(assigner) {
-      return baseRest(function(object, sources) {
-        var index = -1, length = sources.length, customizer = length > 1 ? sources[length - 1] : void 0, guard = length > 2 ? sources[2] : void 0;
-        customizer = assigner.length > 3 && typeof customizer == "function" ? (length--, customizer) : void 0;
-        if (guard && isIterateeCall(sources[0], sources[1], guard)) {
-          customizer = length < 3 ? void 0 : customizer;
-          length = 1;
-        }
-        object = Object(object);
-        while (++index < length) {
-          var source = sources[index];
-          if (source) {
-            assigner(object, source, index, customizer);
-          }
-        }
-        return object;
-      });
-    }
-    module.exports = createAssigner;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/merge.js
-var require_merge = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/merge.js"(exports, module) {
-    "use strict";
-    var baseMerge = require_baseMerge();
-    var createAssigner = require_createAssigner();
-    var merge3 = createAssigner(function(object, source, srcIndex) {
-      baseMerge(object, source, srcIndex);
-    });
-    module.exports = merge3;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseGet.js
-var require_baseGet = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseGet.js"(exports, module) {
-    "use strict";
-    var castPath = require_castPath();
-    var toKey = require_toKey();
-    function baseGet(object, path) {
-      path = castPath(path, object);
-      var index = 0, length = path.length;
-      while (object != null && index < length) {
-        object = object[toKey(path[index++])];
+        (key == "length" || // Node.js 0.10 has enumerable non-index properties on buffers.
+        isBuff && (key == "offset" || key == "parent") || // PhantomJS 2 has enumerable non-index properties on typed arrays.
+        isType && (key == "buffer" || key == "byteLength" || key == "byteOffset") || // Skip index properties.
+        isIndex(key, length)))) {
+          result.push(key);
+        }
       }
-      return index && index == length ? object : void 0;
-    }
-    module.exports = baseGet;
-  }
-});
-
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/get.js
-var require_get = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/get.js"(exports, module) {
-    "use strict";
-    var baseGet = require_baseGet();
-    function get3(object, path, defaultValue) {
-      var result = object == null ? void 0 : baseGet(object, path);
-      return result === void 0 ? defaultValue : result;
+      return result;
     }
-    module.exports = get3;
+    module.exports = arrayLikeKeys;
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isString.js
-var require_isString = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isString.js"(exports, module) {
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_isPrototype.js
+var require_isPrototype = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_isPrototype.js"(exports, module) {
     "use strict";
-    var baseGetTag = require_baseGetTag();
-    var isArray = require_isArray();
-    var isObjectLike = require_isObjectLike();
-    var stringTag = "[object String]";
-    function isString2(value) {
-      return typeof value == "string" || !isArray(value) && isObjectLike(value) && baseGetTag(value) == stringTag;
+    var objectProto = Object.prototype;
+    function isPrototype(value) {
+      var Ctor = value && value.constructor, proto = typeof Ctor == "function" && Ctor.prototype || objectProto;
+      return value === proto;
     }
-    module.exports = isString2;
+    module.exports = isPrototype;
   }
 });
 
-// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_arrayAggregator.js
-var require_arrayAggregator = __commonJS({
-  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_arrayAggregator.js"(exports, module) {
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_overArg.js
+var require_overArg = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_overArg.js"(exports, module) {
     "use strict";
-    function arrayAggregator(array, setter, iteratee, accumulator) {
-      var index = -1, length = array == null ? 0 : array.length;
-      while (++index < length) {
-        var value = array[index];
-        setter(accumulator, value, iteratee(value), array);
-      }
-      return accumulator;
+    function overArg(func, transform) {
+      return function(arg) {
+        return func(transform(arg));
+      };
     }
-    module.exports = arrayAggregator;
+    module.exports = overArg;
   }
 });
 
@@ -3942,6 +3234,19 @@ var require_baseKeys = __commonJS({
   }
 });
 
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isArrayLike.js
+var require_isArrayLike = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/isArrayLike.js"(exports, module) {
+    "use strict";
+    var isFunction = require_isFunction();
+    var isLength = require_isLength();
+    function isArrayLike(value) {
+      return value != null && isLength(value.length) && !isFunction(value);
+    }
+    module.exports = isArrayLike;
+  }
+});
+
 // ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/keys.js
 var require_keys = __commonJS({
   "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/keys.js"(exports, module) {
@@ -4021,6 +3326,104 @@ var require_baseAggregator = __commonJS({
   }
 });
 
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackClear.js
+var require_stackClear = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackClear.js"(exports, module) {
+    "use strict";
+    var ListCache = require_ListCache();
+    function stackClear() {
+      this.__data__ = new ListCache();
+      this.size = 0;
+    }
+    module.exports = stackClear;
+  }
+});
+
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackDelete.js
+var require_stackDelete = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackDelete.js"(exports, module) {
+    "use strict";
+    function stackDelete(key) {
+      var data = this.__data__, result = data["delete"](key);
+      this.size = data.size;
+      return result;
+    }
+    module.exports = stackDelete;
+  }
+});
+
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackGet.js
+var require_stackGet = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackGet.js"(exports, module) {
+    "use strict";
+    function stackGet(key) {
+      return this.__data__.get(key);
+    }
+    module.exports = stackGet;
+  }
+});
+
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackHas.js
+var require_stackHas = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackHas.js"(exports, module) {
+    "use strict";
+    function stackHas(key) {
+      return this.__data__.has(key);
+    }
+    module.exports = stackHas;
+  }
+});
+
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackSet.js
+var require_stackSet = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_stackSet.js"(exports, module) {
+    "use strict";
+    var ListCache = require_ListCache();
+    var Map2 = require_Map();
+    var MapCache = require_MapCache();
+    var LARGE_ARRAY_SIZE = 200;
+    function stackSet(key, value) {
+      var data = this.__data__;
+      if (data instanceof ListCache) {
+        var pairs = data.__data__;
+        if (!Map2 || pairs.length < LARGE_ARRAY_SIZE - 1) {
+          pairs.push([key, value]);
+          this.size = ++data.size;
+          return this;
+        }
+        data = this.__data__ = new MapCache(pairs);
+      }
+      data.set(key, value);
+      this.size = data.size;
+      return this;
+    }
+    module.exports = stackSet;
+  }
+});
+
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Stack.js
+var require_Stack = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Stack.js"(exports, module) {
+    "use strict";
+    var ListCache = require_ListCache();
+    var stackClear = require_stackClear();
+    var stackDelete = require_stackDelete();
+    var stackGet = require_stackGet();
+    var stackHas = require_stackHas();
+    var stackSet = require_stackSet();
+    function Stack(entries) {
+      var data = this.__data__ = new ListCache(entries);
+      this.size = data.size;
+    }
+    Stack.prototype.clear = stackClear;
+    Stack.prototype["delete"] = stackDelete;
+    Stack.prototype.get = stackGet;
+    Stack.prototype.has = stackHas;
+    Stack.prototype.set = stackSet;
+    module.exports = Stack;
+  }
+});
+
 // ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_setCacheAdd.js
 var require_setCacheAdd = __commonJS({
   "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_setCacheAdd.js"(exports, module) {
@@ -4149,6 +3552,16 @@ var require_equalArrays = __commonJS({
   }
 });
 
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Uint8Array.js
+var require_Uint8Array = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_Uint8Array.js"(exports, module) {
+    "use strict";
+    var root = require_root();
+    var Uint8Array2 = root.Uint8Array;
+    module.exports = Uint8Array2;
+  }
+});
+
 // ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_mapToArray.js
 var require_mapToArray = __commonJS({
   "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_mapToArray.js"(exports, module) {
@@ -4733,7 +4146,7 @@ var require_baseMatchesProperty = __commonJS({
   "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseMatchesProperty.js"(exports, module) {
     "use strict";
     var baseIsEqual = require_baseIsEqual();
-    var get3 = require_get();
+    var get2 = require_get();
     var hasIn = require_hasIn();
     var isKey = require_isKey();
     var isStrictComparable = require_isStrictComparable();
@@ -4746,7 +4159,7 @@ var require_baseMatchesProperty = __commonJS({
         return matchesStrictComparable(toKey(path), srcValue);
       }
       return function(object) {
-        var objValue = get3(object, path);
+        var objValue = get2(object, path);
         return objValue === void 0 && objValue === srcValue ? hasIn(object, path) : baseIsEqual(srcValue, objValue, COMPARE_PARTIAL_FLAG | COMPARE_UNORDERED_FLAG);
       };
     }
@@ -4754,6 +4167,17 @@ var require_baseMatchesProperty = __commonJS({
   }
 });
 
+// ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/identity.js
+var require_identity = __commonJS({
+  "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/identity.js"(exports, module) {
+    "use strict";
+    function identity(value) {
+      return value;
+    }
+    module.exports = identity;
+  }
+});
+
 // ../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseProperty.js
 var require_baseProperty = __commonJS({
   "../../node_modules/.pnpm/lodash@4.17.21/node_modules/lodash/_baseProperty.js"(exports, module) {
@@ -4863,7 +4287,7 @@ import { Command } from "commander";
 
 // package.json
 var description = "A tool for releasing front-end projects, supporting multiple release modes and configurations, simplifying the release process and improving efficiency.";
-var version = "2.3.5";
+var version = "3.1.0";
 
 // src/cli.ts
 var import_semver = __toESM(require_semver2(), 1);
@@ -4890,10 +4314,7 @@ function tuple(plugin, ...args) {
 import { AsyncExecutor } from "@qlover/fe-corekit";
 
 // src/implments/ReleaseContext.ts
-var import_merge = __toESM(require_merge(), 1);
 var import_get = __toESM(require_get(), 1);
-import { FeScriptContext } from "@qlover/scripts-context";
-import { Env } from "@qlover/env-loader";
 
 // src/defaults.ts
 var DEFAULT_SOURCE_BRANCH = "master";
@@ -4907,68 +4328,169 @@ var WORKSPACE_VERSION_SEPARATOR = "@";
 var BATCH_PR_BODY = "\n## ${name} ${version}\n${changelog}\n";
 
 // src/implments/ReleaseContext.ts
-var DEFAULT_ENV_ORDER = [".env.local", ".env"];
-var ReleaseContext = class extends FeScriptContext {
-  _env;
+import {
+  ScriptContext
+} from "@qlover/scripts-context";
+var ReleaseContext = class extends ScriptContext {
   /**
-   * Shared Config
+   * Creates a new ReleaseContext instance
+   *
+   * Initializes the context with provided options and sets up
+   * default values for required configuration:
+   * - rootPath: Defaults to current working directory
+   * - sourceBranch: Uses environment variables or default
+   * - releaseEnv: Uses environment variables or 'development'
+   *
+   * Environment Variable Priority:
+   * - sourceBranch: FE_RELEASE_BRANCH > FE_RELEASE_SOURCE_BRANCH > DEFAULT_SOURCE_BRANCH
+   * - releaseEnv: FE_RELEASE_ENV > NODE_ENV > 'development'
+   *
+   * @param name - Unique identifier for this release context
+   * @param options - Configuration options
+   *
+   * @example
+   * ```typescript
+   * const context = new ReleaseContext('web-app', {
+   *   rootPath: '/projects/web-app',
+   *   sourceBranch: 'main',
+   *   releaseEnv: 'production'
+   * });
+   * ```
    */
-  shared;
-  constructor(context) {
-    super(context);
-    this._env = Env.searchEnv({
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      logger: this.logger,
-      preloadList: this.feConfig.envOrder || DEFAULT_ENV_ORDER
-    });
-    this.shared = Object.assign(
-      {},
-      this.feConfig.release,
-      this.getDefaultShreadOptions(context.shared)
-    );
-  }
-  getDefaultShreadOptions(props) {
-    return {
-      rootPath: process.cwd(),
-      // use currentBranch by default
-      sourceBranch: this._env.get("FE_RELEASE_BRANCH") || this._env.get("FE_RELEASE_SOURCE_BRANCH") || DEFAULT_SOURCE_BRANCH,
-      releaseEnv: this._env.get("FE_RELEASE_ENV") || this._env.get("NODE_ENV") || "development",
-      ...props
-    };
+  constructor(name, options) {
+    super(name, options);
+    if (!this.options.rootPath) {
+      this.setOptions({ rootPath: process.cwd() });
+    }
+    if (!this.options.sourceBranch) {
+      this.setOptions({
+        sourceBranch: this.env.get("FE_RELEASE_BRANCH") || this.env.get("FE_RELEASE_SOURCE_BRANCH") || DEFAULT_SOURCE_BRANCH
+      });
+    }
+    if (!this.options.releaseEnv) {
+      this.setOptions({
+        releaseEnv: this.env.get("FE_RELEASE_ENV") || this.env.get("NODE_ENV") || "development"
+      });
+    }
   }
+  /**
+   * Gets the root path of the project
+   *
+   * @returns Absolute path to project root
+   *
+   * @example
+   * ```typescript
+   * const root = context.rootPath;
+   * // '/path/to/project'
+   * ```
+   */
   get rootPath() {
-    return this.shared.rootPath;
+    return this.getOptions("rootPath");
   }
+  /**
+   * Gets the source branch for the release
+   *
+   * @returns Branch name to use as source
+   *
+   * @example
+   * ```typescript
+   * const branch = context.sourceBranch;
+   * // 'main' or custom branch name
+   * ```
+   */
   get sourceBranch() {
-    return this.shared.sourceBranch;
+    return this.getOptions("sourceBranch");
   }
+  /**
+   * Gets the release environment
+   *
+   * @returns Environment name (e.g., 'development', 'production')
+   *
+   * @example
+   * ```typescript
+   * const env = context.releaseEnv;
+   * // 'development' or custom environment
+   * ```
+   */
   get releaseEnv() {
-    return this.shared.releaseEnv;
-  }
-  get env() {
-    return this._env;
+    return this.getOptions("releaseEnv");
   }
+  /**
+   * Gets all configured workspaces
+   *
+   * @returns Array of workspace configurations or undefined
+   *
+   * @example
+   * ```typescript
+   * const allWorkspaces = context.workspaces;
+   * // [{ name: 'pkg-a', version: '1.0.0', ... }]
+   * ```
+   */
   get workspaces() {
-    return this.getConfig("workspaces.workspaces");
+    return this.getOptions("workspaces.workspaces");
   }
+  /**
+   * Gets the current active workspace
+   *
+   * @returns Current workspace configuration or undefined
+   *
+   * @example
+   * ```typescript
+   * const current = context.workspace;
+   * // { name: 'pkg-a', version: '1.0.0', ... }
+   * ```
+   */
   get workspace() {
-    return this.getConfig("workspaces.workspace");
+    return this.getOptions("workspaces.workspace");
   }
+  /**
+   * Sets the workspace configurations
+   *
+   * Updates the workspace list while preserving other workspace settings
+   *
+   * @param workspaces - Array of workspace configurations
+   *
+   * @example
+   * ```typescript
+   * context.setWorkspaces([{
+   *   name: 'pkg-a',
+   *   version: '1.0.0',
+   *   path: 'packages/a'
+   * }]);
+   * ```
+   */
   setWorkspaces(workspaces) {
     this.options.workspaces = {
       ...this.options.workspaces,
       workspaces
     };
   }
-  setConfig(config) {
-    this.options = (0, import_merge.default)(this.options, config);
-  }
-  getConfig(key, defaultValue) {
-    return (0, import_get.default)(this.options, key, defaultValue);
-  }
-  setShared(shared) {
-    this.shared = (0, import_merge.default)(this.shared, shared);
-  }
+  /**
+   * Gets package.json data for the current workspace
+   *
+   * Provides type-safe access to package.json fields with optional
+   * path and default value support.
+   *
+   * @param key - Optional dot-notation path to specific field
+   * @param defaultValue - Default value if field not found
+   * @returns Package data of type T
+   * @throws Error if package.json not found
+   *
+   * @example Basic usage
+   * ```typescript
+   * // Get entire package.json
+   * const pkg = context.getPkg();
+   *
+   * // Get specific field
+   * const version = context.getPkg<string>('version');
+   *
+   * // Get nested field with default
+   * const script = context.getPkg<string>(
+   *   'scripts.build',
+   *   'echo "No build script"'
+   * );
+   * ```
+   */
   getPkg(key, defaultValue) {
     const packageJson = this.workspace?.packageJson;
     if (!packageJson) {
@@ -4979,9 +4501,31 @@ var ReleaseContext = class extends FeScriptContext {
     }
     return (0, import_get.default)(packageJson, key, defaultValue);
   }
+  /**
+   * Generates template context for string interpolation
+   *
+   * Combines context options, workspace data, and specific paths
+   * for use in template processing. Includes deprecated fields
+   * for backward compatibility.
+   *
+   * @returns Combined template context
+   *
+   * @example
+   * ```typescript
+   * const context = releaseContext.getTemplateContext();
+   * // {
+   * //   publishPath: 'packages/my-pkg',
+   * //   env: 'production',        // deprecated
+   * //   branch: 'main',          // deprecated
+   * //   releaseEnv: 'production', // use this instead
+   * //   sourceBranch: 'main',    // use this instead
+   * //   ...other options
+   * // }
+   * ```
+   */
   getTemplateContext() {
     return {
-      ...this.shared,
+      ...this.getOptions(),
       ...this.workspace,
       publishPath: this.workspace?.path || "",
       // deprecated
@@ -4989,6 +4533,28 @@ var ReleaseContext = class extends FeScriptContext {
       branch: this.sourceBranch
     };
   }
+  /**
+   * Executes changeset CLI commands
+   *
+   * Automatically detects and uses appropriate package manager
+   * (pnpm or npx) to run changeset commands.
+   *
+   * @param name - Changeset command name
+   * @param args - Optional command arguments
+   * @returns Command output
+   *
+   * @example Version bump
+   * ```typescript
+   * // Bump version with snapshot
+   * await context.runChangesetsCli('version', ['--snapshot', 'alpha']);
+   *
+   * // Create new changeset
+   * await context.runChangesetsCli('add');
+   *
+   * // Status check
+   * await context.runChangesetsCli('status');
+   * ```
+   */
   async runChangesetsCli(name, args) {
     let packageManager = "pnpm";
     try {
@@ -5006,6 +4572,7 @@ var ReleaseContext = class extends FeScriptContext {
 };
 
 // src/implments/ReleaseParams.ts
+import { Shell } from "@qlover/scripts-context";
 var DEFAULT_RELEASE_CONFIG = {
   maxWorkspace: MAX_WORKSPACE,
   multiWorkspaceSeparator: MULTI_WORKSPACE_SEPARATOR,
@@ -5014,22 +4581,85 @@ var DEFAULT_RELEASE_CONFIG = {
   batchTagName: "batch-${length}-packages-${timestamp}"
 };
 var ReleaseParams = class {
-  constructor(shell, logger, config = {}) {
-    this.shell = shell;
+  /**
+   * Creates a new ReleaseParams instance
+   *
+   * Initializes with logger for debug output and optional configuration
+   * overrides. Uses default configuration values for any unspecified options.
+   *
+   * @param logger - Logger instance for debug output
+   * @param config - Optional configuration overrides
+   *
+   * @example
+   * ```typescript
+   * // Basic initialization
+   * const params = new ReleaseParams(logger);
+   *
+   * // With custom configuration
+   * const params = new ReleaseParams(logger, {
+   *   maxWorkspace: 5,
+   *   multiWorkspaceSeparator: '-',
+   *   workspaceVersionSeparator: '#'
+   * });
+   * ```
+   */
+  constructor(logger, config = {}) {
     this.logger = logger;
     this.config = {
       ...DEFAULT_RELEASE_CONFIG,
       ...config
     };
   }
+  /**
+   * Current configuration
+   * @private
+   */
   config;
+  /**
+   * Generates a release branch name for a single package
+   *
+   * Uses the branch name template from shared configuration or
+   * falls back to the default template 'release-${tagName}'.
+   * Supports variable interpolation in the template.
+   *
+   * Template Variables:
+   * - ${pkgName}: Package name
+   * - ${releaseName}: Release name (same as pkgName)
+   * - ${tagName}: Release tag
+   * - All shared config properties
+   *
+   * @param releaseName - Name of the package being released
+   * @param tagName - Version tag for the release
+   * @param shared - Shared configuration with branch template
+   * @returns Formatted branch name
+   * @throws Error if branch name template is not a string
+   *
+   * @example
+   * ```typescript
+   * // With default template
+   * const branch = params.getReleaseBranchName(
+   *   'my-pkg',
+   *   'v1.0.0',
+   *   {}
+   * );
+   * // 'release-v1.0.0'
+   *
+   * // With custom template
+   * const branch = params.getReleaseBranchName(
+   *   'my-pkg',
+   *   'v1.0.0',
+   *   { branchName: '${pkgName}-release-${tagName}' }
+   * );
+   * // 'my-pkg-release-v1.0.0'
+   * ```
+   */
   getReleaseBranchName(releaseName, tagName, shared) {
     const branchNameTpl = shared.branchName || "release-${tagName}";
     if (typeof branchNameTpl !== "string") {
       throw new Error("Branch name template is not a string");
     }
     this.logger.debug("Release Branch template is:", branchNameTpl);
-    return this.shell.format(branchNameTpl, {
+    return Shell.format(branchNameTpl, {
       pkgName: releaseName,
       releaseName,
       tagName,
@@ -5037,13 +4667,56 @@ var ReleaseParams = class {
       ...shared
     });
   }
+  /**
+   * Generates a release branch name for multiple packages
+   *
+   * Uses the batch branch name template from configuration.
+   * Supports variable interpolation with additional batch-specific
+   * variables.
+   *
+   * Template Variables:
+   * - ${pkgName}: Package name
+   * - ${releaseName}: Combined release name
+   * - ${tagName}: Combined tag name
+   * - ${length}: Number of packages
+   * - ${timestamp}: Current timestamp
+   * - All shared config properties
+   *
+   * @param releaseName - Combined name of packages
+   * @param tagName - Combined version tag
+   * @param shared - Shared configuration
+   * @param length - Number of packages in batch
+   * @returns Formatted batch branch name
+   * @throws Error if branch name template is not a string
+   *
+   * @example
+   * ```typescript
+   * // With default template
+   * const branch = params.getBatchReleaseBranchName(
+   *   'pkg-a@1.0.0_pkg-b@2.0.0',
+   *   'batch-2-packages-1234567890',
+   *   {},
+   *   2
+   * );
+   * // 'batch-pkg-a@1.0.0_pkg-b@2.0.0-2-packages-1234567890'
+   *
+   * // With custom template
+   * const branch = params.getBatchReleaseBranchName(
+   *   'pkg-a@1.0.0_pkg-b@2.0.0',
+   *   'v1.0.0',
+   *   {},
+   *   2,
+   * );
+   * // Custom formatted branch name
+   * ```
+   */
   getBatchReleaseBranchName(releaseName, tagName, shared, length) {
     const branchNameTpl = this.config.batchBranchName;
     if (typeof branchNameTpl !== "string") {
       throw new Error("Branch name template is not a string");
     }
     this.logger.debug("Release Batch Branch template is:", branchNameTpl);
-    return this.shell.format(branchNameTpl, {
+    return Shell.format(branchNameTpl, {
       pkgName: releaseName,
       releaseName,
       tagName,
@@ -5053,6 +4726,45 @@ var ReleaseParams = class {
       timestamp: Date.now()
     });
   }
+  /**
+   * Generates a release name from workspace configurations
+   *
+   * For single packages, returns the package name.
+   * For multiple packages, combines names and versions up to
+   * the configured maximum number of workspaces.
+   *
+   * Format:
+   * - Single: packageName
+   * - Multiple: pkg1@1.0.0_pkg2@2.0.0_pkg3@3.0.0
+   *
+   * @param composeWorkspaces - Array of workspace configurations
+   * @returns Formatted release name
+   *
+   * @example
+   * ```typescript
+   * // Single package
+   * const name = params.getReleaseName([
+   *   { name: 'pkg-a', version: '1.0.0' }
+   * ]);
+   * // 'pkg-a'
+   *
+   * // Multiple packages
+   * const name = params.getReleaseName([
+   *   { name: 'pkg-a', version: '1.0.0' },
+   *   { name: 'pkg-b', version: '2.0.0' }
+   * ]);
+   * // 'pkg-a@1.0.0_pkg-b@2.0.0'
+   *
+   * // With max limit
+   * const name = params.getReleaseName([
+   *   { name: 'pkg-a', version: '1.0.0' },
+   *   { name: 'pkg-b', version: '2.0.0' },
+   *   { name: 'pkg-c', version: '3.0.0' },
+   *   { name: 'pkg-d', version: '4.0.0' }
+   * ]);
+   * // Only first 3: 'pkg-a@1.0.0_pkg-b@2.0.0_pkg-c@3.0.0'
+   * ```
+   */
   getReleaseName(composeWorkspaces) {
     if (composeWorkspaces.length === 1) {
       return composeWorkspaces[0].name;
@@ -5062,16 +4774,84 @@ var ReleaseParams = class {
       ({ name, version: version2 }) => `${name}${workspaceVersionSeparator}${version2}`
     ).join(multiWorkspaceSeparator);
   }
+  /**
+   * Generates a tag name for the release
+   *
+   * For single packages, uses the package version.
+   * For multiple packages, generates a batch tag name using
+   * the configured template.
+   *
+   * Format:
+   * - Single: version
+   * - Multiple: batch-${length}-packages-${timestamp}
+   *
+   * @param composeWorkspaces - Array of workspace configurations
+   * @returns Formatted tag name
+   *
+   * @example
+   * ```typescript
+   * // Single package
+   * const tag = params.getReleaseTagName([
+   *   { name: 'pkg-a', version: '1.0.0' }
+   * ]);
+   * // '1.0.0'
+   *
+   * // Multiple packages
+   * const tag = params.getReleaseTagName([
+   *   { name: 'pkg-a', version: '1.0.0' },
+   *   { name: 'pkg-b', version: '2.0.0' }
+   * ]);
+   * // 'batch-2-packages-1234567890'
+   * ```
+   */
   getReleaseTagName(composeWorkspaces) {
     if (composeWorkspaces.length === 1) {
       return composeWorkspaces[0].version;
     }
     const { batchTagName } = this.config;
-    return this.shell.format(batchTagName, {
+    return Shell.format(batchTagName, {
       length: composeWorkspaces.length,
       timestamp: Date.now()
     });
   }
+  /**
+   * Generates branch and tag parameters for the release
+   *
+   * Combines the generation of branch name and tag name into
+   * a single operation. Handles both single and multi-package
+   * releases appropriately.
+   *
+   * @param composeWorkspaces - Array of workspace configurations
+   * @param shared - Shared configuration
+   * @returns Object containing tag name and branch name
+   *
+   * @example Single package
+   * ```typescript
+   * const params = releaseParams.getReleaseBranchParams(
+   *   [{ name: 'pkg-a', version: '1.0.0' }],
+   *   { branchName: 'release-${tagName}' }
+   * );
+   * // {
+   * //   tagName: '1.0.0',
+   * //   releaseBranch: 'release-1.0.0'
+   * // }
+   * ```
+   *
+   * @example Multiple packages
+   * ```typescript
+   * const params = releaseParams.getReleaseBranchParams(
+   *   [
+   *     { name: 'pkg-a', version: '1.0.0' },
+   *     { name: 'pkg-b', version: '2.0.0' }
+   *   ],
+   *   {}
+   * );
+   * // {
+   * //   tagName: 'batch-2-packages-1234567890',
+   * //   releaseBranch: 'batch-pkg-a@1.0.0_pkg-b@2.0.0-2-packages-1234567890'
+   * // }
+   * ```
+   */
   getReleaseBranchParams(composeWorkspaces, shared) {
     const releaseTagName = this.getReleaseTagName(composeWorkspaces);
     const releaseName = this.getReleaseName(composeWorkspaces);
@@ -5086,24 +4866,125 @@ var ReleaseParams = class {
       releaseBranch: releaseBranchName
     };
   }
+  /**
+   * Generates a title for the release pull request
+   *
+   * Uses the configured PR title template or falls back to the default.
+   * Supports variable interpolation with release parameters and context.
+   *
+   * Template Variables:
+   * - ${tagName}: Release tag name
+   * - ${pkgName}: Package/branch name
+   * - All template context properties
+   *
+   * @param releaseBranchParams - Release branch parameters
+   * @param context - Template context for variable interpolation
+   * @returns Formatted PR title
+   *
+   * @example
+   * ```typescript
+   * // With default template
+   * const title = params.getPRTitle(
+   *   {
+   *     tagName: '1.0.0',
+   *     releaseBranch: 'release-1.0.0'
+   *   },
+   *   {
+   *     env: 'production',
+   *     pkgName: 'my-package'
+   *   }
+   * );
+   * // 'Release production my-package 1.0.0'
+   *
+   * // With custom template
+   * const title = params.getPRTitle(
+   *   {
+   *     tagName: '1.0.0',
+   *     releaseBranch: 'release-1.0.0'
+   *   },
+   *   {
+   *     env: 'staging',
+   *     pkgName: 'my-package'
+   *   }
+   * );
+   * // Custom formatted title
+   * ```
+   */
   getPRTitle(releaseBranchParams, context) {
     const prTitleTpl = this.config.PRTitle || DEFAULT_PR_TITLE;
-    return this.shell.format(prTitleTpl, {
+    return Shell.format(prTitleTpl, {
       ...context,
       tagName: releaseBranchParams.tagName,
       pkgName: releaseBranchParams.releaseBranch
     });
   }
   /**
-   * Gets the body for the release pull request.
+   * Generates the body content for the release pull request
+   *
+   * Handles both single and multi-package releases, combining
+   * changelogs appropriately. For batch releases, formats each
+   * package's changelog according to the batch template.
    *
-   * @param options - The options containing tag name and changelog.
-   * @returns The formatted release pull request body.
+   * Template Variables:
+   * - ${tagName}: Release tag or combined workspace versions
+   * - ${changelog}: Single changelog or combined batch changelogs
+   * - All template context properties
+   *
+   * @param composeWorkspaces - Array of workspace configurations
+   * @param releaseBranchParams - Release branch parameters
+   * @param context - Template context for variable interpolation
+   * @returns Formatted PR body content
+   *
+   * @example Single package
+   * ```typescript
+   * const body = params.getPRBody(
+   *   [{
+   *     name: 'pkg-a',
+   *     version: '1.0.0',
+   *     changelog: '- Feature: New functionality\n- Fix: Bug fix'
+   *   }],
+   *   {
+   *     tagName: '1.0.0',
+   *     releaseBranch: 'release-1.0.0'
+   *   },
+   *   context
+   * );
+   * // Custom formatted body with single changelog
+   * ```
+   *
+   * @example Multiple packages
+   * ```typescript
+   * const body = params.getPRBody(
+   *   [
+   *     {
+   *       name: 'pkg-a',
+   *       version: '1.0.0',
+   *       changelog: '- Feature: Package A changes'
+   *     },
+   *     {
+   *       name: 'pkg-b',
+   *       version: '2.0.0',
+   *       changelog: '- Feature: Package B changes'
+   *     }
+   *   ],
+   *   {
+   *     tagName: 'batch-2-packages-1234567890',
+   *     releaseBranch: 'batch-release'
+   *   },
+   *   context
+   * );
+   * // Formatted body with combined changelogs:
+   * // ## pkg-a 1.0.0
+   * // - Feature: Package A changes
+   * //
+   * // ## pkg-b 2.0.0
+   * // - Feature: Package B changes
+   * ```
    */
   getPRBody(composeWorkspaces, releaseBranchParams, context) {
     const PRBodyTpl = this.config.PRBody;
     const changelog = composeWorkspaces.length > 1 ? composeWorkspaces.map((workspace) => {
-      return this.shell.format(
+      return Shell.format(
         BATCH_PR_BODY,
         workspace
       );
@@ -5112,7 +4993,7 @@ var ReleaseParams = class {
     const tagName = composeWorkspaces.length === 1 ? releaseBranchParams.tagName : composeWorkspaces.map(
       (workspace) => `${workspace.name}${workspaceVersionSeparator}${workspace.version}`
     ).join(" ");
-    return this.shell.format(PRBodyTpl, {
+    return Shell.format(PRBodyTpl, {
       ...context,
       tagName,
       changelog
@@ -5121,14 +5002,41 @@ var ReleaseParams = class {
 };
 
 // src/plugins/githubPR/GithubManager.ts
+import { Shell as Shell2 } from "@qlover/scripts-context";
 import { Octokit } from "@octokit/rest";
 var GithubManager = class {
+  /**
+   * Creates a new GithubManager instance
+   *
+   * @param context - Release context containing configuration
+   *
+   * @example
+   * ```typescript
+   * const manager = new GithubManager(context);
+   * ```
+   */
   constructor(context) {
     this.context = context;
   }
+  /** Lazy-loaded Octokit instance */
   _octokit = null;
+  /**
+   * Gets GitHub repository information
+   *
+   * Retrieves the owner and repository name from the context.
+   * This information is required for most GitHub API operations.
+   *
+   * @returns Repository owner and name
+   * @throws Error if owner or repo name is not set
+   *
+   * @example
+   * ```typescript
+   * const info = manager.getGitHubUserInfo();
+   * // { owner: 'org-name', repo: 'repo-name' }
+   * ```
+   */
   getGitHubUserInfo() {
-    const { authorName, repoName } = this.context.shared;
+    const { authorName, repoName } = this.context.getOptions();
     if (!authorName || !repoName) {
       throw new Error("Author name or repo name is not set");
     }
@@ -5137,8 +5045,30 @@ var GithubManager = class {
       repo: repoName
     };
   }
+  /**
+   * Gets GitHub API token
+   *
+   * Retrieves the GitHub API token from environment variables.
+   * The token name can be configured via the tokenRef option.
+   *
+   * @returns GitHub API token
+   * @throws Error if token is not set
+   *
+   * @example Default token
+   * ```typescript
+   * const token = manager.getToken();
+   * // Uses GITHUB_TOKEN env var
+   * ```
+   *
+   * @example Custom token
+   * ```typescript
+   * context.options.githubPR.tokenRef = 'CUSTOM_TOKEN';
+   * const token = manager.getToken();
+   * // Uses CUSTOM_TOKEN env var
+   * ```
+   */
   getToken() {
-    const { tokenRef = "GITHUB_TOKEN" } = this.context.getConfig("githubPR");
+    const { tokenRef = "GITHUB_TOKEN" } = this.context.getOptions("githubPR");
     const token = this.context.env.get(tokenRef);
     if (!token) {
       throw new Error(
@@ -5147,11 +5077,29 @@ var GithubManager = class {
     }
     return token;
   }
+  /**
+   * Gets Octokit instance
+   *
+   * Lazily initializes and returns an Octokit instance configured
+   * with the GitHub token and timeout settings.
+   *
+   * @returns Configured Octokit instance
+   * @throws Error if token retrieval fails
+   *
+   * @example
+   * ```typescript
+   * const octokit = manager.octokit;
+   * await octokit.rest.issues.create({
+   *   ...manager.getGitHubUserInfo(),
+   *   title: 'Issue title'
+   * });
+   * ```
+   */
   get octokit() {
     if (this._octokit) {
       return this._octokit;
     }
-    const { timeout } = this.context.getConfig("githubPR");
+    const { timeout } = this.context.getOptions("githubPR");
     const options = {
       auth: this.getToken(),
       request: {
@@ -5161,9 +5109,37 @@ var GithubManager = class {
     this._octokit = new Octokit(options);
     return this._octokit;
   }
+  /**
+   * Gets logger instance
+   *
+   * Provides access to the context's logger for consistent
+   * logging across the manager.
+   *
+   * @returns Logger instance
+   *
+   * @example
+   * ```typescript
+   * manager.logger.info('Creating release...');
+   * manager.logger.debug('API response:', response);
+   * ```
+   */
   get logger() {
     return this.context.logger;
   }
+  /**
+   * Gets shell interface
+   *
+   * Provides access to the context's shell interface for
+   * executing Git commands and other shell operations.
+   *
+   * @returns Shell interface
+   *
+   * @example
+   * ```typescript
+   * await manager.shell.exec('git fetch origin');
+   * await manager.shell.exec(['git', 'push', 'origin', 'main']);
+   * ```
+   */
   get shell() {
     return this.context.shell;
   }
@@ -5172,24 +5148,77 @@ var GithubManager = class {
    *
    * @default `squash`
    */
+  /**
+   * Gets auto-merge type for pull requests
+   *
+   * Determines how pull requests should be merged when
+   * auto-merge is enabled. Defaults to 'squash'.
+   *
+   * @returns Auto-merge type ('merge', 'squash', or 'rebase')
+   *
+   * @example
+   * ```typescript
+   * const mergeType = manager.autoMergeType;
+   * // 'squash' (default)
+   *
+   * context.options.autoMergeType = 'rebase';
+   * manager.autoMergeType; // 'rebase'
+   * ```
+   */
   get autoMergeType() {
-    return this.context.shared.autoMergeType || DEFAULT_AUTO_MERGE_TYPE;
+    return this.context.getOptions().autoMergeType || DEFAULT_AUTO_MERGE_TYPE;
   }
   /**
    * Dry run PR number
    *
    * @default `999999`
    */
+  /**
+   * Gets pull request number for dry runs
+   *
+   * Returns a placeholder PR number when running in dry-run mode.
+   * This allows testing PR-related functionality without creating
+   * actual pull requests.
+   *
+   * @returns Dry run PR number (default: '999999')
+   *
+   * @example
+   * ```typescript
+   * context.dryRun = true;
+   * const prNumber = manager.dryRunPRNumber;
+   * // '999999'
+   *
+   * context.options.githubPR.dryRunPRNumber = '123456';
+   * manager.dryRunPRNumber; // '123456'
+   * ```
+   */
   get dryRunPRNumber() {
-    return this.context.getConfig("githubPR.dryRunPRNumber", "999999");
+    return this.context.getOptions("githubPR.dryRunPRNumber", "999999");
   }
   /**
    * Auto merge release PR
    *
    * @default `false`
    */
+  /**
+   * Gets auto-merge setting for release PRs
+   *
+   * Determines whether release pull requests should be
+   * automatically merged after creation. Defaults to false.
+   *
+   * @returns True if auto-merge is enabled
+   *
+   * @example
+   * ```typescript
+   * const autoMerge = manager.autoMergeReleasePR;
+   * // false (default)
+   *
+   * context.options.autoMergeReleasePR = true;
+   * manager.autoMergeReleasePR; // true
+   * ```
+   */
   get autoMergeReleasePR() {
-    return this.context.shared.autoMergeReleasePR || DEFAULT_AUTO_MERGE_RELEASE_PR;
+    return this.context.getOptions("autoMergeReleasePR") || DEFAULT_AUTO_MERGE_RELEASE_PR;
   }
   /**
    * Automatically merges a pull request.
@@ -5197,6 +5226,30 @@ var GithubManager = class {
    * @param prNumber - The pull request number to merge.
    * @param releaseBranch - The branch to merge into.
    */
+  /**
+   * Merges a pull request
+   *
+   * Merges the specified pull request using the configured
+   * merge method. In dry-run mode, logs the merge action
+   * without performing it.
+   *
+   * @param prNumber - Pull request number
+   * @param releaseBranch - Branch to merge
+   * @throws Error if merge fails
+   *
+   * @example Basic merge
+   * ```typescript
+   * await manager.mergePR('123', 'release-1.0.0');
+   * // Merges PR #123 using configured merge method
+   * ```
+   *
+   * @example Dry run
+   * ```typescript
+   * context.dryRun = true;
+   * await manager.mergePR('123', 'release-1.0.0');
+   * // Logs merge action without performing it
+   * ```
+   */
   async mergePR(prNumber, releaseBranch) {
     if (!prNumber) {
       this.logger.error("Failed to create Pull Request.", prNumber);
@@ -5204,7 +5257,7 @@ var GithubManager = class {
     }
     const mergeMethod = this.autoMergeType;
     if (this.context.dryRun) {
-      const { repoName, authorName } = this.context.shared;
+      const { repoName, authorName } = this.context.getOptions();
       this.logger.info(
         `[DRY RUN] Would merge PR #${prNumber} with method '${mergeMethod}' in repo ${authorName}/${repoName}, branch ${releaseBranch}`
       );
@@ -5216,6 +5269,24 @@ var GithubManager = class {
       merge_method: mergeMethod
     });
   }
+  /**
+   * Gets commits from a pull request
+   *
+   * Retrieves all commits associated with the specified pull request.
+   * Useful for generating changelogs or analyzing changes.
+   *
+   * @param prNumber - Pull request number
+   * @returns Promise resolving to array of commit information
+   * @throws Error if request fails
+   *
+   * @example
+   * ```typescript
+   * const commits = await manager.getPullRequestCommits(123);
+   * commits.forEach(commit => {
+   *   console.log(commit.sha, commit.commit.message);
+   * });
+   * ```
+   */
   async getPullRequestCommits(prNumber) {
     const pr = await this.octokit.rest.pulls.listCommits({
       ...this.getGitHubUserInfo(),
@@ -5223,6 +5294,23 @@ var GithubManager = class {
     });
     return pr.data;
   }
+  /**
+   * Gets detailed information about a commit
+   *
+   * Retrieves detailed information about a specific commit,
+   * including files changed, author details, and commit message.
+   *
+   * @param commitSha - Commit SHA
+   * @returns Promise resolving to commit information
+   * @throws Error if request fails
+   *
+   * @example
+   * ```typescript
+   * const info = await manager.getCommitInfo('abc123');
+   * console.log(info.commit.message);
+   * console.log(info.files.map(f => f.filename));
+   * ```
+   */
   async getCommitInfo(commitSha) {
     const pr = await this.octokit.rest.repos.getCommit({
       ...this.getGitHubUserInfo(),
@@ -5230,6 +5318,24 @@ var GithubManager = class {
     });
     return pr.data;
   }
+  /**
+   * Gets pull request information
+   *
+   * Retrieves detailed information about a pull request,
+   * including title, body, labels, and review status.
+   *
+   * @param prNumber - Pull request number
+   * @returns Promise resolving to pull request information
+   * @throws Error if request fails
+   *
+   * @example
+   * ```typescript
+   * const pr = await manager.getPullRequest(123);
+   * console.log(pr.title);
+   * console.log(pr.labels.map(l => l.name));
+   * console.log(pr.mergeable_state);
+   * ```
+   */
   async getPullRequest(prNumber) {
     const pr = await this.octokit.rest.pulls.get({
       ...this.getGitHubUserInfo(),
@@ -5243,6 +5349,27 @@ var GithubManager = class {
    * @param prNumber - The pull request number to check.
    * @param releaseBranch - The branch to check against.
    */
+  /**
+   * Checks pull request status and cleans up
+   *
+   * Verifies pull request status and deletes the release branch
+   * if the PR has been merged. Used for post-merge cleanup.
+   *
+   * Process:
+   * 1. Verify PR exists and status
+   * 2. Delete release branch if PR merged
+   * 3. Log cleanup results
+   *
+   * @param prNumber - Pull request number
+   * @param releaseBranch - Branch to clean up
+   * @throws Error if verification or cleanup fails
+   *
+   * @example
+   * ```typescript
+   * await manager.checkedPR('123', 'release-1.0.0');
+   * // Verifies PR #123 and deletes release-1.0.0 if merged
+   * ```
+   */
   async checkedPR(prNumber, releaseBranch) {
     try {
       await this.getPullRequest(Number(prNumber));
@@ -5269,7 +5396,7 @@ var GithubManager = class {
    * @throws If the label is not valid or if the creation fails.
    */
   async createReleasePRLabel() {
-    const label = this.context.shared.label;
+    const label = this.context.getOptions().label;
     if (!label || !label.name || !label.description || !label.color) {
       throw new Error("Label is not valid, skipping creation");
     }
@@ -5304,7 +5431,7 @@ var GithubManager = class {
    * @throws If the creation fails or if the pull request already exists.
    */
   async createReleasePR(options) {
-    const dryRunCreatePR = this.context.getConfig("githubPR.dryRunCreatePR");
+    const dryRunCreatePR = this.context.getOptions("githubPR.dryRunCreatePR");
     if (dryRunCreatePR || this.context.dryRun) {
       this.logger.info(`[DRY RUN] Would create PR with:`, {
         ...options,
@@ -5343,10 +5470,55 @@ var GithubManager = class {
       throw error;
     }
   }
+  /**
+   * Truncates long PR/release body text
+   *
+   * GitHub has a limit on PR and release body length.
+   * This method ensures the text stays within limits by
+   * truncating if necessary.
+   *
+   * @param body - Body text to truncate
+   * @returns Truncated text (if > 124000 chars)
+   *
+   * @example
+   * ```typescript
+   * const body = manager.truncateBody(veryLongText);
+   * // Returns truncated text if > 124000 chars
+   * // Adds '...' to indicate truncation
+   * ```
+   * @private
+   */
   truncateBody(body) {
     if (body && body.length >= 124e3) return body.substring(0, 124e3) + "...";
     return body;
   }
+  /**
+   * Builds GitHub release options
+   *
+   * Combines default release options with provided overrides
+   * and context configuration. Handles formatting of release
+   * name, body, and other settings.
+   *
+   * @param options - Override options for release
+   * @returns Complete release options
+   *
+   * @example
+   * ```typescript
+   * const opts = manager.getOctokitReleaseOptions({
+   *   tag_name: 'v1.0.0',
+   *   body: 'Release notes...'
+   * });
+   * // Returns merged options with defaults:
+   * // {
+   * //   name: 'Release v1.0.0',
+   * //   body: 'Release notes...',
+   * //   draft: false,
+   * //   prerelease: false,
+   * //   ...
+   * // }
+   * ```
+   * @private
+   */
   getOctokitReleaseOptions(options) {
     const {
       releaseName,
@@ -5356,7 +5528,7 @@ var GithubManager = class {
       makeLatest = true,
       releaseNotes,
       discussionCategoryName = void 0
-    } = this.context.getConfig("githubPR");
+    } = this.context.getOptions("githubPR");
     const name = releaseName;
     const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes));
     return {
@@ -5372,12 +5544,43 @@ var GithubManager = class {
       ...this.getGitHubUserInfo()
     };
   }
+  /**
+   * Creates a GitHub release
+   *
+   * Creates a new GitHub release for a workspace with:
+   * - Formatted release name
+   * - Changelog as release notes
+   * - Proper tag
+   * - Configurable settings (draft, prerelease, etc.)
+   *
+   * Handles dry run mode and error cases gracefully.
+   *
+   * @param workspace - Workspace to create release for
+   * @throws Error if tag name is missing or creation fails
+   *
+   * @example Basic release
+   * ```typescript
+   * await manager.createRelease({
+   *   name: 'pkg-a',
+   *   version: '1.0.0',
+   *   tagName: 'v1.0.0',
+   *   changelog: '...'
+   * });
+   * ```
+   *
+   * @example Dry run
+   * ```typescript
+   * context.dryRun = true;
+   * await manager.createRelease(workspace);
+   * // Logs release info without creating
+   * ```
+   */
   async createRelease(workspace) {
     const meragedOptions = this.getOctokitReleaseOptions({
       tag_name: workspace.tagName,
       body: workspace.changelog
     });
-    meragedOptions.name = this.shell.format(
+    meragedOptions.name = Shell2.format(
       meragedOptions.name,
       workspace
     );
@@ -5391,110 +5594,56 @@ var GithubManager = class {
       throw new Error("TagName is undefined");
     }
     if (this.context.dryRun) {
-      return;
-    }
-    try {
-      const response = await this.octokit.repos.createRelease(meragedOptions);
-      this.logger.debug(
-        `[DONE] octokit repos.createRelease "${meragedOptions.name}" (${meragedOptions.tag_name}) (${response.headers.location})`
-      );
-    } catch (error) {
-      this.logger.error(
-        `[FAILED] octokit repos.createRelease "${meragedOptions.name}" (${meragedOptions.tag_name})`,
-        error
-      );
-    }
-  }
-};
-
-// src/plugins/GitBase.ts
-var import_isString = __toESM(require_isString(), 1);
-
-// src/plugins/Plugin.ts
-var import_merge2 = __toESM(require_merge(), 1);
-var import_get2 = __toESM(require_get(), 1);
-var Plugin = class {
-  constructor(context, pluginName, props = {}) {
-    this.context = context;
-    this.pluginName = pluginName;
-    this.props = props;
-    this.setConfig(this.getInitialProps(props));
-  }
-  onlyOne = true;
-  getInitialProps(props) {
-    const pluginConfig = this.context.options[this.pluginName];
-    const fileConfig = (0, import_get2.default)(this.context.shared, this.pluginName);
-    return pluginConfig || props ? (0, import_merge2.default)({}, fileConfig, props, pluginConfig) : {};
-  }
-  get logger() {
-    return this.context.logger;
-  }
-  get shell() {
-    return this.context.shell;
-  }
-  get options() {
-    return this.context.getConfig(this.pluginName, {});
-  }
-  getEnv(key, defaultValue) {
-    return this.context.env.get(key) ?? defaultValue;
-  }
-  enabled(_name, _context) {
-    return true;
-  }
-  getConfig(keys, defaultValue) {
-    if (!keys) {
-      return this.context.getConfig(this.pluginName, defaultValue);
-    }
-    return this.context.getConfig(
-      [this.pluginName, ...Array.isArray(keys) ? keys : [keys]],
-      defaultValue
-    );
-  }
-  setConfig(config) {
-    this.context.setConfig({
-      [this.pluginName]: config
-    });
-  }
-  onBefore(_context) {
-  }
-  onExec(_context) {
-  }
-  onSuccess(_context) {
-  }
-  onError(_context) {
-  }
-  /**
-   * run a step
-   *
-   * this will log the step and return the result of the task
-   *
-   * @param label - the label of the step
-   * @param task - the task to run
-   * @returns the result of the task
-   */
-  async step({ label, task }) {
-    this.logger.log();
-    this.logger.info(label);
-    this.logger.log();
+      return;
+    }
     try {
-      const res = await task();
-      this.logger.info(`${label} - success`);
-      return res;
-    } catch (e) {
-      this.logger.error(e);
-      throw e;
+      const response = await this.octokit.repos.createRelease(meragedOptions);
+      this.logger.debug(
+        `[DONE] octokit repos.createRelease "${meragedOptions.name}" (${meragedOptions.tag_name}) (${response.headers.location})`
+      );
+    } catch (error) {
+      this.logger.error(
+        `[FAILED] octokit repos.createRelease "${meragedOptions.name}" (${meragedOptions.tag_name})`,
+        error
+      );
     }
   }
 };
 
 // src/plugins/GitBase.ts
-var GitBase = class extends Plugin {
+var import_isString = __toESM(require_isString(), 1);
+import { ScriptPlugin } from "@qlover/scripts-context";
+var GitBase = class extends ScriptPlugin {
+  /**
+   * Plugin initialization hook
+   *
+   * Runs before plugin execution to set up repository context:
+   * 1. Retrieves repository information
+   * 2. Gets current branch
+   * 3. Switches to current branch if needed
+   * 4. Updates context with repository info
+   *
+   * @throws Error if repository information cannot be retrieved
+   *
+   * @example
+   * ```typescript
+   * class MyPlugin extends GitBase<GitBaseProps> {
+   *   async onExec() {
+   *     // onBefore has already:
+   *     // - Set up repository info
+   *     // - Switched to correct branch
+   *     // - Updated context
+   *     await this.doSomething();
+   *   }
+   * }
+   * ```
+   */
   async onBefore() {
     const repoInfo = await this.getUserInfo();
     if (!repoInfo) {
       throw new Error("Failed to get repoInfo");
     }
-    let currentBranch = this.context.shared.currentBranch;
+    let currentBranch = this.context.options.currentBranch;
     if (!currentBranch) {
       currentBranch = await this.getCurrentBranch();
     }
@@ -5503,18 +5652,50 @@ var GitBase = class extends Plugin {
         dryRun: false
       });
     }
-    this.context.setShared({
+    this.context.setOptions({
       repoName: repoInfo.repoName,
       authorName: repoInfo.authorName,
       currentBranch
     });
   }
+  /**
+   * Gets the current Git branch name
+   *
+   * Retrieves the name of the currently checked out Git branch.
+   * Includes a small delay to ensure Git's internal state is updated.
+   *
+   * @returns Promise resolving to branch name
+   * @throws Error if branch name cannot be retrieved
+   *
+   * @example
+   * ```typescript
+   * const branch = await plugin.getCurrentBranch();
+   * // 'main' or 'feature/new-feature'
+   * ```
+   */
   async getCurrentBranch() {
     await new Promise((resolve2) => setTimeout(resolve2, 100));
     return this.context.shell.exec("git rev-parse --abbrev-ref HEAD", {
       dryRun: false
     });
   }
+  /**
+   * Gets the Git remote URL
+   *
+   * Retrieves the URL of the 'origin' remote from Git configuration.
+   * This URL is used to identify the GitHub repository.
+   *
+   * @returns Promise resolving to remote URL
+   * @throws Error if remote URL cannot be retrieved
+   *
+   * @example
+   * ```typescript
+   * const url = await plugin.getRemoteUrl();
+   * // 'https://github.com/org/repo.git'
+   * // or
+   * // 'git@github.com:org/repo.git'
+   * ```
+   */
   async getRemoteUrl() {
     return (await this.context.shell.exec("git config --get remote.origin.url", {
       dryRun: false
@@ -5568,9 +5749,53 @@ var GitBase = class extends Plugin {
    * @param value - The value to check.
    * @returns True if the value is a valid string, otherwise false.
    */
+  /**
+   * Type guard for valid string values
+   *
+   * Checks if a value is a non-empty string. Used for validating
+   * repository information and other string inputs.
+   *
+   * @param value - Value to check
+   * @returns True if value is a non-empty string
+   *
+   * @example
+   * ```typescript
+   * if (plugin.isValidString(value)) {
+   *   // value is definitely a non-empty string
+   *   console.log(value.toUpperCase());
+   * }
+   * ```
+   */
   isValidString(value) {
     return !!value && (0, import_isString.default)(value);
   }
+  /**
+   * Creates a Git commit
+   *
+   * Creates a new Git commit with the specified message and optional
+   * additional arguments. The message is automatically JSON-stringified
+   * to handle special characters properly.
+   *
+   * @param message - Commit message
+   * @param args - Additional Git commit arguments
+   * @returns Promise resolving to command output
+   *
+   * @example Basic commit
+   * ```typescript
+   * await plugin.commit('feat: add new feature');
+   * ```
+   *
+   * @example Commit with arguments
+   * ```typescript
+   * await plugin.commit('fix: update deps', ['--no-verify']);
+   * ```
+   *
+   * @example Commit with special characters
+   * ```typescript
+   * await plugin.commit('fix: handle "quotes" & symbols');
+   * // Message is automatically escaped
+   * ```
+   */
   commit(message, args = []) {
     return this.context.shell.exec([
       "git",
@@ -5605,24 +5830,60 @@ var CHANGELOG_ALL_FIELDS = [
   "tag"
 ];
 var GitChangelog = class {
+  /**
+   * Creates a new GitChangelog instance
+   *
+   * @param options - Configuration options including shell and logger
+   *
+   * @example
+   * ```typescript
+   * const changelog = new GitChangelog({
+   *   shell: new Shell(),
+   *   logger: new Logger(),
+   *   directory: 'packages/my-pkg',
+   *   noMerges: true
+   * });
+   * ```
+   */
   constructor(options) {
     this.options = options;
   }
   /**
-   * Get the git log
+   * Retrieves Git commit history with specified options
    *
-   * @param options
-   * @returns
+   * Fetches commit information between specified tags or commits,
+   * with support for filtering and field selection.
+   *
+   * @param options - Configuration options for Git log retrieval
+   * @returns Array of commit objects with requested fields
+   *
+   * @example Basic usage
+   * ```typescript
+   * const commits = await changelog.getGitLog({
+   *   from: 'v1.0.0',
+   *   to: 'v2.0.0',
+   *   directory: 'packages/my-pkg',
+   *   noMerges: true
+   * });
+   * ```
+   *
+   * @example Custom fields
+   * ```typescript
+   * const commits = await changelog.getGitLog({
+   *   fields: ['hash', 'subject', 'authorName'],
+   *   directory: 'src'
+   * });
+   * ```
    */
   async getGitLog(options = {}) {
-    const { directory, noMerges = true, fileds } = options;
+    const { directory, noMerges = true, fields } = options;
     const from = await this.resolveTag(options.from, "root");
     const to = await this.resolveTag(options.to, "HEAD");
     const range = from === to ? to : `${from}..${to}`;
     const gitLogOptions = {
       repo: ".",
       number: 1e3,
-      fields: fileds,
+      fields,
       branch: range,
       file: directory,
       nameStatus: false,
@@ -5633,6 +5894,38 @@ var GitChangelog = class {
     this.options.logger?.debug("GitChangelog commits", commits);
     return commits;
   }
+  /**
+   * Retrieves and parses Git commits with metadata
+   *
+   * Gets commit history and enhances it with parsed conventional
+   * commit information and PR metadata.
+   *
+   * @param options - Configuration options for Git log retrieval
+   * @returns Array of enhanced commit objects with parsed metadata
+   *
+   * @example Basic usage
+   * ```typescript
+   * const commits = await changelog.getCommits({
+   *   from: 'v1.0.0',
+   *   to: 'v2.0.0'
+   * });
+   * // [
+   * //   {
+   * //     base: { hash: '...', subject: '...' },
+   * //     commitlint: { type: 'feat', scope: 'api', ... },
+   * //     commits: []
+   * //   }
+   * // ]
+   * ```
+   *
+   * @example Filtered commits
+   * ```typescript
+   * const commits = await changelog.getCommits({
+   *   directory: 'packages/my-pkg',
+   *   noMerges: true
+   * });
+   * ```
+   */
   async getCommits(options) {
     const gitCommits = await this.getGitLog(options);
     return gitCommits.map((commit) => {
@@ -5645,6 +5938,28 @@ var GitChangelog = class {
       };
     });
   }
+  /**
+   * Creates a base commit object from message and optional data
+   *
+   * Utility method to create a standardized commit object with
+   * basic metadata. Used internally for commit value creation.
+   *
+   * @param message - Commit message
+   * @param target - Optional additional commit data
+   * @returns Base commit object
+   * @protected
+   *
+   * @example
+   * ```typescript
+   * const commit = changelog.createBaseCommit(
+   *   'feat: new feature',
+   *   {
+   *     hash: 'abc123',
+   *     authorName: 'John Doe'
+   *   }
+   * );
+   * ```
+   */
   createBaseCommit(message, target) {
     return {
       subject: message,
@@ -5654,16 +5969,66 @@ var GitChangelog = class {
     };
   }
   /**
-   * Tabify the body
+   * Indents each line of a text block
+   *
+   * Adds specified number of spaces to the start of each line
+   * in a multi-line string. Used for formatting commit body text.
    *
    * @since 2.3.2
-   * @param body
-   * @param size
-   * @returns
+   * @param body - Text to indent
+   * @param size - Number of spaces to add (default: 2)
+   * @returns Indented text
+   *
+   * @example
+   * ```typescript
+   * const text = changelog.tabify(
+   *   'Line 1\nLine 2\nLine 3',
+   *   4
+   * );
+   * // '    Line 1\n    Line 2\n    Line 3'
+   * ```
    */
   tabify(body, size = 2) {
     return body.split("\n").map((line) => " ".repeat(size) + line.trim()).join("\n");
   }
+  /**
+   * Parses a commit message into conventional commit format
+   *
+   * Extracts type, scope, message, and body from a commit message
+   * following the conventional commit specification.
+   *
+   * Format: type(scope): message
+   *
+   * @param subject - Commit subject line
+   * @param rawBody - Full commit message body
+   * @returns Parsed conventional commit data
+   *
+   * @example Basic commit
+   * ```typescript
+   * const commit = changelog.parseCommitlint(
+   *   'feat(api): add new endpoint'
+   * );
+   * // {
+   * //   type: 'feat',
+   * //   scope: 'api',
+   * //   message: 'add new endpoint'
+   * // }
+   * ```
+   *
+   * @example With body
+   * ```typescript
+   * const commit = changelog.parseCommitlint(
+   *   'fix(core): memory leak',
+   *   'Fixed memory leak in core module\n\nBREAKING CHANGE: API changed'
+   * );
+   * // {
+   * //   type: 'fix',
+   * //   scope: 'core',
+   * //   message: 'memory leak',
+   * //   body: '  Fixed memory leak in core module\n\n  BREAKING CHANGE: API changed'
+   * // }
+   * ```
+   */
   parseCommitlint(subject, rawBody = "") {
     const [title] = subject.trim().split("\n");
     const bodyLines = rawBody.startsWith(title) ? rawBody.replace(title, "") : rawBody;
@@ -5682,6 +6047,51 @@ var GitChangelog = class {
       body: bodyLines ? this.tabify(bodyLines) : void 0
     };
   }
+  /**
+   * Creates a complete commit value object from hash and message
+   *
+   * Combines commit hash, parsed conventional commit data, and
+   * PR information into a single commit value object.
+   *
+   * @param hash - Commit hash
+   * @param message - Full commit message
+   * @returns Complete commit value object
+   *
+   * @example Basic commit
+   * ```typescript
+   * const commit = changelog.toCommitValue(
+   *   'abc123',
+   *   'feat(api): new endpoint'
+   * );
+   * // {
+   * //   base: {
+   * //     hash: 'abc123',
+   * //     abbrevHash: 'abc123',
+   * //     subject: 'feat(api): new endpoint'
+   * //   },
+   * //   commitlint: {
+   * //     type: 'feat',
+   * //     scope: 'api',
+   * //     message: 'new endpoint'
+   * //   },
+   * //   commits: []
+   * // }
+   * ```
+   *
+   * @example PR commit
+   * ```typescript
+   * const commit = changelog.toCommitValue(
+   *   'def456',
+   *   'fix(core): memory leak (#123)'
+   * );
+   * // {
+   * //   base: { hash: 'def456', ... },
+   * //   commitlint: { type: 'fix', ... },
+   * //   commits: [],
+   * //   prNumber: '123'
+   * // }
+   * ```
+   */
   toCommitValue(hash, message) {
     const [title] = message.trim().split("\n");
     const prMatch = title.match(/\(#(\d+)\)/);
@@ -5699,6 +6109,33 @@ var GitChangelog = class {
       prNumber: prMatch?.[1]
     };
   }
+  /**
+   * Resolves a Git tag or reference to a valid commit reference
+   *
+   * Attempts to resolve a tag name to a valid Git reference.
+   * Falls back to root commit or HEAD if tag doesn't exist.
+   *
+   * @param tag - Tag name to resolve
+   * @param fallback - Fallback value ('root' or 'HEAD')
+   * @returns Resolved Git reference
+   * @protected
+   *
+   * @example Basic tag resolution
+   * ```typescript
+   * const ref = await changelog.resolveTag('v1.0.0');
+   * // 'v1.0.0' if tag exists
+   * // 'HEAD' if tag doesn't exist
+   * ```
+   *
+   * @example Root commit fallback
+   * ```typescript
+   * const ref = await changelog.resolveTag(
+   *   'non-existent-tag',
+   *   'root'
+   * );
+   * // First commit hash if tag doesn't exist
+   * ```
+   */
   async resolveTag(tag, fallback) {
     if (tag) {
       try {
@@ -5716,11 +6153,78 @@ var GitChangelog = class {
 
 // src/implments/changelog/GitChangelogFormatter.ts
 var import_groupBy = __toESM(require_groupBy(), 1);
+import { Shell as Shell3 } from "@qlover/scripts-context";
 var DEFAULT_TEMPLATE = "\n- ${scopeHeader} ${commitlint.message} ${commitLink} ${prLink}";
 var GitChangelogFormatter = class {
+  /**
+   * Creates a new GitChangelogFormatter instance
+   *
+   * @param options - Configuration options including shell interface
+   *
+   * @example
+   * ```typescript
+   * const formatter = new GitChangelogFormatter({
+   *   shell: new Shell(),
+   *   repoUrl: 'https://github.com/org/repo',
+   *   types: [
+   *     { type: 'feat', section: '### Features' }
+   *   ],
+   *   formatTemplate: '- ${commitlint.message}'
+   * });
+   * ```
+   */
   constructor(options) {
     this.options = options;
   }
+  /**
+   * Formats an array of commits into changelog entries
+   *
+   * Groups commits by type and formats them according to the
+   * configured template and options. Supports commit body
+   * inclusion and type-based sections.
+   *
+   * @param commits - Array of commit values to format
+   * @param options - Optional formatting options
+   * @returns Array of formatted changelog lines
+   *
+   * @example Basic formatting
+   * ```typescript
+   * const changelog = formatter.format([
+   *   {
+   *     base: { hash: 'abc123' },
+   *     commitlint: {
+   *       type: 'feat',
+   *       scope: 'api',
+   *       message: 'new endpoint'
+   *     }
+   *   }
+   * ]);
+   * // [
+   * //   '### Features',
+   * //   '- **api:** new endpoint ([abc123](...))'
+   * // ]
+   * ```
+   *
+   * @example With commit body
+   * ```typescript
+   * const changelog = formatter.format(
+   *   [{
+   *     commitlint: {
+   *       type: 'fix',
+   *       message: 'memory leak',
+   *       body: 'Fixed memory allocation\nAdded cleanup'
+   *     }
+   *   }],
+   *   { commitBody: true }
+   * );
+   * // [
+   * //   '### Bug Fixes',
+   * //   '- memory leak',
+   * //   '  Fixed memory allocation',
+   * //   '  Added cleanup'
+   * // ]
+   * ```
+   */
   format(commits, options) {
     const { types = [], commitBody = false } = { ...this.options, ...options };
     const changelog = [];
@@ -5747,6 +6251,41 @@ var GitChangelogFormatter = class {
     });
     return changelog;
   }
+  /**
+   * Formats a single commit into a changelog entry
+   *
+   * Applies the configured template to a commit, including
+   * scope formatting, PR links, and commit hash links.
+   *
+   * @param commit - Commit value to format
+   * @param options - Optional formatting options
+   * @returns Formatted changelog entry
+   *
+   * @example Basic formatting
+   * ```typescript
+   * const entry = formatter.formatCommit({
+   *   base: { hash: 'abc123' },
+   *   commitlint: {
+   *     type: 'feat',
+   *     scope: 'api',
+   *     message: 'new endpoint'
+   *   }
+   * });
+   * // '- **api:** new endpoint ([abc123](...))'
+   * ```
+   *
+   * @example With PR number
+   * ```typescript
+   * const entry = formatter.formatCommit({
+   *   base: { hash: 'def456' },
+   *   commitlint: {
+   *     message: 'fix bug'
+   *   },
+   *   prNumber: '123'
+   * });
+   * // '- fix bug ([def456](...)) (#123)'
+   * ```
+   */
   formatCommit(commit, options) {
     const {
       commitlint,
@@ -5766,19 +6305,72 @@ var GitChangelogFormatter = class {
       hash.slice(0, 7),
       repoUrl ? `${repoUrl}/commit/${hash}` : ""
     ) : "";
-    return this.options.shell.format(formatTemplate, {
+    return Shell3.format(formatTemplate, {
       ...commit,
       scopeHeader,
       commitLink: hashLink,
       prLink
     });
   }
+  /**
+   * Formats a target string as a Markdown link
+   *
+   * Creates a Markdown-formatted link with optional URL.
+   * If no URL is provided, formats as a plain reference.
+   *
+   * @param target - Text to display
+   * @param url - Optional URL for the link
+   * @returns Formatted Markdown link
+   *
+   * @example With URL
+   * ```typescript
+   * const link = formatter.foramtLink('abc123', 'https://github.com/org/repo/commit/abc123');
+   * // '([abc123](https://github.com/org/repo/commit/abc123))'
+   * ```
+   *
+   * @example Without URL
+   * ```typescript
+   * const link = formatter.foramtLink('abc123');
+   * // '(abc123)'
+   * ```
+   */
   foramtLink(target, url) {
     return url ? `([${target}](${url}))` : `(${target})`;
   }
+  /**
+   * Formats a commit hash as a Markdown link
+   *
+   * @deprecated Use foramtLink instead
+   * @param target - Commit hash to display
+   * @param url - Optional URL to the commit
+   * @returns Formatted Markdown link
+   *
+   * @example
+   * ```typescript
+   * const link = formatter.formatCommitLink(
+   *   'abc123',
+   *   'https://github.com/org/repo/commit/abc123'
+   * );
+   * // '([abc123](https://github.com/org/repo/commit/abc123))'
+   * ```
+   */
   formatCommitLink(target, url) {
     return url ? `([${target}](${url}))` : `(${target})`;
   }
+  /**
+   * Formats a commit scope in Markdown
+   *
+   * Wraps the scope in bold syntax and adds a colon.
+   *
+   * @param scope - Scope to format
+   * @returns Formatted scope in Markdown
+   *
+   * @example
+   * ```typescript
+   * const scope = formatter.formatScope('api');
+   * // '**api:**'
+   * ```
+   */
   formatScope(scope) {
     return `**${scope}:**`;
   }
@@ -5832,7 +6424,30 @@ var Pather = class {
     return child[boundaryIndex] === sep;
   }
   /**
-   * Normalised `startsWith` helper.
+   * Normalized path prefix check
+   *
+   * Checks if sourcePath starts with targetPath after normalization.
+   * Handles cross-platform path separators and trailing separators.
+   *
+   * @param sourcePath - Path to check
+   * @param targetPath - Prefix path to match
+   * @returns True if sourcePath starts with targetPath
+   *
+   * @example Basic usage
+   * ```typescript
+   * const pather = new Pather();
+   *
+   * pather.startsWith('src/utils/file.ts', 'src')     // true
+   * pather.startsWith('src\\utils\\file.ts', 'src')   // true
+   * pather.startsWith('lib/utils/file.ts', 'src')     // false
+   * ```
+   *
+   * @example Trailing separators
+   * ```typescript
+   * pather.startsWith('src/utils', 'src/')    // true
+   * pather.startsWith('src/utils/', 'src')    // true
+   * pather.startsWith('src2/utils', 'src')    // false
+   * ```
    */
   startsWith(sourcePath, targetPath) {
     let src = this.toLocalPath(sourcePath);
@@ -5846,7 +6461,44 @@ var Pather = class {
     return src.startsWith(tgt);
   }
   /**
-   * Segment-aware containment check (not mere substring).
+   * Segment-aware path containment check
+   *
+   * Checks if sourcePath contains targetPath as a complete path segment.
+   * Unlike simple substring matching, this ensures proper path boundaries.
+   * For example, 'src/abc' does not contain 'src/a' even though 'src/a'
+   * is a substring.
+   *
+   * Features:
+   * - Cross-platform path handling
+   * - Proper segment boundary checking
+   * - Trailing separator normalization
+   * - Exact match support
+   *
+   * @param sourcePath - Path to search in
+   * @param targetPath - Path to search for
+   * @returns True if sourcePath contains targetPath as a segment
+   *
+   * @example Basic usage
+   * ```typescript
+   * const pather = new Pather();
+   *
+   * pather.containsPath('src/utils/file.ts', 'utils')     // true
+   * pather.containsPath('src/utils/file.ts', 'src/utils') // true
+   * pather.containsPath('src/utils/file.ts', 'til')      // false
+   * ```
+   *
+   * @example Segment boundaries
+   * ```typescript
+   * pather.containsPath('src/abc/file.ts', 'src/a')     // false
+   * pather.containsPath('src/abc/file.ts', 'src/abc')   // true
+   * ```
+   *
+   * @example Trailing separators
+   * ```typescript
+   * pather.containsPath('src/utils/', 'utils')     // true
+   * pather.containsPath('src/utils', 'utils/')     // true
+   * pather.containsPath('src/utils/', 'utils/')    // true
+   * ```
    */
   containsPath(sourcePath, targetPath) {
     let src = this.toLocalPath(sourcePath);
@@ -5872,18 +6524,49 @@ var Pather = class {
 // src/plugins/githubPR/GithubChangelog.ts
 var DOMAIN = "https://github.com";
 var GithubChangelog = class _GithubChangelog extends GitChangelog {
+  /**
+   * Creates a new GitHub changelog generator
+   *
+   * @param options - Changelog generation options
+   * @param githubManager - GitHub API manager
+   *
+   * @example
+   * ```typescript
+   * const changelog = new GithubChangelog({
+   *   shell,
+   *   logger,
+   *   mergePRcommit: true,
+   *   githubRootPath: 'https://github.com/org/repo'
+   * }, githubManager);
+   * ```
+   */
   constructor(options, githubManager) {
     super(options);
     this.options = options;
     this.githubManager = githubManager;
   }
+  /** Path manipulation utility */
   pather = new Pather();
   /**
-   * Filter commits by directory
-   * @param commits - commits
-   * @param directory - directory
-   * @returns filtered commits
+   * Filters commits by directory
+   *
+   * Filters commits based on whether they contain changes in
+   * the specified directory. Uses GitHub API to get detailed
+   * commit information.
+   *
+   * @param commits - Array of commits to filter
+   * @param directory - Directory path to filter by
+   * @returns Promise resolving to filtered commits
    * @since 2.4.0
+   *
+   * @example
+   * ```typescript
+   * const commits = await changelog.filterCommitsByDirectory(
+   *   allCommits,
+   *   'packages/pkg-a'
+   * );
+   * // Only commits that modified files in packages/pkg-a
+   * ```
    */
   async filterCommitsByDirectory(commits, directory) {
     const result = [];
@@ -5901,6 +6584,41 @@ var GithubChangelog = class _GithubChangelog extends GitChangelog {
     }
     return result;
   }
+  /**
+   * Gets complete commit information with PR details
+   *
+   * Retrieves commits and enhances them with pull request
+   * information. For commits associated with PRs, includes
+   * all PR commits and filters by directory.
+   *
+   * Process:
+   * 1. Get base commits
+   * 2. Extract PR numbers
+   * 3. Fetch PR commits
+   * 4. Filter by directory
+   * 5. Flatten results
+   *
+   * @param options - Changelog options
+   * @returns Promise resolving to enhanced commits
+   *
+   * @example Basic usage
+   * ```typescript
+   * const commits = await changelog.getFullCommit({
+   *   from: 'v1.0.0',
+   *   directory: 'packages/pkg-a'
+   * });
+   * // Returns commits with PR information
+   * ```
+   *
+   * @example With PR merging
+   * ```typescript
+   * const commits = await changelog.getFullCommit({
+   *   mergePRcommit: true,
+   *   directory: 'packages/pkg-a'
+   * });
+   * // Includes all PR commits
+   * ```
+   */
   async getFullCommit(options) {
     const _options = { ...this.options, ...options };
     const allCommits = await this.getCommits(_options);
@@ -5928,14 +6646,49 @@ var GithubChangelog = class _GithubChangelog extends GitChangelog {
     );
     return newallCommits.flat();
   }
+  /**
+   * Transforms workspaces with GitHub changelogs
+   *
+   * Processes each workspace to add GitHub-specific changelog
+   * information. Includes:
+   * - GitHub repository URL
+   * - PR-aware commit history
+   * - Formatted changelog with links
+   *
+   * Process:
+   * 1. Build GitHub root path
+   * 2. Configure changelog options
+   * 3. Get commits for each workspace
+   * 4. Format changelog with links
+   * 5. Update workspace objects
+   *
+   * @param workspaces - Array of workspaces to process
+   * @param context - Release context
+   * @returns Promise resolving to updated workspaces
+   *
+   * @example
+   * ```typescript
+   * const workspaces = await changelog.transformWorkspace(
+   *   [
+   *     {
+   *       name: 'pkg-a',
+   *       path: 'packages/a',
+   *       lastTag: 'v1.0.0'
+   *     }
+   *   ],
+   *   context
+   * );
+   * // Returns workspaces with GitHub-formatted changelogs
+   * ```
+   */
   async transformWorkspace(workspaces, context) {
     const githubRootPath = [
       DOMAIN,
-      context.shared.authorName,
-      context.shared.repoName
+      context.getOptions("authorName"),
+      context.getOptions("repoName")
     ].join("/");
     const changelogProps = {
-      ...context.getConfig("changelog"),
+      ...context.getOptions("changelog"),
       githubRootPath,
       mergePRcommit: true,
       shell: context.shell,
@@ -5951,7 +6704,7 @@ var GithubChangelog = class _GithubChangelog extends GitChangelog {
         const changelog = await githubChangelog.getFullCommit({
           from: workspace.lastTag ?? "",
           directory: workspace.path,
-          fileds: CHANGELOG_ALL_FIELDS
+          fields: CHANGELOG_ALL_FIELDS
         });
         if (typeof changelog === "string") {
           return {
@@ -5973,9 +6726,30 @@ var GithubChangelog = class _GithubChangelog extends GitChangelog {
 };
 
 // src/plugins/githubPR/GithubPR.ts
+import { Shell as Shell4 } from "@qlover/scripts-context";
 var DEFAULT_RELEASE_NAME = "Release ${name} v${version}";
 var DEFAULT_COMMIT_MESSAGE = "chore(tag): ${name} v${version}";
 var GithubPR = class extends GitBase {
+  /**
+   * Creates a new GithubPR plugin instance
+   *
+   * Initializes the plugin with GitHub-specific configuration and
+   * sets up release parameters and GitHub manager.
+   *
+   * @param context - Release context
+   * @param props - Plugin configuration
+   *
+   * @example
+   * ```typescript
+   * const plugin = new GithubPR(context, {
+   *   releasePR: true,
+   *   releaseName: 'Release v${version}',
+   *   commitMessage: 'chore: release v${version}',
+   *   draft: false,
+   *   preRelease: false
+   * });
+   * ```
+   */
   constructor(context, props) {
     super(context, "githubPR", {
       releaseName: DEFAULT_RELEASE_NAME,
@@ -5983,23 +6757,75 @@ var GithubPR = class extends GitBase {
     });
     this.context = context;
     this.githubManager = new GithubManager(this.context);
-    this.releaseParams = new ReleaseParams(context.shell, context.logger, {
-      PRTitle: this.getConfig("PRTitle", this.context.shared.PRTitle),
-      PRBody: this.getConfig("PRBody", this.context.shared.PRBody),
+    this.releaseParams = new ReleaseParams(context.logger, {
+      PRTitle: this.getConfig("PRTitle", this.context.options.PRTitle),
+      PRBody: this.getConfig("PRBody", this.context.options.PRBody),
       ...this.props
     });
   }
   releaseParams;
   githubManager;
+  /**
+   * Determines if the plugin should be enabled
+   *
+   * Plugin is enabled unless explicitly skipped via configuration.
+   * This allows for conditional PR creation and release publishing.
+   *
+   * @param _name - Plugin name (unused)
+   * @returns True if plugin should be enabled
+   *
+   * @example
+   * ```typescript
+   * const plugin = new GithubPR(context, { skip: true });
+   * plugin.enabled(); // false
+   *
+   * const plugin2 = new GithubPR(context, {});
+   * plugin2.enabled(); // true
+   * ```
+   */
   enabled(_name) {
     if (this.getConfig("skip")) {
       return false;
     }
     return true;
   }
+  /**
+   * Determines if the plugin is in publish mode
+   *
+   * In publish mode, the plugin publishes releases directly.
+   * In non-publish mode (releasePR=true), it creates pull requests.
+   *
+   * @returns True if in publish mode
+   *
+   * @example
+   * ```typescript
+   * const plugin = new GithubPR(context, { releasePR: true });
+   * plugin.isPublish; // false (PR mode)
+   *
+   * const plugin2 = new GithubPR(context, { releasePR: false });
+   * plugin2.isPublish; // true (publish mode)
+   * ```
+   */
   get isPublish() {
     return !this.getConfig("releasePR");
   }
+  /**
+   * Checks if the current repository is a GitHub repository
+   *
+   * Verifies that the remote URL contains 'github.com' to ensure
+   * GitHub-specific features can be used.
+   *
+   * @returns Promise resolving to true if GitHub repository
+   *
+   * @example
+   * ```typescript
+   * const isGithub = await plugin.isGithubRepository();
+   * if (isGithub) {
+   *   // Use GitHub-specific features
+   * }
+   * ```
+   * @private
+   */
   async isGithubRepository() {
     try {
       const remoteUrl = await this.getRemoteUrl();
@@ -6008,6 +6834,24 @@ var GithubPR = class extends GitBase {
       return false;
     }
   }
+  /**
+   * Plugin initialization hook
+   *
+   * Performs pre-execution setup:
+   * 1. Verifies repository is on GitHub
+   * 2. Runs parent class initialization
+   * 3. Sets up NPM token for publishing
+   *
+   * @throws Error if not a GitHub repository
+   * @throws Error if NPM_TOKEN missing in publish mode
+   *
+   * @example
+   * ```typescript
+   * const plugin = new GithubPR(context, {});
+   * await plugin.onBefore();
+   * // Throws if not GitHub repo or missing NPM token
+   * ```
+   */
   async onBefore() {
     this.logger.debug("GithubPR onBefore");
     const isGithub = await this.isGithubRepository();
@@ -6018,7 +6862,7 @@ var GithubPR = class extends GitBase {
     }
     await super.onBefore();
     if (this.isPublish) {
-      const npmToken = this.getEnv("NPM_TOKEN");
+      const npmToken = this.context.getEnv("NPM_TOKEN");
       if (!npmToken) {
         throw new Error("NPM_TOKEN is not set");
       }
@@ -6027,10 +6871,28 @@ var GithubPR = class extends GitBase {
       );
     }
   }
+  /**
+   * Main plugin execution hook
+   *
+   * Processes changelogs for all workspaces using GitHub-specific
+   * formatting and updates the context with the results.
+   *
+   * Process:
+   * 1. Initialize GitHub changelog processor
+   * 2. Transform workspace changelogs
+   * 3. Update context with new workspace info
+   *
+   * @example
+   * ```typescript
+   * const plugin = new GithubPR(context, {});
+   * await plugin.onExec();
+   * // Transforms changelogs with GitHub links
+   * ```
+   */
   async onExec() {
     const workspaces = this.context.workspaces;
     const githubChangelog = new GithubChangelog(
-      this.context.getConfig("changelog"),
+      this.context.getOptions("changelog"),
       this.githubManager
     );
     const newWorkspaces = await this.step({
@@ -6039,6 +6901,27 @@ var GithubPR = class extends GitBase {
     });
     this.context.setWorkspaces(newWorkspaces);
   }
+  /**
+   * Success hook after plugin execution
+   *
+   * Handles either PR creation or release publishing based on
+   * configuration. In publish mode, publishes to NPM and creates
+   * GitHub releases. In PR mode, creates release pull requests.
+   *
+   * @example PR mode
+   * ```typescript
+   * const plugin = new GithubPR(context, { releasePR: true });
+   * await plugin.onSuccess();
+   * // Creates release PR
+   * ```
+   *
+   * @example Publish mode
+   * ```typescript
+   * const plugin = new GithubPR(context, { releasePR: false });
+   * await plugin.onSuccess();
+   * // Publishes to NPM and creates GitHub release
+   * ```
+   */
   async onSuccess() {
     if (this.isPublish) {
       await this.publishPR(this.context.workspaces);
@@ -6046,6 +6929,28 @@ var GithubPR = class extends GitBase {
     }
     await this.releasePR(this.context.workspaces);
   }
+  /**
+   * Creates a release pull request
+   *
+   * Handles the complete process of creating a release PR:
+   * 1. Creates release commit
+   * 2. Creates release branch
+   * 3. Creates and configures pull request
+   *
+   * @param workspaces - Array of workspace configurations
+   *
+   * @example
+   * ```typescript
+   * const workspaces = [{
+   *   name: 'pkg-a',
+   *   version: '1.0.0',
+   *   changelog: '...'
+   * }];
+   *
+   * await plugin.releasePR(workspaces);
+   * // Creates PR with release changes
+   * ```
+   */
   async releasePR(workspaces) {
     await this.step({
       label: "Release Commit",
@@ -6057,6 +6962,28 @@ var GithubPR = class extends GitBase {
     });
     await this.releasePullRequest(workspaces, releaseBranchParams);
   }
+  /**
+   * Publishes releases to NPM and GitHub
+   *
+   * In non-dry-run mode:
+   * 1. Publishes packages to NPM
+   * 2. Pushes tags to GitHub
+   * 3. Creates GitHub releases
+   *
+   * @param workspaces - Array of workspace configurations
+   *
+   * @example
+   * ```typescript
+   * const workspaces = [{
+   *   name: 'pkg-a',
+   *   version: '1.0.0',
+   *   changelog: '...'
+   * }];
+   *
+   * await plugin.publishPR(workspaces);
+   * // Publishes to NPM and creates GitHub releases
+   * ```
+   */
   async publishPR(workspaces) {
     if (!this.getConfig("dryRunCreatePR")) {
       await this.context.runChangesetsCli("publish");
@@ -6072,6 +6999,34 @@ var GithubPR = class extends GitBase {
       )
     });
   }
+  /**
+   * Creates release commit(s)
+   *
+   * Creates either a single commit for all workspaces or
+   * individual commits per workspace. Uses configured commit
+   * message template.
+   *
+   * @param workspaces - Array of workspace configurations
+   *
+   * @example Single workspace
+   * ```typescript
+   * await plugin.relesaeCommit([{
+   *   name: 'pkg-a',
+   *   version: '1.0.0'
+   * }]);
+   * // Creates: "chore(tag): pkg-a v1.0.0"
+   * ```
+   *
+   * @example Multiple workspaces
+   * ```typescript
+   * await plugin.relesaeCommit([
+   *   { name: 'pkg-a', version: '1.0.0' },
+   *   { name: 'pkg-b', version: '2.0.0' }
+   * ]);
+   * // Creates: "chore(tag): pkg-a v1.0.0,pkg-b v2.0.0"
+   * ```
+   * @private
+   */
   async relesaeCommit(workspaces) {
     const commitArgs = this.getConfig("commitArgs", []);
     if (workspaces.length === 1) {
@@ -6083,6 +7038,34 @@ var GithubPR = class extends GitBase {
     const commitMessage = `chore(tag): ${workspaces.map((w) => `${w.name} v${w.version}`).join(",")}`;
     await this.commit(commitMessage, commitArgs);
   }
+  /**
+   * Creates and optionally merges a release pull request
+   *
+   * Creates a PR with release changes and handles auto-merge
+   * if configured. Adds release and change labels to the PR.
+   *
+   * @param workspaces - Array of workspace configurations
+   * @param releaseBranchParams - Branch and tag information
+   *
+   * @example Manual merge
+   * ```typescript
+   * await plugin.releasePullRequest(
+   *   workspaces,
+   *   { releaseBranch: 'release-v1.0.0', tagName: 'v1.0.0' }
+   * );
+   * // Creates PR for manual merge
+   * ```
+   *
+   * @example Auto-merge
+   * ```typescript
+   * const plugin = new GithubPR(context, {
+   *   autoMergeReleasePR: true
+   * });
+   *
+   * await plugin.releasePullRequest(workspaces, params);
+   * // Creates and auto-merges PR
+   * ```
+   */
   async releasePullRequest(workspaces, releaseBranchParams) {
     const prNumber = await this.step({
       label: "Create Release PR",
@@ -6104,8 +7087,36 @@ var GithubPR = class extends GitBase {
       `Please manually merge PR(#${prNumber}) and complete the publishing process afterwards`
     );
   }
+  /**
+   * Creates a commit for a single workspace
+   *
+   * Uses the configured commit message template to create a
+   * commit for the workspace's changes.
+   *
+   * @param workspace - Workspace configuration
+   * @param commitArgs - Additional Git commit arguments
+   * @returns Promise resolving to commit output
+   *
+   * @example Basic commit
+   * ```typescript
+   * await plugin.commitWorkspace({
+   *   name: 'pkg-a',
+   *   version: '1.0.0'
+   * });
+   * // Creates: "chore(tag): pkg-a v1.0.0"
+   * ```
+   *
+   * @example With arguments
+   * ```typescript
+   * await plugin.commitWorkspace(
+   *   { name: 'pkg-a', version: '1.0.0' },
+   *   ['--no-verify']
+   * );
+   * ```
+   * @private
+   */
   async commitWorkspace(workspace, commitArgs = []) {
-    const commitMessage = this.shell.format(
+    const commitMessage = Shell4.format(
       this.getConfig("commitMessage", DEFAULT_COMMIT_MESSAGE),
       workspace
     );
@@ -6121,16 +7132,48 @@ var GithubPR = class extends GitBase {
    *
    * @returns The release branch.
    */
+  /**
+   * Creates a release branch for changes
+   *
+   * Creates a new branch from the current branch for release
+   * changes. The branch name is generated from the configured
+   * template and workspace information.
+   *
+   * Process:
+   * 1. Generate branch parameters
+   * 2. Fetch required branches
+   * 3. Create and push release branch
+   *
+   * @param workspaces - Array of workspace configurations
+   * @returns Promise resolving to branch parameters
+   *
+   * @example
+   * ```typescript
+   * const params = await plugin.createReleaseBranch([{
+   *   name: 'pkg-a',
+   *   version: '1.0.0'
+   * }]);
+   * // {
+   * //   tagName: 'pkg-a@1.0.0',
+   * //   releaseBranch: 'release-pkg-a-1.0.0'
+   * // }
+   * ```
+   *
+   * @throws Error if tag name is invalid
+   * @throws Error if branch creation fails
+   * @private
+   */
   async createReleaseBranch(workspaces) {
     const params = this.releaseParams.getReleaseBranchParams(
       workspaces,
+      // @ts-expect-error TODO: fix this
       this.context.getTemplateContext()
     );
     const { tagName, releaseBranch } = params;
     if (typeof tagName !== "string") {
       throw new Error("Tag name is not a string");
     }
-    const { sourceBranch, currentBranch } = this.context.shared;
+    const { sourceBranch, currentBranch } = this.context.getOptions();
     this.context.logger.debug("PR TagName is:", tagName);
     this.context.logger.debug("PR CurrentBranch is:", currentBranch);
     this.context.logger.debug("PR SourceBranch is:", sourceBranch);
@@ -6162,11 +7205,47 @@ var GithubPR = class extends GitBase {
    * @param releaseBranchParams - The release branch params.
    * @returns The created pull request number.
    */
+  /**
+   * Creates a release pull request
+   *
+   * Creates a pull request with:
+   * 1. Release label
+   * 2. Change labels (if configured)
+   * 3. Generated title and body
+   * 4. Proper branch configuration
+   *
+   * @param workspaces - Array of workspace configurations
+   * @param releaseBranchParams - Branch and tag information
+   * @returns Promise resolving to PR number
+   *
+   * @example Basic PR
+   * ```typescript
+   * const prNumber = await plugin.createReleasePR(
+   *   workspaces,
+   *   { releaseBranch: 'release-v1.0.0', tagName: 'v1.0.0' }
+   * );
+   * // Creates PR with default labels
+   * ```
+   *
+   * @example With change labels
+   * ```typescript
+   * const plugin = new GithubPR(context, {
+   *   pushChangeLabels: true
+   * });
+   *
+   * const prNumber = await plugin.createReleasePR(
+   *   workspaces,
+   *   params
+   * );
+   * // Creates PR with release and change labels
+   * ```
+   * @private
+   */
   async createReleasePR(workspaces, releaseBranchParams) {
     const label = await this.githubManager.createReleasePRLabel();
     let labels = [label.name];
     if (this.getConfig("pushChangeLabels")) {
-      const changeLabels = this.context.getConfig("workspaces.changeLabels");
+      const changeLabels = this.context.getOptions("workspaces.changeLabels");
       if (Array.isArray(changeLabels) && changeLabels.length > 0) {
         labels.push(...changeLabels);
       }
@@ -6195,21 +7274,137 @@ import { join as join2, resolve, relative } from "path";
 
 // src/implments/ReleaseLabel.ts
 var ReleaseLabel = class {
+  /**
+   * Creates a new ReleaseLabel instance
+   *
+   * @param options - Configuration options for label management
+   *
+   * @example
+   * ```typescript
+   * const label = new ReleaseLabel({
+   *   // Label template with ${name} placeholder
+   *   changePackagesLabel: 'changed:${name}',
+   *
+   *   // Package directories to monitor
+   *   packagesDirectories: ['packages/a', 'packages/b'],
+   *
+   *   // Optional custom comparison logic
+   *   compare: (file, pkg) => file.includes(pkg)
+   * });
+   * ```
+   */
   constructor(options) {
     this.options = options;
   }
+  /**
+   * Compares a changed file path against a package path
+   *
+   * Uses custom comparison function if provided, otherwise
+   * checks if the file path starts with the package path.
+   *
+   * @param changedFilePath - Path of the changed file
+   * @param packagePath - Path of the package to check against
+   * @returns True if the file belongs to the package
+   *
+   * @example
+   * ```typescript
+   * // Default comparison
+   * label.compare('packages/a/src/index.ts', 'packages/a');
+   * // true
+   *
+   * // Custom comparison
+   * const label = new ReleaseLabel({
+   *   ...options,
+   *   compare: (file, pkg) => file.includes(pkg)
+   * });
+   * label.compare('src/packages/a/index.ts', 'packages/a');
+   * // true
+   * ```
+   */
   compare(changedFilePath, packagePath) {
     if (typeof this.options.compare === "function") {
       return this.options.compare(changedFilePath, packagePath);
     }
     return changedFilePath.startsWith(packagePath);
   }
+  /**
+   * Generates a change label for a single package
+   *
+   * Replaces ${name} placeholder in the label template with
+   * the package path.
+   *
+   * @param packagePath - Path of the package
+   * @param label - Optional custom label template
+   * @returns Formatted change label
+   *
+   * @example
+   * ```typescript
+   * // Default label template
+   * label.toChangeLabel('packages/a');
+   * // 'changed:packages/a'
+   *
+   * // Custom label template
+   * label.toChangeLabel('packages/a', 'modified:${name}');
+   * // 'modified:packages/a'
+   * ```
+   */
   toChangeLabel(packagePath, label = this.options.changePackagesLabel) {
     return label.replace("${name}", packagePath);
   }
+  /**
+   * Generates change labels for multiple packages
+   *
+   * Maps each package path to a formatted change label.
+   *
+   * @param packages - Array of package paths
+   * @param label - Optional custom label template
+   * @returns Array of formatted change labels
+   *
+   * @example
+   * ```typescript
+   * // Default label template
+   * label.toChangeLabels(['packages/a', 'packages/b']);
+   * // ['changed:packages/a', 'changed:packages/b']
+   *
+   * // Custom label template
+   * label.toChangeLabels(
+   *   ['packages/a', 'packages/b'],
+   *   'modified:${name}'
+   * );
+   * // ['modified:packages/a', 'modified:packages/b']
+   * ```
+   */
   toChangeLabels(packages, label = this.options.changePackagesLabel) {
     return packages.map((pkg) => this.toChangeLabel(pkg, label));
   }
+  /**
+   * Identifies packages affected by changed files
+   *
+   * Checks each changed file against package paths to determine
+   * which packages have been modified.
+   *
+   * @param changedFiles - Array or Set of changed file paths
+   * @param packages - Optional array of package paths to check
+   * @returns Array of affected package paths
+   *
+   * @example
+   * ```typescript
+   * // Check against default packages
+   * label.pick(['packages/a/src/index.ts']);
+   * // ['packages/a']
+   *
+   * // Check specific packages
+   * label.pick(
+   *   ['packages/a/index.ts', 'packages/b/test.ts'],
+   *   ['packages/a', 'packages/c']
+   * );
+   * // ['packages/a']
+   *
+   * // Using Set of files
+   * label.pick(new Set(['packages/a/index.ts']));
+   * // ['packages/a']
+   * ```
+   */
   pick(changedFiles, packages = this.options.packagesDirectories) {
     const result = [];
     for (const pkgPath of packages) {
@@ -6254,7 +7449,8 @@ var WorkspaceCreator = class _WorkspaceCreator {
 };
 
 // src/plugins/workspaces/Workspaces.ts
-var Workspaces = class extends Plugin {
+import { ScriptPlugin as ScriptPlugin2 } from "@qlover/scripts-context";
+var Workspaces = class extends ScriptPlugin2 {
   releaseTask = null;
   workspacesList = [];
   _skip = false;
@@ -6262,8 +7458,8 @@ var Workspaces = class extends Plugin {
   constructor(context) {
     super(context, "workspaces");
     this.releaseLabel = new ReleaseLabel({
-      changePackagesLabel: this.context.shared.changePackagesLabel || "change:${name}",
-      packagesDirectories: this.context.shared.packagesDirectories || [],
+      changePackagesLabel: this.context.options.changePackagesLabel || "change:${name}",
+      packagesDirectories: this.context.options.packagesDirectories || [],
       compare: (changedFilePath, packagePath) => resolve(changedFilePath).startsWith(resolve(packagePath))
     });
   }
@@ -6281,7 +7477,7 @@ var Workspaces = class extends Plugin {
     if (this.getConfig("skipCheckPackage") || workspaces.length === 0) {
       throw new Error("No changes to publish packages");
     }
-    const { publishPath } = this.context.shared;
+    const publishPath = this.context.getOptions("publishPath");
     if (publishPath) {
       const targetWorkspace = workspaces.find(
         (workspace2) => resolve(workspace2.root) === resolve(publishPath)
@@ -6315,7 +7511,7 @@ var Workspaces = class extends Plugin {
     this.releaseTask = releaseTask;
   }
   setCurrentWorkspace(workspace, workspaces) {
-    this.context.setShared({
+    this.context.setOptions({
       publishPath: workspace.path
     });
     this.setConfig({
@@ -6347,7 +7543,7 @@ var Workspaces = class extends Plugin {
   }
   getProjectWorkspaces() {
     const rootPath = this.context.rootPath;
-    const packagesDirectories = this.context.shared.packagesDirectories;
+    const packagesDirectories = this.context.options.packagesDirectories;
     if (Array.isArray(packagesDirectories) && packagesDirectories.length > 0) {
       return packagesDirectories.map(
         (path) => WorkspaceCreator.toWorkspace({ path }, rootPath)
@@ -6571,8 +7767,37 @@ async function loaderPluginsFromPluginTuples(context, pluginsTuples, maxLimit =
 // src/plugins/Changelog.ts
 import { join as join4 } from "path";
 import { existsSync, writeFileSync } from "fs";
+import {
+  ScriptPlugin as ScriptPlugin3,
+  Shell as Shell5
+} from "@qlover/scripts-context";
 var contentTmplate = "---\n'${name}': '${increment}'\n---\n\n${changelog}";
-var Changelog = class extends Plugin {
+var Changelog = class extends ScriptPlugin3 {
+  /**
+   * Creates a new Changelog plugin instance
+   *
+   * Initializes the plugin with default configuration values and
+   * merges them with provided options.
+   *
+   * Default values:
+   * - increment: 'patch'
+   * - changesetRoot: '.changeset'
+   * - tagTemplate: '${name}@${version}'
+   * - tagPrefix: '${name}'
+   * - tagMatch: '${name}@*'
+   *
+   * @param context - Release context
+   * @param props - Plugin configuration
+   *
+   * @example
+   * ```typescript
+   * const plugin = new Changelog(context, {
+   *   increment: 'minor',
+   *   changesetRoot: 'custom/changeset',
+   *   tagTemplate: 'v${version}'
+   * });
+   * ```
+   */
   constructor(context, props) {
     super(context, "changelog", {
       increment: "patch",
@@ -6583,15 +7808,78 @@ var Changelog = class extends Plugin {
       ...props
     });
   }
+  /**
+   * Gets the absolute path to the changeset root directory
+   *
+   * Combines the project root path with the configured changeset
+   * directory path.
+   *
+   * @returns Absolute path to changeset directory
+   *
+   * @example
+   * ```typescript
+   * const root = plugin.changesetRoot;
+   * // '/path/to/project/.changeset'
+   * ```
+   */
   get changesetRoot() {
     return join4(this.context.rootPath, this.getConfig("changesetRoot"));
   }
+  /**
+   * Gets the path to the changeset configuration file
+   *
+   * Returns the absolute path to the config.json file in the
+   * changeset directory.
+   *
+   * @returns Path to changeset config file
+   *
+   * @example
+   * ```typescript
+   * const configPath = plugin.changesetConfigPath;
+   * // '/path/to/project/.changeset/config.json'
+   * ```
+   */
   get changesetConfigPath() {
     return join4(this.changesetRoot, "config.json");
   }
+  /**
+   * Determines if the plugin should be enabled
+   *
+   * Plugin is enabled unless explicitly skipped via configuration.
+   * This allows for conditional changelog generation.
+   *
+   * @returns True if plugin should be enabled
+   *
+   * @example
+   * ```typescript
+   * const plugin = new Changelog(context, { skip: true });
+   * plugin.enabled(); // false
+   *
+   * const plugin2 = new Changelog(context, {});
+   * plugin2.enabled(); // true
+   * ```
+   */
   enabled() {
     return !this.getConfig("skip");
   }
+  /**
+   * Plugin initialization hook
+   *
+   * Verifies that the changeset directory exists before proceeding
+   * with changelog generation.
+   *
+   * @throws Error if changeset directory does not exist
+   *
+   * @example
+   * ```typescript
+   * const plugin = new Changelog(context, {
+   *   changesetRoot: '.changeset'
+   * });
+   *
+   * await plugin.onBefore();
+   * // Throws if .changeset directory doesn't exist
+   * ```
+   */
   async onBefore() {
     if (!existsSync(this.changesetRoot)) {
       throw new Error(
@@ -6600,6 +7888,33 @@ var Changelog = class extends Plugin {
     }
     this.logger.debug(`${this.changesetRoot} exists`);
   }
+  /**
+   * Updates workspace information with latest versions
+   *
+   * Reads the latest version information from each workspace's
+   * package.json and updates the workspace objects with new
+   * versions and tag names.
+   *
+   * @param workspaces - Array of workspace configurations
+   * @returns Updated workspace configurations
+   *
+   * @example
+   * ```typescript
+   * const workspaces = [
+   *   { name: 'pkg-a', path: 'packages/a', version: '1.0.0' }
+   * ];
+   *
+   * const updated = plugin.mergeWorkspaces(workspaces);
+   * // [
+   * //   {
+   * //     name: 'pkg-a',
+   * //     path: 'packages/a',
+   * //     version: '1.1.0',  // Updated version
+   * //     tagName: 'pkg-a@1.1.0'
+   * //   }
+   * // ]
+   * ```
+   */
   mergeWorkspaces(workspaces) {
     return workspaces.map((workspace) => {
       const newPackgeJson = WorkspaceCreator.toWorkspace(
@@ -6616,6 +7931,25 @@ var Changelog = class extends Plugin {
       return newWorkspace;
     });
   }
+  /**
+   * Main plugin execution hook
+   *
+   * Generates changelogs for all workspaces in parallel and updates
+   * the context with the results.
+   *
+   * Process:
+   * 1. Generate changelogs for each workspace
+   * 2. Update context with new workspace information
+   *
+   * @param _context - Execution context
+   *
+   * @example
+   * ```typescript
+   * const plugin = new Changelog(context, {});
+   * await plugin.onExec(execContext);
+   * // Generates changelogs for all workspaces
+   * ```
+   */
   async onExec(_context) {
     const workspaces = await this.step({
       label: "Generate Changelogs",
@@ -6627,6 +7961,28 @@ var Changelog = class extends Plugin {
     });
     this.context.setWorkspaces(workspaces);
   }
+  /**
+   * Success hook after plugin execution
+   *
+   * Handles post-changelog generation tasks:
+   * 1. Creates changeset files (if not skipped)
+   * 2. Updates package versions
+   * 3. Restores unchanged packages (if configured)
+   * 4. Updates workspace information
+   *
+   * @example
+   * ```typescript
+   * const plugin = new Changelog(context, {
+   *   skipChangeset: false,
+   *   ignoreNonUpdatedPackages: true
+   * });
+   *
+   * await plugin.onSuccess();
+   * // - Creates changeset files
+   * // - Updates versions
+   * // - Restores unchanged packages
+   * ```
+   */
   async onSuccess() {
     const workspaces = this.context.workspaces;
     if (!this.getConfig("skipChangeset")) {
@@ -6650,8 +8006,27 @@ var Changelog = class extends Plugin {
     this.logger.debug("new workspaces", newWorkspaces);
     this.context.setWorkspaces(newWorkspaces);
   }
+  /**
+   * Restores unchanged packages to their original state
+   *
+   * When ignoreNonUpdatedPackages is enabled, this method:
+   * 1. Identifies packages without changes
+   * 2. Uses git restore to revert them to original state
+   *
+   * @example
+   * ```typescript
+   * // With changed and unchanged packages
+   * context.options.workspaces = {
+   *   packages: ['pkg-a', 'pkg-b', 'pkg-c'],
+   *   changedPaths: ['pkg-a', 'pkg-b']
+   * };
+   *
+   * await plugin.restoreIgnorePackages();
+   * // Restores 'pkg-c' to original state
+   * ```
+   */
   async restoreIgnorePackages() {
-    const { changedPaths = [], packages = [] } = this.context.getConfig(
+    const { changedPaths = [], packages = [] } = this.context.getOptions(
       "workspaces"
     );
     const noChangedPackages = packages.filter((pkgPath) => !changedPaths.includes(pkgPath)).map(
@@ -6662,12 +8037,60 @@ var Changelog = class extends Plugin {
       await this.shell.exec(["git", "restore", ...noChangedPackages]);
     }
   }
+  /**
+   * Gets the tag prefix for a workspace
+   *
+   * Formats the configured tag prefix template with workspace
+   * information. Used for generating Git tag names.
+   *
+   * @param workspace - Workspace configuration
+   * @returns Formatted tag prefix
+   *
+   * @example
+   * ```typescript
+   * const workspace = {
+   *   name: 'pkg-a',
+   *   version: '1.0.0'
+   * };
+   *
+   * const prefix = plugin.getTagPrefix(workspace);
+   * // With default template: 'pkg-a'
+   * // With custom template: 'v1.0.0'
+   * ```
+   */
   getTagPrefix(workspace) {
-    return this.shell.format(
+    return Shell5.format(
       this.getConfig("tagPrefix"),
       workspace
     );
   }
+  /**
+   * Generates a changelog for a workspace
+   *
+   * Creates a changelog by:
+   * 1. Getting the appropriate tag name
+   * 2. Retrieving commits since last tag
+   * 3. Formatting commits into changelog entries
+   *
+   * @param workspace - Workspace configuration
+   * @returns Updated workspace with changelog
+   *
+   * @example
+   * ```typescript
+   * const workspace = {
+   *   name: 'pkg-a',
+   *   path: 'packages/a',
+   *   version: '1.0.0'
+   * };
+   *
+   * const updated = await plugin.generateChangelog(workspace);
+   * // {
+   * //   ...workspace,
+   * //   lastTag: 'pkg-a@1.0.0',
+   * //   changelog: '- feat: new feature\n- fix: bug fix'
+   * // }
+   * ```
+   */
   async generateChangelog(workspace) {
     let tagName = await this.getTagName(workspace);
     if (workspace.lastTag) {
@@ -6680,8 +8103,8 @@ var Changelog = class extends Plugin {
       ...baseConfig,
       from: tagName,
       directory: workspace.path,
-      shell: this.shell,
-      fileds: CHANGELOG_ALL_FIELDS,
+      shell: this.context.shell,
+      fields: CHANGELOG_ALL_FIELDS,
       logger: this.logger
     };
     const gitChangelog = new GitChangelog(props);
@@ -6693,10 +8116,36 @@ var Changelog = class extends Plugin {
       changelog: changelog.join("\n")
     };
   }
+  /**
+   * Generates a tag name for a workspace
+   *
+   * Uses the configured tag template to generate a tag name
+   * for the workspace. Handles errors by providing a fallback.
+   *
+   * @param workspace - Workspace configuration
+   * @returns Generated tag name
+   *
+   * @example
+   * ```typescript
+   * // With default template
+   * const tag = plugin.generateTagName({
+   *   name: 'pkg-a',
+   *   version: '1.0.0'
+   * });
+   * // 'pkg-a@1.0.0'
+   *
+   * // With error (fallback)
+   * const tag = plugin.generateTagName({
+   *   name: 'pkg-a'
+   * });
+   * // 'pkg-a-v0.0.0'
+   * ```
+   * @private
+   */
   generateTagName(workspace) {
     try {
       const tagTemplate = this.getConfig("tagTemplate");
-      return this.shell.format(
+      return Shell5.format(
         tagTemplate,
         workspace
       );
@@ -6705,10 +8154,42 @@ var Changelog = class extends Plugin {
       return `${workspace.name}-v0.0.0`;
     }
   }
+  /**
+   * Gets the appropriate tag name for a workspace
+   *
+   * Attempts to find the latest tag for the workspace, falling back
+   * to generating a new tag if none exists. Uses git commands to
+   * find and sort tags by creation date.
+   *
+   * Process:
+   * 1. Generate current tag pattern
+   * 2. Search for existing tags matching pattern
+   * 3. Return latest tag or generate new one
+   *
+   * @param workspace - Workspace configuration
+   * @returns Promise resolving to tag name
+   *
+   * @example
+   * ```typescript
+   * // With existing tags
+   * const tag = await plugin.getTagName({
+   *   name: 'pkg-a',
+   *   version: '1.0.0'
+   * });
+   * // Returns latest matching tag: 'pkg-a@0.9.0'
+   *
+   * // Without existing tags
+   * const tag = await plugin.getTagName({
+   *   name: 'pkg-b',
+   *   version: '1.0.0'
+   * });
+   * // Returns new tag: 'pkg-b@1.0.0'
+   * ```
+   */
   async getTagName(workspace) {
     try {
       const currentTagPattern = this.generateTagName(workspace);
-      const tagMatch = this.shell.format(
+      const tagMatch = Shell5.format(
         this.getConfig("tagMatch"),
         workspace
       );
@@ -6731,8 +8212,33 @@ var Changelog = class extends Plugin {
       return fallbackTag;
     }
   }
+  /**
+   * Determines the version increment type
+   *
+   * Checks for increment labels in the following order:
+   * 1. 'increment:major' label
+   * 2. 'increment:minor' label
+   * 3. Configured increment value
+   * 4. Default to 'patch'
+   *
+   * @returns Version increment type
+   *
+   * @example
+   * ```typescript
+   * // With labels
+   * context.options.workspaces.changeLabels = ['increment:major'];
+   * plugin.getIncrement(); // 'major'
+   *
+   * // With configuration
+   * const plugin = new Changelog(context, { increment: 'minor' });
+   * plugin.getIncrement(); // 'minor'
+   *
+   * // Default
+   * plugin.getIncrement(); // 'patch'
+   * ```
+   */
   getIncrement() {
-    const lables = this.context.getConfig("workspaces.changeLabels");
+    const lables = this.context.getOptions("workspaces.changeLabels");
     if (Array.isArray(lables) && lables.length > 0) {
       if (lables.includes("increment:major")) {
         return "major";
@@ -6744,13 +8250,50 @@ var Changelog = class extends Plugin {
     const increment = this.getConfig("increment", "patch");
     return increment;
   }
+  /**
+   * Generates a changeset file for a workspace
+   *
+   * Creates a changeset file containing version increment
+   * information and changelog content. Handles dry run mode
+   * and existing files.
+   *
+   * File format:
+   * ```yaml
+   * ---
+   * 'package-name': 'increment-type'
+   * ---
+   *
+   * changelog content
+   * ```
+   *
+   * @param workspace - Workspace configuration
+   *
+   * @example
+   * ```typescript
+   * const workspace = {
+   *   name: 'pkg-a',
+   *   version: '1.0.0',
+   *   changelog: '- feat: new feature'
+   * };
+   *
+   * await plugin.generateChangesetFile(workspace);
+   * // Creates .changeset/pkg-a-1.0.0.md
+   * ```
+   *
+   * @example Dry run
+   * ```typescript
+   * context.dryRun = true;
+   * await plugin.generateChangesetFile(workspace);
+   * // Logs file content without creating file
+   * ```
+   */
   async generateChangesetFile(workspace) {
     const { name, version: version2 } = workspace;
     const changesetName = `${name}-${version2}`.replace(/[\/\\]/g, "_");
     const changesetPath = join4(this.changesetRoot, `${changesetName}.md`);
     const increment = this.getIncrement();
     this.logger.debug("increment is:", [increment]);
-    const fileContent = this.shell.format(contentTmplate, {
+    const fileContent = Shell5.format(contentTmplate, {
       ...workspace,
       increment
     });
@@ -6775,18 +8318,93 @@ var innerTuples = [
   tuple(Changelog, {}),
   tuple(GithubPR, {})
 ];
+var defaultName = "release";
 var ReleaseTask = class {
+  /**
+   * Creates a new ReleaseTask instance
+   *
+   * Initializes the release context and sets up plugin configuration.
+   * Supports custom executors and plugin configurations.
+   *
+   * @param options - Release context configuration
+   * @param executor - Custom async executor (optional)
+   * @param defaultTuples - Plugin configuration tuples (optional)
+   *
+   * @example
+   * ```typescript
+   * // Basic initialization
+   * const task = new ReleaseTask({
+   *   rootPath: '/path/to/project',
+   *   sourceBranch: 'main'
+   * });
+   *
+   * // With custom executor and plugins
+   * const task = new ReleaseTask(
+   *   { rootPath: '/path/to/project' },
+   *   new AsyncExecutor(),
+   *   [tuple(CustomPlugin, { option: 'value' })]
+   * );
+   * ```
+   */
   constructor(options = {}, executor = new AsyncExecutor(), defaultTuples = innerTuples) {
     this.executor = executor;
     this.defaultTuples = defaultTuples;
-    this.context = new ReleaseContext(options);
+    this.context = new ReleaseContext(defaultName, options);
   }
+  /**
+   * Release context instance
+   * @protected
+   */
   context;
+  /**
+   * Gets the current release context
+   *
+   * @returns Release context instance
+   *
+   * @example
+   * ```typescript
+   * const task = new ReleaseTask();
+   * const context = task.getContext();
+   *
+   * console.log(context.releaseEnv);
+   * console.log(context.sourceBranch);
+   * ```
+   */
   getContext() {
     return this.context;
   }
+  /**
+   * Loads and configures plugins for the release task
+   *
+   * Combines default and external plugins, initializes them with
+   * the current context, and configures special cases like the
+   * Workspaces plugin.
+   *
+   * Plugin Loading Process:
+   * 1. Merge default and external plugins
+   * 2. Initialize plugins with context
+   * 3. Configure special plugins
+   * 4. Add plugins to executor
+   *
+   * @param externalTuples - Additional plugin configurations
+   * @returns Array of initialized plugins
+   *
+   * @example Basic usage
+   * ```typescript
+   * const task = new ReleaseTask();
+   * const plugins = await task.usePlugins();
+   * ```
+   *
+   * @example Custom plugins
+   * ```typescript
+   * const task = new ReleaseTask();
+   * const plugins = await task.usePlugins([
+   *   tuple(CustomPlugin, { option: 'value' })
+   * ]);
+   * ```
+   */
   async usePlugins(externalTuples) {
-    externalTuples = externalTuples || this.context.shared.plugins || [];
+    externalTuples = externalTuples || this.context.options.plugins || [];
     const plugins = await loaderPluginsFromPluginTuples(this.context, [
       ...this.defaultTuples,
       ...externalTuples
@@ -6799,12 +8417,65 @@ var ReleaseTask = class {
     });
     return plugins;
   }
+  /**
+   * Executes the release task
+   *
+   * Internal method that runs the task through the executor.
+   * Preserves the context through the execution chain.
+   *
+   * @returns Execution result
+   * @internal
+   */
   async run() {
     return this.executor.exec(
       this.context,
       (context) => Promise.resolve(context)
     );
   }
+  /**
+   * Main entry point for executing the release task
+   *
+   * Checks environment conditions, loads plugins, and executes
+   * the release process. Supports additional plugin configuration
+   * at execution time.
+   *
+   * Environment Control:
+   * - Checks FE_RELEASE environment variable
+   * - Skips release if FE_RELEASE=false
+   *
+   * @param externalTuples - Additional plugin configurations
+   * @returns Execution result
+   * @throws Error if release is skipped via environment variable
+   *
+   * @example Basic execution
+   * ```typescript
+   * const task = new ReleaseTask();
+   * await task.exec();
+   * ```
+   *
+   * @example With additional plugins
+   * ```typescript
+   * const task = new ReleaseTask();
+   * await task.exec([
+   *   tuple(CustomPlugin, { option: 'value' })
+   * ]);
+   * ```
+   *
+   * @example Environment control
+   * ```typescript
+   * // Skip release
+   * process.env.FE_RELEASE = 'false';
+   *
+   * const task = new ReleaseTask();
+   * try {
+   *   await task.exec();
+   * } catch (e) {
+   *   if (e.message === 'Skip Release') {
+   *     console.log('Release skipped via environment variable');
+   *   }
+   * }
+   * ```
+   */
   async exec(externalTuples) {
     if (this.context.env.get("FE_RELEASE") === "false") {
       throw new Error("Skip Release");
@@ -6863,16 +8534,11 @@ function programArgs() {
     splitWithComma
   );
   program.parse();
-  return reduceOptions(program.opts(), "shared");
+  return reduceOptions(program.opts(), "global");
 }
 async function main() {
-  const { shared: commonOptions, ...allOptions } = programArgs();
-  const { dryRun, verbose, ...shared } = commonOptions;
-  const options = Object.assign(
-    allOptions,
-    {}
-  );
-  await new ReleaseTask({ dryRun, verbose, options, shared }).exec();
+  const { global: global2, ...allOptions } = programArgs();
+  await new ReleaseTask({ ...global2, options: allOptions }).exec();
 }
 main().catch((e) => {
   console.error(e.message);