@cloudgrid-io/mcp 0.6.0 → 0.7.0

package/src/corpus/skill-drop.md

@@ -4,8 +4,9 @@ name: drop
 description: |
   Share an artifact and get a public URL. Use when the user wants to share,
   publish, send, or deploy an HTML page or file, or wants a link for a friend.
-  Works with no login (anonymous, 7-day, claimable later) or signed in (published
-  into the user's org, owned, 30-day). Inspirations only.
+  Works with no login (anonymous, claimable later) or signed in (published
+  into the user's org, owned). Re-plugging updates the same URL in place.
+  Inspirations only.
 argument-hint: "[file]"
 allowed-tools: Bash
 ---
@@ -50,18 +51,19 @@ curl -sS -X POST https://api.cloudgrid.io/api/v2/plug \
 
 The response is JSON (HTTP 201 for an anonymous drop). Read these fields:
 
-- `slug` — the entity's public slug. An anonymous inspiration's live link is
-  `https://guest.cloudgrid.io/<slug>`. The response has no ready-made `url`;
-  compose it from the slug. (Apps/agents would be `https://<slug>.<grid>.cloudgrid.io`,
-  but anonymous drops are always inspirations.)
-- `claim_url` — the link to sign in and keep it past the 7-day expiry.
+- `url` — the live link, composed by the server. Use it verbatim; never compose a
+  URL from the slug yourself.
+- `entity_id` — the durable handle for updating this drop later (see re-plug below).
+- `owner_token` — a JWT proving you made this drop. It lets you re-plug the drop
+  anonymously and doubles as the claim token. Its lifetime matches the drop's
+  expiry (default 7 days). Persist it together with `entity_id` and `url`.
+- `claim_url` — the link to sign in and keep the drop past its expiry.
 - `claim_message` — a ready-to-show nudge to sign in and claim.
 
 ## If the user is signed in
 
 A signed-in user can publish into their own org instead of anonymously — the drop
-is owned, lasts 30 days, and needs no claim. Add their token and org to the same
-request:
+is owned and needs no claim. Add their token and org to the same request:
 
 ```
 JWT=$(jq -r .jwt ~/.cloudgrid/credentials 2>/dev/null)
@@ -71,30 +73,63 @@ curl -sS -X POST https://api.cloudgrid.io/api/v2/plug \
   -F "artifact=@/path/to/index.html;type=text/html"
 ```
 
-A signed-in drop returns HTTP 202 with `slug` + `grid` and no `claim_url` (it is
-already owned). Its live link is `https://<grid>.cloudgrid.io/<slug>` for an
-inspiration. The org is taken from the `X-CloudGrid-Org` header — there is no
+A signed-in drop returns HTTP 202 with `entity_id`, `url`, `slug` + `grid` and no
+`claim_url` (it is already owned). Use the returned `url` as the live link — do
+not compose it. The org is taken from the `X-CloudGrid-Org` header — there is no
 `org_slug` form field. If the user is a member of several orgs and the header is
 missing, the API replies with the list of orgs to choose from. The MCP
 `cloudgrid_drop` tool does this automatically when credentials are present.
 
-## One drop = one entity (no in-place re-drop)
+## Re-plug: update the same URL in place
 
-The unified `/api/v2/plug` endpoint is create-only for this flow: every drop mints
-a NEW entity with a NEW URL. There is no `previous_id` / in-place-update path and no
-`202 unchanged` no-op — those belonged to the retired `/drop/auto` endpoint. To
-publish an update, drop again; you get a fresh link. (To update an existing app in
-place, sign in and use `cloudgrid:plug`, which targets the entity by name.)
+`/api/v2/plug` is a unified create-or-update endpoint. The switch is the
+`target_entity_id` form field:
 
-The MCP `cloudgrid_drop` tool accepts a `fresh` flag for backward compatibility,
-but it is now a no-op — each drop is already a fresh create.
+- **Absent** → create: a new entity, a new URL.
+- **Present** → re-plug: the SAME entity is updated — same slug, same URL, new
+  content. This is how you iterate on one shareable link.
+
+Signed in, re-plug with the entity id and your normal auth headers:
+
+```
+curl -sS -X POST https://api.cloudgrid.io/api/v2/plug \
+  -H "Authorization: Bearer $JWT" -H "X-CloudGrid-Org: $ORG" \
+  -F "target_entity_id=$ENTITY_ID" \
+  -F "artifact=@/path/to/index.html;type=text/html"
+```
+
+Anonymously, prove ownership with the `owner_token` the drop returned:
+
+```
+curl -sS -X POST https://api.cloudgrid.io/api/v2/plug \
+  -F "target_entity_id=$ENTITY_ID" \
+  -F "owner_token=$OWNER_TOKEN" \
+  -F "artifact=@/path/to/index.html;type=text/html"
+```
+
+Rules that matter:
+
+- `entity_id` + `url` (+ `owner_token` when anonymous) are the durable re-plug
+  handle. Persist them after every drop.
+- Every anonymous edit REFRESHES the `owner_token` — store the one from the
+  latest response; the old one is superseded. Each edit also resets the drop's
+  expiry window.
+- Editing an archived or expired drop returns **409 `EDIT_REJECTED`** — it never
+  silently creates a new entity. Drop again (without `target_entity_id`) if the
+  user wants a new link.
+- An anonymous edit without a valid `owner_token` returns **401**.
+- Anonymous edits count against the same daily anonymous cap as creates.
+- Only re-plug when the user is iterating on an existing artifact. If they want a
+  separate new link, omit `target_entity_id` (the MCP `cloudgrid_drop` tool's
+  `fresh` flag does the same: it forces a new entity instead of updating).
 
 ## After the drop
 
-Print the composed `url` (e.g. `https://guest.cloudgrid.io/<slug>`) on its own line,
-by itself, so it can be copied in one go. Then add one line of context: an anonymous
-drop lasts 7 days and can be claimed to keep it; a signed-in drop is already owned.
-Do not bury the URL in prose.
+Print the `url` from the response on its own line, by itself, so it can be copied
+in one go. Then add one line of context: an anonymous drop expires (default 7 days,
+reset on every edit) and can be claimed to keep it; a signed-in drop is already
+owned. Do not bury the URL in prose. Keep `entity_id` (and `owner_token` if
+anonymous) so a follow-up "change X" can re-plug the same URL.
 
 ## Limits and errors
 

package/src/corpus/skills-readme.md

@@ -25,16 +25,21 @@ behalf: scaffold, deploy, tail logs, share, read feedback. Everything here is fr
    cloudgrid login
    ```
 
-3. Add the skills. In Claude Code (recommended):
+3. Add the agent-core. In Claude Code (recommended):
 
    ```
    /plugin marketplace add cloudgrid-io/skills
-   /plugin install cloudgrid
+   /plugin install cloudgrid@cloudgrid-skills
    ```
 
-   They show under `/plugin` and `/skills` as `cloudgrid:drop`, `cloudgrid:login`,
-   … — or just say what you want ("drop this HTML to CloudGrid") and the right one
-   triggers.
+   One install wires up everything: the skills, the SessionStart orientation
+   hook, and the CloudGrid MCP server (`gridctl_start`, `gridctl_fetch`, and the
+   CLI-wrapping tools). The MCP auto-starts when the plugin is enabled — no
+   separate `claude mcp add` needed.
+
+   The skills show under `/plugin` and `/skills` as `cloudgrid:drop`,
+   `cloudgrid:login`, … — or just say what you want ("drop this HTML to
+   CloudGrid") and the right one triggers.
 
    Or install with the `gh skill` extension:
 
@@ -82,9 +87,11 @@ walks through it end to end.
 
 ## MCP server
 
-The MCP server is published separately as
+The Claude Code plugin above already bundles the MCP server — installing
+`cloudgrid@cloudgrid-skills` starts it automatically. For every other client, the
+MCP server is published separately as
 [`@cloudgrid-io/mcp`](https://github.com/cloudgrid-io/mcp). It exposes the same
-nine actions as MCP tools, for agents that speak the Model Context Protocol.
+actions as MCP tools, for agents that speak the Model Context Protocol.
 Install it with `npx -y @cloudgrid-io/mcp`, or point a remote-capable client at
 `https://mcp.cloudgrid.io/mcp`. See [USAGE.md](USAGE.md) for per-client setup.
 

package/src/corpus/templates/dashboard/index.html

@@ -0,0 +1,118 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>{{DASHBOARD_TITLE}}</title>
+<style>
+  :root {
+    --bg: #0b0f17;
+    --panel: #121826;
+    --fg: #e8edf5;
+    --muted: #9aa7bd;
+    --accent: #5b8cff;
+    --good: #46d19e;
+    --border: #223049;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: var(--bg);
+    color: var(--fg);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    padding: clamp(1.25rem, 4vw, 2.5rem);
+  }
+  header { margin-bottom: 1.75rem; }
+  h1 { font-size: clamp(1.6rem, 4vw, 2.3rem); letter-spacing: -0.02em; }
+  .status { color: var(--muted); margin-top: 0.35rem; }
+  .grid { display: grid; gap: 1.1rem; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); }
+  .card {
+    background: var(--panel); border: 1px solid var(--border);
+    border-radius: 14px; padding: 1.25rem 1.4rem;
+  }
+  .card .label { color: var(--muted); font-size: 0.85rem; }
+  .card .value { font-size: 2rem; font-weight: 600; margin: 0.35rem 0; font-variant-numeric: tabular-nums; }
+  .card .trend { font-size: 0.85rem; color: var(--good); }
+  .charts { display: grid; gap: 1.1rem; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); margin-top: 1.1rem; }
+  .chart-card { background: var(--panel); border: 1px solid var(--border); border-radius: 14px; padding: 1.25rem 1.4rem; }
+  .chart-card h2 { font-size: 1rem; color: var(--muted); font-weight: 600; margin-bottom: 0.9rem; }
+  svg { width: 100%; height: auto; display: block; }
+</style>
+</head>
+<body>
+  <header>
+    <h1>{{DASHBOARD_TITLE}}</h1>
+    <div class="status">{{STATUS_LINE}}</div>
+  </header>
+
+  <!-- One card per KPI. -->
+  <section class="grid">
+    <div class="card">
+      <div class="label">{{KPI_1_LABEL}}</div>
+      <div class="value">{{KPI_1_VALUE}}</div>
+      <div class="trend">{{KPI_1_TREND}}</div>
+    </div>
+    <div class="card">
+      <div class="label">{{KPI_2_LABEL}}</div>
+      <div class="value">{{KPI_2_VALUE}}</div>
+      <div class="trend">{{KPI_2_TREND}}</div>
+    </div>
+    <div class="card">
+      <div class="label">{{KPI_3_LABEL}}</div>
+      <div class="value">{{KPI_3_VALUE}}</div>
+      <div class="trend">{{KPI_3_TREND}}</div>
+    </div>
+  </section>
+
+  <section class="charts">
+    <div class="chart-card">
+      <h2>{{BAR_CHART_TITLE}}</h2>
+      <svg id="bar" viewBox="0 0 320 160" role="img" aria-label="Bar chart"></svg>
+    </div>
+    <div class="chart-card">
+      <h2>{{LINE_CHART_TITLE}}</h2>
+      <svg id="line" viewBox="0 0 320 160" role="img" aria-label="Line chart"></svg>
+    </div>
+  </section>
+
+  <script>
+    // Charts are hand-rolled inline SVG — no external library. Edit these arrays.
+    var barData = [{{BAR_DATA}}];   // e.g. 12, 19, 9, 22, 17
+    var lineData = [{{LINE_DATA}}]; // e.g. 4, 8, 6, 11, 9, 14
+
+    var NS = "http://www.w3.org/2000/svg";
+    function el(name, attrs) {
+      var n = document.createElementNS(NS, name);
+      for (var k in attrs) n.setAttribute(k, attrs[k]);
+      return n;
+    }
+
+    (function drawBars() {
+      var svg = document.getElementById("bar");
+      var W = 320, H = 160, pad = 20;
+      var max = Math.max.apply(null, barData.concat([1]));
+      var bw = (W - pad * 2) / barData.length;
+      barData.forEach(function (v, i) {
+        var h = (v / max) * (H - pad * 2);
+        svg.appendChild(el("rect", {
+          x: pad + i * bw + bw * 0.15, y: H - pad - h,
+          width: bw * 0.7, height: h, rx: 3, fill: "var(--accent)"
+        }));
+      });
+      svg.appendChild(el("line", { x1: pad, y1: H - pad, x2: W - pad, y2: H - pad, stroke: "var(--border)" }));
+    })();
+
+    (function drawLine() {
+      var svg = document.getElementById("line");
+      var W = 320, H = 160, pad = 20;
+      var max = Math.max.apply(null, lineData.concat([1]));
+      var step = (W - pad * 2) / Math.max(1, lineData.length - 1);
+      var pts = lineData.map(function (v, i) {
+        return (pad + i * step) + "," + (H - pad - (v / max) * (H - pad * 2));
+      }).join(" ");
+      svg.appendChild(el("polyline", { points: pts, fill: "none", stroke: "var(--good)", "stroke-width": 2.5 }));
+      svg.appendChild(el("line", { x1: pad, y1: H - pad, x2: W - pad, y2: H - pad, stroke: "var(--border)" }));
+    })();
+  </script>
+</body>
+</html>

