@groundfloorcloud/mcp 0.1.14 → 0.1.15

package/dist/index.js

@@ -770,7 +770,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 +818,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,19 +1131,19 @@ 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",
+    path: "/docs/deploy",
     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.",
     embedded: CODERUNNER_GUIDE,
     lastUpdated: "2026-09-25"
@@ -1151,7 +1151,7 @@ var DOC_CATALOG = [
   {
     id: "coderunner-runtime",
     title: "Coderunner runtime contract",
-    path: "/docs/customer-portal/coderunner",
+    path: "/docs/deploy",
     summary: "What the platform expects your code to do: Node bootstrap (npm start, PORT/8080, bind 0.0.0.0), Python bind, service Dockerfile.",
     embedded: CODERUNNER_RUNTIME_CONTRACT,
     lastUpdated: "2026-09-23"
@@ -1159,7 +1159,7 @@ var DOC_CATALOG = [
   {
     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"
@@ -1167,19 +1167,19 @@ var DOC_CATALOG = [
   {
     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 +1191,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 +1199,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 +1207,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 +1215,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 +1231,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,7 +1247,7 @@ 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"
@@ -1314,94 +1314,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"
+        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"
       };
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundfloorcloud/mcp",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "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",