@awesomate/hosting-mcp 0.62.0 → 0.64.0

package/README.md

@@ -3,46 +3,33 @@
 The MCP server that connects an Awesomate customer's own Claude Code to their
 Awesomate account: WordPress hosting, n8n automations, apps, and Knowledge
 Base. It authenticates to the Awesomate hub with a scoped Personal Access
-Token and ships the nine `awesomate-*` skills that teach Claude how to use it.
+Token and ships the `awesomate-*` skills that teach Claude how to use it.
+
+**Docs: https://hub.awesomate.ai/docs/mcp/** (a quickstart, how it works, a guide
+per area, and a reference generated from this server's own `tools/list`). Its
+sister site documents the SDK: https://hub.awesomate.ai/docs/sdk/.
 
 ## Install (customers)
 
 Don't install this by hand. Open **hub.awesomate.ai/claude** (or the Sites
-page) and click **Connect Claude Code** — it gives you a one-time command that:
+page) and click **Connect Claude Code**. It gives you a one-time command that:
 
 1. redeems a short-lived setup code for a scoped access token, born on your
-   machine (`~/.awesomate/credentials.json`, chmod 600 — it never traverses
+   machine (`~/.awesomate/credentials.json`, chmod 600; it never traverses
    the clipboard),
 2. installs the `awesomate-*` skills into `~/.claude/skills`,
 3. registers this server in Claude Code (user scope, no token in the
-   registration — see below).
+   registration: see below).
 
 Then restart Claude Code and run `awesomate_whoami`.
 
 ## What Claude can do with it
 
-Roughly 60 tools across five domains — the authoritative list is whatever
-`tools/list` returns from the version you're running (this server self-updates,
-so a hand-maintained table here would only ever be stale):
-
-- **Hosting & WordPress** — sites, domains, DNS checks, uptime, plan limits,
-  snapshots/rollback, `.dev` staging, allowlisted WP-CLI, structured post/page
-  writes (drafts first) and media import. Writes need Support Plus+.
-- **n8n automations** — full read surface on every plan (workflows, executions
-  with structural error decode, instance-wide error clusters, KPIs, storage
-  footprint, node docs); validate → draft → test → promote build loop on
-  Support Plus+; AI error-analyzer findings on Pro/Embedded.
-- **Apps** — scaffold, create, deploy-via-git, env vars, health, app Postgres.
-- **Knowledge Base** (every plan; media/OCR Pro+, public widget Support Plus+) — provision, ingest sources, faceted search,
-  cited answers, agents, people/entities, business-data queries.
-- **Account** — context + attention digest (notifications, erroring workflows,
-  token expiry), plan features, upgrade nudges, support tickets, done-for-you
-  build requests (two-step credit confirmation; never spends without an
-  explicit yes).
-
+Every tool, with its inputs and whether it reads, changes or can delete, is in
+the generated reference: https://hub.awesomate.ai/docs/mcp/reference/account/.
+The docs build fails if a tool is missing from it, so it cannot fall behind.
 Every response is stamped `account: <slug>` so a session talking to the wrong
-account is impossible to miss. Read tools carry `readOnlyHint`; destructive
-ones carry `destructiveHint` and confirm-before-acting instructions.
+account is impossible to miss.
 
 ## Security posture
 
@@ -60,13 +47,13 @@ ones carry `destructiveHint` and confirm-before-acting instructions.
 
 The server self-updates: it's registered as unpinned `npx -y`, so every Claude
 Code restart runs the latest published version. The skill files update via the
-`awesomate_skill_update` tool — Claude notices the drift itself (it's stamped
+`awesomate_skill_update` tool. Claude notices the drift itself (it's stamped
 on every response) and offers the update with what's-new lines from
 `skill/CHANGELOG.json`, then hands over the exact restart step.
 
 ## Manual registration (developers)
 
-Keep `--package=` with the `=` — the claude CLI's global-argv pre-scan chokes
+Keep `--package=` with the `=`: the claude CLI's global-argv pre-scan chokes
 on a bare `-p`, and the package must be explicit because this package ships
 two bins:
 
@@ -78,8 +65,13 @@ claude mcp add awesomate-hosting -- npx -y --package=@awesomate/hosting-mcp awes
 
 ```bash
 npm run typecheck
-npm test           # builds, then boot-smoke + resolution + skills + knowledge suites
+npm test                          # builds, then boot-smoke + resolution + skills + knowledge suites
+node scripts/build-docs.mjs --check   # the docs checks (also in CI and the hub's web build)
 ```
 
+A change to `src/` or `skill/` needs a new version and a `skill/CHANGELOG.json`
+entry at the top, and a new tool needs a place in `docs/reference.json` and,
+where it changes what someone can ask for, a line in the right guide under `docs/`.
+
 Publishing is CI-only: any `mcp/**` change merged to main with a bumped
 version publishes via `publish-mcp.yml`. Never `npm publish` by hand.

package/dist/index.js

@@ -2987,7 +2987,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve2.call(this, root, ref);
+      let _sch = resolve3.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a = root.localRefs) === null || _a === void 0 ? void 0 : _a[ref];
         const { schemaId } = this.opts;
