feat: headless gift flow — CLI + agent skill for operating without UI

[Tar-ive]

Summary

Adds a headless CLI mode so an agent (Devin, Claude Code, etc.) can operate the entire gift flow — generate invite link, poll for completion, view Maxi's picks, checkout — without opening the app.

New files:

• web/scripts/headless-gift.mjs — Node.js CLI with 4 actions:

  generate-link  → builds /invite/<code> URL with sender/recipient/occasion/date
  poll           → long-polls GET /connections until a new challenge completes
  bundle         → calls GET /bundles, renders items + shipping + late flags
  checkout       → outputs purchase links + total for one-tap buying
  

• .agents/skills/headless-gift/SKILL.md — Devin-invocable skill wrapping the above

Auth model (open question): Currently supports --admin-token / GIFTMAXXING_ADMIN_TOKEN for agent environments. Clerk JWT CLI login not yet wired — this is a known gap that needs design input before merging.

Example:

node web/scripts/headless-gift.mjs --action generate-link \
  --sender-id "user_xxx" --sender-name "Saksham" \
  --recipient "Thaman" --occasion birthday --date 2026-07-26
# → outputs https://giftmaxxing.com/invite/...

node web/scripts/headless-gift.mjs --action poll --sender-id "user_xxx"
# → watches until Thaman finishes swiping, prints connection ID

node web/scripts/headless-gift.mjs --action bundle \
  --sender-id "user_xxx" --connection-id "conn_abc123"
# → shows Maxi's picks with prices and shipping estimates

Link to Devin session: https://calhacks-promptetheus.devinenterprise.com/sessions/3d8a7a08115f45c8938df8f9862f2f84
Requested by: @Tar-ive

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment, CI, and merge conflict monitoring

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
giftmaxxing	Ready	Preview, Comment, Open in v0	Jun 28, 2026 2:56pm

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: bb52835c-55df-43fd-b774-83ff92d5c06c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch devin/headless-gift-flow

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}