Suggestions

Suggestions are text-first improvement proposals for packs. Anyone who can read a workflow or context pack can send the owner a suggestion; the owner reviews and resolves it. Suggestions never edit the pack directly. See Suggestions for the lifecycle and permission model.

suggestion create costs 5 credits (the same as pack create); list costs 2 credits; get, update, and resolve cost 1 credit each. Each account can also create at most 20 suggestions per day.

Send a suggestion

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

The <reference> is a pack ID, an @alias, a share URL, or a hub URL — the same forms pack get accepts. The pack's content at creation time is captured as a snapshot. --title and --content are required; both can also be supplied through --input.

Read a suggestion

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

--include-snapshot adds the captured pack content to the response. It is omitted by default to keep responses small.

List suggestions

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 answers a different question depending on the flags:

• no flags — suggestions you submitted.
• --owner — your inbox: suggestions on packs you own.
• --reference — suggestions for one pack (optionally narrowed by --author).

--status accepts a comma-separated list of open, applied, declined, and archived. Use --page to paginate (page size 20) and --include-snapshots to include captured pack content.

list returns each suggestion's content as a short preview (truncated). Use epismo suggestion get <id> to read the full content, mirroring how pack outlines defer to a full fetch.

Update your suggestion

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

Only the suggestion's author can update its title or content.

Resolve a suggestion

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

Only the pack's owner can resolve a suggestion. --status is one of open, applied, declined, or archived. Resolving changes only the status; apply the actual change with pack update first when accepting a suggestion.

Common mistakes

• Resolving a suggestion does not edit the pack. Run pack update to make the change, then suggestion resolve --status applied.
• Only the author can update; only the owner can resolve.
• The snapshot reflects the pack as it was when the suggestion was created, not its current content.