Add public demo scenario manifest endpoint

[emrekayat]

Why this matters

A public scenario manifest helps reviewers reproduce the exact demo path: provider comparison, paid query, result display, and analytics refresh.

Scope

Add a read-only endpoint returning the canonical demo scenarios supported by the app:

• scenario id;
• mode (search, news, scrape);
• recommended provider;
• sample query;
• expected evidence fields;
• whether it works in demo mode and real mode.

Suggested files:

• apps/api/src/routes/public.ts
• apps/web/src/App.tsx
• packages/shared/src/schemas.ts

Acceptance criteria

• Endpoint returns stable JSON without requiring payment or credentials.
• Web can optionally use the manifest to populate demo presets or a reviewer checklist.
• Tests cover response shape and at least one scenario per mode.
• No provider execution occurs when fetching the manifest.
• Existing API tests pass.

Wave complexity

High - makes SCF demo reproducibility easier and safer.

[adepoju2006]

@adepoju2006 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I have experience building lightweight read-only manifest endpoints in Node.js backends. I'll implement a public /demo/scenarios endpoint returning the canonical demo scenarios with id, mode, recommended_provider, and sample_query fields, making the demo path fully reproducible for reviewers without requiring any auth or setup.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @adepoju2006 to this issue.

[OG-wura]

@OG-wura has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Can I please work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @OG-wura to this issue.

[drips-wave]

Congratulations, @OG-wura! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @OG-wura: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