Drive Fond Gripes from your own code

{ "ok": true,  "data":  { ... } }
{ "ok": false, "error": { "code": "...", "message": "...", "status": 402, "details": { ... } } }

{"task": "gripes", "title": "...", "checks": {"mean": false, "veiled": false, "toothless": false},
 "verdict": "too_sharp | sideways | too_sweet | sweet_spot", "verdict_reason": "...",
 "balance": {"care": 4, "challenge": 4},
 "lines": [{"habit": 1, "keep": true, "line": "I hate ...", "note": ""},
           {"habit": 2, "keep": false, "line": "", "note": "..."}],
 "turn": "But mostly I ...", "fixes": ["..."]}

{
 "task": "gripes",
 "who": "roommate",
 "name": "not given",
 "tone": "cheeky",
 "habits": "1. Leaves exactly one spoonful of cereal in the box and puts the box back\n2. Sings the wrong words to every song with total confidence\n3. Says 'five more minutes' and means forty\n4. Alphabetises the spice rack but never closes a cupboard door\n5. Narrates what the cat is thinking",
 "love": "You make every boring errand feel like an adventure",
 "page_facts": "habit_count | 5\nhabit_flags | 1: none / 2: none / 3: none / 4: none / 5: none\npage_guess | unknown - from word lists only, a hint that can be wrong\nverdict_rule | check in order and stop at the first that fits: 1) too_sharp when mean is true; 2) sideways when veiled is true; 3) too_sweet when toothless is true; 4) otherwise sweet_spot"
}

{
 "task": "gripes",
 "title": "A Very Loving List of Grievances",
 "checks": {
  "mean": false,
  "veiled": false,
  "toothless": false
 },
 "verdict": "sweet_spot",
 "verdict_reason": "All five habits are specific, affectionate quirks with nothing unkind or hidden underneath, so the list lands in the sweet spot.",
 "balance": {
  "care": 4,
  "challenge": 4
 },
 "lines": [
  {
   "habit": 1,
   "keep": true,
   "line": "I hate how you leave exactly one spoonful of cereal in the box and then shamelessly put the box back anyway.",
   "note": ""
  },
  {
   "habit": 2,
   "keep": true,
   "line": "I hate how you sing the wrong words to every single song with such total confidence.",
   "note": ""
  },
  {
   "habit": 3,
   "keep": true,
   "line": "I hate how you say 'five more minutes' and somehow always mean forty.",
   "note": ""
  },
  {
   "habit": 4,
   "keep": true,
   "line": "I hate how you alphabetise the spice rack like a genius but can't ever close a cupboard door.",
   "note": ""
  },
  {
   "habit": 5,
   "keep": true,
   "line": "I hate how confidently you narrate what the cat is thinking, as if it's obvious.",
   "note": ""
  }
 ],
 "turn": "But mostly I hate how you make every boring errand feel like an adventure.",
 "fixes": [
  "Lead with the 'five more minutes meaning forty' line since it's the most specific and sets the tone right away.",
  "Save the line about narrating the cat's thoughts for last so it lands as a warm surprise."
 ]
}

{
 "task": "gripes",
 "who": "partner",
 "name": "not given",
 "tone": "gentle",
 "habits": "1. You are too generous with everyone\n2. You always remember everything I mention\n3. You work too hard\n4. Too kind",
 "love": "not given",
 "page_facts": "habit_count | 4\nhabit_flags | 1: a compliment in disguise (too generous) / 2: a compliment in disguise (always remember) / 3: a compliment in disguise (work too hard) / 4: a compliment in disguise (too kind); too short to picture\npage_guess | too_sweet - from word lists only, a hint that can be wrong\nverdict_rule | check in order and stop at the first that fits: 1) too_sharp when mean is true; 2) sideways when veiled is true; 3) too_sweet when toothless is true; 4) otherwise sweet_spot"
}

