Sugerencias

Las sugerencias son propuestas de mejora para paquetes basadas en texto. Cualquiera que pueda leer un flujo de trabajo o un paquete contextual puede enviar una sugerencia al propietario; el propietario lo revisa y soluciona. Las sugerencias nunca editan el paquete directamente. Consulte Sugerencias para conocer el ciclo de vida y el modelo de permisos.

suggestion create cuesta 5 créditos (lo mismo que pack create); list cuesta 2 créditos; get, update y resolve cuestan 1 crédito cada uno. Cada cuenta también puede crear como máximo 20 sugerencias por día.

Enviar una sugerencia

epismo suggestion create @market-research --title "Add review step" \
  --content "Add a final human review before publishing to reduce hallucinated findings."
epismo suggestion create $PACK_ID --input @suggestion.json

El <reference> es un ID de paquete, un @alias, una URL compartida o una URL central: los mismos formularios que acepta pack get. El contenido del paquete en el momento de la creación se captura como una instantánea. Se requieren --title y --content; ambos también se pueden suministrar a través de --input.

Leer una sugerencia

epismo suggestion get $SUGGESTION_ID
epismo suggestion get $SUGGESTION_ID --include-snapshot

--include-snapshot agrega el contenido del paquete capturado a la respuesta. Se omite de forma predeterminada para mantener las respuestas pequeñas.

Lista de sugerencias

epismo suggestion list                                # suggestions you submitted
epismo suggestion list --owner --status open          # your inbox, open only
epismo suggestion list --reference @market-research   # for one pack
epismo suggestion list --status open,declined         # filter by status
epismo suggestion list --author $ACCOUNT_ID --reference @market-research

list responde una pregunta diferente según las banderas:

• sin banderas: sugerencias que enviaste.
• --owner — tu bandeja de entrada: sugerencias sobre paquetes que posees.
• --reference: sugerencias para un paquete (opcionalmente reducidas por --author).

--status acepta una lista separada por comas de open, applied, declined y archived. Utilice --page para paginar (tamaño de página 20) y --include-snapshots para incluir contenido del paquete capturado.

list devuelve el content de cada sugerencia como una breve vista previa (truncada). Utilice epismo suggestion get <id> para leer el contenido completo, reflejando cómo los esquemas de los paquetes difieren hasta una recuperación completa.

Actualiza tu sugerencia

epismo suggestion update $SUGGESTION_ID --title "Add review step" \
  --content "Please add a reviewer approval step before publish."

Sólo el autor de la sugerencia puede actualizar su título o contenido.

Resolver una sugerencia

epismo suggestion resolve $SUGGESTION_ID --status applied
epismo suggestion resolve $SUGGESTION_ID --status declined
epismo suggestion resolve $SUGGESTION_ID --status archived

Sólo el propietario del pack puede resolver una sugerencia. --status es uno de open, applied, declined o archived. La resolución cambia sólo el estado; aplique el cambio real con pack update primero al aceptar una sugerencia.

Errores comunes

• Resolver una sugerencia no edita el pack. Ejecute pack update para realizar el cambio, luego suggestion resolve --status applied.
• Sólo el autor puede update; sólo el propietario puede resolve.
• La instantánea refleja el paquete tal como estaba cuando se creó la sugerencia, no su contenido actual.