@cloudgrid-io/mcp 0.13.0 → 0.14.0

package/src/corpus/templates/project-management/services/web/app/api/projects/route.js

@@ -0,0 +1,48 @@
+// App Router route handler for the `projects` collection.
+// GET -> list projects, POST -> add a project, DELETE -> remove a project (and its tasks).
+//
+// To adapt this app, rename the collection and change the fields to match your
+// own data.
+import { NextResponse } from "next/server";
+import { ObjectId } from "mongodb";
+import { getDb } from "../../../lib/db.js";
+
+// Never cache — always read/write live data.
+export const dynamic = "force-dynamic";
+
+async function projects() {
+  const db = await getDb();
+  return db.collection("projects");
+}
+
+// GET /api/projects — list all projects, newest first.
+export async function GET() {
+  const col = await projects();
+  const items = await col.find({}).sort({ createdAt: -1 }).toArray();
+  return NextResponse.json(items.map((p) => ({ id: p._id.toString(), name: p.name })));
+}
+
+// POST /api/projects — add a project. Body: { name: string }.
+export async function POST(request) {
+  const body = await request.json().catch(() => ({}));
+  const name = typeof body.name === "string" ? body.name.trim() : "";
+  if (!name) {
+    return NextResponse.json({ error: "name is required" }, { status: 400 });
+  }
+  const col = await projects();
+  const res = await col.insertOne({ name, createdAt: new Date() });
+  return NextResponse.json({ id: res.insertedId.toString(), name }, { status: 201 });
+}
+
+// DELETE /api/projects?id=<id> — remove a project and all of its tasks.
+export async function DELETE(request) {
+  const id = new URL(request.url).searchParams.get("id");
+  if (!id || !ObjectId.isValid(id)) {
+    return NextResponse.json({ error: "valid id is required" }, { status: 400 });
+  }
+  const db = await getDb();
+  await db.collection("projects").deleteOne({ _id: new ObjectId(id) });
+  // Cascade: drop the project's tasks too (tasks store projectId as a string).
+  await db.collection("tasks").deleteMany({ projectId: id });
+  return NextResponse.json({ ok: true });
+}

package/src/corpus/templates/project-management/services/web/app/api/tasks/route.js

@@ -0,0 +1,85 @@
+// App Router route handler for the `tasks` collection.
+// GET    -> list tasks for a project, POST -> add a task,
+// PATCH  -> change a task's status, DELETE -> remove a task.
+//
+// A task document: { projectId: string, title: string, status: "todo"|"doing"|"done",
+// assignee: string, createdAt: Date }.
+import { NextResponse } from "next/server";
+import { ObjectId } from "mongodb";
+import { getDb } from "../../../lib/db.js";
+
+// Never cache — always read/write live data.
+export const dynamic = "force-dynamic";
+
+const STATUSES = ["todo", "doing", "done"];
+
+async function tasks() {
+  const db = await getDb();
+  return db.collection("tasks");
+}
+
+function shape(t) {
+  return {
+    id: t._id.toString(),
+    projectId: t.projectId,
+    title: t.title,
+    status: t.status,
+    assignee: t.assignee || "",
+  };
+}
+
+// GET /api/tasks?projectId=<id> — list a project's tasks, newest first.
+export async function GET(request) {
+  const projectId = new URL(request.url).searchParams.get("projectId");
+  if (!projectId) {
+    return NextResponse.json({ error: "projectId is required" }, { status: 400 });
+  }
+  const col = await tasks();
+  const items = await col.find({ projectId }).sort({ createdAt: -1 }).toArray();
+  return NextResponse.json(items.map(shape));
+}
+
+// POST /api/tasks — add a task. Body: { projectId, title, assignee?, status? }.
+export async function POST(request) {
+  const body = await request.json().catch(() => ({}));
+  const projectId = typeof body.projectId === "string" ? body.projectId : "";
+  const title = typeof body.title === "string" ? body.title.trim() : "";
+  const assignee = typeof body.assignee === "string" ? body.assignee.trim() : "";
+  const status = STATUSES.includes(body.status) ? body.status : "todo";
+  if (!projectId || !ObjectId.isValid(projectId)) {
+    return NextResponse.json({ error: "valid projectId is required" }, { status: 400 });
+  }
+  if (!title) {
+    return NextResponse.json({ error: "title is required" }, { status: 400 });
+  }
+  const col = await tasks();
+  const doc = { projectId, title, status, assignee, createdAt: new Date() };
+  const res = await col.insertOne(doc);
+  return NextResponse.json(shape({ ...doc, _id: res.insertedId }), { status: 201 });
+}
+
+// PATCH /api/tasks?id=<id> — change a task's status. Body: { status }.
+export async function PATCH(request) {
+  const id = new URL(request.url).searchParams.get("id");
+  if (!id || !ObjectId.isValid(id)) {
+    return NextResponse.json({ error: "valid id is required" }, { status: 400 });
+  }
+  const body = await request.json().catch(() => ({}));
+  if (!STATUSES.includes(body.status)) {
+    return NextResponse.json({ error: "status must be todo, doing, or done" }, { status: 400 });
+  }
+  const col = await tasks();
+  await col.updateOne({ _id: new ObjectId(id) }, { $set: { status: body.status } });
+  return NextResponse.json({ ok: true });
+}
+
+// DELETE /api/tasks?id=<id> — remove a task.
+export async function DELETE(request) {
+  const id = new URL(request.url).searchParams.get("id");
+  if (!id || !ObjectId.isValid(id)) {
+    return NextResponse.json({ error: "valid id is required" }, { status: 400 });
+  }
+  const col = await tasks();
+  await col.deleteOne({ _id: new ObjectId(id) });
+  return NextResponse.json({ ok: true });
+}

