@tenderprompt/cli 0.1.11 → 0.1.12

package/README.md

@@ -169,7 +169,7 @@ tender app analytics suggestions artifact_123 --range 30d --json
 
 tender app analytics charts templates --json
 
-tender app analytics property-slots list artifact_123 --json
+tender app analytics properties list artifact_123 --json
 ```
 
 Safe write previews:
@@ -177,7 +177,7 @@ Safe write previews:
 ```bash
 tender app analytics dashboards artifact_123 --create "Agent dashboard" --dry-run --json
 
-tender app analytics property-slots activate artifact_123 \
+tender app analytics properties activate artifact_123 \
   --event signup_started \
   --property plan \
   --type dimension \
@@ -217,11 +217,12 @@ inspection. For example, inspect where the app calls
 `__TP_ANALYTICS.invoke(...)`, propose a chart spec, validate it with
 `analytics query`, and only then create a saved chart.
 Use `charts templates --json` for reusable chart shapes; adapt any placeholders
-to observed events, paths, or promoted property keys before querying or saving.
-Property group-bys and property metrics need promoted slots; `charts create`
-and `charts update` activate missing slots automatically when the spec includes
-an `event_name = ...` filter. `analytics query` is read-only, so use
-`property-slots activate` first when trying an ad hoc property query. When a
+to observed events, paths, or queryable property keys before querying or saving.
+Property group-bys and property metrics need the custom event property to be
+available for dashboard queries; `charts create` and `charts update` activate
+missing properties automatically when the spec includes an `event_name = ...`
+filter. `analytics query` is read-only, so use
+`properties activate` first when trying an ad hoc property query. When a
 query fails for a missing dashboard-query property, the CLI prints the exact
 activation commands to run and does not perform that write automatically.
 
@@ -237,7 +238,7 @@ activation commands to run and does not perform that write automatically.
   remote URLs.
 - Analytics commands use tenant/artifact-scoped API routes. They do not expose
   raw query credentials or raw SQL.
-- Property slot activation is an explicit analytics write and remains
+- Dashboard-query property activation is an explicit analytics write and remains
   tenant/artifact-scoped.
 - Raw analytics event export is intentionally not available; exports are bounded
   catalog metadata or validated aggregate query rows.

package/dist/index.js

@@ -213,10 +213,10 @@ Commands:
                              Update a saved chart title or spec
   tender app analytics charts delete <app-id>
                              Delete a saved chart
-  tender app analytics property-slots list <app-id>
-                             List promoted property slots
-  tender app analytics property-slots activate <app-id>
-                             Activate a promoted property slot
+  tender app analytics properties list <app-id>
+                             List properties available to dashboard queries
+  tender app analytics properties activate <app-id>
+                             Make a custom event property queryable
   tender app context fetch <app-id>
                              Fetch AGENTS.md, skills, and Tender App scaffold files
   tender app context status <app-id>
@@ -255,8 +255,8 @@ Examples:
   tender app analytics charts list artifact_123 --dashboard analytics_dashboard_123 --json
   tender app analytics charts update artifact_123 --chart analytics_chart_123 --title "Signup funnel" --spec funnel.json --dry-run --json
   tender app analytics charts delete artifact_123 --chart analytics_chart_123 --dry-run --json
-  tender app analytics property-slots list artifact_123 --json
-  tender app analytics property-slots activate artifact_123 --event signup_started --property plan --type dimension --dry-run --json
+  tender app analytics properties list artifact_123 --json
+  tender app analytics properties activate artifact_123 --event signup_started --property plan --type dimension --dry-run --json
   tender app context fetch artifact_123 --dir ./widget --dry-run --json
   tender app context status artifact_123 --dir ./widget --json
   tender app context refresh artifact_123 --dir ./widget --dry-run --json
@@ -294,8 +294,8 @@ Commands:
   tender app analytics charts list <app-id>   List saved charts in one dashboard
   tender app analytics charts update <app-id> Update a saved chart
   tender app analytics charts delete <app-id> Delete a saved chart
-  tender app analytics property-slots list <app-id>      List promoted property slots
-  tender app analytics property-slots activate <app-id>  Activate a promoted property slot
+  tender app analytics properties list <app-id>      List queryable custom event properties
+  tender app analytics properties activate <app-id>  Make a property queryable
 
 Examples:
   tender app analytics summary artifact_123 --range 30d --json
@@ -311,8 +311,8 @@ Examples:
   tender app analytics charts list artifact_123 --dashboard analytics_dashboard_123 --json
   tender app analytics charts update artifact_123 --chart analytics_chart_123 --title "Signup funnel" --spec funnel.json --dry-run --json
   tender app analytics charts delete artifact_123 --chart analytics_chart_123 --dry-run --json
