@cloudgrid-io/mcp 0.20.12 → 0.20.14

package/src/corpus/workflows/lms.md

@@ -53,9 +53,10 @@ you build it from the guide.
 
 ## 4. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**
 per the AGENTS.md tree, and (b) fill `cloudgrid.yaml` to the shape below.
 
 ## 5. cloudgrid.yaml + wiring

package/src/corpus/workflows/marketplace.md

@@ -54,9 +54,11 @@ There is no app code to copy — you generate it from the guide.
 
 ## 4. Scaffold + fill cloudgrid.yaml
 
-`grid_create_project` an app `<name>` FIRST (creates the entity + `.cloudgrid/link.json`
-and a starter `cloudgrid.yaml` with empty `services:{}`; `plug` needs a linked
-directory). Then put the app under **`services/web/`** and set `cloudgrid.yaml` to
+`grid_create_project` an app `<name>` — it scaffolds the project folder and a
+starter `cloudgrid.yaml` with empty `services:{}` (no server entity yet; the
+first `grid plug` auto-creates it from the manifest, honoring its `name:`, and
+writes `.cloudgrid/link.json`). Then put the app under **`services/web/`** and
+set `cloudgrid.yaml` to
 the blueprint's active fields:
 
 ```yaml

package/src/corpus/workflows/membership-site.md

@@ -53,9 +53,10 @@ workflow:
 
 ## 4. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then write the app under **`services/web/`** and
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then write the app under **`services/web/`** and
 set `cloudgrid.yaml` to the active shape below.
 
 ## 5. Build the app following AGENTS.md

package/src/corpus/workflows/monitoring-dashboard.md

@@ -39,9 +39,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/online-store.md

@@ -40,9 +40,9 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST.
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
 
 ## 4. Fetch the blueprint and read AGENTS.md
 

package/src/corpus/workflows/product-catalog.md

@@ -41,9 +41,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/project-management.md

@@ -42,9 +42,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/property-listings.md

@@ -38,9 +38,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/quiz-platform.md

@@ -39,9 +39,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/restaurant-reservations.md

@@ -56,9 +56,10 @@ so the deliverable is `cloudgrid.yaml` + `AGENTS.md`, not app code.
 
 ## 4. Scaffold + fill
 
-1. `grid_create_project` an app `<name>` — creates the entity + `.cloudgrid/link.json`
-   and a `cloudgrid.yaml` with an EMPTY `services: {}`. Run `init` FIRST (plug
-   needs a linked directory).
+1. `grid_create_project` an app `<name>` — scaffolds the project folder and a
+   `cloudgrid.yaml` with an EMPTY `services: {}`. No server entity exists yet —
+   the first `grid plug` auto-creates it from the manifest (honoring its
+   `name:`) and writes `.cloudgrid/link.json`.
 2. Write the app under **`services/web/`** (`path:` is the URL mount, NOT the
    filesystem path), following `AGENTS.md`.
 3. Set `cloudgrid.yaml` to the blueprint's active fields:

package/src/corpus/workflows/revenue-dashboard.md

@@ -38,9 +38,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/semantic-search.md

@@ -42,9 +42,11 @@ the **local edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>` FIRST — it creates the entity +
-`.cloudgrid/link.json` and a starter `cloudgrid.yaml` with empty `services: {}`
-(`plug` needs a linked directory).
+`grid_create_project` an app `<name>` — it scaffolds the project folder and a
+starter `cloudgrid.yaml` with empty `services: {}`. No server entity exists yet:
+the first `grid plug` auto-creates it from the manifest (honoring its `name:`)
+and writes `.cloudgrid/link.json`; `grid plug --no-deploy` registers it without
+deploying (useful to set secrets first).
 
 ## 4. Fetch the template and READ AGENTS.md
 

package/src/corpus/workflows/simple-semantic-search.md

@@ -5,7 +5,7 @@ needs: vector, ai
 deploy: runtime
 editions: local
 capabilities_note: "vector search — needs: { vector: pgvector } (injects VECTOR_PGVECTOR_URL; #1545 shipped, verified live 2026-07-16) + ai: true (embeddings via @cloudgrid-io/runtime, no API key). Runtime app, async build, local edition only."
