@groundfloorcloud/mcp 0.1.2 → 0.1.3

package/README.md

@@ -67,11 +67,15 @@ The `command` must be your Node (from `which node`), not `npx` and not Cursor’
 | `coderunner_list` / `_get_status` / `_get_logs` | Inspect workloads |
 | `apps_list` / `apps_get` | Inspect product Apps |
 | `secrets_list` / `files_list` / `domains_list` / `dataplane_status` | Inspect (no secrets values) |
-| `docs_list` / `docs_get` | Product docs (`coderunner` returns the full type/auth/Dockerfile guide) |
+| `docs_list` / `docs_get` | Product docs (`coderunner` and `shell` are embedded how-tos) |
 | `suggest_cli` | Command to run: login, deploy, init_app, publish_app, … |
 
 Never create `app_kind=coderunner`. Deploy with `gf deploy`.
 
+**Shell apps:** `docs_get` id `shell`. Always `gf apps init --slug <portal-slug>`,
+then `npm run release` and `gf apps publish --path release.zip`. Do not invent
+`App.tsx` / `vite.config`, zip `dist/`, or upload only `remoteEntry.js`.
+
 **Coderunner how-to** is embedded: `docs_get` id `coderunner` (also
 `coderunner-overview`). That page covers:
 

package/dist/index.js

@@ -517,6 +517,40 @@ Inspect: \`workspace_context\`, \`docs_get\` id \`coderunner\`, \`suggest_cli\`.
 Act: \`gf deploy\`, \`gf coderunner run|status\`. MCP does not deploy.
 `.trim();
 
+// src/shell-guide.ts
+var SHELL_APP_GUIDE = `
+# Shell federated apps
+
+A Groundfloor **App** (app_kind=shell_federated) is a Module Federation remote
+loaded by the workspace Shell. It is **not** a Coderunner. Do not \`gf deploy\`.
+
+## Required path (do not invent a Vite app)
+
+Agents must not scaffold App.tsx, vite.config.ts, or BrowserRouter from memory.
+A from-scratch remote 404s in Shell (missing sibling chunks) or crashes
+(extra Router). Federation \`name\` must be federationRemoteName(slug)
+(\`hello-world\` \u2192 \`hello_world\`).
+
+\`\`\`bash
+gf apps create --name "Hello World" --slug hello-world --kind shell_federated
+gf apps init --slug hello-world
+cd hello-world
+npm install
+# edit src/ inside the kit only
+npm run release
+gf apps publish --path release.zip
+\`\`\`
+
+\`npm run release\` packs **all** of dist/assets (remoteEntry.js + hashed
+\`__federation_*.js\` + CSS) at the zip root. Do not zip \`dist/\`. Do not
+upload a lone \`remoteEntry.js\`. \`gf apps publish\` rejects incomplete zips.
+
+## suggest_cli
+
+- init_app \u2192 \`gf apps init --slug <portal-slug>\`
+- publish_app \u2192 init + npm install + npm run release + gf apps publish --path release.zip
+`;
+
 // src/docs.ts
 var DOCS_ORIGIN = "https://docs.groundfloor.cloud";
 var DOC_CATALOG = [
@@ -524,7 +558,7 @@ var DOC_CATALOG = [
     id: "agents",
     title: "Deploy with agents",
     path: "/docs/customer-portal/agents",
-    summary: "How agents should deploy Coderunner workloads and init/publish Shell apps with gf / MCP. Enable workspace Authentication before create. Service (Deployment) requires a Dockerfile."
+    summary: "How agents should deploy Coderunner workloads and init/publish Shell apps with gf / MCP. Enable workspace Authentication before create. Service (Deployment) requires a Dockerfile. Shell apps: gf apps init, never invent App.tsx."
   },
   {
     id: "developers",
@@ -562,7 +596,8 @@ var DOC_CATALOG = [
     id: "shell",
     title: "Shell federated apps",
     path: "/docs/integrations/shell",
-    summary: "Product Apps vs Coderunner deploy."
+    summary: "Product Apps vs Coderunner. Always gf apps init --slug <portal-slug>, then npm run release and gf apps publish --path release.zip. Never zip dist/ or upload only remoteEntry.js.",
+    embedded: SHELL_APP_GUIDE
   }
 ];
 function docUrl(entry) {
@@ -652,14 +687,14 @@ function suggestCli(intent, args) {
       const slug = args?.slug?.trim();
       return {
         command: slug ? `gf apps init --slug ${slug}` : "gf apps init --slug <portal-slug>",
-        why: "Download the official Shell starter-kit and stamp APP_ID. Never scaffold a federated App.tsx from memory \u2014 BrowserRouter in App.tsx crashes the Shell.",
+        why: "Download the official Shell starter-kit and stamp APP_ID. Never scaffold vite.config / App.tsx from memory. Never wrap App in BrowserRouter. Never zip dist/ or upload only remoteEntry.js.",
         docs: "https://docs.groundfloor.cloud/docs/integrations/shell"
       };
     }
     case "publish_app":
       return {
         command: args?.slug ? `gf apps init --slug ${args.slug} && cd ${args.slug} && npm install && npm run release && gf apps publish --path release.zip` : "gf apps init --slug <portal-slug> && cd <slug> && npm install && npm run release && gf apps publish --path release.zip",
-        why: "Ship a Shell federated product App. Init the starter-kit first; run npm run release (do not zip Vite dist/). Do not gf deploy and do not invent App.tsx.",
+        why: "Ship a Shell federated App. Always init the kit first. npm run release (not zip dist/, not a lone remoteEntry.js). Do not gf deploy. Do not invent App.tsx.",
         docs: "https://docs.groundfloor.cloud/docs/integrations/shell"
       };
     case "secrets":
@@ -721,7 +756,7 @@ async function resolveCoderunnerId(apiUrl, workspaceId, idOrSlug) {
 }
 var server = new McpServer({
   name: "groundfloor",
-  version: "0.1.0"
+  version: "0.1.3"
 });
 server.tool(
   "whoami",
@@ -791,10 +826,17 @@ server.tool(
           node: 'Bootstrap image uses CMD ["npm","start"]. Missing scripts.start \u2192 deploy Failed (status 4), 8080 connection refused.',
           local_live_data: 'eval "$(gf env)" then call Control Plane vault/files/secrets with Bearer $(gf token). Do not zip .env files.'
         },
+        shell_app_howto: {
+          docs_get: "shell",
+          rule: "Never invent a Vite + Module Federation app. gf apps init --slug <portal-slug>, npm install, npm run release, gf apps publish --path release.zip. Do not zip dist/ or upload only remoteEntry.js.",
+          suggest_cli: "init_app | publish_app"
+        },
         actions: {
           deploy: suggestCli("deploy"),
           switch_workspace: suggestCli("switch_workspace"),
-          run: suggestCli("run")
+          run: suggestCli("run"),
+          init_app: suggestCli("init_app"),
+          publish_app: suggestCli("publish_app")
         },
         docs: DOC_CATALOG.map((d) => ({
           id: d.id,
@@ -1022,7 +1064,7 @@ server.tool(
 );
 server.tool(
   "suggest_cli",
-  "Return the gf command the developer (or agent terminal) should run. MCP does not execute mutations.",
+  "Return the gf command to run. For a Shell App use intent init_app or publish_app (never scaffold App.tsx; never gf deploy). MCP does not execute mutations.",
   {
     intent: z.enum([
       "login",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundfloorcloud/mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Groundfloor MCP — inspect workspace state and docs; take actions with the gf CLI.",
   "type": "module",
   "bin": {