@cimplify/cli 0.2.7 → 0.3.0

package/dist/{chunk-JOUXICGV.mjs → chunk-MOZQODQS.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { TERMINAL_DEPLOYMENT_STATUSES, DEPLOYMENT_STATUS } from './chunk-MXYUAJEW.mjs';
-import { dim, CliError, CLI_ERROR_CODE, failure, success, isJsonMode } from './chunk-NZ4RG62Z.mjs';
+import { dim, CliError, CLI_ERROR_CODE, failure, success, isJsonMode } from './chunk-I3XQSSOT.mjs';
 
 // src/progress.ts
 var POLL_INTERVAL_MS = 1e3;

package/dist/{chunk-KPGRCXQY.mjs → chunk-QGBXGDA5.mjs}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { promptYesNo } from './chunk-L6474RPL.mjs';
+import { promptYesNo } from './chunk-RZQTHTXX.mjs';
 import { TOKEN_PURPOSE, REPO_PROVIDER, REPO_PROVIDER_VALUES } from './chunk-MXYUAJEW.mjs';
-import { parseArgs, flagString, flagBool } from './chunk-4SBJVRGM.mjs';
-import { ApiClient } from './chunk-NC3GKHDD.mjs';
-import { readAuth, readProjectLink } from './chunk-JJYWETGA.mjs';
-import { CliError, CLI_ERROR_CODE, isJsonMode, result, dim, success, info, bold } from './chunk-NZ4RG62Z.mjs';
+import { parseArgs, flagString, flagBool } from './chunk-C4M3DXKC.mjs';
+import { ApiClient } from './chunk-D7WMSGKK.mjs';
+import { readAuth, readProjectLink } from './chunk-LS2VTSMQ.mjs';
+import { CliError, CLI_ERROR_CODE, isJsonMode, result, dim, success, info, bold } from './chunk-I3XQSSOT.mjs';
 
 // src/commands/repo.ts
 var SUB_PROVISION = "provision";

package/dist/chunk-RRY3NEZZ.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import { CliError, CLI_ERROR_CODE } from './chunk-I3XQSSOT.mjs';
+import { spawn } from 'child_process';
+
+var GIT_BINARY = "git";
+var ENCODING_UTF8 = "utf8";
+var REMOTE_DEFAULT = "origin";
+var ARGS_STATUS_PORCELAIN = ["status", "--porcelain=v1"];
+var ARGS_REV_PARSE_HEAD = ["rev-parse", "HEAD"];
+var ARGS_REV_PARSE_ABBREV_REF = ["rev-parse", "--abbrev-ref", "HEAD"];
+var ARGS_REV_PARSE_SHOW_TOPLEVEL = ["rev-parse", "--show-toplevel"];
+var ARGS_REMOTE_GET_URL = ["remote", "get-url"];
+var ARGS_PUSH = ["push"];
+async function runGit(args, cwd) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(GIT_BINARY, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    child.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
+    child.stderr.on("data", (chunk) => stderrChunks.push(chunk));
+    child.on("error", (err) => {
+      reject(new CliError(CLI_ERROR_CODE.GIT_ERROR, `git not found: ${err.message}`));
+    });
+    child.on("close", (code) => {
+      resolve({
+        code: code ?? -1,
+        stdout: Buffer.concat(stdoutChunks).toString(ENCODING_UTF8),
+        stderr: Buffer.concat(stderrChunks).toString(ENCODING_UTF8)
+      });
+    });
+  });
+}
+async function runGitOk(args, cwd) {
+  const { code, stdout, stderr } = await runGit(args, cwd);
+  if (code !== 0) {
+    throw new CliError(
+      CLI_ERROR_CODE.GIT_ERROR,
+      `git ${args.join(" ")} failed: ${stderr.trim() || stdout.trim() || `exit ${code}`}`
+    );
+  }
+  return stdout.trimEnd();
+}
+async function gitStatusPorcelain(cwd) {
+  return runGitOk(ARGS_STATUS_PORCELAIN, cwd);
+}
+async function gitCurrentSha(cwd) {
+  return runGitOk(ARGS_REV_PARSE_HEAD, cwd);
+}
+async function gitCurrentBranch(cwd) {
+  return runGitOk(ARGS_REV_PARSE_ABBREV_REF, cwd);
+}
+async function gitDetectRoot(cwd) {
+  const { code, stdout } = await runGit(ARGS_REV_PARSE_SHOW_TOPLEVEL, cwd);
+  if (code !== 0) return null;
+  return stdout.trimEnd() || null;
+}
+async function gitGetRemoteUrl(cwd, name = REMOTE_DEFAULT) {
+  const { code, stdout } = await runGit([...ARGS_REMOTE_GET_URL, name], cwd);
+  if (code !== 0) return null;
+  return stdout.trimEnd() || null;
+}
+async function gitPush(cwd, branch) {
+  const args = branch ? [...ARGS_PUSH, REMOTE_DEFAULT, branch] : [...ARGS_PUSH];
+  await runGitOk(args, cwd);
+}
+async function gitPushToUrl(cwd, url, branch) {
+  await runGitOk([...ARGS_PUSH, url, branch], cwd);
+}
+var FREESTYLE_GIT_HOST = "git.freestyle.sh";
+function isFreestyleRemote(url) {
+  if (!url) return false;
+  try {
+    return new URL(url).hostname === FREESTYLE_GIT_HOST;
+  } catch {
+    return url.includes(FREESTYLE_GIT_HOST);
+  }
+}
+
+export { gitCurrentBranch, gitCurrentSha, gitDetectRoot, gitGetRemoteUrl, gitPush, gitPushToUrl, gitStatusPorcelain, isFreestyleRemote };

