@soloworks/smking-next 0.12.1 → 0.12.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @soloworks/smking-next
 
+## 0.12.2 — 2026-05-21
+
+**Fix: `doctor` now auto-loads `.env.local` + `.env` matching Next.js convention.**
+
+### Fixed
+
+- `npx @soloworks/smking-next doctor` was reporting `SMKING_API_KEY not set` even when the wizard had just written keys to `.env.local`. Cause: standalone Node bin script doesn't get Next.js framework env loading — only `next dev` / `next build` parse `.env.local`. Customer mental model expected doctor to mirror `next dev`.
+- `runDoctor` now calls `process.loadEnvFile()` (Node 20.6+ native, zero deps) for `.env` then `.env.local`. Existing shell env wins (Next.js precedence). Falls through silently if files don't exist or Node is too old — doctor still reports `not set` as it would have anyway.
+
 ## 0.12.1 — 2026-05-21
 
 **Fix: `npx @soloworks/smking-next doctor` failed for all customers.**

package/bin/install.mjs

@@ -94,6 +94,37 @@ function runInstall() {
 
 // ── doctor (self-check) ─────────────────────────────────────────
 
+/**
+ * Load `.env.local` + `.env` from cwd into `process.env`, matching the
+ * Next.js convention so `npx @soloworks/smking-next doctor` sees the same
+ * env vars the customer's `next dev` / `next build` would. Standalone
+ * Node bin scripts don't get framework env loading for free — without
+ * this, doctor would fail "SMKING_API_KEY not set" on every install where
+ * the wizard wrote to `.env.local` instead of shell env.
+ *
+ * `process.loadEnvFile` is available Node 20.6+ (experimental → stable
+ * in 21.7+). Next.js 16 requires Node 20+ so the customer environment is
+ * guaranteed to have it. Existing process env wins (we don't overwrite —
+ * matches Next.js precedence: shell env > .env.local > .env).
+ *
+ * Files load in reverse-precedence order (lowest first) so later files
+ * win when both define the same key. Next.js's actual order: .env.local
+ * > .env.development.local > .env.development > .env. We do the minimal
+ * pair customers actually use.
+ */
+function loadEnvFiles() {
+  for (const file of [".env", ".env.local"]) {
+    if (!existsSync(file)) continue;
+    try {
+      process.loadEnvFile(file);
+    } catch {
+      // Older Node fallback or unreadable file — silently skip; doctor
+      // will report SMKING_API_KEY not set as it would have anyway.
+    }
+  }
+}
+
+
 /**
  * @typedef {{ name: string, status: "pass" | "fail" | "info", detail: string }} DoctorCheck
  */
@@ -236,6 +267,11 @@ async function checkApiReachable() {
  * @returns {Promise<number>}
  */
 async function runDoctor(jsonOutput) {
+  // Mirror Next.js env loading so doctor sees what `next dev` would.
+  // Customers run this from project root; .env.local is the wizard's
+  // write target for SMKING_API_KEY + SMKING_BASE_URL.
+  loadEnvFiles();
+
   const appDir = detectAppDir();
   /** @type {DoctorCheck[]} */
   const checks = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soloworks/smking-next",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "description": "AI-native SEO (AEO) for Next.js — auto-inject JSON-LD, FAQ, AI summary, and SEO metadata so AI crawlers (ChatGPT, Perplexity, Google AI) can cite your pages.",
   "license": "MIT",
   "homepage": "https://github.com/sillyleo/smking/tree/main/packages/smking-next",