@cimplify/cli 0.2.2 → 0.2.4

package/dist/{deploy-N3GTTUI5.mjs → deploy-M37L5P6H.mjs}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { pollDeployment } from './chunk-2BO4H6VP.mjs';
-import { fetchCloneToken } from './chunk-WLLH5HFI.mjs';
+import { pollDeployment } from './chunk-JOUXICGV.mjs';
+import { fetchCloneToken } from './chunk-2Y4JWLPE.mjs';
 import { promptYesNo } from './chunk-L6474RPL.mjs';
-import { TOKEN_PURPOSE, ENV_SCOPE, DEPLOY_TRIGGER, DEPLOYMENT_STATUS } from './chunk-VE74N3YS.mjs';
+import { TOKEN_PURPOSE, ENV_SCOPE, DEPLOY_TRIGGER, DEPLOYMENT_STATUS } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagBool, flagString } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth, readProjectLink, writeProjectState } from './chunk-JJYWETGA.mjs';
 import { CliError, CLI_ERROR_CODE, step, info, dim, success, result, EXIT_CODE } from './chunk-NZ4RG62Z.mjs';
 import { spawn } from 'child_process';

package/dist/{dev-ABPRBTPU.mjs → dev-AQP6TMYK.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { parseEnvFile, formatEnvFile } from './chunk-4YSOZ6LY.mjs';
-import { ENV_SCOPE, PUBLIC_ENV_PREFIX } from './chunk-VE74N3YS.mjs';
+import { ENV_SCOPE, PUBLIC_ENV_PREFIX } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagBool } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth, readProjectLink } from './chunk-JJYWETGA.mjs';
 import { info, CliError, CLI_ERROR_CODE, dim } from './chunk-NZ4RG62Z.mjs';
 import { spawn } from 'child_process';

package/dist/dispatcher.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-O36TGF2L.mjs';
-import { TEMPLATES } from './chunk-SN6E73KY.mjs';
+import { package_default } from './chunk-7RQTL7FM.mjs';
+import { TEMPLATES } from './chunk-RHAO6VWV.mjs';
 
 // src/dispatcher.ts
 var VERSION = package_default.version ?? "unknown";