package/src/corpus/templates/project-management/services/web/app/board.js

@@ -0,0 +1,182 @@
+"use client";
+
+// Client component: renders the project list plus a per-project task board with
+// three status columns (todo / doing / done). Talks to /api/projects and
+// /api/tasks. Kept self-contained — no external UI libraries.
+import { useState } from "react";
+
+const STATUSES = ["todo", "doing", "done"];
+const LABELS = { todo: "To do", doing: "Doing", done: "Done" };
+
+export default function Board({ initialProjects, initialSelectedId, initialTasks }) {
+  const [projects, setProjects] = useState(initialProjects);
+  const [selectedId, setSelectedId] = useState(initialSelectedId);
+  const [tasks, setTasks] = useState(initialTasks);
+  const [projectName, setProjectName] = useState("");
+  const [taskTitle, setTaskTitle] = useState("");
+  const [taskAssignee, setTaskAssignee] = useState("");
+  const [busy, setBusy] = useState(false);
+
+  async function loadTasks(projectId) {
+    const res = await fetch(`/api/tasks?projectId=${encodeURIComponent(projectId)}`);
+    if (res.ok) setTasks(await res.json());
+    else setTasks([]);
+  }
+
+  async function selectProject(id) {
+    setSelectedId(id);
+    await loadTasks(id);
+  }
+
+  async function addProject(e) {
+    e.preventDefault();
+    const name = projectName.trim();
+    if (!name) return;
+    setBusy(true);
+    const res = await fetch("/api/projects", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ name }),
+    });
+    if (res.ok) {
+      const project = await res.json();
+      setProjects((prev) => [project, ...prev]);
+      setProjectName("");
+      setSelectedId(project.id);
+      setTasks([]);
+    }
+    setBusy(false);
+  }
+
+  async function removeProject(id) {
+    setBusy(true);
+    const res = await fetch(`/api/projects?id=${encodeURIComponent(id)}`, { method: "DELETE" });
+    if (res.ok) {
+      const next = projects.filter((p) => p.id !== id);
+      setProjects(next);
+      if (selectedId === id) {
+        const fallback = next[0] ? next[0].id : null;
+        setSelectedId(fallback);
+        if (fallback) await loadTasks(fallback);
+        else setTasks([]);
+      }
+    }
+    setBusy(false);
+  }
+
+  async function addTask(e) {
+    e.preventDefault();
+    const title = taskTitle.trim();
+    if (!title || !selectedId) return;
+    setBusy(true);
+    const res = await fetch("/api/tasks", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ projectId: selectedId, title, assignee: taskAssignee.trim() }),
+    });
+    if (res.ok) {
+      const task = await res.json();
+      setTasks((prev) => [task, ...prev]);
+      setTaskTitle("");
+      setTaskAssignee("");
+    }
+    setBusy(false);
+  }
+
+  async function moveTask(id, status) {
+    setBusy(true);
+    const res = await fetch(`/api/tasks?id=${encodeURIComponent(id)}`, {
+      method: "PATCH",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ status }),
+    });
+    if (res.ok) setTasks((prev) => prev.map((t) => (t.id === id ? { ...t, status } : t)));
+    setBusy(false);
+  }
+
+  async function removeTask(id) {
+    setBusy(true);
+    const res = await fetch(`/api/tasks?id=${encodeURIComponent(id)}`, { method: "DELETE" });
+    if (res.ok) setTasks((prev) => prev.filter((t) => t.id !== id));
+    setBusy(false);
+  }
+
+  return (
+    <div>
+      <form onSubmit={addProject} className="row">
+        <input
+          value={projectName}
+          onChange={(e) => setProjectName(e.target.value)}
+          placeholder="New project name…"
+          aria-label="New project name"
+        />
+        <button type="submit" disabled={busy}>Add project</button>
+      </form>
+
+      <ul className="projects">
+        {projects.length === 0 && <li className="empty">No projects yet.</li>}
+        {projects.map((p) => (
+          <li key={p.id} className={p.id === selectedId ? "active" : ""}>
+            <span className="name" onClick={() => selectProject(p.id)}>{p.name}</span>
+            <button type="button" onClick={() => removeProject(p.id)} disabled={busy}>Delete</button>
+          </li>
+        ))}
+      </ul>
+
+      {selectedId && (
+        <>
+          <h2>Tasks</h2>
+          <form onSubmit={addTask} className="row">
+            <input
+              value={taskTitle}
+              onChange={(e) => setTaskTitle(e.target.value)}
+              placeholder="Task title…"
+              aria-label="Task title"
+            />
+            <input
+              value={taskAssignee}
+              onChange={(e) => setTaskAssignee(e.target.value)}
+              placeholder="Assignee (optional)"
+              aria-label="Assignee"
+            />
+            <button type="submit" disabled={busy}>Add task</button>
+          </form>
+
+          <div className="board">
+            {STATUSES.map((status) => (
+              <div className="col" key={status}>
+                <h3>{LABELS[status]}</h3>
+                {tasks.filter((t) => t.status === status).length === 0 && (
+                  <p className="hint">Nothing here.</p>
+                )}
+                {tasks
+                  .filter((t) => t.status === status)
+                  .map((t) => (
+                    <div className="card" key={t.id}>
+                      <div className="title">{t.title}</div>
+                      {t.assignee && <div className="assignee">{t.assignee}</div>}
+                      <div className="actions">
+                        {STATUSES.filter((s) => s !== status).map((s) => (
+                          <button
+                            key={s}
+                            type="button"
+                            onClick={() => moveTask(t.id, s)}
+                            disabled={busy}
+                          >
+                            → {LABELS[s]}
+                          </button>
+                        ))}
+                        <button type="button" onClick={() => removeTask(t.id)} disabled={busy}>
+                          Delete
+                        </button>
+                      </div>
+                    </div>
+                  ))}
+              </div>
+            ))}
+          </div>
+        </>
+      )}
+    </div>
+  );
+}

