@thinkingai/ae-cli 6.1.8 → 6.1.10

package/dist/{te-analysis-DJ6KELTU.js → te-analysis-ITKTO6JS.js}

@@ -1,6 +1,6 @@
 import {
   createCapabilityCommand
-} from "./chunk-EBPXT3TN.js";
+} from "./chunk-LHVM35J4.js";
 import {
   registerCapabilityGatewayRoute,
   resolveGatewayDomain
@@ -9,6 +9,7 @@ import {
   CapabilityGatewayError,
   buildCapabilityGatewayUrl,
   dryRunCapability,
+  executeCapability,
   executeCapabilityWithEnvelope,
   fetchCapabilityGateway,
   requestCapabilityGateway,
@@ -18,7 +19,7 @@ import {
 } from "./chunk-RGXCNC4N.js";
 import {
   withOutputMetadata
-} from "./chunk-JTKMDN4A.js";
+} from "./chunk-KTYR3U6D.js";
 import "./chunk-E7UXXHO3.js";
 import "./chunk-IR4ZLVPW.js";
 import "./chunk-V6FR6WTW.js";
@@ -5860,6 +5861,24 @@ var dataTypeFlag = {
   required: false,
   desc: "Live data type: normal (default) or error."
 };
+var debugDeviceIdFlag = {
+  name: "device-id",
+  type: "string",
+  required: true,
+  desc: "Debug device ID reported by the SDK as #device_id."
+};
+var debugDeviceNameFlag = {
+  name: "device-name",
+  type: "string",
+  required: true,
+  desc: "Human-readable name for the Debug device."
+};
+var eventNameFlag = {
+  name: "event-name",
+  type: "string",
+  required: false,
+  desc: "Optional event name filter."
+};
 var eventNamesFlag = {
   name: "event-names",
   type: "json",
@@ -6086,6 +6105,323 @@ var trackingPlanSyncFromMeta = createTrackingCapabilityCommand({
   buildInput: projectInput2
 });
 
+// src/commands/te-analysis/tracking/plan/sync-display-names.ts
+import { existsSync as existsSync3 } from "fs";
+import { readFile } from "fs/promises";
+
+// src/tracking/plan/display-name-sync.ts
+function buildDisplayNameSyncPlan(draft, metadata) {
+  return {
+    event: buildGroup(
+      "event",
+      eventDefinitions(draft.events),
+      existingDefinitions(metadata.events, "event_name", "event_desc")
+    ),
+    event_property: buildGroup(
+      "event_property",
+      propertyDefinitions([
+        ...draft.common_event_properties,
+        ...draft.event_properties
+      ]),
+      existingDefinitions(metadata.eventProperties, "prop_name", "prop_desc")
+    ),
+    user_property: buildGroup(
+      "user_property",
+      propertyDefinitions(draft.user_properties),
+      existingDefinitions(metadata.userProperties, "prop_name", "prop_desc")
+    )
+  };
+}
+function assertTrackingDraft(value) {
+  if (!isRecord(value)) {
+    throw new Error("Tracking draft must be a JSON object.");
+  }
+  for (const field of [
+    "events",
+    "event_properties",
+    "common_event_properties",
+    "user_properties"
+  ]) {
+    if (!Array.isArray(value[field])) {
+      throw new Error(`Tracking draft field "${field}" must be an array.`);
+    }
+  }
+}
+function eventDefinitions(events) {
+  return definitions(
+    events.map((event) => ({
+      name: event.event_name,
+      displayName: event.display_name
+    })),
+    "event"
+  );
+}
+function propertyDefinitions(properties) {
+  return definitions(
+    properties.map((property) => ({
+      name: property.name,
+      displayName: property.display_name
+    })),
+    "property"
+  );
+}
+function definitions(candidates, kind) {
+  const byName = /* @__PURE__ */ new Map();
+  const missing = /* @__PURE__ */ new Set();
+  for (const candidate of candidates) {
+    const name = nonEmptyString(candidate.name);
+    if (!name) continue;
+    const displayName = nonEmptyString(candidate.displayName);
+    if (!displayName) {
+      if (!byName.has(name)) missing.add(name);
+      continue;
+    }
+    const previous = byName.get(name);
+    if (previous && previous !== displayName) {
+      throw new Error(
+        `Tracking draft maps ${kind} "${name}" to conflicting display names: "${previous}" and "${displayName}".`
+      );
+    }
+    byName.set(name, displayName);
+    missing.delete(name);
+  }
+  return {
+    definitions: [...byName.entries()].map(([name, displayName]) => ({
+      name,
+      displayName
+    })),
+    missing: [...missing]
+  };
+}
+function existingDefinitions(value, nameField, displayNameField) {
+  if (!Array.isArray(value)) return [];
+  const rows = [];
+  for (const item of value) {
+    if (!isRecord(item)) continue;
+    const name = nonEmptyString(item[nameField]);
+    if (!name) continue;
+    rows.push({
+      name,
+      displayName: nonEmptyString(item[displayNameField])
+    });
+  }
+  return rows;
+}
+function buildGroup(type, source, existing) {
+  const existingByName = new Map(
+    existing.map((item) => [item.name, item.displayName])
+  );
+  const items = [];
+  const skippedExisting = [];
+  const missingInMetadata = [];
+  for (const definition of source.definitions) {
+    if (!existingByName.has(definition.name)) {
+      missingInMetadata.push(definition.name);
+      continue;
+    }
+    if (existingByName.get(definition.name)) {
+      skippedExisting.push(definition.name);
+      continue;
+    }
+    items.push(
+      type === "event" ? { event_name: definition.name, event_desc: definition.displayName } : { prop_name: definition.name, prop_desc: definition.displayName }
+    );
+  }
+  return {
+    type,
+    items,
+    skippedExisting,
+    missingInMetadata,
+    missingInDraft: source.missing
+  };
+}
+function nonEmptyString(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : void 0;
+}
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+// src/commands/te-analysis/tracking/plan/sync-display-names.ts
+var GATEWAY_DOMAIN = "analysis";
+var LIST_CAPABILITIES = {
+  events: "metadata.event.list",
+  eventProperties: "metadata.property.list",
+  userProperties: "metadata.property.list"
+};
+var EDIT_CAPABILITY = "metadata.super_metadata.batch_edit";
+var MAX_BATCH_SIZE = 200;
+var trackingPlanSyncDisplayNames = {
+  service: "tracking",
+  resource: "plan",
+  command: "sync-display-names",
+  description: "Fill blank event and property metadata display names from a local tracking-plan draft. Existing non-empty display names are never overwritten.",
+  flags: [
+    projectIdFlag,
+    {
+      name: "draft",
+      type: "string",
+      required: true,
+      desc: "Local tracking-plan draft.json containing event/property display_name values."
+    }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    if (!existsSync3(ctx.str("draft"))) {
+      throw new Error(
+        "--draft must reference a readable tracking-plan JSON file."
+      );
+    }
+  },
+  dryRun: async (ctx) => {
+    const draft = await readDraft(ctx.str("draft"));
+    return {
+      project_id: ctx.num("project-id"),
+      draft: ctx.str("draft"),
+      source_counts: sourceCounts(draft),
+      behavior: "Fill blank metadata display names only; preserve all existing non-empty display names.",
+      steps: [
+        ...Object.values(LIST_CAPABILITIES).map((capabilityId) => ({
+          method: "POST",
+          url: buildCapabilityGatewayUrl(
+            ctx.host(),
+            GATEWAY_DOMAIN,
+            `capabilities/${capabilityId}/execute`
+          )
+        })),
+        {
+          method: "POST",
+          url: buildCapabilityGatewayUrl(
+            ctx.host(),
+            GATEWAY_DOMAIN,
+            `capabilities/${EDIT_CAPABILITY}/execute`
+          ),
+          note: "Called only for non-empty update groups, in batches of at most 200 items."
+        }
+      ]
+    };
+  },
+  execute: async (ctx) => {
+    const projectId = ctx.num("project-id");
+    const draftPath = ctx.str("draft");
+    const draft = await readDraft(draftPath);
+    const [eventResult, eventPropertyResult, userPropertyResult] = await Promise.all([
+      executeCapability(
+        ctx.host(),
+        GATEWAY_DOMAIN,
+        LIST_CAPABILITIES.events,
+        {
+          project_id: projectId,
+          fields: ["event_name", "event_desc"]
+        }
+      ),
+      executeCapability(
+        ctx.host(),
+        GATEWAY_DOMAIN,
+        LIST_CAPABILITIES.eventProperties,
+        {
+          project_id: projectId,
+          table_type: "event",
+          fields: ["prop_name", "prop_desc"]
+        }
+      ),
+      executeCapability(
+        ctx.host(),
+        GATEWAY_DOMAIN,
+        LIST_CAPABILITIES.userProperties,
+        {
+          project_id: projectId,
+          table_type: "user",
+          fields: ["prop_name", "prop_desc"]
+        }
+      )
+    ]);
+    const plan = buildDisplayNameSyncPlan(draft, {
+      events: eventResult?.events,
+      eventProperties: eventPropertyResult?.properties,
+      userProperties: userPropertyResult?.properties
+    });
+    const updateResults = {};
+    for (const group of Object.values(plan)) {
+      updateResults[group.type] = await executeUpdates(ctx, projectId, group);
+    }
+    return {
+      project_id: projectId,
+      draft: draftPath,
+      policy: "blank_only",
+      updated: counts(plan, (group) => group.items.length),
+      skipped_existing: counts(plan, (group) => group.skippedExisting.length),
+      missing_in_metadata: counts(
+        plan,
+        (group) => group.missingInMetadata.length
+      ),
+      missing_display_name_in_draft: counts(
+        plan,
+        (group) => group.missingInDraft.length
+      ),
+      details: {
+        missing_in_metadata: Object.fromEntries(
+          Object.values(plan).map((group) => [
+            group.type,
+            group.missingInMetadata
+          ])
+        ),
+        missing_display_name_in_draft: Object.fromEntries(
+          Object.values(plan).map((group) => [
+            group.type,
+            group.missingInDraft
+          ])
+        )
+      },
+      batches: updateResults
+    };
+  }
+};
+async function readDraft(filePath) {
+  let value;
+  try {
+    value = JSON.parse(await readFile(filePath, "utf8"));
+  } catch (error) {
+    throw new Error(
+      `Unable to read tracking draft "${filePath}": ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  assertTrackingDraft(value);
+  return value;
+}
+async function executeUpdates(ctx, projectId, group) {
+  const results = [];
+  for (let offset = 0; offset < group.items.length; offset += MAX_BATCH_SIZE) {
+    const items = group.items.slice(offset, offset + MAX_BATCH_SIZE);
+    results.push(
+      await executeCapability(ctx.host(), GATEWAY_DOMAIN, EDIT_CAPABILITY, {
+        project_id: projectId,
+        type: group.type,
+        items
+      })
+    );
+  }
+  return results;
+}
+function sourceCounts(draft) {
+  return {
+    event: draft.events.length,
+    event_property: new Set(
+      [...draft.common_event_properties, ...draft.event_properties].map(
+        (property) => property.name
+      )
+    ).size,
+    user_property: draft.user_properties.length
+  };
+}
+function counts(plan, value) {
+  return Object.fromEntries(
+    Object.values(plan).map((group) => [group.type, value(group)])
+  );
+}
+
 // src/commands/te-analysis/tracking/plan/index.ts
 var commands63 = [
   trackingPlanGet,
@@ -6094,7 +6430,8 @@ var commands63 = [
   trackingPlanGenerate,
   trackingPlanExport,
   trackingPlanImportExcel,
-  trackingPlanSyncFromMeta
+  trackingPlanSyncFromMeta,
+  trackingPlanSyncDisplayNames
 ];
 var plan_default = commands63;
 
@@ -6329,8 +6666,116 @@ var commands70 = [
 ];
 var event_blacklist_default = commands70;
 
-// src/commands/te-analysis/tracking/index.ts
+// src/commands/te-analysis/tracking/debug-device/add.ts
+var trackingDebugDeviceAdd = createTrackingCapabilityCommand({
+  resource: "debug-device",
+  command: "add",
+  capabilityId: "tracking.debug_device.add",
+  description: "Create or update a Debug device for an AE project.",
+  flags: [projectIdFlag, debugDeviceIdFlag, debugDeviceNameFlag],
+  risk: "write",
+  buildInput: (ctx) => ({
+    ...projectInput2(ctx),
+    device_id: ctx.str("device-id"),
+    device_name: ctx.str("device-name")
+  })
+});
+
+// src/commands/te-analysis/tracking/debug-device/list.ts
+var trackingDebugDeviceList = createTrackingCapabilityCommand({
+  resource: "debug-device",
+  command: "list",
+  capabilityId: "tracking.debug_device.list",
+  description: "List Debug devices and the device selected by the current CLI user.",
+  flags: [projectIdFlag],
+  risk: "read",
+  buildInput: projectInput2
+});
+
+// src/commands/te-analysis/tracking/debug-device/select.ts
+var trackingDebugDeviceSelect = createTrackingCapabilityCommand({
+  resource: "debug-device",
+  command: "select",
+  capabilityId: "tracking.debug_device.select",
+  description: "Select the active Debug device for the current CLI user.",
+  flags: [projectIdFlag, debugDeviceIdFlag],
+  risk: "write",
+  buildInput: (ctx) => ({
+    ...projectInput2(ctx),
+    device_id: ctx.str("device-id")
+  })
+});
+
+// src/commands/te-analysis/tracking/debug-device/index.ts
 var commands71 = [
+  trackingDebugDeviceList,
+  trackingDebugDeviceAdd,
+  trackingDebugDeviceSelect
+];
+var debug_device_default = commands71;
+
+// src/commands/te-analysis/tracking/debug-data/list.ts
+var debugStartTimeFlag = {
+  name: "start-time",
+  type: "string",
+  required: false,
+  desc: "Query start time in YYYY-MM-DD HH:mm:ss local time. Defaults to one hour ago."
+};
+var trackingDebugDataList = createTrackingCapabilityCommand({
+  resource: "debug-data",
+  command: "list",
+  capabilityId: "tracking.debug_data.list",
+  description: "List Debug data received from one device.",
+  flags: [projectIdFlag, debugDeviceIdFlag, debugStartTimeFlag, eventNameFlag],
+  risk: "read",
+  buildInput: (ctx) => compactInput({
+    ...projectInput2(ctx),
+    device_id: ctx.str("device-id"),
+    start_time: optionalString(ctx, "start-time") ?? formatLocalTime(new Date(Date.now() - 60 * 60 * 1e3)),
+    event_name: optionalString(ctx, "event-name")
+  }),
+  postProcess: (result, input) => {
+    const data = isRecord2(result) ? result : {};
+    const eventList = Array.isArray(data.event_list) ? data.event_list : [];
+    const deviceDataList = Array.isArray(data.device_data_list) ? data.device_data_list : [];
+    return {
+      device_id: input.device_id,
+      start_time: input.start_time,
+      ...input.event_name ? { event_name: input.event_name } : {},
+      has_data: deviceDataList.length > 0,
+      event_count: eventList.length,
+      data_count: deviceDataList.length,
+      event_list: eventList,
+      device_data_list: deviceDataList
+    };
+  }
+});
+function formatLocalTime(value) {
+  const pad = (part) => String(part).padStart(2, "0");
+  return [
+    value.getFullYear(),
+    "-",
+    pad(value.getMonth() + 1),
+    "-",
+    pad(value.getDate()),
+    " ",
+    pad(value.getHours()),
+    ":",
+    pad(value.getMinutes()),
+    ":",
+    pad(value.getSeconds())
+  ].join("");
+}
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+// src/commands/te-analysis/tracking/debug-data/index.ts
+var commands72 = [trackingDebugDataList];
+var debug_data_default = commands72;
+
+// src/commands/te-analysis/tracking/index.ts
+var commands73 = [
   ...plan_default,
   ...sdk_sample_default,
   ...plan_change_log_default,
@@ -6338,9 +6783,11 @@ var commands71 = [
   ...ingest_default,
   ...ingest_error_default,
   ...live_data_default,
-  ...event_blacklist_default
+  ...event_blacklist_default,
+  ...debug_device_default,
+  ...debug_data_default
 ];
-var tracking_default = commands71;
+var tracking_default = commands73;
 
 // src/commands/te-analysis/alert/shared.ts
 var alertIdFlag = {
@@ -6460,7 +6907,7 @@ var analysisAlertStop = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert/index.ts
-var commands72 = [
+var commands74 = [
   analysisAlertList,
   analysisAlertGet,
   analysisAlertCreate,
@@ -6469,7 +6916,7 @@ var commands72 = [
   analysisAlertStart,
   analysisAlertStop
 ];
-var alert_default = commands72;
+var alert_default = commands74;
 
 // src/commands/te-analysis/alert-detail/list.ts
 var analysisAlertDetailList = createAnalysisCapabilityCommand({
@@ -6483,10 +6930,10 @@ var analysisAlertDetailList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-detail/index.ts
-var commands73 = [
+var commands75 = [
   analysisAlertDetailList
 ];
-var alert_detail_default = commands73;
+var alert_detail_default = commands75;
 
 // src/commands/te-analysis/alert-job/list.ts
 var analysisAlertJobList = createAnalysisCapabilityCommand({
@@ -6500,10 +6947,10 @@ var analysisAlertJobList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-job/index.ts
-var commands74 = [
+var commands76 = [
   analysisAlertJobList
 ];
-var alert_job_default = commands74;
+var alert_job_default = commands76;
 
 // src/commands/te-analysis/alert-notice-config/list.ts
 var analysisAlertNoticeConfigList = createAnalysisCapabilityCommand({
@@ -6517,10 +6964,10 @@ var analysisAlertNoticeConfigList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-notice-config/index.ts
-var commands75 = [
+var commands77 = [
   analysisAlertNoticeConfigList
 ];
-var alert_notice_config_default = commands75;
+var alert_notice_config_default = commands77;
 
 // src/commands/te-analysis/index.ts
 registerCapabilityGatewayRoute("analysis", { gatewayDomain: "analysis" });
@@ -6566,8 +7013,8 @@ var baseCommands = [
   ...alert_job_default,
   ...alert_notice_config_default
 ];
-var commands76 = [...baseCommands];
-var te_analysis_default = commands76;
+var commands78 = [...baseCommands];
+var te_analysis_default = commands78;
 export {
   baseCommands,
   te_analysis_default as default