@@ -115,24 +115,24 @@ Need the mock storefront server? It ships with @cimplify/sdk:
   bunx @cimplify/sdk mock [flags]            Boot the local Cimplify API mock
 `;
 var COMMANDS = {
-  login: () => import('./login-JFDAQ7T5.mjs'),
+  login: () => import('./login-RSKGT6GU.mjs'),
   logout: () => import('./logout-ZFZLSJ32.mjs'),
-  whoami: () => import('./whoami-INHDUHWA.mjs'),
-  projects: () => import('./projects-L7JEO3KO.mjs'),
-  link: () => import('./link-QPWA5Q6Z.mjs'),
+  whoami: () => import('./whoami-DIJZYZIN.mjs'),
+  projects: () => import('./projects-IHDG76PK.mjs'),
+  link: () => import('./link-P4K2HRXY.mjs'),
   unlink: () => import('./unlink-5ABCT7B6.mjs'),
-  deploy: () => import('./deploy-N3GTTUI5.mjs'),
-  rollback: () => import('./rollback-YTKRECZ5.mjs'),
-  env: () => import('./env-H6M4G4V6.mjs'),
-  domains: () => import('./domains-7Y23SAEM.mjs'),
-  logs: () => import('./logs-EABEQBEV.mjs'),
-  status: () => import('./status-IFJIYWRQ.mjs'),
-  dev: () => import('./dev-ABPRBTPU.mjs'),
-  repo: () => import('./repo-54HUIBFC.mjs'),
-  list: () => import('./list-DS4C3JRB.mjs'),
-  add: () => import('./add-YJDP63WM.mjs'),
-  update: () => import('./update-UH2HKLOK.mjs'),
-  upgrade: () => import('./update-UH2HKLOK.mjs')
+  deploy: () => import('./deploy-M37L5P6H.mjs'),
+  rollback: () => import('./rollback-36O4NOEL.mjs'),
+  env: () => import('./env-FDBPGU3W.mjs'),
+  domains: () => import('./domains-2ZQ7AG27.mjs'),
+  logs: () => import('./logs-E2AGTDCF.mjs'),
+  status: () => import('./status-6AT4HF63.mjs'),
+  dev: () => import('./dev-AQP6TMYK.mjs'),
+  repo: () => import('./repo-XMMLZHLC.mjs'),
+  list: () => import('./list-FDJZCW22.mjs'),
+  add: () => import('./add-5JU6S6MB.mjs'),
+  update: () => import('./update-4FJNHZYC.mjs'),
+  upgrade: () => import('./update-4FJNHZYC.mjs')
 };
 var GLOBAL_FLAGS = /* @__PURE__ */ new Set(["--json", "--yes", "-y"]);
 function extractGlobalFlags(argv) {
@@ -157,11 +157,18 @@ async function main() {
   const [maybeSub, ...rest] = cleaned.args;
   const TOP_LEVEL_FLAGS = /* @__PURE__ */ new Set(["--help", "-h", "help", "--version", "-v", "version"]);
   if (!maybeSub) {
-    console.log(HELP);
+    if (cleaned.json) {
+      process.stdout.write(
+        `${JSON.stringify({ ok: true, data: { help: true, version: VERSION } })}
+`
+      );
+    } else {
+      console.log(HELP);
+    }
     return;
   }
   if (TOP_LEVEL_FLAGS.has(maybeSub)) {
-    return await runDispatcherFlag(maybeSub);
+    return await runDispatcherFlag(maybeSub, cleaned.json);
   }
   const sub = maybeSub;
   const args = rest;
@@ -313,8 +320,16 @@ async function emitError(sub, err) {
   }
   console.error(`cimplify ${sub}:`, String(err));
 }
-async function runDispatcherFlag(flag) {
-  if (flag === "-h" || flag === "--help" || flag === "help") {
+async function runDispatcherFlag(flag, json) {
+  const isHelp = flag === "-h" || flag === "--help" || flag === "help";
+  if (json) {
+    process.stdout.write(
+      `${JSON.stringify({ ok: true, data: isHelp ? { help: true, version: VERSION } : { version: VERSION } })}
+`
+    );
+    return;
+  }
+  if (isHelp) {
     console.log(HELP);
     return;
   }

package/dist/{domains-7Y23SAEM.mjs → domains-2ZQ7AG27.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { promptYesNo } from './chunk-L6474RPL.mjs';
-import { ENV_SCOPE, DOMAIN_TYPE } from './chunk-VE74N3YS.mjs';
+import { ENV_SCOPE, DOMAIN_TYPE } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagBool, flagString } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth, readProjectLink } from './chunk-JJYWETGA.mjs';
 import { CliError, CLI_ERROR_CODE, info, dim, result, bold, success } from './chunk-NZ4RG62Z.mjs';
 

package/dist/{env-H6M4G4V6.mjs → env-FDBPGU3W.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { formatEnvFile, parseEnvFile, parseKeyValueArg } from './chunk-4YSOZ6LY.mjs';
 import { promptYesNo } from './chunk-L6474RPL.mjs';
-import { ENV_SCOPE, PUBLIC_ENV_PREFIX, SECRET_MASK } from './chunk-VE74N3YS.mjs';
+import { ENV_SCOPE, PUBLIC_ENV_PREFIX, SECRET_MASK } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagString, flagBool } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth, readProjectLink } from './chunk-JJYWETGA.mjs';
 import { CliError, CLI_ERROR_CODE, info, dim, result, bold, success } from './chunk-NZ4RG62Z.mjs';
 import { promises } from 'fs';

package/dist/{link-QPWA5Q6Z.mjs → link-P4K2HRXY.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { parseArgs } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth, writeProjectLink } from './chunk-JJYWETGA.mjs';
 import { CliError, CLI_ERROR_CODE, success, info, dim, result } from './chunk-NZ4RG62Z.mjs';
 

package/dist/{list-DS4C3JRB.mjs → list-FDJZCW22.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { REGISTRY_INDEX } from './chunk-SN6E73KY.mjs';
+import { REGISTRY_INDEX } from './chunk-RHAO6VWV.mjs';
 import { parseArgs, flagBool } from './chunk-4SBJVRGM.mjs';
 import { CliError, CLI_ERROR_CODE, info, bold, dim, green, result } from './chunk-NZ4RG62Z.mjs';
 

package/dist/{login-JFDAQ7T5.mjs → login-RSKGT6GU.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { parseArgs, flagString, flagBool } from './chunk-4SBJVRGM.mjs';
-import { resolveBaseUrl, ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { resolveBaseUrl, ApiClient } from './chunk-NC3GKHDD.mjs';
 import { writeAuth } from './chunk-JJYWETGA.mjs';
 import { CliError, CLI_ERROR_CODE, success, result, isJsonMode, step, info, dim } from './chunk-NZ4RG62Z.mjs';
 import os from 'os';

package/dist/{logs-EABEQBEV.mjs → logs-E2AGTDCF.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { TERMINAL_DEPLOYMENT_STATUSES } from './chunk-VE74N3YS.mjs';
+import { TERMINAL_DEPLOYMENT_STATUSES } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagString, flagBool } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth, readProjectLink, readProjectState } from './chunk-JJYWETGA.mjs';
 import { CliError, CLI_ERROR_CODE, isJsonMode, failure, result, red } from './chunk-NZ4RG62Z.mjs';
 

package/dist/{projects-L7JEO3KO.mjs → projects-IHDG76PK.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { REPO_PROVIDER } from './chunk-VE74N3YS.mjs';
+import { REPO_PROVIDER } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagString, flagBool } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth } from './chunk-JJYWETGA.mjs';
 import { CliError, CLI_ERROR_CODE, info, dim, result, bold, success } from './chunk-NZ4RG62Z.mjs';
 

package/dist/{repo-54HUIBFC.mjs → repo-XMMLZHLC.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-export { run as default, fetchCloneToken } from './chunk-WLLH5HFI.mjs';
+export { run as default, fetchCloneToken } from './chunk-2Y4JWLPE.mjs';
 import './chunk-L6474RPL.mjs';
-import './chunk-VE74N3YS.mjs';
+import './chunk-MXYUAJEW.mjs';
 import './chunk-4SBJVRGM.mjs';
-import './chunk-4ZVTPMUZ.mjs';
+import './chunk-NC3GKHDD.mjs';
 import './chunk-JJYWETGA.mjs';
 import './chunk-NZ4RG62Z.mjs';

package/dist/{rollback-YTKRECZ5.mjs → rollback-36O4NOEL.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { pollDeployment } from './chunk-2BO4H6VP.mjs';
-import { DEPLOYMENT_STATUS, DEPLOY_TRIGGER } from './chunk-VE74N3YS.mjs';
+import { pollDeployment } from './chunk-JOUXICGV.mjs';
+import { DEPLOYMENT_STATUS, DEPLOY_TRIGGER } from './chunk-MXYUAJEW.mjs';
 import { parseArgs, flagBool } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth, readProjectLink, writeProjectState } from './chunk-JJYWETGA.mjs';
 import { CliError, CLI_ERROR_CODE, step, success, info, dim, result, EXIT_CODE } from './chunk-NZ4RG62Z.mjs';
 

package/dist/{status-IFJIYWRQ.mjs → status-6AT4HF63.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { DEPLOYMENT_STATUS } from './chunk-VE74N3YS.mjs';
+import { DEPLOYMENT_STATUS } from './chunk-MXYUAJEW.mjs';
 import { parseArgs } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth, readProjectLink, readProjectState } from './chunk-JJYWETGA.mjs';
 import { bold, dim, info, result } from './chunk-NZ4RG62Z.mjs';
 

package/dist/{update-UH2HKLOK.mjs → update-4FJNHZYC.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-O36TGF2L.mjs';
+import { package_default } from './chunk-7RQTL7FM.mjs';
 import { promptYesNo } from './chunk-L6474RPL.mjs';
 import { parseArgs, flagBool, flagString } from './chunk-4SBJVRGM.mjs';
 import { success, bold, info, dim, result, failure, CliError, CLI_ERROR_CODE, step, isJsonMode } from './chunk-NZ4RG62Z.mjs';

package/dist/{whoami-INHDUHWA.mjs → whoami-DIJZYZIN.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { ApiClient } from './chunk-4ZVTPMUZ.mjs';
+import { ApiClient } from './chunk-NC3GKHDD.mjs';
 import { readAuth } from './chunk-JJYWETGA.mjs';
 import { info, bold, dim, result } from './chunk-NZ4RG62Z.mjs';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/cli",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Cimplify CLI — deploy, manage env vars, link projects, and scaffold storefronts",
   "keywords": [
     "cimplify",

package/templates/storefront-bakery/.env.example

@@ -14,3 +14,9 @@ NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_default_akua_bakery
 # and OpenGraph metadata. Set this on production deploys (Vercel auto-injects
 # via VERCEL_URL but Next prefers an explicit value).
 NEXT_PUBLIC_SITE_URL=https://example.com
+
+# Business handle (human-readable slug, e.g. "akua-bakery"). Used by the
+# UCP manifest endpoint at /.well-known/ucp so AI agents (Claude / ChatGPT /
+# Gemini) can discover this storefront's commerce capabilities. Set this
+# on production deploys; leave empty in dev unless you're testing UCP.
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE=

package/templates/storefront-bakery/app/.well-known/ucp/route.ts

@@ -0,0 +1,66 @@
+import { NextResponse } from "next/server";
+
+/**
+ * UCP (Universal Commerce Protocol) manifest discovery endpoint.
+ *
+ * Agents — Claude, ChatGPT, Gemini, MCP clients — probe
+ * `https://<your-domain>/.well-known/ucp` to learn what commerce
+ * capabilities your storefront supports. We forward the request to
+ * Cimplify, which returns the canonical manifest; the response body
+ * tells agents to make subsequent UCP calls directly to
+ * `api.cimplify.io/ucp/v1/<handle>/*` (no per-request proxy here).
+ *
+ * Edge-cached for an hour because capabilities change rarely.
+ */
+const UCP_API_BASE =
+  process.env.NEXT_PUBLIC_CIMPLIFY_API_URL || "https://api.cimplify.io";
+
+export const revalidate = 3600;
+
+export async function GET() {
+  const businessHandle = process.env.NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE;
+
+  if (!businessHandle) {
+    return NextResponse.json(
+      {
+        error: "NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE not set",
+        remediation:
+          "Set NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE in .env.local (and your deployment env) to your business handle.",
+      },
+      { status: 500 },
+    );
+  }
+
+  try {
+    const response = await fetch(
+      `${UCP_API_BASE}/ucp/v1/${businessHandle}/manifest`,
+      {
+        headers: { "Content-Type": "application/json" },
+        next: { revalidate: 3600 },
+      },
+    );
+
+    if (!response.ok) {
+      return NextResponse.json(
+        { error: `Upstream UCP manifest fetch failed: ${response.status}` },
+        { status: response.status },
+      );
+    }
+
+    const manifest = await response.json();
+    return NextResponse.json(manifest, {
+      headers: {
+        "Content-Type": "application/json",
+        "Cache-Control": "public, max-age=3600, s-maxage=3600",
+      },
+    });
+  } catch (error) {
+    return NextResponse.json(
+      {
+        error: "Failed to fetch UCP manifest",
+        detail: error instanceof Error ? error.message : String(error),
+      },
+      { status: 500 },
+    );
+  }
+}