package/src/corpus/templates/project-management/services/web/app/layout.js

@@ -0,0 +1,45 @@
+// Root layout + plain inline CSS (no external CDNs, fonts, or stylesheets).
+export const metadata = {
+  title: "Projects",
+  description: "A team project & task board on CloudGrid, backed by grid-shared Mongo.",
+};
+
+const css = `
+  :root { color-scheme: light dark; }
+  * { box-sizing: border-box; }
+  body { margin: 0; font-family: system-ui, -apple-system, sans-serif; line-height: 1.5; }
+  main { max-width: 60rem; margin: 3rem auto; padding: 0 1.25rem; }
+  h1 { margin: 0 0 .25rem; }
+  h2 { margin: 2rem 0 .75rem; font-size: 1.15rem; }
+  .hint { margin: 0 0 1.5rem; opacity: .7; font-size: .9rem; }
+  .row { display: flex; gap: .5rem; margin-bottom: 1rem; flex-wrap: wrap; }
+  input, select { padding: .5rem .75rem; border: 1px solid #8886; border-radius: .5rem; font: inherit; background: transparent; }
+  input { flex: 1; min-width: 8rem; }
+  button { padding: .5rem .9rem; border: 1px solid #8886; border-radius: .5rem; background: #6663; font: inherit; cursor: pointer; }
+  button:disabled { opacity: .5; cursor: default; }
+  ul { list-style: none; padding: 0; margin: 0; }
+  .projects li { display: flex; align-items: center; justify-content: space-between; gap: .5rem; padding: .6rem 0; border-bottom: 1px solid #8883; }
+  .projects li.active { font-weight: 600; }
+  .projects .name { cursor: pointer; flex: 1; }
+  li.empty { opacity: .6; }
+  .board { display: grid; grid-template-columns: repeat(3, 1fr); gap: 1rem; }
+  .col { border: 1px solid #8883; border-radius: .75rem; padding: .75rem; min-height: 6rem; }
+  .col h3 { margin: 0 0 .5rem; font-size: .8rem; text-transform: uppercase; letter-spacing: .05em; opacity: .7; }
+  .card { border: 1px solid #8884; border-radius: .5rem; padding: .5rem .6rem; margin-bottom: .5rem; }
+  .card .title { font-size: .95rem; }
+  .card .assignee { font-size: .8rem; opacity: .65; }
+  .card .actions { display: flex; gap: .35rem; margin-top: .4rem; flex-wrap: wrap; }
+  .card .actions button { padding: .2rem .5rem; font-size: .75rem; }
+  @media (max-width: 40rem) { .board { grid-template-columns: 1fr; } }
+`;
+
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en">
+      <head>
+        <style dangerouslySetInnerHTML={{ __html: css }} />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}