package/src/corpus/templates/landing-page/index.html

@@ -0,0 +1,97 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>{{PRODUCT_NAME}}</title>
+<style>
+  :root {
+    --bg: #0b0f17;
+    --panel: #121826;
+    --fg: #e8edf5;
+    --muted: #9aa7bd;
+    --accent: #5b8cff;
+    --border: #223049;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: var(--bg);
+    color: var(--fg);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    line-height: 1.5;
+  }
+  header, section, footer { padding: clamp(2rem, 6vw, 5rem) clamp(1.25rem, 6vw, 6rem); }
+  nav {
+    display: flex; align-items: center; justify-content: space-between;
+    padding: 1.1rem clamp(1.25rem, 6vw, 6rem);
+    border-bottom: 1px solid var(--border);
+  }
+  nav .brand { font-weight: 600; letter-spacing: -0.01em; }
+  nav a { color: var(--muted); text-decoration: none; }
+  .hero { text-align: center; display: grid; gap: 1.25rem; place-items: center; }
+  .hero h1 {
+    font-size: clamp(2.4rem, 6vw, 4.5rem);
+    line-height: 1.05; letter-spacing: -0.02em; max-width: 20ch;
+  }
+  .hero p { font-size: clamp(1.05rem, 2.4vw, 1.5rem); color: var(--muted); max-width: 48ch; }
+  .cta {
+    display: inline-block; margin-top: 0.5rem;
+    background: var(--accent); color: #fff; text-decoration: none;
+    padding: 0.85rem 1.6rem; border-radius: 10px; font-weight: 600;
+  }
+  .cta:hover { filter: brightness(1.08); }
+  .features {
+    display: grid; gap: 1.25rem;
+    grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+    border-top: 1px solid var(--border);
+  }
+  .feature {
+    background: var(--panel); border: 1px solid var(--border);
+    border-radius: 14px; padding: 1.5rem;
+  }
+  .feature h3 { font-size: 1.15rem; margin-bottom: 0.5rem; letter-spacing: -0.01em; }
+  .feature p { color: var(--muted); }
+  .closing { text-align: center; border-top: 1px solid var(--border); display: grid; gap: 1.25rem; place-items: center; }
+  .closing h2 { font-size: clamp(1.8rem, 4.5vw, 3rem); letter-spacing: -0.01em; max-width: 24ch; }
+  footer { border-top: 1px solid var(--border); color: var(--muted); font-size: 0.9rem; text-align: center; }
+</style>
+</head>
+<body>
+  <nav>
+    <span class="brand">{{PRODUCT_NAME}}</span>
+    <a class="cta" href="{{CTA_HREF}}">{{CTA_LABEL}}</a>
+  </nav>
+
+  <header class="hero">
+    <h1>{{HERO_HEADLINE}}</h1>
+    <p>{{HERO_SUBHEAD}}</p>
+    <a class="cta" href="{{CTA_HREF}}">{{CTA_LABEL}}</a>
+  </header>
+
+  <section class="features">
+    <!-- FEATURES_START -->
+    <div class="feature">
+      <h3>{{FEATURE_1_TITLE}}</h3>
+      <p>{{FEATURE_1_BODY}}</p>
+    </div>
+    <div class="feature">
+      <h3>{{FEATURE_2_TITLE}}</h3>
+      <p>{{FEATURE_2_BODY}}</p>
+    </div>
+    <div class="feature">
+      <h3>{{FEATURE_3_TITLE}}</h3>
+      <p>{{FEATURE_3_BODY}}</p>
+    </div>
+    <!-- Add more <div class="feature">...</div> blocks as needed. -->
+    <!-- FEATURES_END -->
+  </section>
+
+  <section class="closing">
+    <h2>{{CLOSING_HEADLINE}}</h2>
+    <a class="cta" href="{{CTA_HREF}}">{{CTA_LABEL}}</a>
+  </section>
+
+  <footer>{{FOOTER_TEXT}}</footer>
+</body>
+</html>

