@koda-sl/baker-cli 0.513.0 → 0.515.0

package/dist/query-OOP63DJF.js

@@ -0,0 +1,236 @@
+import {
+  resolvePropertyId
+} from "./chunk-TU5LQUJM.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getQueryTtl,
+  handleConnectionError,
+  isNotConnectedError,
+  toCsvRow,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-6DPSWLGY.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ga4/query.ts
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { defineCommand } from "citty";
+
+// src/commands/ga4/presets.ts
+var GA4_PRESETS = [
+  {
+    name: "tracking-health",
+    description: "Compare GA4 sessions to GAds clicks \u2014 flag >20% discrepancy",
+    playbook: "[07] Discrepancy Check"
+  },
+  {
+    name: "lp-performance",
+    description: "Landing page UX diagnostic \u2014 flag duration <10s as message mismatch",
+    playbook: "[06] LP Diagnostic"
+  },
+  {
+    name: "traffic-quality",
+    description: "Warm traffic trap \u2014 flag >40% returning user conversions",
+    playbook: "[06] Warm Traffic Trap"
+  },
+  {
+    name: "funnel-leakage",
+    description: "Funnel drop-off analysis between form events",
+    playbook: "[06] Funnel Analysis"
+  },
+  {
+    name: "first-touch",
+    description: "First-touch attribution \u2014 true acquisition value of channels",
+    playbook: "First-Touch Attribution"
+  },
+  {
+    name: "traffic-overview",
+    description: "General traffic trends by date and source",
+    playbook: "General"
+  }
+];
+
+// src/commands/ga4/query.ts
+registerSchema({
+  command: "ga4.query",
+  description: "Run GA4 Data API reports. Use --preset for playbook-aligned queries (primary usage) or --dimensions/--metrics for free-form queries.",
+  args: {
+    "property-id": { type: "string", description: "GA4 property ID (auto-resolved if not provided)", required: false },
+    preset: {
+      type: "string",
+      description: "Named preset (tracking-health, lp-performance, traffic-quality, funnel-leakage, first-touch, traffic-overview)",
+      required: false
+    },
+    dimensions: { type: "string", description: "Comma-separated dimension names (escape hatch)", required: false },
+    metrics: { type: "string", description: "Comma-separated metric names (escape hatch)", required: false },
+    days: { type: "string", description: "Lookback window in days (default: 30)", required: false },
+    "start-date": {
+      type: "string",
+      description: "Explicit start date (YYYY-MM-DD or GA4 relative like '30daysAgo')",
+      required: false
+    },
+    "end-date": { type: "string", description: "Explicit end date (YYYY-MM-DD or 'yesterday')", required: false },
+    limit: { type: "string", description: "Max rows (default: 1000)", required: false },
+    "list-presets": { type: "boolean", description: "List available presets", required: false },
+    out: { type: "string", description: "Write data to file (.csv, .jsonl, .json)", required: false },
+    append: { type: "boolean", description: "Append to existing file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function extractFields(rows) {
+  const first = rows[0];
+  return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, append) {
+  const fields = extractFields(rows);
+  const ext = filePath.split(".").pop()?.toLowerCase();
+  if (ext === "csv") {
+    if (!append || !existsSync(filePath)) {
+      writeFileSync(filePath, `${toCsvRow(fields)}
+`, "utf-8");
+    }
+    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+    appendFileSync(filePath, `${csvRows.join("\n")}
+`, "utf-8");
+  } else if (ext === "jsonl") {
+    const lines = rows.map((row) => JSON.stringify(row));
+    const content = `${lines.join("\n")}
+`;
+    if (append && existsSync(filePath)) {
+      appendFileSync(filePath, content, "utf-8");
+    } else {
+      writeFileSync(filePath, content, "utf-8");
+    }
+  } else if (append && existsSync(filePath)) {
+    const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+    writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+  } else {
+    writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+  }
+}
+function outputRows(rows, args, response, cached) {
+  if (args.out) {
+    const filePath = resolve(args.out);
+    writeRowsToFile(filePath, rows, !!args.append);
+    writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...cached && { cached: true } });
+    return;
+  }
+  const format = args.output || "json";
+  if (format !== "json") {
+    writeAdsOutput(rows, format);
+    return;
+  }
+  writeJsonEnvelope({ ...response, ...cached && { cached: true } });
+}
+function buildRequestBody(args, propertyId, useCache) {
+  const body = { propertyId };
+  if (args.preset) body.preset = args.preset;
+  if (args.dimensions) body.dimensions = args.dimensions.split(",").map((d) => d.trim());
+  if (args.metrics) body.metrics = args.metrics.split(",").map((m) => m.trim());
+  if (args.days) body.days = Number(args.days);
+  if (args["start-date"]) body.startDate = args["start-date"];
+  if (args["end-date"]) body.endDate = args["end-date"];
+  if (args.limit) body.limit = Number(args.limit);
+  if (!useCache) body.skipCache = true;
+  return body;
+}
+function handleError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("ga4", err.message);
+    }
+    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+var queryCommand = defineCommand({
+  meta: {
+    name: "query",
+    description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
+
+Presets (primary usage):
+  baker ga4 query --preset tracking-health
+  baker ga4 query --preset lp-performance --days 14
+  baker ga4 query --list-presets
+
+Free-form (escape hatch):
+  baker ga4 query --dimensions "date,sessionSourceMedium" --metrics "sessions,conversions"
+  baker ga4 query --metrics "eventCount" --dimensions "eventName" --days 7`
+  },
+  args: {
+    "property-id": { type: "string", description: "GA4 property ID", required: false },
+    preset: { type: "string", description: "Named preset", required: false },
+    dimensions: { type: "string", description: "Comma-separated dimensions", required: false },
+    metrics: { type: "string", description: "Comma-separated metrics", required: false },
+    days: { type: "string", description: "Lookback days (default: 30)", required: false },
+    "start-date": { type: "string", description: "Start date override", required: false },
+    "end-date": { type: "string", description: "End date override", required: false },
+    limit: { type: "string", description: "Max rows (default: 1000)", required: false },
+    "list-presets": { type: "boolean", description: "List presets", required: false },
+    out: { type: "string", description: "Output file path", required: false },
+    append: { type: "boolean", description: "Append to file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    if (args["list-presets"]) {
+      writeJsonEnvelope({
+        ok: true,
+        data: GA4_PRESETS.map((p) => ({ name: p.name, description: p.description, playbook: p.playbook }))
+      });
+      return;
+    }
+    if (!args.preset && !args.metrics) {
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Provide --preset or --metrics. Run --list-presets to see options."
+        }
+      });
+      process.exit(1);
+    }
+    const propertyId = await resolvePropertyId(args);
+    const useCache = !args["no-cache"];
+    const body = buildRequestBody(args, propertyId, useCache);
+    const cacheKey = buildQueryCacheKey(propertyId, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("ga4-queries", cacheKey);
+      if (cached) {
+        outputRows(cached.data.data ?? [], args, cached.data, true);
+        return;
+      }
+    }
+    try {
+      const response = await apiPost("/api/ga4/query", body);
+      if (useCache) {
+        cacheSet("ga4-queries", cacheKey, response, getQueryTtl(JSON.stringify(body)));
+      }
+      outputRows(response.data ?? [], args, response, false);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  queryCommand
+};
+//# sourceMappingURL=query-OOP63DJF.js.map

package/dist/query-RBZFAIDK.js

@@ -0,0 +1,247 @@
+import {
+  resolveSiteUrl
+} from "./chunk-HCQJYI6X.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getQueryTtl,
+  handleConnectionError,
+  isNotConnectedError,
+  toCsvRow,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-6DPSWLGY.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/gsc/query.ts
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { defineCommand } from "citty";
+
+// src/commands/gsc/presets.ts
+var GSC_PRESETS = [
+  {
+    name: "cannibalization",
+    description: "PPC-SEO arbitrage \u2014 find queries ranking #1-2 organically where you also pay for ads",
+    playbook: "[05] PPC-SEO Arbitrage"
+  },
+  {
+    name: "missed-revenue",
+    description: "High-impression queries with no PPC coverage (position > 10)",
+    playbook: "[05] Opportunity Finder"
+  },
+  {
+    name: "brand-halo",
+    description: "Brand search volume trends \u2014 proves upper-funnel awareness lift",
+    playbook: "[21] YouTube/DG ROI",
+    requiresBrand: true
+  },
+  {
+    name: "negative-keywords",
+    description: "Discover negative keyword candidates (login, support, cancel queries)",
+    playbook: "Negative Keyword Discovery"
+  },
+  {
+    name: "top-pages",
+    description: "Top performing pages by clicks",
+    playbook: "General"
+  },
+  {
+    name: "top-queries",
+    description: "Top search queries by clicks",
+    playbook: "General"
+  }
+];
+
+// src/commands/gsc/query.ts
+registerSchema({
+  command: "gsc.query",
+  description: "Run GSC Search Analytics queries. Use --preset for playbook-aligned queries (primary usage) or --dimensions for free-form queries.",
+  args: {
+    "site-url": { type: "string", description: "Site URL (auto-resolved if not provided)", required: false },
+    preset: {
+      type: "string",
+      description: "Named preset (cannibalization, missed-revenue, brand-halo, negative-keywords, top-pages, top-queries)",
+      required: false
+    },
+    brand: { type: "string", description: "Brand name (required for brand-halo preset)", required: false },
+    dimensions: {
+      type: "string",
+      description: "Comma-separated dimensions (escape hatch: query, page, country, device, date)",
+      required: false
+    },
+    days: { type: "string", description: "Lookback window in days (default: 28)", required: false },
+    "start-date": { type: "string", description: "Explicit start date (YYYY-MM-DD)", required: false },
+    "end-date": { type: "string", description: "Explicit end date (YYYY-MM-DD)", required: false },
+    "row-limit": { type: "string", description: "Max rows (default: 1000, max: 25000)", required: false },
+    type: { type: "string", description: "Search type: web|image|video|news|discover (default: web)", required: false },
+    filter: { type: "string", description: "Dimension filter groups as JSON string", required: false },
+    "list-presets": { type: "boolean", description: "List available presets", required: false },
+    out: { type: "string", description: "Write data to file (.csv, .jsonl, .json)", required: false },
+    append: { type: "boolean", description: "Append to existing file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function extractFields(rows) {
+  const first = rows[0];
+  return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, append) {
+  const fields = extractFields(rows);
+  const ext = filePath.split(".").pop()?.toLowerCase();
+  if (ext === "csv") {
+    if (!append || !existsSync(filePath)) {
+      writeFileSync(filePath, `${toCsvRow(fields)}
+`, "utf-8");
+    }
+    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+    appendFileSync(filePath, `${csvRows.join("\n")}
+`, "utf-8");
+  } else if (ext === "jsonl") {
+    const content = `${rows.map((row) => JSON.stringify(row)).join("\n")}
+`;
+    if (append && existsSync(filePath)) {
+      appendFileSync(filePath, content, "utf-8");
+    } else {
+      writeFileSync(filePath, content, "utf-8");
+    }
+  } else if (append && existsSync(filePath)) {
+    const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+    writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+  } else {
+    writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+  }
+}
+function outputRows(rows, args, response, cached) {
+  if (args.out) {
+    const filePath = resolve(args.out);
+    writeRowsToFile(filePath, rows, !!args.append);
+    writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...cached && { cached: true } });
+    return;
+  }
+  const format = args.output || "json";
+  if (format !== "json") {
+    writeAdsOutput(rows, format);
+    return;
+  }
+  writeJsonEnvelope({ ...response, ...cached && { cached: true } });
+}
+function buildRequestBody(args, siteUrl, useCache) {
+  const body = { siteUrl };
+  if (args.preset) body.preset = args.preset;
+  if (args.brand) body.brand = args.brand;
+  if (args.dimensions) body.dimensions = args.dimensions.split(",").map((d) => d.trim());
+  if (args.days) body.days = Number(args.days);
+  if (args["start-date"]) body.startDate = args["start-date"];
+  if (args["end-date"]) body.endDate = args["end-date"];
+  if (args["row-limit"]) body.rowLimit = Number(args["row-limit"]);
+  if (args.type) body.type = args.type;
+  if (args.filter) body.filter = args.filter;
+  if (!useCache) body.skipCache = true;
+  return body;
+}
+function handleError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("gsc", err.message);
+    }
+    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+var queryCommand = defineCommand({
+  meta: {
+    name: "query",
+    description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
+
+Presets (primary usage):
+  baker gsc query --preset cannibalization
+  baker gsc query --preset brand-halo --brand "Acme" --days 90
+  baker gsc query --list-presets
+
+Free-form (escape hatch):
+  baker gsc query --dimensions "query,page" --days 28
+  baker gsc query --dimensions "query" --row-limit 25000 --out keywords.csv`
+  },
+  args: {
+    "site-url": { type: "string", description: "Site URL", required: false },
+    preset: { type: "string", description: "Named preset", required: false },
+    brand: { type: "string", description: "Brand name for brand-halo preset", required: false },
+    dimensions: { type: "string", description: "Comma-separated dimensions", required: false },
+    days: { type: "string", description: "Lookback days (default: 28)", required: false },
+    "start-date": { type: "string", description: "Start date override", required: false },
+    "end-date": { type: "string", description: "End date override", required: false },
+    "row-limit": { type: "string", description: "Max rows (default: 1000)", required: false },
+    type: { type: "string", description: "Search type (default: web)", required: false },
+    filter: { type: "string", description: "Filter JSON", required: false },
+    "list-presets": { type: "boolean", description: "List presets", required: false },
+    out: { type: "string", description: "Output file path", required: false },
+    append: { type: "boolean", description: "Append to file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    if (args["list-presets"]) {
+      writeJsonEnvelope({
+        ok: true,
+        data: GSC_PRESETS.map((p) => ({
+          name: p.name,
+          description: p.description,
+          playbook: p.playbook,
+          ...p.requiresBrand && { requiresBrand: true }
+        }))
+      });
+      return;
+    }
+    if (!args.preset && !args.dimensions) {
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Provide --preset or --dimensions. Run --list-presets to see options."
+        }
+      });
+      process.exit(1);
+    }
+    const siteUrl = await resolveSiteUrl(args);
+    const useCache = !args["no-cache"];
+    const body = buildRequestBody(args, siteUrl, useCache);
+    const cacheKey = buildQueryCacheKey(siteUrl, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("gsc-queries", cacheKey);
+      if (cached) {
+        outputRows(cached.data.data ?? [], args, cached.data, true);
+        return;
+      }
+    }
+    try {
+      const response = await apiPost("/api/gsc/query", body);
+      if (useCache) {
+        cacheSet("gsc-queries", cacheKey, response, getQueryTtl(JSON.stringify(body)));
+      }
+      outputRows(response.data ?? [], args, response, false);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  queryCommand
+};
+//# sourceMappingURL=query-RBZFAIDK.js.map

