vibn-agent-runner/docs/AI_PATH_B_EXECUTION_PLAN.md

AI Path B (Shipped)

Note: This document outlines the architecture for "Path B", which shifted the AI's execution context from Cloud Run to persistent per-project Docker containers hosted on the Coolify server. This architecture was fully successfully shipped in May 2026.

Architecture

• Every project has a persistent Gitea repository.
• Every project gets a single vibn-dev container provisioned as a Coolify service (ensureDevContainer).
• The AI runs its tools (like shell_exec and fs_*) inside this container using docker exec via the Coolify API.
• Dev servers (like npm run dev) bind to 0.0.0.0:3000 and are exposed to the internet via Traefik wildcard subdomains (*.preview.vibnai.com).
• When the user is ready, the code is committed to Gitea and deployed to production via apps_deploy.

(Refer to lib/ai/vibn-tools.ts and app/api/mcp/route.ts for the live implementation).