package/src/corpus/templates/project-management/services/web/app/page.js

@@ -0,0 +1,49 @@
+// Home page: a server component reads projects (and, for the selected project, its
+// tasks) straight from Mongo. A client component adds/removes projects and manages
+// the task board via the API routes. Data persists across refresh and across users
+// because it lives in the grid-shared Mongo, not in memory.
+import { getDb } from "../lib/db.js";
+import Board from "./board.js";
+
+export const dynamic = "force-dynamic";
+
+async function listProjects() {
+  const db = await getDb();
+  const items = await db.collection("projects").find({}).sort({ createdAt: -1 }).toArray();
+  return items.map((p) => ({ id: p._id.toString(), name: p.name }));
+}
+
+async function listTasks(projectId) {
+  const db = await getDb();
+  const items = await db
+    .collection("tasks")
+    .find({ projectId })
+    .sort({ createdAt: -1 })
+    .toArray();
+  return items.map((t) => ({
+    id: t._id.toString(),
+    projectId: t.projectId,
+    title: t.title,
+    status: t.status,
+    assignee: t.assignee || "",
+  }));
+}
+
+export default async function Page({ searchParams }) {
+  const projects = await listProjects();
+  const sp = await searchParams;
+  const selectedId =
+    (sp && sp.project && projects.some((p) => p.id === sp.project) && sp.project) ||
+    (projects[0] && projects[0].id) ||
+    null;
+  const tasks = selectedId ? await listTasks(selectedId) : [];
+  return (
+    <main>
+      <h1>Projects</h1>
+      <p className="hint">
+        A team project &amp; task board persisted in the grid-shared Mongo — survives refresh.
+      </p>
+      <Board initialProjects={projects} initialSelectedId={selectedId} initialTasks={tasks} />
+    </main>
+  );
+}

package/src/corpus/templates/project-management/services/web/lib/db.js

@@ -0,0 +1,32 @@
+// Cached MongoDB client for the App Router.
+//
+// The grid injects the connection string as the DATABASE_MONGODB_URL environment
+// variable (plus the legacy MONGODB_URL alias) at dev-time (`grid dev`) and
+// runtime (after `grid plug`). Read the canonical var first, fall back to the
+// legacy alias. Never hardcode a connection string here and never commit a secret.
+//
+// The env var and client are resolved LAZILY (inside getDb), never at module top
+// level — otherwise `next build` throws when it imports this module for route
+// analysis, before the grid injects the var.
+import { MongoClient } from "mongodb";
+
+function clientPromise() {
+  const uri = process.env.DATABASE_MONGODB_URL || process.env.MONGODB_URL;
+  if (!uri) {
+    throw new Error(
+      "DATABASE_MONGODB_URL is not set. The grid injects it automatically — run " +
+        "this app with `grid dev` locally, or deploy it with `grid plug` (the grid " +
+        "injects the DB connection string at runtime). Do not set it by hand.",
+    );
+  }
+  if (!globalThis.__mongoClientPromise) {
+    globalThis.__mongoClientPromise = new MongoClient(uri).connect();
+  }
+  return globalThis.__mongoClientPromise;
+}
+
+export async function getDb() {
+  const client = await clientPromise();
+  // The default DB comes from the connection-string path segment the grid injects.
+  return client.db();
+}

