@koda-sl/baker-cli 0.453.0 → 0.454.0-dev.67ad219ab

package/dist/query-SGGBCHTF.js

@@ -1,236 +0,0 @@
-import {
-  resolvePropertyId
-} from "./chunk-QSN5MZGS.js";
-import {
-  buildQueryCacheKey,
-  cacheGet,
-  cacheSet,
-  getQueryTtl,
-  handleConnectionError,
-  isNotConnectedError,
-  toCsvRow,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.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-SGGBCHTF.js.map

package/dist/query-VTGVZQIO.js

@@ -1,247 +0,0 @@
-import {
-  resolveSiteUrl
-} from "./chunk-2TK4DEOE.js";
-import {
-  buildQueryCacheKey,
-  cacheGet,
-  cacheSet,
-  getQueryTtl,
-  handleConnectionError,
-  isNotConnectedError,
-  toCsvRow,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.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-VTGVZQIO.js.map

package/dist/questionnaire-J56AATOX.js

@@ -1,93 +0,0 @@
-import {
-  questionnaireErrorEnvelope
-} from "./chunk-HTW7FTP4.js";
-import "./chunk-SSJK7FEV.js";
-import "./chunk-EDLZGTGN.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.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-J56AATOX.js.map

package/dist/questionnaire-J56AATOX.js.map

@@ -1 +0,0 @@
-{"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":"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","names":["args"]}