[AAASM-4838] 📝 (examples): Make crewai/langchain-research live-mode honest (was inert)

[Chisanan232]

What changed

Both python/crewai-research-crew and python/langchain-research-agent computed
a mock flag but never branched on it: every invocation replayed the static
scripted trajectory, while a non-mock run mislabelled the mode as "live". The
READMEs' "Switching to the live … integration" / "Switching to production mode"
sections handed users a uv run python src/main.py command that produced the
exact same scripted output — an inert "live mode" that promised a real
crew/agent loop the code never runs.

A real CrewAI crew / LangChain ReAct loop is out of scope for this example
gallery (offline, no LLM keys, CI-safe). So the fix makes the guidance honest
rather than faking a live path:

• Gate the previously dead mock flag: a non-mock invocation (with
  OPENAI_API_KEY set) now prints a clear "live integration is not implemented
  in this example — it is an offline scripted governance demo" notice and exits,
  instead of replaying the mock under a "live" label. The dead computed flag is
  removed; the mode label is now always mock (offline).
• Rewrite the module docstrings and the READMEs' live/production sections to
  state plainly that these are offline scripted demos with no runnable live mode,
  and describe a real integration only as a conceptual, out-of-scope exercise —
  no command that the code doesn't actually run.

The offline --mock path (what CI exercises) is unchanged.

Related ticket

Closes AAASM-4838

Jira: https://lightning-dust-mite.atlassian.net/browse/AAASM-4838

How to verify

# offline demo still runs (unchanged output)
cd python/crewai-research-crew && uv sync --extra dev && uv run python src/main.py --mock
cd python/langchain-research-agent && uv sync --extra dev && uv run python src/main.py --mock

# a "live" request is now refused honestly rather than replaying the mock
OPENAI_API_KEY=sk-test uv run python src/main.py   # prints the not-implemented notice, exits

# byte-compile + smoke tests
uv run python -m py_compile src/main.py
uv run pytest tests/ -q     # crewai 6 passed / langchain 8 passed

Checklist

• PR title follows [AAASM-XXXX] <GitEmoji> (<scope>): <summary>
• No secrets, API keys, or .env files committed
• Example sub-projects include their own README.md with prerequisites and run instructions
• SDK/runtime version dependencies are documented or pinned

🤖 Generated with Claude Code

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Chisanan232]

🤖 Claude Code — PR review

Scope (AAASM-4838, MED): ✅ crewai/langchain-research 'live mode' now refuses cleanly with a clear notice instead of silently replaying the mock under a 'live' label; --mock path unchanged.

1. CI ✅ green. 2. Scope ✅ 4 files, smoke tests pass. 3. Side effects none. 4. FE n/a. Verdict: ready to merge pending Pioneer approval.