package/dist/{chunk-L6474RPL.mjs → chunk-RZQTHTXX.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { isAutoYes, isInteractive, CliError, CLI_ERROR_CODE } from './chunk-NZ4RG62Z.mjs';
+import { isAutoYes, isInteractive, CliError, CLI_ERROR_CODE } from './chunk-I3XQSSOT.mjs';
 import readline from 'readline';
 
 async function promptLine(question) {

package/dist/{chunk-4YSOZ6LY.mjs → chunk-YI7UMMM7.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { CliError, CLI_ERROR_CODE } from './chunk-NZ4RG62Z.mjs';
+import { CliError, CLI_ERROR_CODE } from './chunk-I3XQSSOT.mjs';
 
 // src/envfile.ts
 var COMMENT_CHAR = "#";

package/dist/{chunk-52GZ5B77.mjs → chunk-YQVMG62Z.mjs}

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@cimplify/cli",
-  version: "0.2.7",
+  version: "0.3.0",
   description: "Cimplify CLI \u2014 deploy, manage env vars, link projects, and scaffold storefronts",
   keywords: [
     "cimplify",
@@ -19,7 +19,7 @@ var package_default = {
     "templates"
   ],
   scripts: {
-    "bundle-assets": "bun scripts/bundle-assets.ts",
+    "bundle-assets": "bun scripts/bundle-assets.ts && bun scripts/bundle-docs.ts",
     prebuild: "bun run bundle-assets",
     build: "tsup",
     "build:binary": "bun run bundle-assets && bun scripts/build-binaries.ts",
@@ -29,7 +29,7 @@ var package_default = {
     prepublishOnly: "bun scripts/sync-template-pins.ts && bun run build",
     dev: "bun run bundle-assets && tsup --watch",
     typecheck: "bun run bundle-assets && tsgo --noEmit -p tsconfig.json",
-    clean: "rm -rf dist bin src/embedded-assets.ts",
+    clean: "rm -rf dist bin src/embedded-assets.ts src/embedded-docs.ts",
     "lint:ox": "oxlint --fix .",
     format: "oxfmt . --write",
     "format:check": "oxfmt . --check",

package/dist/{deploy-6KVOROT3.mjs → deploy-UKOOPJAE.mjs}

@@ -1,87 +1,13 @@
 #!/usr/bin/env node
-import { pollDeployment } from './chunk-JOUXICGV.mjs';
-import { fetchCloneToken } from './chunk-KPGRCXQY.mjs';
-import { promptYesNo } from './chunk-L6474RPL.mjs';
+import { pollDeployment } from './chunk-MOZQODQS.mjs';
+import { gitDetectRoot, gitStatusPorcelain, gitCurrentBranch, gitCurrentSha, gitGetRemoteUrl, isFreestyleRemote, gitPushToUrl, gitPush } from './chunk-RRY3NEZZ.mjs';
+import { fetchCloneToken } from './chunk-QGBXGDA5.mjs';
+import { promptYesNo } from './chunk-RZQTHTXX.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-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';
-
-var GIT_BINARY = "git";
-var ENCODING_UTF8 = "utf8";
-var REMOTE_DEFAULT = "origin";
-var ARGS_STATUS_PORCELAIN = ["status", "--porcelain=v1"];
-var ARGS_REV_PARSE_HEAD = ["rev-parse", "HEAD"];
-var ARGS_REV_PARSE_ABBREV_REF = ["rev-parse", "--abbrev-ref", "HEAD"];
-var ARGS_REV_PARSE_SHOW_TOPLEVEL = ["rev-parse", "--show-toplevel"];
-var ARGS_REMOTE_GET_URL = ["remote", "get-url"];
-var ARGS_PUSH = ["push"];
-async function runGit(args, cwd) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(GIT_BINARY, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
-    const stdoutChunks = [];
-    const stderrChunks = [];
-    child.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
-    child.stderr.on("data", (chunk) => stderrChunks.push(chunk));
-    child.on("error", (err) => {
-      reject(new CliError(CLI_ERROR_CODE.GIT_ERROR, `git not found: ${err.message}`));
-    });
-    child.on("close", (code) => {
-      resolve({
-        code: code ?? -1,
-        stdout: Buffer.concat(stdoutChunks).toString(ENCODING_UTF8),
-        stderr: Buffer.concat(stderrChunks).toString(ENCODING_UTF8)
-      });
-    });
-  });
-}
-async function runGitOk(args, cwd) {
-  const { code, stdout, stderr } = await runGit(args, cwd);
-  if (code !== 0) {
-    throw new CliError(
-      CLI_ERROR_CODE.GIT_ERROR,
-      `git ${args.join(" ")} failed: ${stderr.trim() || stdout.trim() || `exit ${code}`}`
-    );
-  }
-  return stdout.trimEnd();
-}
-async function gitStatusPorcelain(cwd) {
-  return runGitOk(ARGS_STATUS_PORCELAIN, cwd);
-}
-async function gitCurrentSha(cwd) {
-  return runGitOk(ARGS_REV_PARSE_HEAD, cwd);
-}
-async function gitCurrentBranch(cwd) {
-  return runGitOk(ARGS_REV_PARSE_ABBREV_REF, cwd);
-}
-async function gitDetectRoot(cwd) {
-  const { code, stdout } = await runGit(ARGS_REV_PARSE_SHOW_TOPLEVEL, cwd);
-  if (code !== 0) return null;
-  return stdout.trimEnd() || null;
-}
-async function gitGetRemoteUrl(cwd, name = REMOTE_DEFAULT) {
-  const { code, stdout } = await runGit([...ARGS_REMOTE_GET_URL, name], cwd);
-  if (code !== 0) return null;
-  return stdout.trimEnd() || null;
-}
-async function gitPush(cwd, branch) {
-  const args = branch ? [...ARGS_PUSH, REMOTE_DEFAULT, branch] : [...ARGS_PUSH];
-  await runGitOk(args, cwd);
-}
-async function gitPushToUrl(cwd, url, branch) {
-  await runGitOk([...ARGS_PUSH, url, branch], cwd);
-}
-var FREESTYLE_GIT_HOST = "git.freestyle.sh";
-function isFreestyleRemote(url) {
-  if (!url) return false;
-  try {
-    return new URL(url).hostname === FREESTYLE_GIT_HOST;
-  } catch {
-    return url.includes(FREESTYLE_GIT_HOST);
-  }
-}
+import { parseArgs, flagBool, flagString } from './chunk-C4M3DXKC.mjs';
+import { ApiClient } from './chunk-D7WMSGKK.mjs';
+import { readAuth, readProjectLink, writeProjectState } from './chunk-LS2VTSMQ.mjs';
+import { CliError, CLI_ERROR_CODE, step, info, dim, success, result, EXIT_CODE } from './chunk-I3XQSSOT.mjs';
 
 // src/commands/deploy.ts
 var FLAG_PROD = "prod";

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

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { parseEnvFile, formatEnvFile } from './chunk-4YSOZ6LY.mjs';
+import { parseEnvFile, formatEnvFile } from './chunk-YI7UMMM7.mjs';
 import { ENV_SCOPE, PUBLIC_ENV_PREFIX } from './chunk-MXYUAJEW.mjs';
-import { parseArgs, flagBool } from './chunk-4SBJVRGM.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 { parseArgs, flagBool } from './chunk-C4M3DXKC.mjs';
+import { ApiClient } from './chunk-D7WMSGKK.mjs';
+import { readAuth, readProjectLink } from './chunk-LS2VTSMQ.mjs';
+import { info, CliError, CLI_ERROR_CODE, dim } from './chunk-I3XQSSOT.mjs';
 import { spawn } from 'child_process';
 import { promises } from 'fs';
 import path from 'path';

package/dist/dispatcher.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-52GZ5B77.mjs';
-import { TEMPLATES } from './chunk-G2P6KHM5.mjs';
+import { TEMPLATES } from './chunk-MHK4WVNF.mjs';
+import { package_default } from './chunk-YQVMG62Z.mjs';
 
 // src/dispatcher.ts
 var VERSION = package_default.version ?? "unknown";
@@ -18,6 +18,12 @@ Project:
   cimplify projects create <name>            Create a Next.js project
   cimplify link <project-id>                 Link CWD to a Cimplify project (writes .cimplify/project.json)
   cimplify unlink                            Remove the local project link
+  cimplify introspect                        Snapshot the current storefront: auth, link, brand, mock, env, git
+  cimplify doctor [--offline]                Run pre-flight checks; verdicts + fix hints (exit 1 on any fail)
+  cimplify explain [topic]                   Print canonical guidance on cart, products, bundles, errors, \u2026
+  cimplify assets upload <dir>               Upload storefront brand assets to the Cimplify CDN
+  cimplify assets ls                         List uploaded assets from cimplify-assets.json
+  cimplify assets rm <key>                   Remove an asset entry from the manifest (remote blob stays)
 
 Deploy:
   cimplify deploy [flags]                    Push current SHA + trigger a build
@@ -82,7 +88,7 @@ Misc:
   cimplify --version, -v                     Show CLI version
 
 Init flags:
-  --template <name>, -t    bakery (default) | restaurant | retail | services | grocery | fashion
+  --template <name>, -t    bakery (default) | restaurant | retail | services | grocery | fashion | pharmacy | auto
                            Picks the storefront design.
 
 Login flags:
@@ -115,24 +121,28 @@ 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-RSKGT6GU.mjs'),
-  logout: () => import('./logout-ZFZLSJ32.mjs'),
-  whoami: () => import('./whoami-DIJZYZIN.mjs'),
-  projects: () => import('./projects-5CJOZ3MT.mjs'),
-  link: () => import('./link-P4K2HRXY.mjs'),
-  unlink: () => import('./unlink-5ABCT7B6.mjs'),
-  deploy: () => import('./deploy-6KVOROT3.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-E6SBKVDG.mjs'),
-  list: () => import('./list-FL6JZ6A4.mjs'),
-  add: () => import('./add-7N2EZR6W.mjs'),
-  update: () => import('./update-LFTHO6Q5.mjs'),
-  upgrade: () => import('./update-LFTHO6Q5.mjs')
+  login: () => import('./login-WSAW4BEA.mjs'),
+  logout: () => import('./logout-DJDINVDF.mjs'),
+  whoami: () => import('./whoami-LACWBSNL.mjs'),
+  projects: () => import('./projects-364HGWHO.mjs'),
+  link: () => import('./link-X3E4UZBF.mjs'),
+  unlink: () => import('./unlink-HIIW57OO.mjs'),
+  deploy: () => import('./deploy-UKOOPJAE.mjs'),
+  rollback: () => import('./rollback-5YALPQXL.mjs'),
+  env: () => import('./env-EVMYQUIK.mjs'),
+  domains: () => import('./domains-JQMV6GAP.mjs'),
+  logs: () => import('./logs-KUKGEXR2.mjs'),
+  status: () => import('./status-W4HW3CX3.mjs'),
+  dev: () => import('./dev-FD4PM3UD.mjs'),
+  introspect: () => import('./introspect-PFBI3JHO.mjs'),
+  doctor: () => import('./doctor-5LBLYT7M.mjs'),
+  explain: () => import('./explain-3KBMWL6M.mjs'),
+  assets: () => import('./assets-DMK2QOPD.mjs'),
+  repo: () => import('./repo-26N2CHF6.mjs'),
+  list: () => import('./list-TE54SJIB.mjs'),
+  add: () => import('./add-ZJNXWN2B.mjs'),
+  update: () => import('./update-5MRKRVZC.mjs'),
+  upgrade: () => import('./update-5MRKRVZC.mjs')
 };
 var GLOBAL_FLAGS = /* @__PURE__ */ new Set(["--json", "--yes", "-y"]);
 function extractGlobalFlags(argv) {
@@ -201,7 +211,9 @@ async function runInit(args) {
     "retail",
     "services",
     "grocery",
-    "fashion"
+    "fashion",
+    "pharmacy",
+    "auto"
   ]);
   let template = "bakery";
   for (let i = 0; i < args.length; i++) {

package/dist/doctor-5LBLYT7M.mjs

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+import { gatherIntrospection } from './chunk-5IAYN7AJ.mjs';
+import './chunk-RRY3NEZZ.mjs';
+import './chunk-YI7UMMM7.mjs';
+import './chunk-YQVMG62Z.mjs';
+import { parseArgs, flagBool } from './chunk-C4M3DXKC.mjs';
+import { ApiClient } from './chunk-D7WMSGKK.mjs';
+import { readAuthOrNull } from './chunk-LS2VTSMQ.mjs';
+import { bold, dim, info, result, isCliError, CLI_ERROR_CODE, red, yellow, green } from './chunk-I3XQSSOT.mjs';
+import { promises } from 'fs';
+import path from 'path';
+
+var ENDPOINT_AUTH_ME = "/v1/auth/me";
+var NON_BUN_LOCKFILES = ["package-lock.json", "yarn.lock", "pnpm-lock.yaml"];
+var BUN_LOCKFILES = ["bun.lock", "bun.lockb"];
+function ok(name, message) {
+  return { name, level: "ok", message };
+}
+function warn(name, message, fix) {
+  return { name, level: "warn", message, fix };
+}
+function fail(name, message, fix) {
+  return { name, level: "fail", message, fix };
+}
+function skip(name, message) {
+  return { name, level: "skip", message };
+}
+async function pathExists(abs) {
+  try {
+    await promises.stat(abs);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function detectLockfile(cwd) {
+  let bun = null;
+  for (const name of BUN_LOCKFILES) {
+    if (await pathExists(path.join(cwd, name))) {
+      bun = name;
+      break;
+    }
+  }
+  let other = null;
+  for (const name of NON_BUN_LOCKFILES) {
+    if (await pathExists(path.join(cwd, name))) {
+      other = name;
+      break;
+    }
+  }
+  return { bun, other };
+}
+function deriveLocalChecks(snapshot, extras) {
+  const checks = [];
+  checks.push(ok("cli", snapshot.cli.version));
+  if (!snapshot.package.found) {
+    checks.push(
+      fail("package_json", "no package.json in this directory", "run from a Cimplify project root")
+    );
+  } else {
+    checks.push(ok("package_json", snapshot.package.name ?? "(unnamed)"));
+    if (!extras.nodeModules) {
+      checks.push(fail("node_modules", "missing \u2014 dependencies not installed", "run `bun install`"));
+    } else {
+      checks.push(ok("node_modules", "installed"));
+    }
+    if (extras.lockfile.bun) {
+      checks.push(ok("lockfile", extras.lockfile.bun));
+    } else if (extras.lockfile.other) {
+      checks.push(
+        warn(
+          "lockfile",
+          `${extras.lockfile.other} present \u2014 Cimplify expects bun`,
+          `delete ${extras.lockfile.other} and run \`bun install\``
+        )
+      );
+    } else {
+      checks.push(fail("lockfile", "no lockfile found", "run `bun install`"));
+    }
+    const pin = snapshot.package.sdk_pin;
+    if (!pin) {
+      checks.push(
+        fail(
+          "sdk_pin",
+          "@cimplify/sdk not in dependencies",
+          "run `bun add @cimplify/sdk`"
+        )
+      );
+    } else if (pin === "*" || pin === "latest") {
+      checks.push(
+        warn(
+          "sdk_pin",
+          `@cimplify/sdk pinned to '${pin}' \u2014 unpredictable`,
+          "pin to a specific minor (e.g. ^0.45.0)"
+        )
+      );
+    } else {
+      checks.push(ok("sdk_pin", `@cimplify/sdk ${pin}`));
+    }
+  }
+  if (snapshot.brand.found) {
+    checks.push(ok("brand_file", `${snapshot.brand.path} \xB7 ${snapshot.brand.name ?? "(no name)"}`));
+  } else if (snapshot.package.found) {
+    checks.push(
+      warn(
+        "brand_file",
+        "no lib/brand.ts \u2014 content is not centralized",
+        "scaffold one via `cimplify init` or copy from a template"
+      )
+    );
+  } else {
+    checks.push(skip("brand_file", "no package.json \u2014 not a project root"));
+  }
+  if (snapshot.next_config.path === null) {
+    checks.push(skip("next_config", "no next.config \u2014 non-Next project?"));
+  } else if (snapshot.next_config.cache_components === true) {
+    checks.push(ok("next_config", "cacheComponents: true"));
+  } else if (snapshot.next_config.cache_components === false) {
+    checks.push(
+      fail(
+        "next_config",
+        "cacheComponents is explicitly false",
+        "set `cacheComponents: true` in next.config.ts \u2014 Cimplify templates rely on Next 16 cache primitives"
+      )
+    );
+  } else {
+    checks.push(
+      warn(
+        "next_config",
+        "cacheComponents not set",
+        "add `cacheComponents: true` to enable `'use cache'` + `cacheTag`"
+      )
+    );
+  }
+  if (snapshot.theme.globals_css_path === null) {
+    checks.push(skip("globals_css", "no app/globals.css"));
+  } else if (snapshot.theme.has_theme_block) {
+    checks.push(ok("globals_css", `${snapshot.theme.globals_css_path} \xB7 @theme block present`));
+  } else {
+    checks.push(
+      warn(
+        "globals_css",
+        `${snapshot.theme.globals_css_path} has no @theme block`,
+        "add an @theme block to customize tokens (Tailwind v4)"
+      )
+    );
+  }
+  if (snapshot.mock.seed) {
+    checks.push(ok("mock_seed", `seed: ${snapshot.mock.seed}`));
+  } else if (snapshot.package.found) {
+    checks.push(
+      warn(
+        "mock_seed",
+        "no `cimplify-mock --seed <industry>` in dev script",
+        "add `cimplify-mock --seed retail` to `scripts.dev`"
+      )
+    );
+  } else {
+    checks.push(skip("mock_seed", "no package.json"));
+  }
+  if (!snapshot.git) {
+    checks.push(skip("git", "not a git repo"));
+  } else if (snapshot.git.dirty) {
+    checks.push(
+      warn(
+        "git",
+        `working tree dirty on ${snapshot.git.branch ?? "(no branch)"}`,
+        "commit before `cimplify deploy` (or pass --allow-dirty)"
+      )
+    );
+  } else {
+    checks.push(ok("git", `${snapshot.git.branch ?? "(no branch)"} \xB7 clean`));
+  }
+  if (snapshot.auth.logged_in) {
+    checks.push(ok("auth_present", snapshot.auth.email ?? snapshot.auth.account_id ?? "logged in"));
+  } else {
+    checks.push(fail("auth_present", "not logged in", "run `cimplify login`"));
+  }
+  if (snapshot.project.linked) {
+    checks.push(ok("project_linked", snapshot.project.id ?? ""));
+  } else {
+    checks.push(
+      fail(
+        "project_linked",
+        ".cimplify/project.json not present",
+        "run `cimplify link <project-id>` (or `cimplify projects create`)"
+      )
+    );
+  }
+  return checks;
+}
+async function runRemoteChecks(snapshot, auth) {
+  if (!auth) {
+    return {
+      authValid: skip("auth_valid", "not logged in"),
+      projectResolves: skip("project_resolves", "not logged in")
+    };
+  }
+  const client = ApiClient.fromAuth(auth);
+  let authValid;
+  try {
+    const me = await client.get(ENDPOINT_AUTH_ME);
+    const env = auth.apiKey.startsWith("dk_test_") || auth.apiKey.startsWith("sk_test_") ? "test" : "live";
+    authValid = ok("auth_valid", `${env} token \xB7 business ${me.business_id}`);
+  } catch (err) {
+    if (isCliError(err) && err.code === CLI_ERROR_CODE.AUTH_FAILED) {
+      authValid = fail("auth_valid", "token rejected (401)", "run `cimplify login` again");
+    } else if (isCliError(err) && err.code === CLI_ERROR_CODE.NETWORK_ERROR) {
+      authValid = fail(
+        "auth_valid",
+        `cannot reach ${auth.apiBaseUrl}`,
+        "check connectivity or set CIMPLIFY_API_URL"
+      );
+    } else {
+      const msg = err instanceof Error ? err.message : String(err);
+      authValid = fail("auth_valid", msg);
+    }
+  }
+  let projectResolves;
+  if (!snapshot.project.linked) {
+    projectResolves = skip("project_resolves", "no linked project");
+  } else if (authValid.level !== "ok") {
+    projectResolves = skip("project_resolves", "auth failed \u2014 cannot check");
+  } else {
+    const bid = encodeURIComponent(auth.businessId);
+    const pid = encodeURIComponent(snapshot.project.id ?? "");
+    try {
+      const p = await client.get(`/v1/businesses/${bid}/projects/${pid}`);
+      projectResolves = ok("project_resolves", `${p.name ?? p.id}`);
+    } catch (err) {
+      if (isCliError(err) && err.code === CLI_ERROR_CODE.NOT_FOUND) {
+        projectResolves = fail(
+          "project_resolves",
+          "project not found on server",
+          "run `cimplify projects ls` to see available projects, then `cimplify link <id>`"
+        );
+      } else {
+        const msg = err instanceof Error ? err.message : String(err);
+        projectResolves = fail("project_resolves", msg);
+      }
+    }
+  }
+  return { authValid, projectResolves };
+}
+function summarize(checks) {
+  const s = { total: checks.length, ok: 0, warn: 0, fail: 0, skip: 0 };
+  for (const c of checks) s[c.level]++;
+  return s;
+}
+async function gatherDoctorReport(opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const snapshot = await gatherIntrospection(cwd);
+  const [nodeModules, lockfile, auth] = await Promise.all([
+    pathExists(path.join(cwd, "node_modules")),
+    detectLockfile(cwd),
+    readAuthOrNull()
+  ]);
+  const local = deriveLocalChecks(snapshot, { nodeModules, lockfile });
+  let checks;
+  if (opts.offline) {
+    checks = [
+      ...local,
+      skip("auth_valid", "skipped (--offline)"),
+      skip("project_resolves", "skipped (--offline)")
+    ];
+  } else {
+    const remote = await runRemoteChecks(snapshot, auth);
+    checks = [...local, remote.authValid, remote.projectResolves];
+  }
+  return { summary: summarize(checks), checks };
+}
+var LABEL_WIDTH = 18;
+function levelGlyph(level) {
+  switch (level) {
+    case "ok":
+      return green("\u2713");
+    case "warn":
+      return yellow("!");
+    case "fail":
+      return red("\u2717");
+    case "skip":
+      return dim("-");
+  }
+}
+function renderDoctor(report) {
+  const out = [];
+  out.push(bold("Cimplify doctor"));
+  out.push("");
+  for (const c of report.checks) {
+    const name = bold(c.name.padEnd(LABEL_WIDTH));
+    out.push(`  ${levelGlyph(c.level)} ${name}${c.message}`);
+    if (c.fix) {
+      out.push(`  ${" ".repeat(LABEL_WIDTH + 2)}${dim(`\u2192 ${c.fix}`)}`);
+    }
+  }
+  out.push("");
+  const s = report.summary;
+  const parts = [`${s.total} checks`, `${s.ok} ok`];
+  if (s.warn > 0) parts.push(`${s.warn} warn`);
+  if (s.fail > 0) parts.push(`${s.fail} fail`);
+  if (s.skip > 0) parts.push(`${s.skip} skip`);
+  out.push(dim(parts.join(" \xB7 ")));
+  return out;
+}
+async function run(argv) {
+  const args = parseArgs(argv);
+  const offline = flagBool(args, "offline");
+  const report = await gatherDoctorReport({ offline });
+  for (const line of renderDoctor(report)) info(line);
+  result(report);
+  if (report.summary.fail > 0) process.exit(1);
+}
+
+export { run as default, deriveLocalChecks, gatherDoctorReport, renderDoctor };