Alias

Los alias son referencias a paquetes legibles por humanos. Utilícelos cuando los mensajes, documentos, scripts o trabajos de CI necesiten un nombre estable en lugar de un UUID de paquete sin formato.

Espacios de nombres

Cada alias vive en uno de dos espacios de nombres:

• personal — tu propia cuenta. Este es el valor predeterminado.
• espacio de trabajo: la cuenta compartida del espacio de trabajo activo. Un alias de espacio de trabajo es un único registro compartido: cualquier miembro del espacio de trabajo puede resolverlo, pero solo el propietario del paquete de destino puede redireccionarlo o eliminarlo. Esto permite llamar al grupo de un compañero de equipo casi como si fuera el suyo.

Cuando crea o elimina un alias, elija el espacio de nombres con --namespace personal|workspace (predeterminado personal).

Formularios de referencia

Un @alias simple (o alias sin @) se resuelve primero en su espacio de nombres personal y luego vuelve al espacio de trabajo activo, de modo que cuando ambos existen con el mismo nombre, su alias personal gana. Para apuntar a un espacio de nombres específico, pase --namespace personal|workspace (CLI) o namespace (API/MCP).

Los alias apuntan sólo a paquetes. Las pistas no tienen alias.

Reglas

• Los nombres de alias se almacenan sin el inicial @.
• Los nombres de alias no pueden contener / ni caracteres de control.
• Solo el propietario del paquete puede crear, redireccionar o eliminar un alias, en cualquiera de los espacios de nombres. Todos los demás simplemente lo resuelven. Para marcar el paquete de otra persona como favorito, utilice like.
• El formulario @handle/alias hace referencia al alias de otra cuenta y es de solo lectura; no se puede crear ni eliminar con él. Para elegir un espacio de nombres, pase --namespace / namespace.
• La actualización de un alias lo redirige a otro paquete.
• Al eliminar un paquete, se eliminan los alias que posee y que apuntan a ese paquete.