package/templates/storefront-bakery/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.45.0",
+    "@cimplify/sdk": "^0.45.1",
     "next": "^16.2.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-fashion/.env.example

@@ -14,3 +14,9 @@ NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_studio_frx
 # and OpenGraph metadata. Set this on production deploys (Vercel auto-injects
 # via VERCEL_URL but Next prefers an explicit value).
 NEXT_PUBLIC_SITE_URL=https://example.com
+
+# Business handle (human-readable slug, e.g. "akua-bakery"). Used by the
+# UCP manifest endpoint at /.well-known/ucp so AI agents (Claude / ChatGPT /
+# Gemini) can discover this storefront's commerce capabilities. Set this
+# on production deploys; leave empty in dev unless you're testing UCP.
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE=

package/templates/storefront-fashion/app/.well-known/ucp/route.ts

@@ -0,0 +1,66 @@
+import { NextResponse } from "next/server";
+
+/**
+ * UCP (Universal Commerce Protocol) manifest discovery endpoint.
+ *
+ * Agents — Claude, ChatGPT, Gemini, MCP clients — probe
+ * `https://<your-domain>/.well-known/ucp` to learn what commerce
+ * capabilities your storefront supports. We forward the request to
+ * Cimplify, which returns the canonical manifest; the response body
+ * tells agents to make subsequent UCP calls directly to
+ * `api.cimplify.io/ucp/v1/<handle>/*` (no per-request proxy here).
+ *
+ * Edge-cached for an hour because capabilities change rarely.
+ */
+const UCP_API_BASE =
+  process.env.NEXT_PUBLIC_CIMPLIFY_API_URL || "https://api.cimplify.io";
+
+export const revalidate = 3600;
+
+export async function GET() {
+  const businessHandle = process.env.NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE;
+
+  if (!businessHandle) {
+    return NextResponse.json(
+      {
+        error: "NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE not set",
+        remediation:
+          "Set NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE in .env.local (and your deployment env) to your business handle.",
+      },
+      { status: 500 },
+    );
+  }
+
+  try {
+    const response = await fetch(
+      `${UCP_API_BASE}/ucp/v1/${businessHandle}/manifest`,
+      {
+        headers: { "Content-Type": "application/json" },
+        next: { revalidate: 3600 },
+      },
+    );
+
+    if (!response.ok) {
+      return NextResponse.json(
+        { error: `Upstream UCP manifest fetch failed: ${response.status}` },
+        { status: response.status },
+      );
+    }
+
+    const manifest = await response.json();
+    return NextResponse.json(manifest, {
+      headers: {
+        "Content-Type": "application/json",
+        "Cache-Control": "public, max-age=3600, s-maxage=3600",
+      },
+    });
+  } catch (error) {
+    return NextResponse.json(
+      {
+        error: "Failed to fetch UCP manifest",
+        detail: error instanceof Error ? error.message : String(error),
+      },
+      { status: 500 },
+    );
+  }
+}