{
 "task": "gripes",
 "title": "Too Sweet For Your Own Good",
 "checks": {
  "mean": false,
  "veiled": false,
  "toothless": true
 },
 "verdict": "too_sweet",
 "verdict_reason": "Every habit reads as a compliment in disguise, with nothing specific enough to tease, so the list leans too sweet rather than sharp.",
 "balance": {
  "care": 5,
  "challenge": 0
 },
 "lines": [
  {
   "habit": 1,
   "keep": true,
   "line": "I hate how impossibly generous you are with everyone.",
   "note": ""
  },
  {
   "habit": 2,
   "keep": true,
   "line": "I hate that you remember absolutely everything I mention.",
   "note": ""
  },
  {
   "habit": 3,
   "keep": true,
   "line": "I hate that you work entirely too hard at everything you do.",
   "note": ""
  },
  {
   "habit": 4,
   "keep": true,
   "line": "I hate that you are so endlessly kind.",
   "note": ""
  }
 ],
 "turn": "But mostly I hate how much I love [the thing you love most] about you.",
 "fixes": [
  "Swap 'too generous with everyone' for a specific habit you can actually picture, not just admire.",
  "Trade 'too kind' for a small, real moment - it's too short to tease as it stands.",
  "Turn 'you work too hard' into one small, specific moment instead of a general compliment."
 ]
}

{
 "task": "gripes",
 "who": "sibling",
 "name": "Bean",
 "tone": "cheeky",
 "habits": "1. Still owes me money from the concert\n2. Has a nose like a ski jump\n3. Starts laughing at their own jokes before the punchline\n4. Too lazy to ever text back",
 "love": "You always have my back when it counts",
 "page_facts": "habit_count | 4\nhabit_flags | 1: a sore spot (owes, money) / 2: looks or a trait (nose) / 3: none / 4: an insult word (lazy)\npage_guess | too_sharp - from word lists only, a hint that can be wrong\nverdict_rule | check in order and stop at the first that fits: 1) too_sharp when mean is true; 2) sideways when veiled is true; 3) too_sweet when toothless is true; 4) otherwise sweet_spot"
}

{
 "task": "gripes",
 "title": "Bean's Fine Print of Fondness",
 "checks": {
  "mean": true,
  "veiled": false,
  "toothless": false
 },
 "verdict": "too_sharp",
 "verdict_reason": "A debt that's still owed and a comment about their nose read as real hurts rather than fond teasing, which tips this list too sharp.",
 "balance": {
  "care": 1,
  "challenge": 4
 },
 "lines": [
  {
   "habit": 1,
   "keep": false,
   "line": "",
   "note": "Money they owe is a real issue that deserves its own honest talk between them."
  },
  {
   "habit": 2,
   "keep": false,
   "line": "",
   "note": "Their nose isn't something to tease - looks are off limits here."
  },
  {
   "habit": 3,
   "keep": true,
   "line": "I hate how you crack up at your own jokes before you even reach the punchline.",
   "note": ""
  },
  {
   "habit": 4,
   "keep": false,
   "line": "",
   "note": "Not texting back might be real, but calling them lazy crosses into insult."
  }
 ],
 "turn": "But mostly I hate how much I love that you always have my back when it counts.",
 "fixes": [
  "Drop the habit about owing money from the concert and raise it directly with them.",
  "Swap the nose comment for a real small habit instead of a look they can't change.",
  "Soften 'lazy' into a warmer tease about texting back, since the word itself stings."
 ]
}

{
 "task": "gripes",
 "who": "roommate",
 "name": "not given",
 "tone": "deadpan",
 "habits": "1. Funny how the dishes are always 'soaking' when it is your turn\n2. Must be nice to sleep until noon while some of us work\n3. Hums the whole time while brushing teeth\n4. Calls every dog 'buddy', even the ones that ignore you",
 "love": "You still laugh at all my terrible jokes",
 "page_facts": "habit_count | 4\nhabit_flags | 1: a sideways dig (funny how) / 2: a sideways dig (must be nice, some of us) / 3: none / 4: none\npage_guess | sideways - from word lists only, a hint that can be wrong\nverdict_rule | check in order and stop at the first that fits: 1) too_sharp when mean is true; 2) sideways when veiled is true; 3) too_sweet when toothless is true; 4) otherwise sweet_spot"
}

