@groundfloorcloud/mcp 0.1.14 → 0.1.16

package/dist/index.js

@@ -446,14 +446,38 @@ async function resolveMcpConfig(overrides) {
 
 // src/coderunner-runtime.ts
 var CODERUNNER_RUNTIME_BODY = `
-When a ZIP has **no Dockerfile**, Coderunner injects a language bootstrap image.
-Your process must match that image \u2014 \`gf deploy\` checks the Node bits before
-upload. A custom Dockerfile (required for \`service\` / Deployment) replaces
-the bootstrap; the listen/bind rules still apply.
+The contract depends on the workload type.
 
-## Node (no Dockerfile)
+| Type | Entrypoint (no Dockerfile) | Needs |
+|---|---|---|
+| \`function\`, \`job\`, \`schedule\` | Generated \`/app/main.js\` that does \`require('./handler')\` | Root \`handler.js\` exporting \`handler\` |
+| \`service\` (Deployment) | Your Dockerfile \`CMD\` (Dockerfile required) | \`npm start\` / \`PORT\` / bind \`0.0.0.0\` if CMD is \`npm start\` |
 
-Bootstrap is effectively:
+\`gf deploy\` checks the Node bits before upload.
+
+## Node: function, job, schedule
+
+\`npm start\` is **not** run for these types. The platform's generated
+\`/app/main.js\` loads your code with \`require('./handler')\`, so:
+
+1. Put a \`handler.js\` at the ZIP root (not nested) that exports \`handler\`.
+   \`gf deploy\` also accepts a \`package.json\` \`"main"\` that points at an
+   existing file, but \`./handler\` is the documented path; prefer \`handler.js\`.
+2. \`scripts.start\` is not required, and a server that listens on a port is
+   not needed.
+3. Missing \`handler.js\` \u2192 the new revision crash-loops
+   (\`Cannot find module './handler'\`, \`MODULE_NOT_FOUND\`) and the deployment
+   ends **Failed (status 4)**. Check \`gf coderunner logs -c <id>\`.
+
+For the handler's arguments and, for functions, the HTTP event/return shape,
+see the runtime docs (https://docs.groundfloor.cloud/docs/deploy). Do not guess
+the argument order.
+
+## Node: service (or any Dockerfile that runs \`npm start\`)
+
+A \`service\` **requires** a root Dockerfile; you own \`CMD\`. If it is
+\`npm start\` (for any type), \`package.json\` needs \`"scripts": { "start": ... }\`,
+and the process must follow the HTTP contract:
 
 \`\`\`dockerfile
 FROM node:18-alpine
@@ -464,8 +488,7 @@ ENV PORT=8080
 CMD ["npm", "start"]
 \`\`\`
 
-1. \`package.json\` **must** define \`"scripts": { "start": "node <entrypoint>" }\`.
-   Missing \`start\` \u2192 container crash loop, probe \`127.0.0.1:8080\` connection
+1. Missing \`start\` \u2192 container crash loop, probe \`127.0.0.1:8080\` connection
    refused, deployment **Failed (status 4)** after several minutes.
 2. Listen on \`Number(process.env.PORT || 8080)\`.
 3. Bind **\`0.0.0.0\`**, not \`127.0.0.1\`. Cluster traffic is not loopback.
@@ -477,29 +500,8 @@ server.listen(port, "0.0.0.0", () => {
 });
 \`\`\`
 
-Offer GET \`/\` or \`/health\` for the probe. Sample: \`samples/hello-fn/\`.
-
-## Known issue: bootstrap has been reported to skip \`npm start\`
-
-Reported 2026-09-22 against a \`function\` deploy with no Dockerfile, **unresolved as of this
-writing**: instead of running \`npm start\` per the contract above, the platform's own
-\`/app/main.js\` ran \`require('./handler')\` \u2014 a file/module contract this document does not
-describe \u2014 even though \`scripts.start\` and the entrypoint were present and correct. Symptom in
-\`gf coderunner logs -c <id>\`: \`Cannot find module './handler'\` (\`MODULE_NOT_FOUND\`), repeated
-probe \`127.0.0.1:8080\` connection refused, deployment **Failed (status 4)**. Whether \`job\` and
-\`schedule\` share this bootstrap path and are equally affected has not been confirmed either way \u2014
-treat the workaround below as precautionary for those types too if you hit the same signature.
-
-**Workaround:** add your own root \`Dockerfile\` (e.g. \`CMD ["npm", "start"]\`) and keep your
-existing \`workload_type\` \u2014 a Dockerfile bypasses the injected bootstrap entirely regardless of
-type (see "Node (with Dockerfile)" below), so this sidesteps the bug without changing how the
-workload is invoked.
-
-## Node (with Dockerfile)
-
-You own \`CMD\`. If it is \`npm start\`, you still need \`scripts.start\`.
-Listen on 8080 / \`PORT\` and bind \`0.0.0.0\`. \`service\` (Deployment)
-**requires** a root Dockerfile \u2014 bootstrap is not injected on that path.
+Offer GET \`/\` or \`/health\` for the probe. A Dockerfile whose \`CMD\` is not
+\`npm start\` replaces the generated bootstrap entirely, for any type.
 
 ## Python
 
@@ -508,16 +510,18 @@ Bind \`0.0.0.0\` and \`PORT\` (default 8080), for example
 
 ## Jobs and schedules
 
-Same package/start rules. The process may exit 0 when finished; it does not
-need a public URL. Schedules have **no** Deployment URL. Set cron with
+Node: \`handler.js\` exporting \`handler\`, same as functions (no \`npm start\`).
+They do not need a public URL. Schedules have **no** Deployment URL. Set cron with
 \`gf deploy --workload-type schedule --schedule "<cron>"\` or
 \`groundfloor.json\` \`"schedule"\`.
 
 ## What \`gf deploy\` checks
 
 - \`service\` without a root Dockerfile \u2192 fail immediately.
-- Node without a Dockerfile (or a Dockerfile that runs \`npm start\`) and no
-  \`scripts.start\` \u2192 fail immediately with this contract.
+- Node \`function\`/\`job\`/\`schedule\` without a Dockerfile and without a root
+  \`handler.js\` (or a \`package.json\` \`"main"\` that resolves to a file) \u2192 fail
+  immediately. \`scripts.start\` is not required.
+- Node with a Dockerfile that runs \`npm start\` and no \`scripts.start\` \u2192 fail immediately.
 - Listen/bind are not parsed from source; match the sample or the probe fails
   at deploy time. Check Process Log / \`gf coderunner logs -c <id>\`.
 `.trim();
@@ -571,24 +575,24 @@ Pick **one** type per coderunner. Changing type later means a new coderunner.
 
 ### Function
 
-- ZIP at archive root (\`package.json\` / \`index.js\` or \`main.py\` not nested).
-- Listen on \`process.env.PORT || 8080\`, bind **\`0.0.0.0\`** (health GET \`/\` or \`/health\`).
-- **Node:** \`package.json\` **must** include \`"scripts": { "start": "node index.js" }\`.
-  The runtime image is \`CMD ["npm", "start"]\`. Missing \`start\` \u2192 crash loop,
-  probe \`127.0.0.1:8080\` connection refused, deployment **Failed (status 4)**.
+- ZIP at archive root (\`handler.js\` / \`package.json\` or \`main.py\` not nested).
+- **Node:** a root \`handler.js\` exporting \`handler\`. The platform runs a generated
+  \`/app/main.js\` that does \`require('./handler')\`; \`npm start\` is **not** run and
+  \`scripts.start\` is not required. Missing \`handler.js\` \u2192 crash loop
+  (\`Cannot find module './handler'\`), deployment **Failed (status 4)**.
+  \`gf deploy\` fails fast on this. Handler arguments and the HTTP event/return
+  shape: see the runtime docs (\`docs_get\` id \`coderunner-runtime\`, docs.groundfloor.cloud/docs/deploy).
+- Node with your own Dockerfile (\`CMD ["npm","start"]\`) instead: listen on
+  \`process.env.PORT || 8080\`, bind **\`0.0.0.0\`** (health GET \`/\` or \`/health\`), and
+  define \`scripts.start\`.
 - Python: process must bind 0.0.0.0:\${PORT:-8080}.
 - After deploy: \`gf coderunner run -c <slug> --payload '{"hello":"world"}'\`.
-- \u26A0\uFE0F See "Known issue" in \`docs_get\` id \`coderunner-runtime\` if \`gf coderunner logs\` shows
-  \`Cannot find module './handler'\` despite a correct \`scripts.start\` \u2014 add a Dockerfile as the
-  workaround, no type change needed.
 
 ### Job
 
-- Same package rules as function. No need to serve forever; exit 0 on success.
+- Node: same as function (root \`handler.js\` exporting \`handler\`; no \`npm start\`).
+  No need to serve forever; exit 0 on success.
 - Deploy, then start a run (\`gf coderunner run\`). Check Process Log.
-- \u26A0\uFE0F Not confirmed whether the no-Dockerfile bootstrap bug in \`docs_get\` id \`coderunner-runtime\`
-  ("Known issue") also hits \`job\` \u2014 if a run never starts and logs show the same
-  \`MODULE_NOT_FOUND: './handler'\`, apply the same Dockerfile workaround.
 
 ### Schedule
 
@@ -598,8 +602,7 @@ Pick **one** type per coderunner. Changing type later means a new coderunner.
 - GET/list/status expose top-level \`workload_type\` and \`schedule\`.
   \`gf coderunner status -c <slug>\` prints type, schedule, last_job.
 - No public invoke URL. Debug with \`gf coderunner logs\`, not curl.
-- \u26A0\uFE0F Same caveat as Job: unconfirmed whether the bootstrap "Known issue" affects scheduled runs;
-  same Dockerfile workaround if you see the identical crash signature.
+- Node: same handler contract as function (root \`handler.js\`).
 
 ### Service (Deployment)
 
@@ -620,7 +623,7 @@ ENV PORT=8080
 CMD ["npm", "start"]
 \`\`\`
 
-- Still require Node \`"start"\` if CMD is \`npm start\`.
+- Services follow the \`npm start\` / \`PORT\` contract: Node needs \`scripts.start\` if CMD is \`npm start\`.
 - Prefer curling the Deployment URL (\`/health\`) over \`\u2026/run\`.
 
 ## Latest deploy rules (all types)
@@ -651,7 +654,7 @@ gf dataplane status       # provision if needed: gf dataplane provision
 gf secrets ls
 \`\`\`
 
-Local HTTP (Node function/service):
+Local HTTP (Node service, or a Dockerfile-based function):
 
 \`\`\`bash
 export PORT=8080
@@ -770,7 +773,7 @@ If they opt out of Tailwind:
 
 The kit ships FederatedStyleRoot in src/lib/FederatedStyleRoot.tsx.
 
-Human docs: /docs/integrations/shell/css-and-styling
+Human docs: /docs/apps/shell/styling
 `;
 
 // src/databases-guide.ts
@@ -818,7 +821,7 @@ resolution. POST /v1/workspaces/{id}/vault/collections with
   POST /v1/workspaces/{id}/managed-databases with engine postgres
 - Shell 403 / empty vault \u2192 collection Access for the site role
 
-docs_get id databases. Human docs: /docs/customer-portal/databases and /docs/customer-portal/data-vault
+docs_get id databases. Human docs: /docs/data/databases and /docs/data/data-vault
 `;
 
 // src/design-standard-guide.ts
@@ -1131,55 +1134,55 @@ var DOC_CATALOG = [
   {
     id: "agents",
     title: "Deploy with agents",
-    path: "/docs/customer-portal/agents",
+    path: "/docs/developer-tools/ai-agents",
     summary: "How agents should deploy Coderunner workloads and init/publish Shell apps with gf / MCP. App authentication is optional (end-user login). Service (Deployment) requires a Dockerfile. Shell apps: gf apps init, never invent App.tsx."
   },
   {
     id: "developers",
     title: "Developers (gf CLI)",
-    path: "/docs/customer-portal/developers",
+    path: "/docs/developer-tools/cli",
     summary: "gf login, workspaces, deploy, secrets, feature flags (gf flags), files, apps, gf m2m token. Coderunner types: function, job, schedule, service (also called Deployment). App authentication optional."
   },
   {
     id: "coderunner",
     title: "Coderunner",
-    path: "/docs/customer-portal/coderunner",
-    summary: "Workload types (function, job, schedule, service/Deployment), runtime contract (scripts.start, 0.0.0.0:8080), Dockerfile for services, Coderunner identities for Vault, App authentication optional, local live data, gf deploy.",
+    path: "/docs/deploy",
+    summary: "Workload types (function, job, schedule, service/Deployment), runtime contract (handler.js for function/job/schedule; npm start, PORT 8080 for service), Dockerfile for services, Coderunner identities for Vault, App authentication optional, local live data, gf deploy.",
     embedded: CODERUNNER_GUIDE,
-    lastUpdated: "2026-09-25"
+    lastUpdated: "2026-10-02"
   },
   {
     id: "coderunner-runtime",
     title: "Coderunner runtime contract",
-    path: "/docs/customer-portal/coderunner",
-    summary: "What the platform expects your code to do: Node bootstrap (npm start, PORT/8080, bind 0.0.0.0), Python bind, service Dockerfile.",
+    path: "/docs/deploy",
+    summary: "What the platform expects your code to do: Node handler.js for function/job/schedule, npm start + PORT/8080 + bind 0.0.0.0 for service/Dockerfile, Python bind.",
     embedded: CODERUNNER_RUNTIME_CONTRACT,
-    lastUpdated: "2026-09-23"
+    lastUpdated: "2026-10-02"
   },
   {
     id: "coderunner-overview",
     title: "Coderunner overview",
-    path: "/docs/integrations/coderunner/overview",
+    path: "/docs/deploy",
     summary: "Architecture and lifecycle. Prefer docs_get id coderunner for type usage, Dockerfile, and create prerequisites.",
     embedded: CODERUNNER_GUIDE,
-    lastUpdated: "2026-09-25"
+    lastUpdated: "2026-10-02"
   },
   {
     id: "authentication",
     title: "Workspace Authentication",
-    path: "/docs/customer-portal/authentication",
+    path: "/docs/access/app-authentication",
     summary: "Workspace site auth (Groundfloor or external) is optional end-user login. Leaving Groundfloor keeps the realm (disabled) until Delete Groundfloor login. Separate from portal Team. Not required to create Apps or Coderunners."
   },
   {
     id: "access",
     title: "Access",
-    path: "/docs/customer-portal/access",
+    path: "/docs/access/site-access",
     summary: "Grant site roles Data Vault collections, workspace-wide Files, and Apps launch. Admin is implicit. M2M is not an Access subject. Team membership is unchanged."
   },
   {
     id: "m2m",
     title: "M2M tokens",
-    path: "/docs/customer-portal/m2m-tokens",
+    path: "/docs/access/m2m-tokens",
     summary: "Confidential client secret \u2192 short Control Plane JWT (typ=m2m). Attach on Coderunner or gf m2m token. Never DATAPLANE_SERVICE_API_KEY. v1 is Team Writer, no collection ACL. Secrets only with the opt-in secrets:read scope (read-only). Cache the token; minting is rate-limited per client and IP."
   },
   {
@@ -1191,7 +1194,7 @@ var DOC_CATALOG = [
   {
     id: "shell",
     title: "Shell federated apps",
-    path: "/docs/integrations/shell",
+    path: "/docs/apps/shell",
     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,
     lastUpdated: "2026-09-26"
@@ -1199,7 +1202,7 @@ var DOC_CATALOG = [
   {
     id: "design-standard",
     title: "Shell app design standard",
-    path: "/docs/integrations/shell/design-standard",
+    path: "/docs/apps/shell/styling",
     summary: "Visual rules for Shell apps: grey ground, flat controls, Geist, one brand accent from theme.primaryColor, DataGrid, PhaseChevron. Use the kit; do not restyle to stock Tailwind.",
     embedded: DESIGN_STANDARD_GUIDE,
     lastUpdated: "2026-09-04"
@@ -1207,7 +1210,7 @@ var DOC_CATALOG = [
   {
     id: "css-and-styling",
     title: "CSS and styling",
-    path: "/docs/integrations/shell/css-and-styling",
+    path: "/docs/apps/shell/styling",
     summary: "Tailwind is the default. Own CSS framework (Bootstrap, MUI, \u2026) uses FederatedStyleRoot and Shadow DOM \u2014 do not load it globally onto the Shell page.",
     embedded: CSS_AND_STYLING_GUIDE,
     lastUpdated: "2026-09-04"
@@ -1215,7 +1218,7 @@ var DOC_CATALOG = [
   {
     id: "databases",
     title: "Databases",
-    path: "/docs/customer-portal/databases",
+    path: "/docs/data/databases",
     summary: "Dataplane is not a database. PostgreSQL (shared, platform-managed) is ready through Dataplane with no deploy step. A dedicated PostgreSQL you deploy and own is a separate, heavier path. PostgreSQL is the only engine offered.",
     embedded: DATABASES_GUIDE,
     lastUpdated: "2026-09-26"
@@ -1231,7 +1234,7 @@ var DOC_CATALOG = [
   {
     id: "feature-flags",
     title: "Feature Flags",
-    path: "/docs/customer-portal/feature-flags",
+    path: "/docs/configure/feature-flags",
     summary: "Built-in per-environment feature flags (toggles / config values) \u2014 use these, not a Vault collection. gf flags ls|set|compare|promote. Apps read GET \u2026/flags/runtime: Shell apps with the end-user JWT + window.__GF_ENVIRONMENT_ID__ (starter-kit useFlag), Coderunners with gf m2m token + GROUNDFLOOR_ENVIRONMENT_ID. Default environment is dev.",
     embedded: FLAGS_GUIDE,
     lastUpdated: "2026-09-26"
@@ -1247,10 +1250,10 @@ var DOC_CATALOG = [
   {
     id: "scheduled-jobs",
     title: "Scheduled jobs",
-    path: "/docs/customer-portal/scheduled-jobs",
+    path: "/docs/deploy/schedules",
     summary: "workload_type=schedule plus cron. gf coderunner status shows type/schedule/last_job. Use Process Log, not a public URL.",
     embedded: CODERUNNER_GUIDE,
-    lastUpdated: "2026-09-25"
+    lastUpdated: "2026-10-02"
   }
 ];
 function docUrl(entry) {
@@ -1314,94 +1317,94 @@ function suggestCli(intent, args) {
       return {
         command: args?.cell === "stage" ? "gf login --stage" : args?.cell === "dev" ? "gf login --dev" : "gf login",
         why: "Creates ~/.groundfloor session (auto-refresh). MCP reads this; do not paste JWTs into mcp.json.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
+        docs: "https://docs.groundfloor.cloud/docs/developer-tools/cli"
       };
     case "switch_workspace":
       return {
         command: args?.workspace ? `gf workspaces use ${args.workspace}` : "gf workspaces && gf workspaces use <uuid>",
         why: "Sets the default workspace for gf and MCP.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
+        docs: "https://docs.groundfloor.cloud/docs/developer-tools/cli"
       };
     case "deploy":
       return {
         command: name ? `gf deploy -n ${name}${ws}` : `gf deploy${ws}`,
-        why: 'Package the current (or --path) folder and deploy as a Coderunner. App authentication is optional (end-user login only). workloadType function|job|schedule|service (service = Deployment; requires a Dockerfile). Schedules need --schedule "<cron>" or groundfloor.json schedule. Node bootstrap: scripts.start, listen PORT||8080, bind 0.0.0.0. Do not create an App for this.',
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/coderunner"
+        why: 'Package the current (or --path) folder and deploy as a Coderunner. App authentication is optional (end-user login only). workloadType function|job|schedule|service (service = Deployment; requires a Dockerfile). Schedules need --schedule "<cron>" or groundfloor.json schedule. Node function/job/schedule: root handler.js exporting handler (no npm start). Node service/Dockerfile: scripts.start, listen PORT||8080, bind 0.0.0.0. Do not create an App for this.',
+        docs: "https://docs.groundfloor.cloud/docs/deploy"
       };
     case "run":
       return {
         command: name ? `gf coderunner run -c ${name}${ws}` : `gf coderunner run -c <id-or-slug>${ws}`,
         why: "Smoke-invoke a deployed function or job.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/coderunner"
+        docs: "https://docs.groundfloor.cloud/docs/deploy"
       };
     case "status":
       return {
         command: name ? `gf coderunner status -c ${name}${ws}` : `gf coderunner ls${ws}`,
         why: "Inspect build/deploy state.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/coderunner"
+        docs: "https://docs.groundfloor.cloud/docs/deploy"
       };
     case "logs":
       return {
         command: name ? `gf coderunner logs -c ${name}${ws}` : `gf coderunner logs -c <id-or-slug>${ws}`,
         why: "Process Log (stdout/stderr). gf deploy prints the last lines on failure; this command fetches more. runner_id accepts a coderunner id.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/coderunner"
+        docs: "https://docs.groundfloor.cloud/docs/deploy"
       };
     case "init_app": {
       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 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"
+        docs: "https://docs.groundfloor.cloud/docs/apps/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 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"
+        docs: "https://docs.groundfloor.cloud/docs/apps/shell"
       };
     case "environments":
       return {
         command: `gf environments ls${ws}`,
         why: "List workspace environments (id, name, status) for secrets and deploy targeting.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
+        docs: "https://docs.groundfloor.cloud/docs/developer-tools/cli"
       };
     case "cancel_deployment":
       return {
         command: name ? `gf coderunner cancel-deployment -c ${name}${ws}` : `gf coderunner cancel-deployment -c <id-or-slug>${ws}`,
         why: "Delete the current deployment (or --deployment-id). Use this for a deploy stuck in deploying.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/coderunner"
+        docs: "https://docs.groundfloor.cloud/docs/deploy"
       };
     case "secrets":
       return {
         command: `gf secrets ls${ws}`,
         why: "Mutations: gf secrets set|get|rm. MCP only lists keys.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
+        docs: "https://docs.groundfloor.cloud/docs/developer-tools/cli"
       };
     case "flags":
       return {
         command: `gf flags ls${ws}`,
         why: "Feature flags per environment. Mutations: gf flags set|rm|compare|promote (-e <id|name>). Apps read GET \u2026/flags/runtime (docs_get id feature-flags). Do not build flags in a Vault collection.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/feature-flags"
+        docs: "https://docs.groundfloor.cloud/docs/configure/feature-flags"
       };
     case "dataplane":
       return {
         command: `gf dataplane status${ws}  # provision: gf dataplane provision`,
         why: "Dataplane is required for vault, files, and secrets.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
+        docs: "https://docs.groundfloor.cloud/docs/developer-tools/cli"
       };
     case "vault_token":
     case "m2m_token":
       return {
         command: `gf m2m token${ws}`,
         why: "Exchange GROUNDFLOOR_M2M_CLIENT_ID + GROUNDFLOOR_M2M_CLIENT_SECRET for a short Control Plane JWT. Call Vault and Files at $CONTROLPLANE_URL. Never DATAPLANE_SERVICE_API_KEY. gf token is a builder credential.",
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/m2m-tokens"
+        docs: "https://docs.groundfloor.cloud/docs/access/m2m-tokens"
       };
     default:
       return {
         command: "gf --help",
         why: `Unknown intent "${intent}". Use login | switch_workspace | deploy | run | status | logs | environments | cancel_deployment | init_app | publish_app | secrets | flags | dataplane | vault_token.`,
-        docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
+        docs: "https://docs.groundfloor.cloud/docs/developer-tools/cli"
       };
   }
 }
