feat(mana-ai): v0.7 — cross-tick Deep Research Max pre-planning

Opt-in path for missions that want Gemini Deep Research Max (up to 60 min
per task) instead of the shallow RSS pre-research. Because Max runs well
past a single 60-second tick, the state is carried across ticks:

  tick N:   submit → INSERT mission_research_jobs row → skip planner
  tick N+k: poll → still running → skip planner (metric pending_skips)
  tick N+m: poll → completed → inject as ResolvedInput, DELETE row, plan

- ManaResearchClient talks to mana-research's new internal
  /v1/internal/research/async endpoints with X-Service-Key +
  X-User-Id. Graceful-null on transport errors so a flaky
  mana-research never crashes the tick loop.
- New table mana_ai.mission_research_jobs with PK (user_id, mission_id)
  — presence is the "pending" flag; delete-on-terminal keeps queries
  trivial.
- handleDeepResearch() encapsulates the state machine; planOneMission
  now returns a discriminated union (planned | skipped | failed) so
  "research pending" isn't miscounted as a parse failure.
- Opt-in at TWO gates to keep cost in check ($3–7/task, 1500 credits
  per run):
    1. MANA_AI_DEEP_RESEARCH_ENABLED=true server-side (default off)
    2. DEEP_RESEARCH_TRIGGER regex matches the mission objective
       (strict: "deep research", "tiefe recherche", "umfassende
       recherche", "hintergrundrecherche", "deep dive")
  Falls back to shallow RSS when either gate fails or the submit
  errors upstream.
- Prom metrics: mana_ai_research_jobs_{submitted,completed,failed}_total
  labelled by provider, plus _pending_skips_total.
- docker-compose wires MANA_RESEARCH_URL + the opt-in flag and adds
  mana-research to depends_on.
- Full write-up with real API response shape (outputs plural, not
  OpenAI-style), step-3 MCP-server plan (security-gated, not built),
  ops + kill-switch: docs/reports/gemini-deep-research.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.env.development

@@ -178,6 +178,19 @@ MANA_LLM_URL=https://llm.mana.how
 MANA_LLM_API_KEY=
 MANA_LLM_DEFAULT_MODEL=gemma3:4b
 
+# mana-research — unified research orchestration (port 3068). Fronts
+# search + extract + sync/async research agents behind one API. mana-ai
+# calls the service-to-service /api/v1/internal/research/async path
+# for cross-tick Deep Research Max jobs.
+MANA_RESEARCH_URL=http://localhost:3068
+
+# mana-ai deep-research opt-in. When true AND a mission's objective
+# matches DEEP_RESEARCH_TRIGGER (see services/mana-ai/src/cron/tick.ts),
+# mana-ai submits a gemini-deep-research-max task (~$3–7 / 1500 credits
+# per run) and polls across ticks instead of the shallow RSS path.
+# Keep this off in dev unless you're actively testing the feature.
+MANA_AI_DEEP_RESEARCH_ENABLED=false
+
 # mana-crawler — Go service. Default binary port is 3023 (local dev);
 # the macmini docker-compose overrides to 3014 internally. Used by the
 # Kontext URL import endpoint (POST /api/v1/context/import-url) to