-  tender app analytics property-slots list artifact_123 --json
-  tender app analytics property-slots activate artifact_123 --event signup_started --property plan --type dimension --dry-run --json`;
+  tender app analytics properties list artifact_123 --json
+  tender app analytics properties activate artifact_123 --event signup_started --property plan --type dimension --dry-run --json`;
 }
 function analyticsSummaryHelp() {
     return `Usage: tender app analytics summary <app-id> [--range <7d|30d|90d|YYYY-MM-DD..YYYY-MM-DD>] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
@@ -388,7 +388,7 @@ Examples:
 function analyticsChartsCreateHelp() {
     return `Usage: tender app analytics charts create <app-id> --dashboard <dashboard-id> --title <title> --spec <file|-> [--dry-run] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
 
-Property charts automatically activate required promoted property slots before
+Property charts automatically make required custom event properties queryable before
 saving when the spec has an event_name = filter.
 
 Examples:
@@ -406,7 +406,7 @@ function analyticsChartsUpdateHelp() {
 
 At least one of --title or --spec is required. When one is omitted, the CLI reads
 the existing saved chart and keeps that value.
-Property charts automatically activate required promoted property slots before
+Property charts automatically make required custom event properties queryable before
 saving when the spec has an event_name = filter.
 
 Examples:
@@ -421,19 +421,19 @@ Examples:
   tender app analytics charts delete artifact_123 --chart analytics_chart_123 --dry-run --json
   tender app analytics charts delete artifact_123 --chart analytics_chart_123 --json`;
 }
-function analyticsPropertySlotsListHelp() {
-    return `Usage: tender app analytics property-slots list <app-id> [--event <event-name>] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+function analyticsPropertiesListHelp() {
+    return `Usage: tender app analytics properties list <app-id> [--event <event-name>] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
 
 Examples:
-  tender app analytics property-slots list artifact_123 --json
-  tender app analytics property-slots list artifact_123 --event signup_started --json`;
+  tender app analytics properties list artifact_123 --json
+  tender app analytics properties list artifact_123 --event signup_started --json`;
 }
-function analyticsPropertySlotsActivateHelp() {
-    return `Usage: tender app analytics property-slots activate <app-id> --event <event-name> --property <property-key> --type <dimension|metric> [--slot <slot-name>] [--label <label>] [--dry-run] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
+function analyticsPropertiesActivateHelp() {
+    return `Usage: tender app analytics properties activate <app-id> --event <event-name> --property <property-key> --type <dimension|metric> [--label <label>] [--dry-run] [--base-url <url>] [--token <token>] [--profile <name>] [--json]
 
 Examples:
-  tender app analytics property-slots activate artifact_123 --event signup_started --property plan --type dimension --dry-run --json
-  tender app analytics property-slots activate artifact_123 --event score_saved --property score --type metric --json`;
+  tender app analytics properties activate artifact_123 --event signup_started --property plan --type dimension --dry-run --json
+  tender app analytics properties activate artifact_123 --event score_saved --property score --type metric --json`;
 }
 function artifactsListHelp() {
     return `Usage: tender app list [--base-url <url>] [--token <token>] [--profile <name>] [--json]
@@ -816,8 +816,8 @@ function tenderCliCapabilities() {
                     "tender app analytics charts templates --json",
                     "tender app analytics query <artifact-id> --spec chart.json --json",
                     "tender app analytics export query <artifact-id> --spec chart.json --format csv",
-                    "tender app analytics property-slots list <artifact-id> --json",
-                    "tender app analytics property-slots activate <artifact-id> --event <event-name> --property <property-key> --type dimension --dry-run --json",
+                    "tender app analytics properties list <artifact-id> --json",
+                    "tender app analytics properties activate <artifact-id> --event <event-name> --property <property-key> --type dimension --dry-run --json",
                     "tender app analytics dashboards <artifact-id> --create \"Agent dashboard\" --dry-run --json",
                     "tender app analytics charts create <artifact-id> --dashboard <dashboard-id> --title <title> --spec chart.json --dry-run --json",
                     "tender app analytics charts list <artifact-id> --dashboard <dashboard-id> --json",
@@ -827,8 +827,8 @@ function tenderCliCapabilities() {
                 notes: [
                     "Combine CLI capabilities with local source inspection of analytics calls.",
                     "Validate chart specs with query before creating or updating saved charts.",
-                    "Property chart create/update commands automatically activate missing promoted property slots when the spec has an event_name = filter.",
-                    "Ad hoc query is read-only; if it reports a missing property slot, activate the slot first or save the chart through charts create/update.",
+                    "Property chart create/update commands automatically make missing custom event properties queryable when the spec has an event_name = filter.",
+                    "Ad hoc query is read-only; if it reports a missing dashboard-query property, activate the property first or save the chart through charts create/update.",
                     "Use list before writes so agents can avoid duplicates and explain the exact chart they are changing.",
                 ],
             },
@@ -886,14 +886,14 @@ function tenderCliCapabilities() {
                 writes: false,
             },
             {
-                command: "tender app analytics property-slots list <artifact-id> --json",
-                purpose: "List active promoted property slots that make custom event properties queryable.",
+                command: "tender app analytics properties list <artifact-id> --json",
+                purpose: "List custom event properties available to dashboard queries.",
                 requiresAuth: true,
                 writes: false,
             },
             {
-                command: "tender app analytics property-slots activate <artifact-id> --event <event-name> --property <property-key> --type <dimension|metric> --dry-run --json",
-                purpose: "Preview or activate the promoted slot needed for a property group-by or property metric chart.",
+                command: "tender app analytics properties activate <artifact-id> --event <event-name> --property <property-key> --type <dimension|metric> --dry-run --json",
+                purpose: "Preview or activate the custom event property needed for a property group-by or property metric chart.",
                 requiresAuth: true,
                 writes: true,
                 dryRun: true,
@@ -2938,13 +2938,13 @@ function analyticsChartTemplates() {
             id: "property_breakdown",
             title: "Property breakdown",
             visualization: "bar",
-            purpose: "Compare a promoted dimension property observed in events.",
+            purpose: "Compare a queryable dimension property observed in events.",
             usableAsIs: false,
             placeholders: {
-                property: "<promoted_dimension_property>",
+                property: "<queryable_dimension_property>",
             },
             adaptWith: [
-                "Use a property key promoted by capabilities chartSpec.groupBy, such as property:plan.",
+                "Use a queryable property key from capabilities chartSpec.groupBy, such as property:plan.",
                 "Choose stable categorical properties with enough observations to compare.",
             ],
             spec: {
@@ -2952,7 +2952,7 @@ function analyticsChartTemplates() {
                 dataset: "events",
                 visualization: "bar",
                 metric: { name: "custom_event_count" },
-                groupBy: [{ field: "property:<promoted_dimension_property>" }],
+                groupBy: [{ field: "property:<queryable_dimension_property>" }],
                 filters: [],
                 range: { preset: "30d" },
                 sort: [{ field: "value", direction: "desc" }],
@@ -2966,17 +2966,17 @@ function analyticsChartTemplates() {
             purpose: "Track an observed numeric event property over time.",
             usableAsIs: false,
             placeholders: {
-                metric: "avg:<promoted_metric_property>",
+                metric: "avg:<queryable_metric_property>",
             },
             adaptWith: [
-                "Use a numeric property key promoted by capabilities chartSpec.metrics.",
+                "Use a queryable numeric property key from capabilities chartSpec.metrics.",
                 "Prefer averages for scores, durations, quantities, or ordinal values.",
             ],
             spec: {
                 version: 1,
                 dataset: "events",
                 visualization: "line",
-                metric: { name: "avg:<promoted_metric_property>" },
+                metric: { name: "avg:<queryable_metric_property>" },
                 groupBy: [{ field: "day" }],
                 filters: [],
                 range: { preset: "30d" },
@@ -3019,7 +3019,7 @@ function runAnalyticsChartsTemplates(command, io) {
         templates,
         next: [
             "Run tender app analytics capabilities <artifact-id> --include-catalog --range 30d --json.",
-            "Choose a template and replace placeholders with observed events, paths, or promoted property keys.",
+            "Choose a template and replace placeholders with observed events, paths, or queryable property keys.",
             "Validate with tender app analytics query <artifact-id> --spec chart.json --json.",
             "Preview saved writes with tender app analytics dashboards ... --dry-run and charts create ... --dry-run.",
         ],
@@ -3206,13 +3206,13 @@ function parseAnalyticsChartsDeleteArgs(args) {
         ...parsed,
     };
 }
-function parseAnalyticsPropertySlotsListArgs(args) {
+function parseAnalyticsPropertiesListArgs(args) {
     if (args.includes("--help") || args.includes("-h")) {
-        return { command: "help", topic: "app analytics property-slots list" };
+        return { command: "help", topic: "app analytics properties list" };
     }
     const artifactId = args[0];
     if (!artifactId || artifactId.startsWith("-")) {
-        throw new TenderCliUsageError("app id is required. Example: tender app analytics property-slots list <app-id> --json");
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics properties list <app-id> --json");
     }
     const parsed = parseAnalyticsCommonArgs(args, 1);
     let eventName = null;
@@ -3223,28 +3223,27 @@ function parseAnalyticsPropertySlotsListArgs(args) {
             index += 1;
             continue;
         }
-        throw new TenderCliUsageError(`Unknown analytics property-slots list option: ${arg}`);
+        throw new TenderCliUsageError(`Unknown analytics properties list option: ${arg}`);
     }
     return {
-        command: "app analytics property-slots list",
+        command: "app analytics properties list",
         artifactId,
         eventName,
         ...parsed,
     };
 }
-function parseAnalyticsPropertySlotsActivateArgs(args) {
+function parseAnalyticsPropertiesActivateArgs(args) {
     if (args.includes("--help") || args.includes("-h")) {
-        return { command: "help", topic: "app analytics property-slots activate" };
+        return { command: "help", topic: "app analytics properties activate" };
     }
     const artifactId = args[0];
     if (!artifactId || artifactId.startsWith("-")) {
-        throw new TenderCliUsageError("app id is required. Example: tender app analytics property-slots activate <app-id> --event <event-name> --property <property-key> --type dimension --json");
+        throw new TenderCliUsageError("app id is required. Example: tender app analytics properties activate <app-id> --event <event-name> --property <property-key> --type dimension --json");
     }
     const parsed = parseAnalyticsCommonArgs(args, 1);
     let eventName = null;
     let propertyKey = null;
-    let slotType = null;
-    let slotName = null;
+    let propertyType = null;
     let label = null;
     let dryRun = false;
     for (let index = 0; index < parsed.remaining.length; index += 1) {
@@ -3264,12 +3263,7 @@ function parseAnalyticsPropertySlotsActivateArgs(args) {
             if (value !== "dimension" && value !== "metric") {
                 throw new TenderCliUsageError("--type must be dimension or metric.");
             }
-            slotType = value;
-            index += 1;
-            continue;
-        }
-        if (arg === "--slot") {
-            slotName = parseRequiredFlagValue(parsed.remaining[index + 1], "--slot");
+            propertyType = value;
             index += 1;
             continue;
         }
@@ -3282,18 +3276,17 @@ function parseAnalyticsPropertySlotsActivateArgs(args) {
             dryRun = true;
             continue;
         }
-        throw new TenderCliUsageError(`Unknown analytics property-slots activate option: ${arg}`);
+        throw new TenderCliUsageError(`Unknown analytics properties activate option: ${arg}`);
     }
-    if (!eventName || !propertyKey || !slotType) {
-        throw new TenderCliUsageError("--event, --property, and --type are required. Example: tender app analytics property-slots activate artifact_123 --event signup_started --property plan --type dimension --json");
+    if (!eventName || !propertyKey || !propertyType) {
+        throw new TenderCliUsageError("--event, --property, and --type are required. Example: tender app analytics properties activate artifact_123 --event signup_started --property plan --type dimension --json");
     }
     return {
-        command: "app analytics property-slots activate",
+        command: "app analytics properties activate",
         artifactId,
         eventName,
         propertyKey,
-        slotType,
-        slotName,
+        propertyType,
         label,
         dryRun,
         ...parsed,
@@ -3383,21 +3376,21 @@ function parseTenderArgs(args) {
             return parseAnalyticsDashboardsArgs(resourceArgs.slice(3));
         }
         if (resourceArgs[1] === "analytics" &&
-            resourceArgs[2] === "property-slots" &&
+            resourceArgs[2] === "properties" &&
             (resourceArgs[3] === undefined ||
                 resourceArgs[3] === "--help" ||
                 resourceArgs[3] === "-h")) {
-            return { command: "help", topic: "app analytics property-slots list" };
+            return { command: "help", topic: "app analytics properties list" };
         }
         if (resourceArgs[1] === "analytics" &&
-            resourceArgs[2] === "property-slots" &&
+            resourceArgs[2] === "properties" &&
             resourceArgs[3] === "list") {
-            return parseAnalyticsPropertySlotsListArgs(resourceArgs.slice(4));
+            return parseAnalyticsPropertiesListArgs(resourceArgs.slice(4));
         }
         if (resourceArgs[1] === "analytics" &&
-            resourceArgs[2] === "property-slots" &&
+            resourceArgs[2] === "properties" &&
             resourceArgs[3] === "activate") {
-            return parseAnalyticsPropertySlotsActivateArgs(resourceArgs.slice(4));
+            return parseAnalyticsPropertiesActivateArgs(resourceArgs.slice(4));
         }
         if (resourceArgs[1] === "analytics" &&
             resourceArgs[2] === "export" &&
@@ -3859,8 +3852,8 @@ function analyticsCorrectedExample(artifactId, analyticsPath) {
     if (analyticsPath === "suggestions") {
         return `tender app analytics suggestions ${artifactId} --range 30d --json`;
     }
-    if (analyticsPath === "property-slots") {
-        return `tender app analytics property-slots list ${artifactId} --json`;
+    if (analyticsPath === "properties") {
+        return `tender app analytics properties list ${artifactId} --json`;
     }
     if (analyticsPath === "dashboards") {
         return `tender app analytics dashboards ${artifactId} --json`;
@@ -3877,6 +3870,10 @@ function readCliStringField(record, field) {
     const value = record[field];
     return typeof value === "string" ? value : null;
 }
+function readCliBooleanField(record, field) {
+    const value = record[field];
+    return typeof value === "boolean" ? value : false;
+}
 function readAnalyticsDashboardRecords(payload) {
     return Array.isArray(payload.dashboards)
         ? payload.dashboards.filter(isCliJsonRecord)
@@ -3912,9 +3909,9 @@ function readAnalyticsChartSpec(chart) {
 function readAnalyticsChartLayout(chart) {
     return isCliJsonRecord(chart.layout) ? chart.layout : {};
 }
-function readAnalyticsPropertySlotRecords(payload) {
-    return Array.isArray(payload.propertySlots)
-        ? payload.propertySlots.filter(isCliJsonRecord)
+function readAnalyticsPropertyRecords(payload) {
+    return Array.isArray(payload.properties)
+        ? payload.properties.filter(isCliJsonRecord)
         : [];
 }
 function readAnalyticsSpecEventNameFilter(spec) {
@@ -3940,34 +3937,34 @@ function readAnalyticsSpecGroupField(spec) {
     const [group] = spec.groupBy.filter(isCliJsonRecord);
     return group ? readCliStringField(group, "field") : null;
 }
-function readRequiredAnalyticsPropertySlotsFromSpec(spec) {
+function readRequiredAnalyticsPropertiesFromSpec(spec) {
     const eventName = readAnalyticsSpecEventNameFilter(spec);
     const requirements = [];
     const groupField = readAnalyticsSpecGroupField(spec);
     if (groupField?.startsWith("property:")) {
         if (!eventName) {
-            throw new TenderCliUsageError("Property group-by chart specs require an event_name = filter so the CLI can activate the promoted property slot.");
+            throw new TenderCliUsageError("Property group-by chart specs require an event_name = filter so the CLI can make the property available to dashboard queries.");
         }
         requirements.push({
             eventName,
             propertyKey: groupField.slice("property:".length),
-            slotType: "dimension",
+            propertyType: "dimension",
         });
     }
     const metricName = readAnalyticsSpecMetricName(spec);
     if (metricName?.startsWith("sum:") || metricName?.startsWith("avg:")) {
         if (!eventName) {
-            throw new TenderCliUsageError("Property metric chart specs require an event_name = filter so the CLI can activate the promoted property slot.");
+            throw new TenderCliUsageError("Property metric chart specs require an event_name = filter so the CLI can make the property available to dashboard queries.");
         }
         requirements.push({
             eventName,
             propertyKey: metricName.slice(metricName.indexOf(":") + 1),
-            slotType: "metric",
+            propertyType: "metric",
         });
     }
     const seen = new Set();
     return requirements.filter((requirement) => {
-        const key = `${requirement.slotType}:${requirement.eventName}:${requirement.propertyKey}`;
+        const key = `${requirement.propertyType}:${requirement.eventName}:${requirement.propertyKey}`;
         if (seen.has(key)) {
             return false;
         }
@@ -3975,107 +3972,22 @@ function readRequiredAnalyticsPropertySlotsFromSpec(spec) {
         return true;
     });
 }
-function analyticsPropertySlotNames(slotType) {
-    return slotType === "dimension"
-        ? Array.from({ length: 13 }, (_, index) => `blob${index + 8}`)
-        : Array.from({ length: 19 }, (_, index) => `double${index + 2}`);
-}
-function isValidAnalyticsPropertySlotName(input) {
-    return analyticsPropertySlotNames(input.slotType).includes(input.slotName);
-}
-function findExistingAnalyticsPropertySlot(input) {
-    return (input.propertySlots.find((slot) => readCliStringField(slot, "status") === "active" &&
-        readCliStringField(slot, "eventName") === input.requirement.eventName &&
-        readCliStringField(slot, "propertyKey") === input.requirement.propertyKey &&
-        readCliStringField(slot, "slotType") === input.requirement.slotType) ?? null);
-}
-function chooseAnalyticsPropertySlotName(input) {
-    if (input.requestedSlotName) {
-        if (!isValidAnalyticsPropertySlotName({
-            slotType: input.requirement.slotType,
-            slotName: input.requestedSlotName,
-        })) {
-            throw new TenderCliUsageError(`--slot must be a valid ${input.requirement.slotType} analytics slot.`);
-        }
-        const conflictingSlot = input.propertySlots.find((slot) => readCliStringField(slot, "status") === "active" &&
-            readCliStringField(slot, "eventName") === input.requirement.eventName &&
-            readCliStringField(slot, "slotType") === input.requirement.slotType &&
-            readCliStringField(slot, "slotName") === input.requestedSlotName &&
-            readCliStringField(slot, "propertyKey") !== input.requirement.propertyKey);
-        if (conflictingSlot) {
-            throw new TenderCliUsageError(`--slot ${input.requestedSlotName} is already active for another ${input.requirement.slotType} property on ${input.requirement.eventName}.`);
-        }
-        return input.requestedSlotName;
-    }
-    const usedSlots = new Set(input.propertySlots
-        .filter((slot) => readCliStringField(slot, "status") === "active" &&
-        readCliStringField(slot, "eventName") === input.requirement.eventName &&
-        readCliStringField(slot, "slotType") === input.requirement.slotType)
-        .map((slot) => readCliStringField(slot, "slotName"))
-        .filter((slotName) => Boolean(slotName)));
-    const slotName = analyticsPropertySlotNames(input.requirement.slotType).find((candidate) => !usedSlots.has(candidate));
-    if (!slotName) {
-        throw new Error("analytics_property_slots_full");
-    }
-    return slotName;
-}
-async function fetchAnalyticsPropertySlots(input) {
-    const payload = await requestAnalyticsApi({
-        artifactId: input.command.artifactId,
-        analyticsPath: "property-slots",
-        method: "GET",
-        baseUrl: input.credentials.baseUrl,
-        token: input.credentials.token,
-        fetcher: input.runtime.fetcher ?? fetch,
-    });
-    return { payload, propertySlots: readAnalyticsPropertySlotRecords(payload) };
-}
-async function ensureAnalyticsPropertySlots(input) {
+async function ensureAnalyticsProperties(input) {
     if (input.requirements.length === 0) {
         return [];
     }
-    const { propertySlots } = await fetchAnalyticsPropertySlots({
-        command: input.command,
-        credentials: input.credentials,
-        runtime: input.runtime,
-    });
     const plan = [];
     for (const requirement of input.requirements) {
-        const existing = findExistingAnalyticsPropertySlot({
-            propertySlots,
-            requirement,
-        });
-        if (existing) {
-            plan.push({
-                ...requirement,
-                slotName: readCliStringField(existing, "slotName") ?? "",
-                label: readCliStringField(existing, "label") ?? requirement.propertyKey,
-                status: "existing",
-                propertySlot: existing,
-            });
-            continue;
-        }
-        const slotName = chooseAnalyticsPropertySlotName({
-            propertySlots,
-            requirement,
-        });
         const body = {
             eventName: requirement.eventName,
             propertyKey: requirement.propertyKey,
-            slotType: requirement.slotType,
-            slotName,
+            propertyType: requirement.propertyType,
             label: requirement.propertyKey,
+            dryRun: input.dryRun,
         };
-        if (input.dryRun) {
-            plan.push({
-                ...body,
-                status: "planned",
-            });
-            continue;
-        }
         const payload = await requestAnalyticsApi({
             artifactId: input.command.artifactId,
-            analyticsPath: "property-slots",
+            analyticsPath: "properties",
             method: "POST",
             baseUrl: input.credentials.baseUrl,
             token: input.credentials.token,
@@ -4083,17 +3995,16 @@ async function ensureAnalyticsPropertySlots(input) {
             body,
         });
         plan.push({
-            ...body,
-            status: "activated",
-            propertySlot: payload.propertySlot,
-        });
-        propertySlots.push({
-            eventName: body.eventName,
-            propertyKey: body.propertyKey,
-            slotType: body.slotType,
-            slotName: body.slotName,
-            label: body.label,
-            status: "active",
+            eventName: requirement.eventName,
+            propertyKey: requirement.propertyKey,
+            propertyType: requirement.propertyType,
+            label: requirement.propertyKey,
+            status: readCliBooleanField(payload, "alreadyActive")
+                ? "existing"
+                : input.dryRun
+                    ? "planned"
+                    : "activated",
+            property: payload.property,
         });
     }
     return plan;
@@ -4108,12 +4019,12 @@ function analyticsCommandAuthFlags(command) {
     }
     return flags;
 }
-function analyticsPropertySlotActivationCommand(input) {
+function analyticsPropertyActivationCommand(input) {
     return [
         "tender",
         "app",
         "analytics",
-        "property-slots",
+        "properties",
         "activate",
         shellQuote(input.command.artifactId),
         "--event",
@@ -4121,16 +4032,16 @@ function analyticsPropertySlotActivationCommand(input) {
         "--property",
         shellQuote(input.requirement.propertyKey),
         "--type",
-        input.requirement.slotType,
+        input.requirement.propertyType,
         ...(input.dryRun ? ["--dry-run"] : []),
         ...analyticsCommandAuthFlags(input.command),
         "--json",
     ].join(" ");
 }
-function createAnalyticsPropertySlotGuidance(input) {
+function createAnalyticsPropertyGuidance(input) {
     let requirements;
     try {
-        requirements = readRequiredAnalyticsPropertySlotsFromSpec(input.spec);
+        requirements = readRequiredAnalyticsPropertiesFromSpec(input.spec);
     }
     catch {
         return null;
@@ -4142,11 +4053,11 @@ function createAnalyticsPropertySlotGuidance(input) {
         "To make this chart available for dashboard queries, activate the custom event property first:",
     ];
     for (const requirement of requirements) {
-        lines.push(analyticsPropertySlotActivationCommand({
+        lines.push(analyticsPropertyActivationCommand({
             command: input.command,
             requirement,
             dryRun: true,
-        }), analyticsPropertySlotActivationCommand({
+        }), analyticsPropertyActivationCommand({
             command: input.command,
             requirement,
             dryRun: false,
@@ -4172,8 +4083,8 @@ async function requestAnalyticsQueryWithPropertyGuidance(input) {
     }
     catch (error) {
         if (error instanceof TenderCliAnalyticsApiError &&
-            error.reasonCode === "analytics_property_slot_not_found") {
-            const guidance = createAnalyticsPropertySlotGuidance({
+            error.reasonCode === "analytics_property_not_queryable") {
+            const guidance = createAnalyticsPropertyGuidance({
                 command: input.command,
                 spec: input.spec,
             });
@@ -6380,93 +6291,43 @@ async function runAnalyticsExportQuery(command, io, runtime) {
     io.stdout(JSON.stringify(payload, null, 2));
     return 0;
 }
-async function runAnalyticsPropertySlotsList(command, io, runtime) {
+async function runAnalyticsPropertiesList(command, io, runtime) {
     const credentials = await resolveAnalyticsCredentials(command, runtime);
     const payload = await requestAnalyticsApi({
         artifactId: command.artifactId,
-        analyticsPath: "property-slots",
+        analyticsPath: "properties",
         method: "GET",
         baseUrl: credentials.baseUrl,
         token: credentials.token,
         fetcher: runtime.fetcher ?? fetch,
     });
-    const propertySlots = readAnalyticsPropertySlotRecords(payload).filter((slot) => !command.eventName ||
-        readCliStringField(slot, "eventName") === command.eventName);
+    const properties = readAnalyticsPropertyRecords(payload).filter((property) => !command.eventName ||
+        readCliStringField(property, "eventName") === command.eventName);
     printAnalyticsPayload(command, io, {
         ok: true,
         command: command.command,
         artifactId: command.artifactId,
         eventName: command.eventName,
-        propertySlots,
+        properties,
     }, [
         `app_id: ${command.artifactId}`,
         command.eventName ? `event: ${command.eventName}` : "event: all",
-        `property_slots: ${propertySlots.length}`,
+        `properties: ${properties.length}`,
     ]);
     return 0;
 }
-async function runAnalyticsPropertySlotsActivate(command, io, runtime) {
+async function runAnalyticsPropertiesActivate(command, io, runtime) {
     const credentials = await resolveAnalyticsCredentials(command, runtime);
-    const requirement = {
-        eventName: command.eventName,
-        propertyKey: command.propertyKey,
-        slotType: command.slotType,
-    };
-    const { propertySlots } = await fetchAnalyticsPropertySlots({
-        command,
-        credentials,
-        runtime,
-    });
-    const existing = findExistingAnalyticsPropertySlot({
-        propertySlots,
-        requirement,
-    });
-    if (existing) {
-        const payload = {
-            ok: true,
-            command: command.command,
-            artifactId: command.artifactId,
-            alreadyActive: true,
-            propertySlot: existing,
-        };
-        printAnalyticsPayload(command, io, payload, [
-            `app_id: ${command.artifactId}`,
-            "already_active: true",
-            `slot_name: ${readCliStringField(existing, "slotName") ?? ""}`,
-        ]);
-        return 0;
-    }
-    const slotName = chooseAnalyticsPropertySlotName({
-        propertySlots,
-        requirement,
-        requestedSlotName: command.slotName,
-    });
     const request = {
         eventName: command.eventName,
         propertyKey: command.propertyKey,
-        slotType: command.slotType,
-        slotName,
+        propertyType: command.propertyType,
         label: command.label ?? command.propertyKey,
+        dryRun: command.dryRun,
     };
-    if (command.dryRun) {
-        printAnalyticsPayload(command, io, {
-            ok: true,
-            command: command.command,
-            dryRun: true,
-            artifactId: command.artifactId,
-            request,
-        }, [
-            `app_id: ${command.artifactId}`,
-            `event: ${command.eventName}`,
-            `property: ${command.propertyKey}`,
-            `slot_name: ${slotName}`,
-            "dry_run: true",
-        ]);
-        return 0;
-    }
     const payload = await requestAnalyticsApi({
         artifactId: command.artifactId,
-        analyticsPath: "property-slots",
+        analyticsPath: "properties",
         method: "POST",
         baseUrl: credentials.baseUrl,
         token: credentials.token,
@@ -6477,7 +6338,8 @@ async function runAnalyticsPropertySlotsActivate(command, io, runtime) {
         `app_id: ${command.artifactId}`,
         `event: ${command.eventName}`,
         `property: ${command.propertyKey}`,
-        `slot_name: ${slotName}`,
+        `type: ${command.propertyType}`,
+        ...(command.dryRun ? ["dry_run: true"] : []),
     ]);
     return 0;
 }
@@ -6492,16 +6354,16 @@ async function runAnalyticsChartsCreate(command, io, runtime) {
         spec,
         layout: {},
     };
-    const requiredPropertySlots = readRequiredAnalyticsPropertySlotsFromSpec(spec);
-    const credentials = !command.dryRun || requiredPropertySlots.length > 0
+    const requiredProperties = readRequiredAnalyticsPropertiesFromSpec(spec);
+    const credentials = !command.dryRun || requiredProperties.length > 0
         ? await resolveAnalyticsCredentials(command, runtime)
         : null;
-    const propertySlots = credentials
-        ? await ensureAnalyticsPropertySlots({
+    const properties = credentials
+        ? await ensureAnalyticsProperties({
             command,
             credentials,
             runtime,
-            requirements: requiredPropertySlots,
+            requirements: requiredProperties,
             dryRun: command.dryRun,
         })
         : [];
@@ -6510,7 +6372,7 @@ async function runAnalyticsChartsCreate(command, io, runtime) {
             ok: true,
             dryRun: true,
             artifactId: command.artifactId,
-            propertySlots,
+            properties,
             request: body,
         };
         printAnalyticsPayload(command, io, payload, [
@@ -6533,10 +6395,10 @@ async function runAnalyticsChartsCreate(command, io, runtime) {
         fetcher: runtime.fetcher ?? fetch,
         body,
     });
-    printAnalyticsPayload(command, io, { ...payload, propertySlots }, [
+    printAnalyticsPayload(command, io, { ...payload, properties }, [
         `app_id: ${command.artifactId}`,
         `chart_id: ${String(payload.chart?.id ?? "")}`,
-        `property_slots: ${propertySlots.length}`,
+        `properties: ${properties.length}`,
     ]);
     return 0;
 }
@@ -6583,11 +6445,11 @@ async function runAnalyticsChartsUpdate(command, io, runtime) {
         spec,
         layout: readAnalyticsChartLayout(existing.chart),
     };
-    const propertySlots = await ensureAnalyticsPropertySlots({
+    const properties = await ensureAnalyticsProperties({
         command,
         credentials,
         runtime,
-        requirements: readRequiredAnalyticsPropertySlotsFromSpec(spec),
+        requirements: readRequiredAnalyticsPropertiesFromSpec(spec),
         dryRun: command.dryRun,
     });
     const dashboardId = readCliStringField(existing.dashboard, "id");
@@ -6599,7 +6461,7 @@ async function runAnalyticsChartsUpdate(command, io, runtime) {
             chartId: command.chartId,
             dashboardId,
             currentChart: existing.chart,
-            propertySlots,
+            properties,
             request: body,
         }, [
             `app_id: ${command.artifactId}`,
@@ -6619,11 +6481,11 @@ async function runAnalyticsChartsUpdate(command, io, runtime) {
         fetcher: runtime.fetcher ?? fetch,
         body,
     });
-    printAnalyticsPayload(command, io, { ...payload, propertySlots }, [
+    printAnalyticsPayload(command, io, { ...payload, properties }, [
         `app_id: ${command.artifactId}`,
         `chart_id: ${command.chartId}`,
         `title: ${String(payload.chart?.title ?? title)}`,
-        `property_slots: ${propertySlots.length}`,
+        `properties: ${properties.length}`,
     ]);
     return 0;
 }
@@ -6792,11 +6654,11 @@ export async function runTenderCli(args, io = {
             else if (command.topic === "app analytics charts delete") {
                 io.stdout(analyticsChartsDeleteHelp());
             }
-            else if (command.topic === "app analytics property-slots list") {
-                io.stdout(analyticsPropertySlotsListHelp());
+            else if (command.topic === "app analytics properties list") {
+                io.stdout(analyticsPropertiesListHelp());
             }
-            else if (command.topic === "app analytics property-slots activate") {
-                io.stdout(analyticsPropertySlotsActivateHelp());
+            else if (command.topic === "app analytics properties activate") {
+                io.stdout(analyticsPropertiesActivateHelp());
             }
             else if (command.topic === "app") {
                 io.stdout(appHelp());
@@ -6908,11 +6770,11 @@ export async function runTenderCli(args, io = {
         if (command.command === "app analytics charts delete") {
             return await runAnalyticsChartsDelete(command, io, runtime);
         }
-        if (command.command === "app analytics property-slots list") {
-            return await runAnalyticsPropertySlotsList(command, io, runtime);
+        if (command.command === "app analytics properties list") {
+            return await runAnalyticsPropertiesList(command, io, runtime);
         }
-        if (command.command === "app analytics property-slots activate") {
-            return await runAnalyticsPropertySlotsActivate(command, io, runtime);
+        if (command.command === "app analytics properties activate") {
+            return await runAnalyticsPropertiesActivate(command, io, runtime);
         }
         if (command.command === "app git remote") {
             return await runGitRemote(command, io, runtime);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tenderprompt/cli",
-	"version": "0.1.11",
+	"version": "0.1.12",
 	"type": "module",
 	"bin": {
 		"tender": "bin/tender.js"