@@ -1524,12 +1527,12 @@ server.tool(
           runtime_contract: "coderunner-runtime",
           before_create: "Team write can create Coderunners without App authentication. Site auth is optional (end-user login). Mode none uses Portal JWKS (GET /v1/public/jwks.json).",
           types: {
-            function: "HTTP handler on PORT/8080 bound to 0.0.0.0. Invoke with gf coderunner run or the Deployment URL. Node requires package.json scripts.start.",
-            job: "Run-to-completion worker. Deploy, then gf coderunner run.",
+            function: "Request/response handler. Invoke with gf coderunner run or the Deployment URL. Node: root handler.js exporting handler (npm start is not run); see docs_get coderunner-runtime.",
+            job: "Run-to-completion worker. Node: root handler.js exporting handler. Deploy, then gf coderunner run.",
             schedule: 'Cron job. No public Deployment URL. Set cron with gf deploy --workload-type schedule --schedule "<cron>" (or groundfloor.json schedule).',
             service: "Long-running Deployment (same type as service). Dockerfile at ZIP root is required. Listen on 8080 / 0.0.0.0."
           },
-          node: "No Dockerfile \u2192 platform injects node:18-alpine CMD npm start EXPOSE 8080. Require scripts.start; listen on PORT||8080; bind 0.0.0.0. gf deploy fails fast if scripts.start is missing.",
+          node: "function/job/schedule without a Dockerfile run a generated /app/main.js that requires ./handler: ship a root handler.js exporting handler (scripts.start not needed). service/Dockerfile running npm start: scripts.start, listen PORT||8080, bind 0.0.0.0. gf deploy fails fast on either missing.",
           local_live_data: 'eval "$(gf env)". For files/secrets as a builder use Bearer $(gf token). For Vault/Files as the deployed workload, attach an M2M client and use Bearer $(gf m2m token). Never DATAPLANE_SERVICE_API_KEY. Do not zip .env files.'
         },
         shell_app_howto: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundfloorcloud/mcp",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Groundfloor MCP — inspect workspace state and docs; take actions with the gf CLI.",
   "type": "module",
   "bin": {
@@ -18,7 +18,7 @@
     "url": "git+ssh://git@bitbucket.org/codementeam/groundfloor-client-portal.git",
     "directory": "packages/mcp"
   },
-  "homepage": "https://docs.groundfloor.cloud/docs/customer-portal/agents",
+  "homepage": "https://docs.groundfloor.cloud/docs/developer-tools/ai-agents",
   "keywords": [
     "groundfloor",
     "mcp",