package/templates/storefront-fashion/package.json

@@ -19,7 +19,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.45.0",
+    "@cimplify/sdk": "^0.45.1",
     "next": "^16.2.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-grocery/.env.example

@@ -14,3 +14,9 @@ NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_freshmart
 # and OpenGraph metadata. Set this on production deploys (Vercel auto-injects
 # via VERCEL_URL but Next prefers an explicit value).
 NEXT_PUBLIC_SITE_URL=https://example.com
+
+# Business handle (human-readable slug, e.g. "akua-bakery"). Used by the
+# UCP manifest endpoint at /.well-known/ucp so AI agents (Claude / ChatGPT /
+# Gemini) can discover this storefront's commerce capabilities. Set this
+# on production deploys; leave empty in dev unless you're testing UCP.
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE=

package/templates/storefront-grocery/app/.well-known/ucp/route.ts

@@ -0,0 +1,66 @@
+import { NextResponse } from "next/server";
+
+/**
+ * UCP (Universal Commerce Protocol) manifest discovery endpoint.
+ *
+ * Agents — Claude, ChatGPT, Gemini, MCP clients — probe
+ * `https://<your-domain>/.well-known/ucp` to learn what commerce
+ * capabilities your storefront supports. We forward the request to
+ * Cimplify, which returns the canonical manifest; the response body
+ * tells agents to make subsequent UCP calls directly to
+ * `api.cimplify.io/ucp/v1/<handle>/*` (no per-request proxy here).
+ *
+ * Edge-cached for an hour because capabilities change rarely.
+ */
+const UCP_API_BASE =
+  process.env.NEXT_PUBLIC_CIMPLIFY_API_URL || "https://api.cimplify.io";
+
+export const revalidate = 3600;
+
+export async function GET() {
+  const businessHandle = process.env.NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE;
+
+  if (!businessHandle) {
+    return NextResponse.json(
+      {
+        error: "NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE not set",
+        remediation:
+          "Set NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE in .env.local (and your deployment env) to your business handle.",
+      },
+      { status: 500 },
+    );
+  }
+
+  try {
+    const response = await fetch(
+      `${UCP_API_BASE}/ucp/v1/${businessHandle}/manifest`,
+      {
+        headers: { "Content-Type": "application/json" },
+        next: { revalidate: 3600 },
+      },
+    );
+
+    if (!response.ok) {
+      return NextResponse.json(
+        { error: `Upstream UCP manifest fetch failed: ${response.status}` },
+        { status: response.status },
+      );
+    }
+
+    const manifest = await response.json();
+    return NextResponse.json(manifest, {
+      headers: {
+        "Content-Type": "application/json",
+        "Cache-Control": "public, max-age=3600, s-maxage=3600",
+      },
+    });
+  } catch (error) {
+    return NextResponse.json(
+      {
+        error: "Failed to fetch UCP manifest",
+        detail: error instanceof Error ? error.message : String(error),
+      },
+      { status: 500 },
+    );
+  }
+}

