feat(scripts): run the examples this machine is set up for

[williedoran-neo4j]

Last of the chain-B PRs. Stacked on #602 — the diff above contains #597, #599 and #602 until they merge; this PR's own change is the final commit.

Adds --live to the examples checker: an opt-in, manual-stage run of every example this machine can actually support. Nothing invokes it on commit, on push, or in CI.

The point of the restructure

What "set up for" means is now the doctor's judgement rather than a second opinion.

The version this replaces kept its own gate — a hardcoded RUNNABLE_PROVIDERS = {"openai"} plus a services check — which had drifted from blockers_for. Measured against the real corpus, it skipped 30 examples across 12 providers that were perfectly runnable, whatever credentials you had. Two implementations of the same question, disagreeing.

Delegating deletes RUNNABLE_PROVIDERS, _service_available (a one-line pass-through) and providers_used (already dead), and gains everything the doctor checks: extras, per-provider env vars, credential probes, APOC, indexes, sibling-module imports. A skip line now carries the fix, and apply_env_file means a key living only in .env reaches the subprocess instead of failing a preflight.

Cost

The whitelist was quietly doing one job worth keeping — cost control. Removing it means the doctor green-lights considerably more. So --live now says what it is about to spend, and waits:

--live will run 51 example(s) against live provider APIs. This COSTS MONEY.
Providers billed: anthropic, bedrock, cohere, gemini, mistral, openai, vertexai
Continue? [y/N]

That is real output from this branch. --yes skips the prompt for scripted use.

Type of Change

• New feature
• Bug fix
• Breaking change
• Documentation update
• Project configuration change

Complexity

Complexity: Medium

How Has This Been Tested?

• Unit tests
• E2E tests
• Manual tests

Nothing covered the --live path before, so this adds the gating tests: snippets are never run, a blocked example is skipped rather than run, declining the prompt runs nothing and exits 0, and the prompt names the providers that will be billed. Confirmed by hand that declining runs nothing.

Checklist

• Documentation has been updated
• Unit tests have been updated
• E2E tests have been updated
• Examples have been updated
• New files have copyright header
• CLA (https://neo4j.com/developer/cla/) has been signed
• CHANGELOG.md updated if appropriate

🤖 Generated with Claude Code