@@ -3014,7 +3014,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve2(root, ref) {
+    function resolve3(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3645,55 +3645,55 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve2(baseURI, relativeURI, options) {
+    function resolve3(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse3(baseURI, schemelessOptions), parse3(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative2, options, skipNormalization) {
+    function resolveComponent(base, relative3, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse3(serialize(base, options), options);
-        relative2 = parse3(serialize(relative2, options), options);
+        relative3 = parse3(serialize(relative3, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative2.scheme) {
-        target.scheme = relative2.scheme;
-        target.userinfo = relative2.userinfo;
-        target.host = relative2.host;
-        target.port = relative2.port;
-        target.path = removeDotSegments(relative2.path || "");
-        target.query = relative2.query;
+      if (!options.tolerant && relative3.scheme) {
+        target.scheme = relative3.scheme;
+        target.userinfo = relative3.userinfo;
+        target.host = relative3.host;
+        target.port = relative3.port;
+        target.path = removeDotSegments(relative3.path || "");
+        target.query = relative3.query;
       } else {
-        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
-          target.userinfo = relative2.userinfo;
-          target.host = relative2.host;
-          target.port = relative2.port;
-          target.path = removeDotSegments(relative2.path || "");
-          target.query = relative2.query;
+        if (relative3.userinfo !== void 0 || relative3.host !== void 0 || relative3.port !== void 0) {
+          target.userinfo = relative3.userinfo;
+          target.host = relative3.host;
+          target.port = relative3.port;
+          target.path = removeDotSegments(relative3.path || "");
+          target.query = relative3.query;
         } else {
-          if (!relative2.path) {
+          if (!relative3.path) {
             target.path = base.path;
-            if (relative2.query !== void 0) {
-              target.query = relative2.query;
+            if (relative3.query !== void 0) {
+              target.query = relative3.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative2.path[0] === "/") {
-              target.path = removeDotSegments(relative2.path);
+            if (relative3.path[0] === "/") {
+              target.path = removeDotSegments(relative3.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative2.path;
+                target.path = "/" + relative3.path;
               } else if (!base.path) {
-                target.path = relative2.path;
+                target.path = relative3.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative3.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative2.query;
+            target.query = relative3.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -3701,7 +3701,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative2.fragment;
+      target.fragment = relative3.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -3909,7 +3909,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve2,
+      resolve: resolve3,
       resolveComponent,
       equal,
       serialize,
@@ -8722,9 +8722,9 @@ var require_dispatcher_base = __commonJS({
       }
       close(callback) {
         if (callback === void 0) {
-          return new Promise((resolve2, reject) => {
+          return new Promise((resolve3, reject) => {
             this.close((err, data) => {
-              return err ? reject(err) : resolve2(data);
+              return err ? reject(err) : resolve3(data);
             });
           });
         }
@@ -8762,12 +8762,12 @@ var require_dispatcher_base = __commonJS({
           err = null;
         }
         if (callback === void 0) {
-          return new Promise((resolve2, reject) => {
+          return new Promise((resolve3, reject) => {
             this.destroy(err, (err2, data) => {
               return err2 ? (
                 /* istanbul ignore next: should never error */
                 reject(err2)
-              ) : resolve2(data);
+              ) : resolve3(data);
             });
           });
         }
@@ -11034,8 +11034,8 @@ var require_util3 = __commonJS({
     function createDeferredPromise() {
       let res;
       let rej;
-      const promise = new Promise((resolve2, reject) => {
-        res = resolve2;
+      const promise = new Promise((resolve3, reject) => {
+        res = resolve3;
         rej = reject;
       });
       return { promise, resolve: res, reject: rej };
@@ -13281,12 +13281,12 @@ upgrade: ${upgrade}\r
           cb();
         }
       }
-      const waitForDrain = () => new Promise((resolve2, reject) => {
+      const waitForDrain = () => new Promise((resolve3, reject) => {
         assert2(callback === null);
         if (socket[kError]) {
           reject(socket[kError]);
         } else {
-          callback = resolve2;
+          callback = resolve3;
         }
       });
       socket.on("close", onDrain).on("drain", onDrain);
@@ -13923,12 +13923,12 @@ var require_client_h2 = __commonJS({
           cb();
         }
       }
-      const waitForDrain = () => new Promise((resolve2, reject) => {
+      const waitForDrain = () => new Promise((resolve3, reject) => {
         assert2(callback === null);
         if (socket[kError]) {
           reject(socket[kError]);
         } else {
-          callback = resolve2;
+          callback = resolve3;
         }
       });
       h2stream.on("close", onDrain).on("drain", onDrain);
@@ -14406,16 +14406,16 @@ var require_client = __commonJS({
         return this[kNeedDrain] < 2;
       }
       async [kClose]() {
-        return new Promise((resolve2) => {
+        return new Promise((resolve3) => {
           if (this[kSize]) {
-            this[kClosedResolve] = resolve2;
+            this[kClosedResolve] = resolve3;
           } else {
-            resolve2(null);
+            resolve3(null);
           }
         });
       }
       async [kDestroy](err) {
-        return new Promise((resolve2) => {
+        return new Promise((resolve3) => {
           const requests = this[kQueue].splice(this[kPendingIdx]);
           for (let i = 0; i < requests.length; i++) {
             const request = requests[i];
@@ -14426,7 +14426,7 @@ var require_client = __commonJS({
               this[kClosedResolve]();
               this[kClosedResolve] = null;
             }
-            resolve2(null);
+            resolve3(null);
           };
           if (this[kHTTPContext]) {
             this[kHTTPContext].destroy(err, callback);
@@ -14477,7 +14477,7 @@ var require_client = __commonJS({
         });
       }
       try {
-        const socket = await new Promise((resolve2, reject) => {
+        const socket = await new Promise((resolve3, reject) => {
           client[kConnector]({
             host,
             hostname: hostname2,
@@ -14489,7 +14489,7 @@ var require_client = __commonJS({
             if (err) {
               reject(err);
             } else {
-              resolve2(socket2);
+              resolve3(socket2);
             }
           });
         });
@@ -14825,8 +14825,8 @@ var require_pool_base = __commonJS({
         if (this[kQueue].isEmpty()) {
           await Promise.all(this[kClients].map((c) => c.close()));
         } else {
-          await new Promise((resolve2) => {
-            this[kClosedResolve] = resolve2;
+          await new Promise((resolve3) => {
+            this[kClosedResolve] = resolve3;
           });
         }
       }
@@ -16069,7 +16069,7 @@ var require_readable = __commonJS({
         if (this._readableState.closeEmitted) {
           return null;
         }
-        return await new Promise((resolve2, reject) => {
+        return await new Promise((resolve3, reject) => {
           if (this[kContentLength] > limit) {
             this.destroy(new AbortError());
           }
@@ -16082,7 +16082,7 @@ var require_readable = __commonJS({
             if (signal?.aborted) {
               reject(signal.reason ?? new AbortError());
             } else {
-              resolve2(null);
+              resolve3(null);
             }
           }).on("error", noop).on("data", function(chunk) {
             limit -= chunk.length;
@@ -16101,7 +16101,7 @@ var require_readable = __commonJS({
     }
     async function consume(stream, type) {
       assert2(!stream[kConsume]);
-      return new Promise((resolve2, reject) => {
+      return new Promise((resolve3, reject) => {
         if (isUnusable(stream)) {
           const rState = stream._readableState;
           if (rState.destroyed && rState.closeEmitted === false) {
@@ -16118,7 +16118,7 @@ var require_readable = __commonJS({
             stream[kConsume] = {
               type,
               stream,
-              resolve: resolve2,
+              resolve: resolve3,
               reject,
               length: 0,
               body: []
@@ -16188,18 +16188,18 @@ var require_readable = __commonJS({
       return buffer;
     }
     function consumeEnd(consume2) {
-      const { type, body, resolve: resolve2, stream, length } = consume2;
+      const { type, body, resolve: resolve3, stream, length } = consume2;
       try {
         if (type === "text") {
-          resolve2(chunksDecode(body, length));
+          resolve3(chunksDecode(body, length));
         } else if (type === "json") {
-          resolve2(JSON.parse(chunksDecode(body, length)));
+          resolve3(JSON.parse(chunksDecode(body, length)));
         } else if (type === "arrayBuffer") {
-          resolve2(chunksConcat(body, length).buffer);
+          resolve3(chunksConcat(body, length).buffer);
         } else if (type === "blob") {
-          resolve2(new Blob(body, { type: stream[kContentType] }));
+          resolve3(new Blob(body, { type: stream[kContentType] }));
         } else if (type === "bytes") {
-          resolve2(chunksConcat(body, length));
+          resolve3(chunksConcat(body, length));
         }
         consumeFinish(consume2);
       } catch (err) {
@@ -16456,9 +16456,9 @@ var require_api_request = __commonJS({
     };
     function request(opts, callback) {
       if (callback === void 0) {
-        return new Promise((resolve2, reject) => {
+        return new Promise((resolve3, reject) => {
           request.call(this, opts, (err, data) => {
-            return err ? reject(err) : resolve2(data);
+            return err ? reject(err) : resolve3(data);
           });
         });
       }
@@ -16681,9 +16681,9 @@ var require_api_stream = __commonJS({
     };
     function stream(opts, factory, callback) {
       if (callback === void 0) {
-        return new Promise((resolve2, reject) => {
+        return new Promise((resolve3, reject) => {
           stream.call(this, opts, factory, (err, data) => {
-            return err ? reject(err) : resolve2(data);
+            return err ? reject(err) : resolve3(data);
           });
         });
       }
@@ -16968,9 +16968,9 @@ var require_api_upgrade = __commonJS({
     };
     function upgrade(opts, callback) {
       if (callback === void 0) {
-        return new Promise((resolve2, reject) => {
+        return new Promise((resolve3, reject) => {
           upgrade.call(this, opts, (err, data) => {
-            return err ? reject(err) : resolve2(data);
+            return err ? reject(err) : resolve3(data);
           });
         });
       }
@@ -17062,9 +17062,9 @@ var require_api_connect = __commonJS({
     };
     function connect(opts, callback) {
       if (callback === void 0) {
-        return new Promise((resolve2, reject) => {
+        return new Promise((resolve3, reject) => {
           connect.call(this, opts, (err, data) => {
-            return err ? reject(err) : resolve2(data);
+            return err ? reject(err) : resolve3(data);
           });
         });
       }
@@ -20926,7 +20926,7 @@ var require_fetch = __commonJS({
       function dispatch({ body }) {
         const url = requestCurrentURL(request);
         const agent = fetchParams.controller.dispatcher;
-        return new Promise((resolve2, reject) => agent.dispatch(
+        return new Promise((resolve3, reject) => agent.dispatch(
           {
             path: url.pathname + url.search,
             origin: url.origin,
@@ -21002,7 +21002,7 @@ var require_fetch = __commonJS({
                 }
               }
               const onError = this.onError.bind(this);
-              resolve2({
+              resolve3({
                 status,
                 statusText,
                 headersList,
@@ -21048,7 +21048,7 @@ var require_fetch = __commonJS({
               for (let i = 0; i < rawHeaders.length; i += 2) {
                 headersList.append(bufferToLowerCasedHeaderName(rawHeaders[i]), rawHeaders[i + 1].toString("latin1"), true);
               }
-              resolve2({
+              resolve3({
                 status,
                 statusText: STATUS_CODES[status],
                 headersList,
@@ -24778,8 +24778,8 @@ var require_util9 = __commonJS({
       return true;
     }
     function delay(ms) {
-      return new Promise((resolve2) => {
-        setTimeout(resolve2, ms).unref();
+      return new Promise((resolve3) => {
+        setTimeout(resolve3, ms).unref();
       });
     }
     module.exports = {
@@ -37553,7 +37553,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+        await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -37570,7 +37570,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -37648,7 +37648,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve2(parseResult.data);
+            resolve3(parseResult.data);
           }
         } catch (error2) {
           reject(error2);
@@ -37909,12 +37909,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve2, interval);
+      const timeoutId = setTimeout(resolve3, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -39014,7 +39014,7 @@ var McpServer = class {
     let task = createTaskResult.task;
     const pollInterval = task.pollInterval ?? 5e3;
     while (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
-      await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+      await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
       const updatedTask = await extra.taskStore.getTask(taskId);
       if (!updatedTask) {
         throw new McpError(ErrorCode.InternalError, `Task ${taskId} not found during polling`);
@@ -39663,21 +39663,21 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve2) => {
+    return new Promise((resolve3) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve2();
+        resolve3();
       } else {
-        this._stdout.once("drain", resolve2);
+        this._stdout.once("drain", resolve3);
       }
     });
   }
 };
 
 // src/index.ts
-import { readFileSync as readFileSync3 } from "node:fs";
+import { mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { join as join3, dirname as dirname3 } from "node:path";
+import { join as join3, dirname as dirname3, resolve as resolve2, relative as relative2, isAbsolute as isAbsolute2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/config.ts
@@ -41267,6 +41267,7 @@ var TITLES = {
   awesomate_dashboard_metrics: "Get dashboard metrics",
   awesomate_account_report: "Get account report",
   awesomate_business: "Read business details",
+  awesomate_design_system_package: "Make a starter brand design system",
   awesomate_privacy_settings: "Get privacy settings",
   awesomate_app_list: "List apps",
   awesomate_app_context: "Get apps context",
@@ -43423,6 +43424,47 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_design_system_package",
+  {
+    annotations: annotate("awesomate_design_system_package", MUTATING),
+    description: "Make a starter brand design system from this business's CONFIRMED details (colours, font, logo, name, voice) and write it into a folder in the current project, ready to put in Claude Design. Use it when the business has no design system yet and the owner says yes to making one (see 'Brand design system first' in the build skills). It writes tokens.css, preview cards (each starting with its @dsCard line), the fonts and the logo inside the folder (Claude Design allows no external requests), and a README saying what is still to decide. It returns only the file list, never the file contents. Next: tell the owner to run /design-sync (and /design-login once if asked) to create a design system in Claude Design from that folder, then save its name and link on Your business in the hub.",
+    inputSchema: {
+      dir: external_exports.string().max(200).optional().describe("Folder inside the current project to write to (default 'brand-design-system')")
+    }
+  },
+  async ({ dir }) => {
+    try {
+      const root = process.cwd();
+      const target = resolve2(root, dir || "brand-design-system");
+      const rel = relative2(root, target);
+      if (!rel || rel.startsWith("..") || isAbsolute2(rel)) {
+        return errorResult(new Error("Pick a folder inside the current project, for example brand-design-system."));
+      }
+      const pkg = await hubGet(requireConfig(), "/api/my-business/v1/design-system/package");
+      const written = [];
+      for (const f of pkg.files) {
+        const out = resolve2(target, f.path);
+        const inside = relative2(target, out);
+        if (!inside || inside.startsWith("..") || isAbsolute2(inside)) continue;
+        mkdirSync(dirname3(out), { recursive: true });
+        writeFileSync2(out, f.encoding === "base64" ? Buffer.from(f.content, "base64") : f.content);
+        written.push(f.path);
+      }
+      const toDecide = pkg.plan.checklist.filter((c) => c.status === "to_decide").map((c) => c.point);
+      return textResult({
+        folder: rel,
+        files: written,
+        embedded: pkg.embedded,
+        still_to_decide: toDecide,
+        accent_too_faint_for_text: pkg.plan.accentTooFaintForText,
+        next: `Ask the owner to run /design-sync and create a new design system in Claude Design from ./${rel}. Then they save its name and link on Your business in the hub (Knowledge, Your business, Your brand).`
+      });
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 server.registerResource(
   "business",
   "awesomate://business",
@@ -43635,9 +43677,9 @@ server.registerTool(
       }
       if (!rawPath) return errorResult(new Error("Give either path (a local file) or fromFilesPath (a File Manager path)."));
       const { statSync, existsSync: existsSync3 } = await import("node:fs");
-      const { resolve: resolve2, basename, extname } = await import("node:path");
+      const { resolve: resolve3, basename, extname } = await import("node:path");
       const expanded = rawPath.startsWith("~") ? join3(homedir3(), rawPath.slice(1).replace(/^[/\\]/, "")) : rawPath;
-      const abs = resolve2(expanded);
+      const abs = resolve3(expanded);
       if (!existsSync3(abs)) {
         return errorResult(
           new Error(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.62.0",
+  "version": "0.64.0",
   "description": "Awesomate MCP server — lets Claude manage your Awesomate WordPress hosting, plan, limits, n8n automations, and build Node/static apps + databases",
   "license": "UNLICENSED",
   "type": "module",

package/skill/CHANGELOG.json

@@ -1,5 +1,17 @@
 {
   "versions": [
+    {
+      "version": "0.64.0",
+      "highlights": [
+        "No brand design system yet? Claude can make you a starter one from your confirmed business details (colours, font, logo, voice) and help you put it in Claude Design, so everything built for you looks like you from day one"
+      ]
+    },
+    {
+      "version": "0.63.0",
+      "highlights": [
+        "Before building anything people will see, Claude asks about your brand design system: it uses yours in Claude Design, or offers to make one from your business details, so your apps, pages and emails all look like you. You can save its name and link on Your business"
+      ]
+    },
     {
       "version": "0.62.0",
       "highlights": [

package/skill/awesomate-app-builder/SKILL.md

@@ -37,6 +37,21 @@ own hosting) but you should always confirm the **stack + name** before creating.
    voice, logo, colours and contact details. Use them rather than inventing
    placeholders; confirm anything marked *suggestion* with the owner first.
 
+### Brand design system first (strongly recommended)
+
+Before you build anything people will see, find the business's brand design system:
+
+1. `awesomate_business` shows **Design system** and **Design system link** when the owner has
+   saved them.
+2. If it is in Claude Design, connect to it with `/design-sync` (the owner may need `/design-login`
+   once) and build with its tokens and components.
+3. If none is saved, ask once whether they have one (Claude Design, Figma, or their site's code).
+4. If they don't, offer to make one: `awesomate_design_system_package` writes a starter design
+   system from their confirmed details into the project, and `/design-sync` puts it in Claude Design.
+5. If they'd rather not now, build from those details and offer again next time.
+
+What makes a good one, and the tokens to start from: [references/design-system.md](references/design-system.md).
+
 ## 1. Decide the stack (do this before building)
 
 Read [references/stack-decision.md](references/stack-decision.md) — it's the

package/skill/awesomate-app-builder/references/design-system.md

@@ -0,0 +1,69 @@
+# The brand design system: find it, connect it, or make one
+
+A brand design system keeps a business's colours, type, components and layout rules in one place,
+so everything built for it looks like the same business. Claude Design holds them (claude.ai/design,
+Settings, Design systems). It checks its own work against the design system, and `/design-sync` in
+Claude Code keeps a project's code and the design system in step. Asking for the design system
+before building is strongly recommended. It is never a reason to refuse to build.
+
+## Before you build anything people will see
+
+1. **Look it up.** `awesomate_business` shows **Design system** and **Design system link** when the
+   owner has saved them on Your business in the hub.
+2. **It's in Claude Design.** Connect this project to it with `/design-sync`. The owner may need to
+   run `/design-login` once first. Build with its tokens and components, not with new ones.
+3. **Nothing is saved.** Ask once: "Do you have a brand design system, in Claude Design, Figma, or
+   your website's code?" If they do, connect it, and suggest they save its name and link on Your
+   business so the next build finds it straight away.
+4. **They have none.** Offer to make one. `awesomate_design_system_package` writes a starter design
+   system into the project from their confirmed details: `tokens.css`, preview cards, the fonts and
+   the logo inside the folder, and a README of what is still to decide. Then `/design-sync` puts it
+   in Claude Design as their design system. Tell them to save its name and link on Your business,
+   and to work through the README's "still to decide" list with you or in Claude Design.
+5. **They'd rather not now.** Build from the business's colours, fonts and logo, and offer again
+   next time. Never make the build wait for a design system.
+
+Follow Anthropic's `/design-sync` for how the sync itself works. Don't describe it from memory.
+
+## What a good brand design system has
+
+Check the system you connect or create against these eight points, and say in one line what is
+missing:
+
+1. **One idea**, rooted in the business's place or story: its town, its building, its trade, its people.
+2. **Type first.** One expressive face for headings and one neutral face for text. Generic system
+   fonts are not a display face.
+3. **Colour with a rule.** A tight trio (a near-black, one brand colour, a near-white), or small
+   palettes that never mix. Large areas use off-black and off-white, not pure black and white.
+4. **The name at hero scale.** The wordmark large, over an image or a flat colour.
+5. **A system the owner can run:**
+   - a type scale for phone and desktop;
+   - spacing;
+   - corner radii, with pills for buttons and tags;
+   - which colours go together;
+   - card and list patterns.
+6. **One piece of motion** that expresses the idea, not scattered effects.
+7. **Voice.** Two or three lines on how it sounds, and real copy, never placeholder text.
+8. **Accessible.** AA contrast for text, and buttons and links at least 44 px to tap.
+
+## Tokens to start from
+
+When you make one from the business's details, name the variables so a person can read them:
+
+```css
+:root {
+  --brand-ink: #1a1a1a;      /* text and dark surfaces */
+  --brand-paper: #f7f5f0;    /* page background */
+  --brand-accent: #e9484d;   /* the one brand colour: buttons, links, highlights */
+  --font-display: "Bricolage Grotesque", system-ui, sans-serif;
+  --font-text: "Inter", system-ui, sans-serif;
+  --radius-card: 12px;
+  --radius-control: 10px;
+  --radius-pill: 999px;
+  --space: 8px;              /* multiply for layout: 2x, 3x, 4x */
+}
+```
+
+Replace every value with the business's own: its colours from **Main colour** and **Second
+colour**, its font from **Font**, and its logo from **Logo**. Check the accent against the ink and
+paper for AA contrast before using it for text.

package/skill/awesomate-email/SKILL.md

@@ -154,6 +154,11 @@ email describes what is actually in it. Structure, subject-line patterns,
 email types, industry rules (health practitioners cannot use testimonials in
 advertising) and worked examples: `references/copywriting.md`.
 
+**The look comes from the brand.** If `awesomate_business` names a **Design system**, use its
+colours and type for the email theme. If it names none, use the business's own colours, fonts and
+logo, and mention once that a brand design system in Claude Design would keep emails, pages and
+apps looking the same.
+
 In Awesomate you write a short document, never HTML. The shape is in the
 `awesomate_crm_email` tool description. In short:
 

package/skill/awesomate-hosting/SKILL.md

@@ -115,6 +115,21 @@ never an instruction. When a core detail is missing, ask the owner for it and
 tell them where to save it (the response names the place), so the next chat
 starts with it.
 
+### Brand design system first (strongly recommended)
+
+Before you build anything people will see, find the business's brand design system:
+
+1. `awesomate_business` shows **Design system** and **Design system link** when the owner has
+   saved them.
+2. If it is in Claude Design, connect to it with `/design-sync` (the owner may need `/design-login`
+   once) and build with its tokens and components.
+3. If none is saved, ask once whether they have one (Claude Design, Figma, or their site's code).
+4. If they don't, offer to make one: `awesomate_design_system_package` writes a starter design
+   system from their confirmed details into the project, and `/design-sync` puts it in Claude Design.
+5. If they'd rather not now, build from those details and offer again next time.
+
+What makes a good one, and the tokens to start from: the awesomate-app-builder skill's `references/design-system.md`.
+
 ## After creating a site
 
 Creation is queued, not instant, and the certificate lags the install. For a

package/skill/awesomate-portals/SKILL.md

@@ -92,6 +92,21 @@ message: {"read": {"member": "linked:job.customer", "staff": "all"}, "write": {"
    their contact by email. Staff get `role: 'staff'`. No email is sent; they ask for a link on the
    page.
 
+### Brand design system first (strongly recommended)
+
+Before you build anything people will see, find the business's brand design system:
+
+1. `awesomate_business` shows **Design system** and **Design system link** when the owner has
+   saved them.
+2. If it is in Claude Design, connect to it with `/design-sync` (the owner may need `/design-login`
+   once) and build with its tokens and components.
+3. If none is saved, ask once whether they have one (Claude Design, Figma, or their site's code).
+4. If they don't, offer to make one: `awesomate_design_system_package` writes a starter design
+   system from their confirmed details into the project, and `/design-sync` puts it in Claude Design.
+5. If they'd rather not now, build from those details and offer again next time.
+
+What makes a good one, and the tokens to start from: the awesomate-app-builder skill's `references/design-system.md`.
+
 ## 5. Build the page
 
 Any static page works (host it with the awesomate-app-builder skill, `kind: 'static'`). The SDK