-summary: "One node service that embeds a document into the entity's own pgvector schema at startup and serves POST /search + a minimal UI — probe-sized vector column, idempotent background seed, /health 503-until-ready, cosine <=> ranking. grid init app --here, grid plug, live in ~3 minutes."
+summary: "One node service that embeds a document into the entity's own pgvector schema at startup and serves POST /search + a minimal UI — probe-sized vector column, idempotent background seed, /health 503-until-ready, cosine <=> ranking. grid plug (auto-creates the entity from cloudgrid.yaml), live in ~3 minutes."
 ---
 
 # Workflow: simple-semantic-search
@@ -47,13 +47,13 @@ services:
 ## 4. Deploy
 
 ```bash
-grid init app <name> --here    # registers the entity, writes .cloudgrid/link.json
-grid plug                      # async build — live URL in ~2-3 minutes
+grid plug                      # first plug registers the entity from cloudgrid.yaml
+                               # (honors its name:), then async build — live URL in ~2-3 minutes
 grid visibility set <slug> link
 ```
 
-`.cloudgrid/link.json` (entity_id / org / slug binding) is WRITTEN BY THE CLI —
-never hand-author it. If the folder was copied from someone else's project,
+`.cloudgrid/link.json` (entity_id / org / slug binding) is WRITTEN BY THE CLI on
+the first `grid plug` — never hand-author it. If the folder was copied from someone else's project,
 `rm -rf .cloudgrid` first so `grid plug` doesn't update THEIR app.
 
 ## 5. Verify like it's real

package/src/corpus/workflows/subscription-management.md

@@ -60,9 +60,10 @@ workflow:
 
 ## 4. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then write the app under **`services/web/`** and
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then write the app under **`services/web/`** and
 set `cloudgrid.yaml` to the active shape below.
 
 ## 5. Build the app following AGENTS.md

package/src/corpus/workflows/task-manager.md

@@ -39,9 +39,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/ticket-system.md

@@ -37,9 +37,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/time-tracking.md

@@ -38,9 +38,10 @@ edition** (Claude Desktop / Claude Code) or the CLI.
 
 ## 3. Scaffold
 
-`grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a linked
-directory, so run `init` FIRST. Then (a) write the app under **`services/web/`**,
+`grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
+Then (a) write the app under **`services/web/`**,
 and (b) fill `cloudgrid.yaml` to the shape below (`services.web` + `needs:
 { database: true }`).
 

package/src/corpus/workflows/travel-booking.md

@@ -51,9 +51,9 @@ edition** (Claude Desktop / Claude Code) or the CLI.
    `flights` / `hotels` / `bookings` / `trips` collections + the overbooking
    guard, how CloudGrid injects the DB and vault secrets, how to wire Stripe +
    auth, and the trip-reminder-cron design).
-2. `grid_create_project` an app `<name>`. `init` creates the entity + `.cloudgrid/link.json`
-   and writes a `cloudgrid.yaml` with an EMPTY `services: {}`. `plug` needs a
-   linked directory, so run `init` FIRST.
+2. `grid_create_project` an app `<name>`. It scaffolds the project folder and writes a `cloudgrid.yaml` with an EMPTY
+`services: {}`. No server entity exists yet — the first `grid plug` auto-creates
+it from the manifest (honoring its `name:`) and writes `.cloudgrid/link.json`.
 
 ## 4. Build the app + set cloudgrid.yaml
 

package/src/tools/constants.js

@@ -31,7 +31,7 @@ export const CONSOLE_URL = "https://console.cloudgrid.io/";
 
 export const VISIBILITY_LABELS = {
   private: "Only you",
-  org: "Your org",
+  org: "Your grid",
   authenticated: "Anyone signed in",
   space: "A space",
   link: "Anyone with the link",

package/src/widgets/live-result.html

@@ -44,7 +44,7 @@ body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;b
     if (data.needs_sign_in) {
       root.innerHTML =
         '<div class="card sign-in">' +
-          '<p>Sign in to publish to your org</p>' +
+          '<p>Sign in to publish to your grid</p>' +
           '<button class="btn btn-primary" id="sign-in-btn">Sign in with Google</button>' +
         '</div>';
       var signInBtn = document.getElementById("sign-in-btn");