Add interview-first sparkle-pills chat chaining and deterministic plan response

[Codex]

Canonical issue

Linked by system automation.

Outcome

This PR adds an interview-first path for “sparkle pills” requests so the system asks clarifying questions before proposing a workflow. When required answers are provided, it returns a deterministic, action-oriented plan without invoking model providers.

Scope

• Included:
• Sparkle intent gate: detects sparkle-pill requests in chat input and routes them through a dedicated chaining contract.
• Interview-first response: returns requiresInterview: true plus targeted clarifying questions when required fields are missing.
• Deterministic plan response: returns provider: "sparkle-pills-planner" and a structured operational plan once interview fields are complete.
• Contract documentation: adds CHAINING.md with request/response schema and runtime behavior.
• Focused API coverage: adds tests for both interview-first and completed-interview plan paths.
• Example snippet:

{
  "query": "Build me a system for using sparkle pills",
  "sparkleInterview": {
    "useCase": "Manage weekday focus sessions",
    "trigger": "Start each weekday at 08:30",
    "tools": ["Google Calendar", "Slack"],
    "constraints": "No notifications after 21:00",
    "successSignal": "5 sessions completed per week"
  }
}

• Explicitly excluded:
• Changes to non-sparkle chat routing behavior.
• Any new external integrations, deployment workflows, or dependency updates.

Risk

• Risk level: low
• Failure mode:
  Sparkle detection could match unintended prompts and return interview payloads instead of normal chat output.
• Rollback:
  Revert the sparkle branch in apps/web/src/app/api/chat/route.ts and remove apps/web/src/lib/sparkle-pills.ts.

Verification

List exact automated and manual checks, tied to the current head SHA.

• Focused tests
• Required CI
• Review threads resolved

Production evidence

Not applicable for production behavior claims in this PR description; change is API-path scoped and documented by route contract (CHAINING.md).

Agent handoff

• One canonical issue is linked
• No competing PR implements the same issue
• Acceptance criteria are satisfied
• Required checks pass on the current head
• Human decision is requested only for product, security, irreversible infrastructure, or production approval

Security dependency evidence

• Advisory: Not applicable (no advisory-driven dependency change)
• Package and versions: Not applicable
• Validation: Not applicable
• Rollback: Not applicable

• Fixes [Agent] #2429

[vercel]

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

Project	Deployment	Actions	Updated
v0-uvai	Ready	Preview, v0	Oct 15, 2026 7:04am UTC

[coderabbitai]

Important

Review skipped

Ignore keyword(s) in the title.

⛔ Ignored keywords: 3

• WIP
• DO NOT MERGE
• [skip ci]

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: Repository: groupthinking/EventRelay/.coderabbit.yaml
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: a94f91f1-c964-4145-9124-df4836173ffe

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

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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.}