@hogsend/cli 0.18.0 → 0.19.0

package/dist/bin.js

@@ -1954,6 +1954,25 @@ function skillsNudge(ctx) {
     "Skills out of date"
   );
 }
+function analyticsNudge(ctx) {
+  if (ctx.json) return;
+  const dotenv = loadDotEnv(process.cwd());
+  const captureKey = process.env.POSTHOG_API_KEY ?? dotenv.POSTHOG_API_KEY;
+  const personalKey = process.env.POSTHOG_PERSONAL_API_KEY ?? dotenv.POSTHOG_PERSONAL_API_KEY;
+  if (!captureKey || personalKey) return;
+  ctx.out.note(
+    [
+      "POSTHOG_API_KEY is set without POSTHOG_PERSONAL_API_KEY \u2014 person",
+      "property READS are disabled (the phc_ project key is write-only by",
+      "PostHog's design), so per-user timezone resolution falls back to",
+      "contact properties. Capture and person WRITES are unaffected.",
+      "",
+      `Fix: create a personal API key scoped ${color.cyan("person:read")} and set ${color.cyan("POSTHOG_PERSONAL_API_KEY")}.`,
+      `Docs: ${color.cyan("https://hogsend.com/docs/guides/analytics-access")}`
+    ].join("\n"),
+    "PostHog person reads disabled"
+  );
+}
 var usage5 = `hogsend doctor [--url <baseUrl>] [--admin-key <key>] [--json]
 
 Probe a running Hogsend instance via GET /v1/health and report its health:
@@ -2087,6 +2106,7 @@ async function run5(ctx) {
   ];
   ctx.out.note(lines.join("\n"), "Doctor");
   skillsNudge(ctx);
+  analyticsNudge(ctx);
   if (ok) {
     ctx.out.outro(color.green("doctor: ok"));
     return;