package/src/corpus/templates/report/index.html

@@ -0,0 +1,93 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>{{REPORT_TITLE}}</title>
+<style>
+  :root {
+    --bg: #0b0f17;
+    --panel: #121826;
+    --fg: #e8edf5;
+    --muted: #9aa7bd;
+    --accent: #5b8cff;
+    --border: #223049;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: var(--bg);
+    color: var(--fg);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    line-height: 1.6;
+  }
+  .page {
+    max-width: 820px; margin: 0 auto;
+    padding: clamp(2rem, 6vw, 4.5rem) clamp(1.25rem, 5vw, 3.5rem);
+  }
+  header { border-bottom: 1px solid var(--border); padding-bottom: 1.5rem; margin-bottom: 2rem; }
+  .accent-bar { width: 64px; height: 5px; border-radius: 99px; background: var(--accent); margin-bottom: 1.1rem; }
+  h1 { font-size: clamp(1.9rem, 4.5vw, 2.8rem); line-height: 1.1; letter-spacing: -0.02em; }
+  .subtitle { color: var(--muted); font-size: 1.1rem; margin-top: 0.5rem; }
+  .meta { color: var(--muted); font-size: 0.9rem; margin-top: 0.75rem; }
+  .summary {
+    background: var(--panel); border: 1px solid var(--border);
+    border-radius: 12px; padding: 1.25rem 1.4rem; margin-bottom: 2rem; color: var(--muted);
+  }
+  section { margin-bottom: 2rem; }
+  section h2 { font-size: 1.35rem; letter-spacing: -0.01em; margin-bottom: 0.6rem; }
+  section p { color: var(--muted); }
+  table { width: 100%; border-collapse: collapse; margin-top: 0.5rem; }
+  th, td { text-align: left; padding: 0.6rem 0.75rem; border-bottom: 1px solid var(--border); }
+  th { color: var(--muted); font-size: 0.85rem; font-weight: 600; }
+  td { font-variant-numeric: tabular-nums; }
+  footer { border-top: 1px solid var(--border); padding-top: 1.25rem; color: var(--muted); font-size: 0.85rem; }
+  @media print {
+    :root { --bg: #ffffff; --panel: #f4f6fa; --fg: #10151f; --muted: #4a5568; --border: #d5dbe6; }
+    body { background: #fff; }
+    .page { padding: 0; }
+  }
+</style>
+</head>
+<body>
+  <div class="page">
+    <header>
+      <div class="accent-bar"></div>
+      <h1>{{REPORT_TITLE}}</h1>
+      <div class="subtitle">{{REPORT_SUBTITLE}}</div>
+      <div class="meta">{{REPORT_DATE_LINE}}</div>
+    </header>
+
+    <div class="summary">{{REPORT_SUMMARY}}</div>
+
+    <!-- SECTIONS_START -->
+    <section>
+      <h2>{{SECTION_1_HEADING}}</h2>
+      <p>{{SECTION_1_BODY}}</p>
+    </section>
+    <section>
+      <h2>{{SECTION_2_HEADING}}</h2>
+      <p>{{SECTION_2_BODY}}</p>
+    </section>
+    <!-- Add more <section>...</section> blocks as needed. -->
+    <!-- SECTIONS_END -->
+
+    <section>
+      <h2>{{DATA_HEADING}}</h2>
+      <!-- Fill these rows with the data, or remove this whole section if there is none. -->
+      <table>
+        <thead>
+          <tr><th>{{COL_1}}</th><th>{{COL_2}}</th><th>{{COL_3}}</th></tr>
+        </thead>
+        <tbody>
+          <tr><td>{{R1C1}}</td><td>{{R1C2}}</td><td>{{R1C3}}</td></tr>
+          <tr><td>{{R2C1}}</td><td>{{R2C2}}</td><td>{{R2C3}}</td></tr>
+          <tr><td>{{R3C1}}</td><td>{{R3C2}}</td><td>{{R3C3}}</td></tr>
+        </tbody>
+      </table>
+    </section>
+
+    <footer>{{FOOTER_TEXT}}</footer>
+  </div>
+</body>
+</html>

package/src/corpus/templates/web-app/index.html

@@ -0,0 +1,99 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>{{APP_TITLE}}</title>
+<style>
+  :root {
+    --bg: #0b0f17;
+    --panel: #121826;
+    --fg: #e8edf5;
+    --muted: #9aa7bd;
+    --accent: #5b8cff;
+    --border: #223049;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: var(--bg);
+    color: var(--fg);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    min-height: 100vh;
+    display: grid; place-items: center;
+    padding: 1.5rem;
+  }
+  .app {
+    width: 100%; max-width: 420px;
+    background: var(--panel); border: 1px solid var(--border);
+    border-radius: 16px; padding: 1.75rem;
+  }
+  h1 { font-size: 1.5rem; letter-spacing: -0.01em; margin-bottom: 0.35rem; }
+  .subtitle { color: var(--muted); font-size: 0.95rem; margin-bottom: 1.4rem; }
+  label { display: block; font-size: 0.85rem; color: var(--muted); margin: 0.9rem 0 0.35rem; }
+  input, select {
+    width: 100%; font: inherit; color: var(--fg);
+    background: var(--bg); border: 1px solid var(--border);
+    border-radius: 10px; padding: 0.65rem 0.75rem;
+  }
+  input:focus, select:focus { outline: none; border-color: var(--accent); }
+  .row { display: flex; gap: 0.75rem; }
+  .row > * { flex: 1; }
+  .result {
+    margin-top: 1.5rem; padding: 1.1rem 1.25rem;
+    background: var(--bg); border: 1px solid var(--border); border-radius: 12px;
+    display: flex; align-items: baseline; justify-content: space-between;
+  }
+  .result .label { color: var(--muted); font-size: 0.85rem; }
+  .result .value { font-size: 1.6rem; font-weight: 600; font-variant-numeric: tabular-nums; }
+</style>
+</head>
+<body>
+  <!-- Adapt this shell into the tool you need: rename the title, replace the
+       inputs, and rewrite compute() to produce the output. Keep all logic
+       inline. This starter reads two numeric inputs and shows their result. -->
+  <main class="app">
+    <h1>{{APP_TITLE}}</h1>
+    <p class="subtitle">{{APP_SUBTITLE}}</p>
+
+    <div class="row">
+      <div>
+        <label for="a">{{INPUT_A_LABEL}}</label>
+        <input id="a" type="number" value="0" inputmode="decimal" />
+      </div>
+      <div>
+        <label for="b">{{INPUT_B_LABEL}}</label>
+        <input id="b" type="number" value="0" inputmode="decimal" />
+      </div>
+    </div>
+
+    <div class="result">
+      <span class="label">{{RESULT_LABEL}}</span>
+      <span class="value" id="out">0</span>
+    </div>
+  </main>
+
+  <script>
+    (function () {
+      var a = document.getElementById("a");
+      var b = document.getElementById("b");
+      var out = document.getElementById("out");
+
+      // Replace this with the tool's real calculation.
+      function compute() {
+        var x = parseFloat(a.value) || 0;
+        var y = parseFloat(b.value) || 0;
+        return x + y;
+      }
+
+      function render() {
+        out.textContent = String(compute());
+      }
+
+      a.addEventListener("input", render);
+      b.addEventListener("input", render);
+      render();
+    })();
+  </script>
+</body>
+</html>

package/src/corpus/usage.md

@@ -128,7 +128,7 @@ You can install both; they do not conflict.
 
 | Action | What it does |
 |---|---|
-| drop | Share an artifact, get a public URL. No login needed (anonymous, 7-day) or owned if signed in (30-day). |
+| drop | Share an artifact, get a public URL. No login needed (anonymous, claimable) or owned if signed in. Re-drop with the entity id to update the same URL. |
 | login | Sign in to CloudGrid, with or without the CLI. |
 | claim | Claim an anonymous drop into your account; the URL stays the same. |
 | init | Scaffold a new app or agent. |

package/src/corpus/workflows/dashboard.md

@@ -0,0 +1,33 @@
+---
+name: dashboard
+when: The user wants to build a dashboard showing metrics, status, or KPIs with cards and charts.
+summary: Fetch the dashboard template, fill it with the user's metrics and inline charts, deploy it, and return the live share URL.
+---
+
+# Workflow: dashboard
+
+Detect the intent ("build me a dashboard for X metrics / status") and follow
+this recipe. Do not ask setup questions first; use sensible defaults and build.
+
+1. **Fetch the template.** Call `gridctl_fetch("template", "dashboard")` to load
+   the self-contained HTML dashboard template.
+2. **(Optional) Fetch the example.** Call `gridctl_fetch("example", "dashboard")`
+   to see a filled dashboard as a reference for structure and layout.
+3. **Fill the template.** Replace the placeholders with the user's content:
+   - The dashboard title and (optional) status line.
+   - One metric card per KPI. Each card has a label, a value, and a trend note.
+   - The chart data: edit the inline data arrays that the hand-rolled SVG and
+     inline JS read from. Keep every chart inline — do not add an external chart
+     library or CDN.
+   - Keep it a single self-contained HTML file. Do not add external scripts,
+     stylesheets, fonts, or large embedded media.
+4. **Deploy.** Deploy the filled HTML:
+   - Hosted MCP edition: call the drop tool with the HTML.
+   - Local MCP / CLI edition: write the HTML to a file and run `gridctl plug`.
+   A dashboard is an inspiration and deploys synchronously, so you get a URL
+   right away.
+5. **Return the live share URL.** Give the user the URL that serves the dashboard.
+   For revisions, re-deploy with the entity id from the first deploy — it updates
+   the same share URL, so the user iterates on one link.
+
+Keep the whole flow tight: fetch, fill, deploy, share.

package/src/corpus/workflows/landing-page.md

@@ -0,0 +1,31 @@
+---
+name: landing-page
+when: The user wants to build a landing page, marketing page, or product page for something.
+summary: Fetch the landing-page template, fill it with the user's content, deploy it, and return the live share URL.
+---
+
+# Workflow: landing-page
+
+Detect the intent ("build me a landing page / marketing page for X") and follow
+this recipe. Do not ask setup questions first; use sensible defaults and build.
+
+1. **Fetch the template.** Call `gridctl_fetch("template", "landing-page")` to
+   load the self-contained HTML landing-page template.
+2. **(Optional) Fetch the example.** Call `gridctl_fetch("example", "landing-page")`
+   to see a filled landing page as a reference for tone and structure.
+3. **Fill the template.** Replace the placeholders with the user's content:
+   - The product name, hero headline, and subheadline.
+   - The call-to-action label and (optional) target.
+   - One block per feature. Each feature has a title and a short description.
+   - Keep it a single self-contained HTML file. Do not add external scripts,
+     stylesheets, fonts, or large embedded media.
+4. **Deploy.** Deploy the filled HTML:
+   - Hosted MCP edition: call the drop tool with the HTML.
+   - Local MCP / CLI edition: write the HTML to a file and run `gridctl plug`.
+   A landing page is an inspiration and deploys synchronously, so you get a URL
+   right away.
+5. **Return the live share URL.** Give the user the URL that serves the page.
+   For revisions, re-deploy with the entity id from the first deploy — it updates
+   the same share URL, so the user iterates on one link.
+
+Keep the whole flow tight: fetch, fill, deploy, share.

package/src/corpus/workflows/presentation.md

@@ -24,5 +24,7 @@ this recipe. Do not ask setup questions first; use sensible defaults and build.
    An HTML deck is an inspiration and deploys synchronously, so you get a URL
    right away.
 5. **Return the live share URL.** Give the user the URL that serves the deck.
+   For revisions, re-deploy with the entity id from the first deploy — it updates
+   the same share URL, so the user iterates on one link.
 
 Keep the whole flow tight: fetch, fill, deploy, share.