package/dist/questionnaire-7SHYRTMJ.js

@@ -0,0 +1,94 @@
+import {
+  questionnaireErrorEnvelope
+} from "./chunk-WLESMH4J.js";
+import "./chunk-JOE42ZW6.js";
+import "./chunk-NKQWDEB7.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-6DPSWLGY.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// ../api/src/analytics/questionnaire.ts
+import { z } from "zod";
+var questionnaireObservationSchema = z.object({
+  attemptId: z.string().min(1).max(100),
+  version: z.string().min(1).max(100),
+  stepId: z.string().max(100),
+  sequence: z.number().int().positive(),
+  phase: z.enum(["start", "view", "complete", "skip", "finish"]),
+  timestamp: z.number().finite()
+}).refine(
+  (event) => ["start", "finish"].includes(event.phase) || event.stepId.length > 0,
+  "A question event needs its stable step id"
+);
+var questionnaireRequestSchema = z.object({
+  eventName: z.string().min(1).max(100).default("questionnaire_step"),
+  days: z.number().int().min(1).max(90).default(7),
+  inactivityMinutes: z.number().int().min(5).max(1440).default(30)
+});
+var stepSchema = z.object({
+  version: z.string(),
+  stepId: z.string(),
+  reached: z.number(),
+  completed: z.number(),
+  skipped: z.number(),
+  abandoned: z.number(),
+  pending: z.number(),
+  incomplete: z.number()
+});
+var questionnaireResponseSchema = z.object({
+  ok: z.literal(true),
+  data: z.object({
+    steps: z.array(stepSchema),
+    attempts: z.number(),
+    excludedAttempts: z.number(),
+    unmeasuredEvents: z.number(),
+    observationEndsAt: z.string(),
+    inactivityMinutes: z.number()
+  }),
+  hints: z.array(z.string())
+});
+
+// src/commands/analytics/questionnaire.ts
+import { defineCommand } from "citty";
+var description = "Question-level drop-off from the external questionnaire contract: start, viewed, completed, skipped and finished per attempt, version and sequence. Reports actual reached questions and the last unanswered one after inactivity; deduplicates repeated visits. Refuses a truncated feed (maximum 600 events), so narrow --days if needed. No events is not proof of zero abandonment. The contract is in analytics.md.";
+var args = {
+  name: { type: "string", description: "Event name (default questionnaire_step)", required: false },
+  days: { type: "string", description: "Observation window in days (default 7, maximum 90)", required: false },
+  inactivity: {
+    type: "string",
+    description: "Minutes without an event before abandonment (default 30)",
+    required: false
+  }
+};
+registerSchema({ command: "analytics.questionnaire", description, args });
+var questionnaireCommand = defineCommand({
+  meta: { name: "questionnaire", description },
+  args,
+  run: async ({ args: args2 }) => {
+    try {
+      const body = questionnaireRequestSchema.parse({
+        ...args2.name ? { eventName: args2.name } : {},
+        ...args2.days ? { days: Number(args2.days) } : {},
+        ...args2.inactivity ? { inactivityMinutes: Number(args2.inactivity) } : {}
+      });
+      writeJsonEnvelope(questionnaireResponseSchema.parse(await apiPost("/api/analytics/questionnaire", body)));
+    } catch (error) {
+      writeJsonEnvelope({ ok: false, error: questionnaireErrorEnvelope(error) });
+      process.exitCode = 1;
+    }
+  }
+});
+export {
+  questionnaireCommand
+};
+//# sourceMappingURL=questionnaire-7SHYRTMJ.js.map

