vybekiit 0.7.28 → 0.7.32

package/dist/global-skills/vybekiitReferences/web/agent/goal-routes.json

@@ -0,0 +1,366 @@
+{
+  "routes": [
+    {
+      "skill": "onboarding",
+      "path": ".agents/skills/onboarding/SKILL.md",
+      "phrases": [
+        "set up my app",
+        "let's start",
+        "get me going",
+        "just bought"
+      ],
+      "wholeRequestPhrases": [
+        "hi",
+        "help",
+        "hello",
+        "hey",
+        "what is this",
+        "what can you do",
+        "where do i start"
+      ]
+    },
+    {
+      "skill": "plan-my-idea",
+      "path": ".agents/skills/plan-my-idea/SKILL.md",
+      "phrases": [
+        "help me plan",
+        "figure out my idea",
+        "think it through",
+        "marketplace",
+        "like airbnb"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "setup-payments",
+      "path": ".agents/skills/setup-payments/SKILL.md",
+      "phrases": [
+        "add payments",
+        "take money",
+        "sell something",
+        "charge people"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "go-live",
+      "path": ".agents/skills/go-live/SKILL.md",
+      "phrases": [
+        "put it online",
+        "publish",
+        "make it live",
+        "ship it",
+        "deploy"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-signin",
+      "path": ".agents/skills/add-signin/SKILL.md",
+      "phrases": [
+        "sign in",
+        "log in",
+        "create accounts",
+        "add users"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "reset-password",
+      "path": ".agents/skills/reset-password/SKILL.md",
+      "phrases": [
+        "forgot password",
+        "reset password",
+        "lost password",
+        "change password email"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "sign-in-with-email-link",
+      "path": ".agents/skills/sign-in-with-email-link/SKILL.md",
+      "phrases": [
+        "magic link",
+        "email link sign in",
+        "sign in without password",
+        "passwordless email"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "sign-in-with-phone",
+      "path": ".agents/skills/sign-in-with-phone/SKILL.md",
+      "phrases": [
+        "sign in with phone",
+        "text me a code",
+        "sms login",
+        "phone number login"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "setup-sms",
+      "path": ".agents/skills/setup-sms/SKILL.md",
+      "phrases": [
+        "set up sms",
+        "text messages",
+        "twilio",
+        "whatsapp messages",
+        "send texts"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "save-data",
+      "path": ".agents/skills/save-data/SKILL.md",
+      "phrases": [
+        "save my data",
+        "remember this",
+        "store info",
+        "add a database",
+        "book my classes",
+        "yoga booking",
+        "cancel a reservation",
+        "class scheduling",
+        "booking",
+        "reservations",
+        "appointments",
+        "student accessibility"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "design-my-data",
+      "path": ".agents/skills/design-my-data/SKILL.md",
+      "phrases": [
+        "design my database",
+        "what data do i need",
+        "what should my app remember"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-files",
+      "path": ".agents/skills/add-files/SKILL.md",
+      "phrases": [
+        "upload",
+        "store files",
+        "attachments"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "setup-email",
+      "path": ".agents/skills/setup-email/SKILL.md",
+      "phrases": [
+        "send emails",
+        "email my users",
+        "set up email"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "vybekiit-feedback",
+      "path": ".agents/skills/vybekiit-feedback/SKILL.md",
+      "phrases": [
+        "send feedback",
+        "report a kit bug",
+        "suggest a kit improvement",
+        "the kit is confusing"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "doctor",
+      "path": ".agents/skills/doctor/SKILL.md",
+      "phrases": [
+        "it's broken",
+        "nothing works",
+        "get an error",
+        "check my app"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "update-kit",
+      "path": ".agents/skills/update-kit/SKILL.md",
+      "phrases": [
+        "update the kit",
+        "get the latest",
+        "upgrade"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "harden",
+      "path": ".agents/skills/harden/SKILL.md",
+      "phrases": [
+        "lock down",
+        "make it safe",
+        "protect from abuse"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-images",
+      "path": ".agents/skills/add-images/SKILL.md",
+      "phrases": [
+        "add my logo",
+        "hero image",
+        "app icon",
+        "add images"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-teams",
+      "path": ".agents/skills/add-teams/SKILL.md",
+      "phrases": [
+        "invite teammates",
+        "add my team",
+        "organizations"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-notifications",
+      "path": ".agents/skills/add-notifications/SKILL.md",
+      "phrases": [
+        "notify users",
+        "send alerts"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-analytics",
+      "path": ".agents/skills/add-analytics/SKILL.md",
+      "phrases": [
+        "visitor stats",
+        "analytics",
+        "track usage"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-ai",
+      "path": ".agents/skills/add-ai/SKILL.md",
+      "phrases": [
+        "add ai",
+        "chatbot",
+        "smart replies"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-search",
+      "path": ".agents/skills/add-search/SKILL.md",
+      "phrases": [
+        "let users search",
+        "find things",
+        "search my data"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-realtime",
+      "path": ".agents/skills/add-realtime/SKILL.md",
+      "phrases": [
+        "live updates",
+        "real time",
+        "push changes instantly",
+        "refresh without reload"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-blog",
+      "path": ".agents/skills/add-blog/SKILL.md",
+      "phrases": [
+        "add a blog",
+        "write articles",
+        "changelog"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "buy-domain",
+      "path": ".agents/skills/buy-domain/SKILL.md",
+      "phrases": [
+        "get a domain",
+        "buy a web address",
+        "my own url"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "sign-in-with-google",
+      "path": ".agents/skills/sign-in-with-google/SKILL.md",
+      "phrases": [
+        "sign in with google",
+        "continue with google"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "check-safety",
+      "path": ".agents/skills/check-safety/SKILL.md",
+      "phrases": [
+        "am i ready to ship",
+        "is my app safe",
+        "did we cover security"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "track-errors",
+      "path": ".agents/skills/track-errors/SKILL.md",
+      "phrases": [
+        "tell me when things break",
+        "error alerts",
+        "app crashes"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "watch-my-app",
+      "path": ".agents/skills/watch-my-app/SKILL.md",
+      "phrases": [
+        "watch my app",
+        "check if my app is working",
+        "tell me when my app is down"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "back-up-my-code",
+      "path": ".agents/skills/back-up-my-code/SKILL.md",
+      "phrases": [
+        "save my code",
+        "back up",
+        "put it on github"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "validate-my-idea",
+      "path": ".agents/skills/validate-my-idea/SKILL.md",
+      "phrases": [
+        "validate my idea",
+        "test demand",
+        "start a waitlist",
+        "test my offer"
+      ],
+      "wholeRequestPhrases": []
+    },
+    {
+      "skill": "add-language",
+      "path": ".agents/skills/add-language/SKILL.md",
+      "phrases": [
+        "translate my app",
+        "add spanish",
+        "make it hebrew"
+      ],
+      "wholeRequestPhrases": []
+    }
+  ]
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-agent.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "vybekiit": {
+      "command": "node",
+      "args": [
+        "../../packages/agentMcp/dist/bin.js"
+      ],
+      "env": {
+        "VYBEKIIT_PROJECT_ROOT": ".",
+        "VYBEKIIT_UI_CATALOG_PATH": ".vybekiit/agent/ui-catalog-index.json"
+      }
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-firebase.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "firebase": {
+      "command": "npx",
+      "args": ["-y", "firebase-tools@latest", "mcp"]
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-mongodb.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "mongodb": {
+      "command": "npx",
+      "args": ["-y", "mongodb-mcp-server@latest"],
+      "env": {
+        "MDB_MCP_CONNECTION_STRING": "",
+        "MDB_MCP_READ_ONLY": "true"
+      }
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-neon.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "neon": {
+      "url": "https://mcp.neon.tech/mcp?readonly=true",
+      "headers": {}
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-paypal.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "paypal": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.sandbox.paypal.com/http"]
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-posthog.json

@@ -0,0 +1,17 @@
+{
+  "mcpServers": {
+    "posthog": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "mcp-remote@latest",
+        "https://mcp.posthog.com/mcp",
+        "--header",
+        "Authorization:${POSTHOG_AUTH_HEADER}"
+      ],
+      "env": {
+        "POSTHOG_AUTH_HEADER": "Bearer ${POSTHOG_API_KEY}"
+      }
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-railway-local.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "railway": {
+      "command": "railway",
+      "args": ["mcp"]
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-railway-remote.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "railway": {
+      "url": "https://mcp.railway.com"
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-sentry.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "sentry": {
+      "url": "https://mcp.sentry.dev/mcp"
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-setup.md

@@ -0,0 +1,174 @@
+# MCP setup — Cursor, Claude Code, Claude Desktop, Codex (agent-only)
+
+Merge provider snippets from `.vybekiit/agent/mcp-*.json` into the buyer's AI client config. **Preserve existing servers** — never replace the whole file.
+
+## Cursor
+
+**Config:** project `.cursor/mcp.json` or global `~/.cursor/mcp.json`
+
+1. Open the config file (create with `{ "mcpServers": {} }` if missing).
+2. Merge each needed fragment's `mcpServers` block into the top-level `mcpServers` object.
+3. Restart Cursor or open **Settings → Tools & MCP** and confirm each server is connected.
+
+## Claude Code
+
+**Config:** project `.mcp.json`, or `claude mcp add --scope project <name> ...`
+
+Add a server only when the skill you are following needs it. Every connected server adds its tools
+to each session, so an idle server costs the vibe coder time and money. Merge the needed fragment's
+`mcpServers` block into `.mcp.json` (same JSON shape as Cursor), run `/mcp` to confirm it is
+connected, and remove servers the app no longer uses.
+
+## Claude Desktop
+
+**Config (macOS):** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+Same JSON shape as Cursor — merge `mcpServers` entries from the snippets below. Restart Claude Desktop after saving.
+
+## Codex
+
+**Config:** `~/.codex/config.toml` or project `.codex/config.toml` (trusted projects only)
+
+Use `codex mcp add` interactively, or add TOML tables manually:
+
+### HTTP MCP (Stripe, Supabase, Neon)
+
+```toml
+[mcp_servers.stripe]
+url = "https://mcp.stripe.com"
+
+[mcp_servers.supabase]
+url = "https://mcp.supabase.com/mcp"
+
+[mcp_servers.neon]
+url = "https://mcp.neon.tech/mcp?readonly=true"
+```
+
+### Stdio bridge (PayPal remote)
+
+PayPal uses `mcp-remote` because the hosted server requires streamable HTTP via a local bridge:
+
+```toml
+[mcp_servers.paypal]
+command = "npx"
+args = ["-y", "mcp-remote", "https://mcp.sandbox.paypal.com/http"]
+```
+
+Production PayPal: replace sandbox URL with `https://mcp.paypal.com/http`.
+
+### Stdio (Firebase, MongoDB)
+
+```toml
+[mcp_servers.firebase]
+command = "npx"
+args = ["-y", "firebase-tools@latest", "mcp"]
+
+[mcp_servers.mongodb]
+command = "npx"
+args = ["-y", "mongodb-mcp-server@latest"]
+
+[mcp_servers.mongodb.env]
+MDB_MCP_CONNECTION_STRING = "<copy from MONGODB_URI in .env>"
+MDB_MCP_READ_ONLY = "true"
+```
+
+Restart Codex after changes. Run `/mcp` in a session to verify tools are listed.
+
+## VybeKiit first-party MCPs
+
+## Agent skill (read locally or via MCP)
+
+- Auto-discovered: `.agents/skills/use-kit-mcp/SKILL.md`
+- Platform wrapper: `.vybekiit/platform-skills/mcp-tools-vybekiit.md`
+- Via MCP (when `vybekiit` server is connected): `search_skills({ query: "mcp tools" })` then `get_skill({ id: "use-kit-mcp" })` or `list_platform_skills({ query: "mcp" })`
+
+
+
+After `pnpm build` in the monorepo (or a workspace that includes these packages):
+
+| Server | Tools | Context controls |
+|--------|-------|------------------|
+| `vybekiit` (`mcp-agent.json`) | `search_skills`, `get_skill`, `list_platform_skills`, `search_commands`, `get_command`, `search_doctor_tools`, `search_tech_ids`, `doc_fallback`, `search_automations`, `get_automation`, `run_automation`, `search_ui_components`, `get_ui_component`, `suggest_ui_blend`, `list_ui_sources` | Cursor pagination (`limit`/`cursor`/`nextCursor`), slim rows, fuzzy rank; UI tools take `fields=slim\|full` (default slim) |
+
+Env:
+
+- `VYBEKIIT_PROJECT_ROOT` — project root for skill file reads + automation cwd (default `cwd`)
+- `VYBEKIIT_UI_CATALOG_PATH` — path to `ui-catalog-index.json`
+- `VYBEKIIT_AUTOMATE_BIN` — optional absolute path to `vybekiit-automate` (otherwise package bin / monorepo dist / PATH)
+
+Prefer **search → get** (list slim, then detail) so tool responses stay small.
+
+### Browser automations (from any folder)
+
+```
+search_automations({ query: "lemon squeezy" })
+run_automation({ domain: "ls", command: "setup", dryRun: true })   # preview argv
+run_automation({ domain: "ls", command: "standby" })                # real browser
+```
+
+Shell equivalent (anywhere the monorepo or package is installed):
+
+```
+vybekiit-automate catalog --json
+vybekiit-automate ls setup --json --yes --name=Kit --price-cents=2900 --mode=test --webhook-url=…
+```
+
+`run_automation` resolves the bin automatically (env → package → monorepo dist → PATH) and runs with `cwd=VYBEKIIT_PROJECT_ROOT`.
+
+## Provider snippets (merge one or more)
+
+| When | File | Upstream docs |
+|------|------|---------------|
+| VybeKiit agent surface (skills, CLI, doctor, doc-fallback) | `mcp-agent.json` | Local `@vybekiit/agent-mcp` — always merge first |
+| Default data (`DATA_PROVIDER=supabase`) | `mcp-supabase.json` | https://supabase.com/docs/guides/ai-tools/mcp |
+| Stripe payments | `mcp-stripe.json` | https://docs.stripe.com/mcp |
+| PayPal payments | `mcp-paypal.json` | https://docs.paypal.ai/developer/tools/ai/mcp-quickstart |
+| Neon data | `mcp-neon.json` | https://neon.tech/docs/ai/neon-mcp-server |
+| Firebase data | `mcp-firebase.json` | Firebase MCP via `firebase-tools mcp` |
+| Twilio SMS / Verify | `mcp-twilio-docs.json` | https://mcp.twilio.com/docs |
+| Twilio API (optional alpha) | `mcp-twilio-alpha.json` | `@twilio-alpha/mcp` stdio bridge |
+| Sentry error alerts | `mcp-sentry.json` | https://mcp.sentry.dev/mcp |
+| PostHog analytics / flags | `mcp-posthog.json` | https://mcp.posthog.com/mcp |
+| Advanced data (`DATA_PROVIDER=mongodb`, **agent/maintainer only**) | `mcp-mongodb.json` | https://www.mongodb.com/docs/mcp-server/get-started/ |
+| Railway stack (`HOSTING_PROVIDER=railway` and/or `DATA_PROVIDER=railway`) | `mcp-railway-local.json` | https://docs.railway.com/ai/mcp-server |
+| Railway remote MCP (OAuth, no local CLI state) | `mcp-railway-remote.json` | https://docs.railway.com/ai/mcp-server |
+
+**Railway MCP — when to use which**
+
+- **Local** (`mcp-railway-local.json`): repo-linked deploys, `railway up`, variables, logs — shares CLI login. Preferred when `railway` is installed and authed (doctor runs `railway setup agent -y`).
+- **Remote** (`mcp-railway-remote.json`): OAuth at `mcp.railway.com` — project/service discovery, redeploys, `railway-agent` for multi-step ops. Use when local CLI context is unavailable.
+
+### MCP failure → official docs
+
+If an MCP server fails to connect or a tool call errors **once**, do not retry blindly:
+
+1. Run `vybekiit doc-fallback <tech-id>` (e.g. `twilio`, `supabase`, `stripe`).
+2. Follow the returned official URLs and env key hints.
+3. Tell the builder only: *"I'm double-checking the official setup guide for this — hang tight, I'll have the next step in a moment."* Never say MCP, stack trace, or provider jargon aloud.
+
+See `.vybekiit/agent/tech-references.md` for the full id → docs map.
+
+### Supabase optional query params
+
+Append to the URL for tighter scope (recommended for real data):
+
+- `?project_ref=<ref>` — limit to one project
+- `?read_only=true` — Postgres read-only user
+- Combined: `https://mcp.supabase.com/mcp?project_ref=abc123&read_only=true`
+
+OAuth login happens on first use — no PAT required for interactive clients.
+
+### PayPal OAuth
+
+First tool call opens PayPal login in the browser. Use sandbox endpoint until checkout is verified, then switch to production URL in config.
+
+## Advanced (CI / local only)
+
+- **PayPal local:** `npx -y @paypal/mcp --tools=all` with `PAYPAL_ACCESS_TOKEN` — see PayPal MCP quickstart
+- **Supabase CI:** PAT in `Authorization` header — see Supabase MCP security docs
+
+Never connect MCP to production buyer data without `read_only=true` or a dev branch.
+
+### MongoDB (agent/maintainer only)
+
+When `settings.env` has `DATA_PROVIDER=mongodb`, merge `mcp-mongodb.json` and copy `MONGODB_URI` into `MDB_MCP_CONNECTION_STRING`. Keep `MDB_MCP_READ_ONLY=true` unless a maintainer explicitly needs write tools. Buyers never see provider names — see `BUILDER-VOICE.md`.

package/dist/global-skills/vybekiitReferences/web/agent/mcp-stripe.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "stripe": {
+      "url": "https://mcp.stripe.com"
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-supabase.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "supabase": {
+      "url": "https://mcp.supabase.com/mcp"
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-twilio-alpha.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "twilio-alpha": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@twilio-alpha/mcp",
+        "--services",
+        "api_v2010,messaging_v1,verify_v2"
+      ]
+    }
+  }
+}

package/dist/global-skills/vybekiitReferences/web/agent/mcp-twilio-docs.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "twilio-docs": {
+      "url": "https://mcp.twilio.com/docs"
+    }
+  }
+}