package/templates/storefront-grocery/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.45.0",
+    "@cimplify/sdk": "^0.45.1",
     "next": "^16.2.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-restaurant/.env.example

@@ -14,3 +14,9 @@ NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_mamas_kitchen
 # and OpenGraph metadata. Set this on production deploys (Vercel auto-injects
 # via VERCEL_URL but Next prefers an explicit value).
 NEXT_PUBLIC_SITE_URL=https://example.com
+
+# Business handle (human-readable slug, e.g. "akua-bakery"). Used by the
+# UCP manifest endpoint at /.well-known/ucp so AI agents (Claude / ChatGPT /
+# Gemini) can discover this storefront's commerce capabilities. Set this
+# on production deploys; leave empty in dev unless you're testing UCP.
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE=

package/templates/storefront-restaurant/app/.well-known/ucp/route.ts

@@ -0,0 +1,66 @@
+import { NextResponse } from "next/server";
+
+/**
+ * UCP (Universal Commerce Protocol) manifest discovery endpoint.
+ *
+ * Agents — Claude, ChatGPT, Gemini, MCP clients — probe
+ * `https://<your-domain>/.well-known/ucp` to learn what commerce
+ * capabilities your storefront supports. We forward the request to
+ * Cimplify, which returns the canonical manifest; the response body
+ * tells agents to make subsequent UCP calls directly to
+ * `api.cimplify.io/ucp/v1/<handle>/*` (no per-request proxy here).
+ *
+ * Edge-cached for an hour because capabilities change rarely.
+ */
+const UCP_API_BASE =
+  process.env.NEXT_PUBLIC_CIMPLIFY_API_URL || "https://api.cimplify.io";
+
+export const revalidate = 3600;
+
+export async function GET() {
+  const businessHandle = process.env.NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE;
+
+  if (!businessHandle) {
+    return NextResponse.json(
+      {
+        error: "NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE not set",
+        remediation:
+          "Set NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE in .env.local (and your deployment env) to your business handle.",
+      },
+      { status: 500 },
+    );
+  }
+
+  try {
+    const response = await fetch(
+      `${UCP_API_BASE}/ucp/v1/${businessHandle}/manifest`,
+      {
+        headers: { "Content-Type": "application/json" },
+        next: { revalidate: 3600 },
+      },
+    );
+
+    if (!response.ok) {
+      return NextResponse.json(
+        { error: `Upstream UCP manifest fetch failed: ${response.status}` },
+        { status: response.status },
+      );
+    }
+
+    const manifest = await response.json();
+    return NextResponse.json(manifest, {
+      headers: {
+        "Content-Type": "application/json",
+        "Cache-Control": "public, max-age=3600, s-maxage=3600",
+      },
+    });
+  } catch (error) {
+    return NextResponse.json(
+      {
+        error: "Failed to fetch UCP manifest",
+        detail: error instanceof Error ? error.message : String(error),
+      },
+      { status: 500 },
+    );
+  }
+}

package/templates/storefront-restaurant/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.45.0",
+    "@cimplify/sdk": "^0.45.1",
     "next": "^16.2.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-retail/.env.example

@@ -14,3 +14,9 @@ NEXT_PUBLIC_CIMPLIFY_BUSINESS_ID=bus_currents_electronics
 # and OpenGraph metadata. Set this on production deploys (Vercel auto-injects
 # via VERCEL_URL but Next prefers an explicit value).
 NEXT_PUBLIC_SITE_URL=https://example.com
+
+# Business handle (human-readable slug, e.g. "akua-bakery"). Used by the
+# UCP manifest endpoint at /.well-known/ucp so AI agents (Claude / ChatGPT /
+# Gemini) can discover this storefront's commerce capabilities. Set this
+# on production deploys; leave empty in dev unless you're testing UCP.
+NEXT_PUBLIC_CIMPLIFY_BUSINESS_HANDLE=