package/src/corpus/templates/project-management/services/web/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "my-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "^15.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "mongodb": "^6.12.0"
+  }
+}

package/src/corpus/templates/property-listings/README.md

@@ -0,0 +1,76 @@
+# property-listings template — persistent Next.js + Mongo real-estate site
+
+A minimal but real, deployable property listings site. Listings live in the
+grid-shared MongoDB, so they survive refresh and are shared across users/sessions
+— unlike a static page whose state is in memory only.
+
+The domain is a `properties` collection with `{ title, price:number, location,
+beds:number, description }`. The UI is a responsive card grid with a
+location/price filter, a per-property detail view, and an admin add form.
+
+## How the grid gives you a database
+
+You do **not** provision a database or set a connection string. In
+`cloudgrid.yaml` you declare `needs: { database: true }`, and the grid:
+
+- provisions shared Mongo for the app, and
+- injects the connection string as the **`DATABASE_MONGODB_URL`** environment
+  variable (plus the legacy `MONGODB_URL` alias) — at dev-time (`grid dev`) and
+  at runtime (after `grid plug`).
+
+The app reads it via `process.env.DATABASE_MONGODB_URL` (with a legacy
+`process.env.MONGODB_URL` fallback) in `services/web/lib/db.js` — **lazily,
+inside the `getDb` getter, never at module top level** (a top-level read fails
+`next build`, which imports the module for route analysis before the grid injects
+the var). Never hardcode a connection string; never commit a secret.
+
+> **Declare `needs: { database: true }` (the canonical shape).** The deployer
+> provisions Mongo and injects `DATABASE_MONGODB_URL` (plus the legacy
+> `MONGODB_URL` alias). `requires:` is the deprecated v1 alias — don't author new
+> yaml with it, and never set `needs:` and `requires:` together (the validator
+> rejects the combination).
+
+## Service layout
+
+App code lives under **`services/web/`**, not the template root. `path:` in
+`cloudgrid.yaml` is the URL mount, not the filesystem path — the service named
+`web` means the CLI looks for `services/web/`. Files at the root fail with
+`Error: Service directory not found: …/services/web`.
+
+## Run locally
+
+```bash
+npm install
+grid dev          # runs Next.js with DATABASE_MONGODB_URL injected against dev Mongo
+```
+
+## Deploy
+
+```bash
+grid plug         # builds + deploys the folder (async — poll status until live)
+```
+
+A runtime deploy is asynchronous: `plug` returns `status: building`; poll status
+until the app is live, then use the returned live URL. Re-plug the same entity
+to update the same URL.
+
+## File tree
+
+```
+cloudgrid.yaml                             # name + services.web (nextjs) + needs: { database: true }
+services/web/package.json                  # next, react, react-dom, mongodb driver only
+services/web/lib/db.js                     # lazy Mongo client from DATABASE_MONGODB_URL (legacy MONGODB_URL fallback)
+services/web/app/layout.js                 # root layout + inline CSS (grid + card styles)
+services/web/app/page.js                   # server component: reads/filter properties from Mongo
+services/web/app/listings.js               # client: filter controls, card grid, detail view, admin add form
+services/web/app/api/properties/route.js   # GET (list + filter) / POST (add) / DELETE (remove)
+```
+
+## Adapt it
+
+- Rename the `properties` collection in
+  `services/web/app/api/properties/route.js` and `services/web/app/page.js`
+  (e.g. `rentals`, `homes`).
+- Change the document fields (add photos, sqft, status).
+- Add more filters or routes as the site grows.
+- Add `cache: true` to `needs:` only if you actually need Redis.