feat(solutions): support linked Databricks Blog articles alongside native posts

[andrelandgraf]

Summary

The Solutions tab now supports two kinds of entries via a discriminated union:

• Native solutions (type: "native"): authored on DevHub. Markdown lives in content/solutions/<id>.md, build-time generates /solutions/<id> like before.
• Linked solutions (type: "linked"): pure metadata + Open Graph preview image. Cards on the index page deep-link to the original article (no detail route, no markdown stored). Adds four hand-picked Databricks Blog articles:
  • How to Build Production-Ready Data and AI Apps with Databricks Apps and Lakebase
  • Ship quality enterprise AI agents to business users with Agent Bricks and Databricks Apps
  • How to use Lakebase as a transactional data layer for Databricks Apps
  • Database Branching in Postgres: Git-Style Workflows with Databricks Lakebase

TypeScript guarantees you can't construct a half-linked / half-native solution: Solution = NativeSolution | LinkedSolution, with isNativeSolution / isLinkedSolution guards used at every fork in the renderer, the content-entries plugin (only emits routes for native), llms.txt, and the /solutions.md index.

Preview

Light mode

Dark mode

Image format

Linked-solution previews use the Open Graph standard (1.91:1) so we can drop the upstream OG asset in directly. npm run verify:images now enforces a second contract:

Folder	Aspect	Min size	Used by
static/img/{guides,examples}/	16:9 ±2%	1600x900	recipes, examples, cookbooks
static/img/solutions/	1.91:1 ±2%	1200x628	linked-solution OG previews

The four downloaded OG images are normalized to 1.91:1 (the one 2:1 outlier was lightly cropped with sips) and rendered in a fixed aspect-[1.91/1] container with object-cover so the grid stays consistent regardless of source resolution.

Test plan

• npm run fmt
• npm run typecheck
• npm run verify:images (new 1.91:1 rule on static/img/solutions/)
• npm run build (also runs in pre-commit)
• npx vitest run — 164/164 pass, including new tests/solutions.test.ts (discriminator parity, unique ids, linked-metadata invariants) and updated tests/smoke.test.ts (llms.txt mixes internal .md for native and external URLs for linked)
• npx playwright test — 93/93 pass (no /solutions/ route is emitted, /solutions and /solutions/devhub-launch still load)
• Manual verification with agent-browser in light + dark mode at http://localhost:3001/solutions