--- category: reference tags: [dev, phase-1] last_updated: 2026-03-13 confidence: high --- # Phase 1 Progress ## Task Status | Task | Status | Branch/Repo | Notes | |------|--------|-------------|-------| | P1-1 | Complete | `otterwiki` fork, `wikibot-io` branch | Lambda adapter using apig-wsgi (not Mangum — Mangum is ASGI-only, Flask is WSGI). EFS requirements documented. 325 tests pass. | | P1-2 | Complete | `otterwiki-semantic-search`, merged to `main` | FAISS backend + Bedrock embedding adapter. ChromaDB still default. 56 tests pass. | | P1-3 | Complete | `wikibot-io`, merged to `main` | Otterwiki on Lambda with EFS. URL: `https://jj75wak0pj.execute-api.us-east-1.amazonaws.com`. Cold start ~3.1s, warm 5-600ms. | | P1-4 | Complete | `wikibot-io`, merged to `main` | REST API plugin on Lambda. 20 integration tests pass. Plugin loaded via explicit import (entry points stripped in build). | | P1-5 | In progress | `wikibot-io`, `feat/P1-5-mcp-lambda` | Full MCP server replacing P0-7 PoC. | | P1-6 | In progress | `wikibot-io`, `feat/P1-6-semantic-search-lambda` | FAISS + Bedrock on Lambda with VPC endpoint. | | P1-7 | Complete | `wikibot-io`, merged to `main` | Custom domain `dev.wikibot.io` with ACM TLS. Single API Gateway, path-based routing. | | P1-8 | Not started | — | E2E test. Blocked on P1-5, P1-6. | ## Architecture Decisions ### apig-wsgi instead of Mangum (P1-1 / P1-3) Mangum v0.15+ is ASGI-only. Otterwiki is Flask/WSGI. Switched to `apig-wsgi` which directly adapts WSGI apps for API Gateway v2 events. ### Zip package + Lambda layer instead of Docker (P1-3) Docker daemon not available in dev container. Zip approach: `pip install --target` with `--platform manylinux2014_x86_64`. Package size: 73MB uncompressed / 24MB compressed. Git binary from `lambci/git-lambda2` layer. ### Single API Gateway (P1-7) Consolidated MCP and otterwiki onto one API Gateway. A custom domain can only map to one API Gateway. Routes: `$default` → otterwiki, `ANY /mcp` and `ANY /mcp/{proxy+}` → MCP Lambda. ### MCP on separate Lambda, no VPC (P0-7) MCP Lambda needs internet access for WorkOS JWKS endpoint. Putting it in VPC would require NAT. Since MCP doesn't need EFS, `SimpleLambdaComponent` (no VPC) is simpler and cheaper. ### Plugin loading via explicit import (P1-4) Build step strips `.dist-info` directories to save space, which breaks pluggy's `load_setuptools_entrypoints()`. Workaround: `import otterwiki_api` in `lambda_init.py` triggers self-registration before the Flask app initializes. ## Endpoints | Endpoint | Status | |----------|--------| | `https://dev.wikibot.io/` | Live — Otterwiki web UI | | `https://dev.wikibot.io/api/v1/health` | Live — REST API | | `https://dev.wikibot.io/mcp` | Live — MCP (P0-7 PoC, being replaced by P1-5) | ## Also Completed (Track B / Prerequisites) | Task | Status | Notes | |------|--------|-------| | P0-7 | Complete | FastMCP + WorkOS OAuth on Lambda. 15 tests. Merged to `main`. | | WorkOS config | Complete | Google, Apple, GitHub OAuth providers. API key + Client ID in Pulumi config. AuthKit domain: `appreciative-seed-37-staging.authkit.app`. DCR + CIMD enabled. | | Pulumi fix | Complete | Added `PULUMI_BACKEND_URL` to `pulumi.sh` to avoid conflicts with other Pulumi backends. |