{
 "task": "gripes",
 "title": "The Humming, Soaking, Buddy-Calling Files",
 "checks": {
  "mean": false,
  "veiled": true,
  "toothless": false
 },
 "verdict": "sideways",
 "verdict_reason": "Two habits turn real complaints about dishes and sleep-versus-work into sideways digs ('funny how', 'must be nice') instead of saying them plainly, which decides sideways.",
 "balance": {
  "care": 1,
  "challenge": 2
 },
 "lines": [
  {
   "habit": 1,
   "keep": false,
   "line": "",
   "note": "This is a real fairness complaint about chores - it deserves them hearing it directly."
  },
  {
   "habit": 2,
   "keep": false,
   "line": "",
   "note": "The sleep-versus-work split sounds like a real gripe - worth saying to them plainly."
  },
  {
   "habit": 3,
   "keep": true,
   "line": "I hate that you hum nonstop the whole time you're brushing your teeth, without fail.",
   "note": ""
  },
  {
   "habit": 4,
   "keep": true,
   "line": "I hate that you call every single dog 'buddy', even the ones that just ignore you completely.",
   "note": ""
  }
 ],
 "turn": "But mostly I hate how much I love that you still laugh at all my terrible jokes.",
 "fixes": [
  "Say the dishes-on-your-turn frustration straight to them, not as 'funny how' sarcasm.",
  "Raise the sleeping-until-noon-versus-working split as a real conversation, not a 'must be nice' jab.",
  "Lead with the humming-while-brushing-teeth line - it's the gentlest tease and sets the tone."
 ]
}

const K = GripeKit;
const built = K.buildInput({ who: "roommate", tone: "cheeky", name: "", habits: "Leaves one sip of milk in the carton
Hums the same three notes all day", love: "You make the worst days feel short" });
built.pre;                                       // { habits: [{ text, flags }], count, real, guess, ... } - the free habit check
const wire = K.toWire(built.input);              // POST this to /estimate and /run
// then: const reply = K.normalize(K.parseReply(job.output.output));
// K.check(reply, built).notes                   // the page's re-check of the written list
// K.verdictFor(reply.checks)                    // the verdict rule on the reply's own checks

BASE="https://api.skillsafe.ai/v1/app-api"
TOKEN="paste-your-token-here"   # from https://fond-gripes.skillsafe.ai/tokens.html
api() { # api METHOD PATH [JSON-BODY]
  curl -s -X "$1" "$BASE$2" -H "Content-Type: application/json" \
    ${TOKEN:+-H "Authorization: Bearer $TOKEN"} ${3:+--data "$3"}
}

# a guest token (enough for /me and /estimate); a run needs your personal token from /tokens.html
TOKEN=$(curl -s -X POST "$BASE/guest" -H "Content-Type: application/json" -d '{"slug":"fond-gripes"}' | jq -r '.data.token')

api GET /me | jq '.data | {subject_type, credits}' 

# input.json: the run input object - {"task": "gripes", "who": "roommate", "name": "not given", "tone": "cheeky", "habits": "1. ...", "love": "...", "page_facts": "..."} - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

KEY="fond-gripes:gripes:$(shasum -a 256 input.json | cut -c1-16):a1"
JOB=$(curl -s -X POST "$BASE/run" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $KEY" --data @input.json | jq -r '.data.job_id')
while :; do
  J=$(api GET "/jobs/$JOB"); S=$(echo "$J" | jq -r '.data.status')
  case "$S" in succeeded|failed|cancelled) break;; esac; sleep 2
done
echo "$J" | jq -r '.data.output.output' > reply.json   # one JSON object, the reply contract
echo "$J" | jq '.data | {charged_credits, truncated}' 

# Server-Sent Events: tick/delta events while the job runs, then a final event with the job
curl -N -s -X POST "$BASE/run-stream" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: fond-gripes:gripes:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json