package/dist/questionnaire-7SHYRTMJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/analytics/questionnaire.ts","../src/commands/analytics/questionnaire.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const questionnaireObservationSchema = z\n  .object({\n    attemptId: z.string().min(1).max(100),\n    version: z.string().min(1).max(100),\n    stepId: z.string().max(100),\n    sequence: z.number().int().positive(),\n    phase: z.enum([\"start\", \"view\", \"complete\", \"skip\", \"finish\"]),\n    timestamp: z.number().finite(),\n  })\n  .refine(\n    (event) => [\"start\", \"finish\"].includes(event.phase) || event.stepId.length > 0,\n    \"A question event needs its stable step id\",\n  );\nexport type QuestionnaireObservation = z.infer<typeof questionnaireObservationSchema>;\n\nexport const questionnaireRequestSchema = z.object({\n  eventName: z.string().min(1).max(100).default(\"questionnaire_step\"),\n  days: z.number().int().min(1).max(90).default(7),\n  inactivityMinutes: z.number().int().min(5).max(1440).default(30),\n});\nconst stepSchema = z.object({\n  version: z.string(),\n  stepId: z.string(),\n  reached: z.number(),\n  completed: z.number(),\n  skipped: z.number(),\n  abandoned: z.number(),\n  pending: z.number(),\n  incomplete: z.number(),\n});\nexport const questionnaireResponseSchema = z.object({\n  ok: z.literal(true),\n  data: z.object({\n    steps: z.array(stepSchema),\n    attempts: z.number(),\n    excludedAttempts: z.number(),\n    unmeasuredEvents: z.number(),\n    observationEndsAt: z.string(),\n    inactivityMinutes: z.number(),\n  }),\n  hints: z.array(z.string()),\n});\n\ninterface AttemptState {\n  version: string;\n  viewed: Set<string>;\n  completed: Set<string>;\n  skipped: Set<string>;\n  lastView: string | undefined;\n  closed: boolean;\n  finished: boolean;\n}\n\ntype Step = z.infer<typeof stepSchema>;\n\nfunction countStep(row: Step, state: AttemptState) {\n  if (state.skipped.has(row.stepId)) row.skipped++;\n  if (!state.viewed.has(row.stepId)) return;\n  row.reached++;\n  if (state.completed.has(row.stepId)) {\n    row.completed++;\n    return;\n  }\n  if (state.skipped.has(row.stepId)) return;\n  if (row.stepId !== state.lastView || state.finished) row.incomplete++;\n  else if (state.closed) row.abandoned++;\n  else row.pending++;\n}\n\nfunction countAttempt(\n  raw: readonly QuestionnaireObservation[],\n  rows: Map<string, Step>,\n  now: number,\n  inactivityMs: number,\n): boolean {\n  const events = [...raw].sort((a, b) => a.sequence - b.sequence);\n  const last = events[events.length - 1];\n  if (events[0]?.phase !== \"start\" || !last) return false;\n  const steps = (phase: QuestionnaireObservation[\"phase\"]) =>\n    events.filter((event) => event.phase === phase).map((event) => event.stepId);\n  const views = steps(\"view\");\n  const state: AttemptState = {\n    version: last.version,\n    viewed: new Set(views),\n    completed: new Set(steps(\"complete\")),\n    skipped: new Set(steps(\"skip\")),\n    lastView: views[views.length - 1],\n    finished: last.phase === \"finish\",\n    closed: last.phase === \"finish\" || Math.max(...events.map((event) => event.timestamp)) <= now - inactivityMs,\n  };\n  for (const stepId of new Set([...state.viewed, ...state.skipped])) {\n    const key = JSON.stringify([state.version, stepId]);\n    const row = rows.get(key) ?? {\n      version: state.version,\n      stepId,\n      reached: 0,\n      completed: 0,\n      skipped: 0,\n      abandoned: 0,\n      pending: 0,\n      incomplete: 0,\n    };\n    countStep(row, state);\n    rows.set(key, row);\n  }\n  return true;\n}\n\n/** Drop-off is the last unanswered viewed step of a closed/inactive attempt, never a gap between totals. */\nexport function questionnaireDropoff(\n  observations: readonly QuestionnaireObservation[],\n  now: number,\n  inactivityMs: number,\n) {\n  const attempts = new Map<string, QuestionnaireObservation[]>();\n  for (const event of observations) {\n    const key = JSON.stringify([event.attemptId, event.version]);\n    attempts.set(key, [...(attempts.get(key) ?? []), event]);\n  }\n  const rows = new Map<string, Step>();\n  let excludedAttempts = 0;\n  for (const events of attempts.values()) if (!countAttempt(events, rows, now, inactivityMs)) excludedAttempts++;\n  return {\n    steps: [...rows.values()].sort((a, b) => a.version.localeCompare(b.version) || a.stepId.localeCompare(b.stepId)),\n    attempts: attempts.size - excludedAttempts,\n    excludedAttempts,\n  };\n}\n","import { questionnaireRequestSchema, questionnaireResponseSchema } from \"@baker/api/analytics/questionnaire\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\nimport { questionnaireErrorEnvelope } from \"./errorEnvelope.ts\";\n\nconst description =\n  \"Question-level drop-off from the external questionnaire contract: start, viewed, completed, skipped and finished per attempt, version and sequence. Reports actual reached questions and the last unanswered one after inactivity; deduplicates repeated visits. Refuses a truncated feed (maximum 600 events), so narrow --days if needed. No events is not proof of zero abandonment. The contract is in analytics.md.\";\nconst args = {\n  name: { type: \"string\" as const, description: \"Event name (default questionnaire_step)\", required: false },\n  days: { type: \"string\" as const, description: \"Observation window in days (default 7, maximum 90)\", required: false },\n  inactivity: {\n    type: \"string\" as const,\n    description: \"Minutes without an event before abandonment (default 30)\",\n    required: false,\n  },\n};\nregisterSchema({ command: \"analytics.questionnaire\", description, args });\nexport const questionnaireCommand = defineCommand({\n  meta: { name: \"questionnaire\", description },\n  args,\n  run: async ({ args }) => {\n    try {\n      const body = questionnaireRequestSchema.parse({\n        ...(args.name ? { eventName: args.name } : {}),\n        ...(args.days ? { days: Number(args.days) } : {}),\n        ...(args.inactivity ? { inactivityMinutes: Number(args.inactivity) } : {}),\n      });\n      writeJsonEnvelope(questionnaireResponseSchema.parse(await apiPost(\"/api/analytics/questionnaire\", body)));\n    } catch (error) {\n      writeJsonEnvelope({ ok: false, error: questionnaireErrorEnvelope(error) });\n      process.exitCode = 1;\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,SAAS,SAAS;AAEX,IAAM,iCAAiC,EAC3C,OAAO;AAAA,EACN,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACpC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAClC,QAAQ,EAAE,OAAO,EAAE,IAAI,GAAG;AAAA,EAC1B,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACpC,OAAO,EAAE,KAAK,CAAC,SAAS,QAAQ,YAAY,QAAQ,QAAQ,CAAC;AAAA,EAC7D,WAAW,EAAE,OAAO,EAAE,OAAO;AAC/B,CAAC,EACA;AAAA,EACC,CAAC,UAAU,CAAC,SAAS,QAAQ,EAAE,SAAS,MAAM,KAAK,KAAK,MAAM,OAAO,SAAS;AAAA,EAC9E;AACF;AAGK,IAAM,6BAA6B,EAAE,OAAO;AAAA,EACjD,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,oBAAoB;AAAA,EAClE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC;AAAA,EAC/C,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,QAAQ,EAAE;AACjE,CAAC;AACD,IAAM,aAAa,EAAE,OAAO;AAAA,EAC1B,SAAS,EAAE,OAAO;AAAA,EAClB,QAAQ,EAAE,OAAO;AAAA,EACjB,SAAS,EAAE,OAAO;AAAA,EAClB,WAAW,EAAE,OAAO;AAAA,EACpB,SAAS,EAAE,OAAO;AAAA,EAClB,WAAW,EAAE,OAAO;AAAA,EACpB,SAAS,EAAE,OAAO;AAAA,EAClB,YAAY,EAAE,OAAO;AACvB,CAAC;AACM,IAAM,8BAA8B,EAAE,OAAO;AAAA,EAClD,IAAI,EAAE,QAAQ,IAAI;AAAA,EAClB,MAAM,EAAE,OAAO;AAAA,IACb,OAAO,EAAE,MAAM,UAAU;AAAA,IACzB,UAAU,EAAE,OAAO;AAAA,IACnB,kBAAkB,EAAE,OAAO;AAAA,IAC3B,kBAAkB,EAAE,OAAO;AAAA,IAC3B,mBAAmB,EAAE,OAAO;AAAA,IAC5B,mBAAmB,EAAE,OAAO;AAAA,EAC9B,CAAC;AAAA,EACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;AAC3B,CAAC;;;AC1CD,SAAS,qBAAqB;AAM9B,IAAM,cACJ;AACF,IAAM,OAAO;AAAA,EACX,MAAM,EAAE,MAAM,UAAmB,aAAa,2CAA2C,UAAU,MAAM;AAAA,EACzG,MAAM,EAAE,MAAM,UAAmB,aAAa,sDAAsD,UAAU,MAAM;AAAA,EACpH,YAAY;AAAA,IACV,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AACF;AACA,eAAe,EAAE,SAAS,2BAA2B,aAAa,KAAK,CAAC;AACjE,IAAM,uBAAuB,cAAc;AAAA,EAChD,MAAM,EAAE,MAAM,iBAAiB,YAAY;AAAA,EAC3C;AAAA,EACA,KAAK,OAAO,EAAE,MAAAA,MAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAO,2BAA2B,MAAM;AAAA,QAC5C,GAAIA,MAAK,OAAO,EAAE,WAAWA,MAAK,KAAK,IAAI,CAAC;AAAA,QAC5C,GAAIA,MAAK,OAAO,EAAE,MAAM,OAAOA,MAAK,IAAI,EAAE,IAAI,CAAC;AAAA,QAC/C,GAAIA,MAAK,aAAa,EAAE,mBAAmB,OAAOA,MAAK,UAAU,EAAE,IAAI,CAAC;AAAA,MAC1E,CAAC;AACD,wBAAkB,4BAA4B,MAAM,MAAM,QAAQ,gCAAgC,IAAI,CAAC,CAAC;AAAA,IAC1G,SAAS,OAAO;AACd,wBAAkB,EAAE,IAAI,OAAO,OAAO,2BAA2B,KAAK,EAAE,CAAC;AACzE,cAAQ,WAAW;AAAA,IACrB;AAAA,EACF;AACF,CAAC;","names":["args"]}