Skip to content

docs: close out OSS migration — landed state + next-session pickup - #32

Merged
futurebuildai merged 1 commit into
masterfrom
docs/oss-migration-session-close-master
Jun 19, 2026
Merged

futurebuildai merged 1 commit into
masterfrom
docs/oss-migration-session-close-master

Conversation

@futurebuildai

Copy link
Copy Markdown
Owner

Session close-out for the OSS external-services migration. Both tracks are shipped to master + community and live on demo; this PR updates the docs to reflect the as-built state so a future session can pick up cleanly.

What changed

  • docs/oss-migration-handoff.md — rewritten from the pre-implementation two-thread plan into a landed-state / next-session pickup record: TL;DR table, merged PRs, open items (paste a real ORS key to test routing; rotate the plaintext OpenRouter key + revoke the DO token; manual-deploy note), how each piece works/operates, and the master↔community migration-number divergence. Original kickoff prompts preserved under a <details>.
  • docs/oss-migration-plan.md — status banner flipped to IMPLEMENTED + as-built deltas (FLUX.2 Pro default, async image gen, runtime ORS key, modalities:["image"], free-text Pelias).
  • docs/production-external-services-roadmap.md — fix a future-dated validation note.
  • CLAUDE.md — new short "External services are OSS-migrated" subsection so future sessions discover the OpenRouter/ORS stack + its gotchas (async image gen, [lng,lat], runtime keys).

Docs-only — no code, no migration, no behavior change.

Still open after this (tracked in the handoff)

  1. Test real ORS routing — needs a free openrouteservice.org/dev key pasted into Tech Admin → Routing (demo is in mock mode).
  2. 🔑 Rotate the OpenRouter key + revoke the DO token (both were shared in plaintext during testing).
  3. Demo auto-deploy is off (generic git: source) — manual doctl deploy for now.

🤖 Generated with Claude Code

…ckup

Both tracks (A=AI→OpenRouter, R=routing→OpenRouteService) are shipped to
master + community and live on demo, incl. async FLUX.2 Pro image gen, the
runtime ORS key (Tech Admin → Routing), and the dispatch Optimize button.

- oss-migration-handoff.md: rewritten from a pre-implementation two-thread
  plan into a close-out record — TL;DR landed state, open items (real-ORS
  test, secret rotation, manual deploy), how each piece works/operates, and
  the master↔community migration-number divergence. Original kickoff prompts
  kept under a <details> for history.
- oss-migration-plan.md: status banner → IMPLEMENTED + as-built deltas.
- production-external-services-roadmap.md: fix future-dated async note.
- CLAUDE.md: add a short "External services are OSS-migrated" subsection so
  future sessions discover the OpenRouter/ORS stack and its gotchas.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@futurebuildai
futurebuildai merged commit 7984efa into master Jun 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant