@configdirector/cli 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@configdirector/cli` are documented here. The format fol
 
 ## [Unreleased]
 
+## [0.18.0] - 2026-11-03
+
+### Changed
+
+- `configdirector configs get`, `evaluate` and `configs create` name an experiment's variations wherever they show one of its values, with the value after the name, as in `40% get control (Start free trial), 60% get treatment-a (Try it free for 14 days)` and `Default targeting rule: control (Start free trial)`. `evaluate` names the variation it served too, as in `treatment-a (Try it free for 14 days), served by rule 2`. A variation without a name, and a config without variations, show the value alone, as before. `--json` prints the Admin API's response as received, which now carries the id of each value's variation.
+
 ## [0.17.0] - 2026-11-01
 
 ### Added

package/README.md

@@ -211,6 +211,8 @@ production (live)
   Default targeting rule: false
 ```
 
+On an experiment, each value comes after the name of its variation, as in `40% get control (Start free trial), 60% get treatment-a (Try it free for 14 days)`. `evaluate` names the variation it served the same way, as in `treatment-a (Try it free for 14 days), served by rule 2`, and `configs create` names the variation of the default targeting rule value it starts with.
+
 `projects list`, `environments list`, `configs list`, `configs activity` and `segments list` print a header row that names their columns above their lines, such as `KEY   TYPE   ROLE   LIFETIME   STATE` for `configs list`, and `--no-headers` leaves it out. An empty list prints only a sentence, such as `No configs found in web-app.`
 
 With `--json`, each prints the Admin API's response as received, except `configs list --state`, which prints only the configs in that state. A key no config or segment has exits with 2.

package/dist/configdirector.mjs

@@ -12,7 +12,7 @@ import { promisify } from "node:util";
 import { randomUUID } from "node:crypto";
 import { text } from "node:stream/consumers";
 //#region package.json
-var version = "0.17.0";
+var version = "0.18.0";
 //#endregion
 //#region src/CliError.ts
 var CliError = class extends Error {
@@ -154,14 +154,16 @@ const ConditionSchema = v.variant("kind", [v.object({
 }), SegmentConditionSchema]);
 const PercentageSchema = v.object({
 	percentage: v.number(),
-	value: RuleValueSchema
+	value: RuleValueSchema,
+	variationId: v.optional(v.string())
 });
 const RuleSchema = v.variant("type", [v.variant("target", [v.object({
 	id: v.string(),
 	type: v.literal("conditional"),
 	conditions: v.array(ConditionSchema),
 	target: v.literal("value"),
-	value: RuleValueSchema
+	value: RuleValueSchema,
+	variationId: v.optional(v.string())
 }), v.object({
 	id: v.string(),
 	type: v.literal("conditional"),
@@ -174,6 +176,12 @@ const RuleSchema = v.variant("type", [v.variant("target", [v.object({
 	percentages: v.array(PercentageSchema)
 })]);
 //#endregion
+//#region src/admin-api/variations.ts
+const VariationSchema = v.object({
+	id: v.string(),
+	name: v.nullish(v.string())
+});
+//#endregion
 //#region src/admin-api/config-with-targeting-rules.ts
 const TargetingRulesInEnvironmentSchema = v.object({
 	environment: v.object({
@@ -181,7 +189,8 @@ const TargetingRulesInEnvironmentSchema = v.object({
 		live: v.boolean()
 	}),
 	rules: v.array(RuleSchema),
-	defaultValue: v.string()
+	defaultValue: v.string(),
+	defaultVariationId: v.optional(v.string())
 });
 const NumericBoundSchema = v.object({
 	relation: v.string(),
@@ -239,6 +248,7 @@ const ConfigWithTargetingRulesSchema = v.intersect([v.object({
 	client: v.boolean(),
 	server: v.boolean(),
 	tags: v.array(v.object({ name: v.string() })),
+	variations: v.array(VariationSchema),
 	targets: v.array(TargetingRulesInEnvironmentSchema)
 }), ConfigTypeSchema]);
 //#endregion
@@ -348,6 +358,7 @@ const ConfigEvaluationSchema = v.object({
 		identifier: v.nullable(v.string())
 	})),
 	value: v.optional(v.string()),
+	variationId: v.optional(v.string()),
 	servedBy: v.variant("kind", [v.object({
 		kind: v.literal("rule"),
 		ruleId: v.string()
@@ -355,9 +366,11 @@ const ConfigEvaluationSchema = v.object({
 	rules: v.array(RuleExplanationSchema),
 	targetingRules: v.object({
 		rules: v.array(RuleSchema),
-		defaultValue: v.string()
+		defaultValue: v.string(),
+		defaultVariationId: v.optional(v.string())
 	}),
-	segments: v.record(v.string(), v.object({ name: v.string() }))
+	segments: v.record(v.string(), v.object({ name: v.string() })),
+	variations: v.optional(v.array(VariationSchema), [])
 });
 //#endregion
 //#region src/admin-api/AdminApiClient.ts
@@ -961,10 +974,12 @@ const describeCondition = (condition, segments) => {
 		case "segment": return `${condition.operator} segment ${segmentNameOf(condition.segmentId, segments)}`;
 	}
 };
-const describePercentages = (percentages) => percentages.map((percentage) => `${formatPercentage(percentage.percentage)}% get ${String(percentage.value)}`).join(", ");
-const describeRule = (rule, segments) => {
-	if (rule.type === "percentage") return describePercentages(rule.percentages);
-	return `${rule.conditions.map((condition) => describeCondition(condition, segments)).join(" and ")}: ${rule.target === "value" ? String(rule.value) : describePercentages(rule.percentages)}`;
+const valueWithVariationName = (value, variationName) => variationName ? `${variationName} (${String(value)})` : String(value);
+const describeValue = (value, variationId, variations) => valueWithVariationName(value, variations.find((variation) => variation.id === variationId)?.name);
+const describePercentages = (percentages, variations) => percentages.map((percentage) => `${formatPercentage(percentage.percentage)}% get ${describeValue(percentage.value, percentage.variationId, variations)}`).join(", ");
+const describeRule = (rule, segments, variations) => {
+	if (rule.type === "percentage") return describePercentages(rule.percentages, variations);
+	return `${rule.conditions.map((condition) => describeCondition(condition, segments)).join(" and ")}: ${rule.target === "value" ? describeValue(rule.value, rule.variationId, variations) : describePercentages(rule.percentages, variations)}`;
 };
 //#endregion
 //#region src/configs/config-text.ts
@@ -1001,16 +1016,16 @@ const settingLines = (config) => [
 	...config.tags.length === 0 ? [] : [`Tags: ${config.tags.map((tag) => tag.name).join(", ")}`]
 ];
 const environmentLabel = (environment) => environment.live ? `${environment.slug} (live)` : environment.slug;
-const targetingRuleLines = (targetingRules, segments) => [
+const targetingRuleLines = (targetingRules, segments, variations) => [
 	environmentLabel(targetingRules.environment),
-	...targetingRules.rules.map((rule, index) => `  ${index + 1}. ${describeRule(rule, segments)}`),
-	`  Default targeting rule: ${targetingRules.defaultValue}`
+	...targetingRules.rules.map((rule, index) => `  ${index + 1}. ${describeRule(rule, segments, variations)}`),
+	`  Default targeting rule: ${describeValue(targetingRules.defaultValue, targetingRules.defaultVariationId, variations)}`
 ];
 const configText = (config, requestedKey, segments) => [
 	...oldKeyLines(requestedKey, config.key),
 	config.key,
 	...settingLines(config).map((line) => `  ${line}`),
-	...config.targets.flatMap((targetingRules) => ["", ...targetingRuleLines(targetingRules, segments)]),
+	...config.targets.flatMap((targetingRules) => ["", ...targetingRuleLines(targetingRules, segments, config.variations)]),
 	""
 ].join("\n");
 //#endregion
@@ -1464,6 +1479,10 @@ const getConfig = async (context, [configKey]) => {
 		exitCode: ExitCode.success
 	};
 };
+const defaultValueDescription = (newConfig) => {
+	const defaultVariation = newConfig.variations.find((variation) => variation.value === newConfig.defaultValue);
+	return valueWithVariationName(newConfig.defaultValue, defaultVariation?.name);
+};
 const createdConfigLines = (projectSlug, createdConfig, newConfig) => {
 	const settings = [
 		createdConfig.type,
@@ -1471,7 +1490,7 @@ const createdConfigLines = (projectSlug, createdConfig, newConfig) => {
 		createdConfig.lifetime,
 		availabilityDescription(createdConfig)
 	];
-	return [`Created ${createdConfig.key} in ${projectSlug}: ${settings.join(", ")}.`, `Default targeting rule in every environment: ${String(newConfig.defaultValue)}`];
+	return [`Created ${createdConfig.key} in ${projectSlug}: ${settings.join(", ")}.`, `Default targeting rule in every environment: ${defaultValueDescription(newConfig)}`];
 };
 const keyTakenLines = (projectSlug, configKey, existingConfig) => [`${projectSlug} already has a config with the key ${configKey}, so no config was created:`, ...alignedColumns([summaryColumnsOf(existingConfig)])];
 const rejectsKey = (error) => error instanceof ApiValidationError && error.fieldErrors.some((fieldError) => fieldError.name === "key");
@@ -1766,6 +1785,7 @@ const contextDescription = (evaluation, contextForm) => {
 	const identity = `${evaluatedContext.kind} ${evaluatedContext.identifier}`;
 	return contextForm.form === "saved" ? `saved context ${identity}` : identity;
 };
+const servedValueDescription = (evaluation) => evaluation.value === void 0 ? "no value" : describeValue(evaluation.value, evaluation.variationId, evaluation.variations);
 const servedByDescription = (evaluation) => {
 	const { servedBy } = evaluation;
 	switch (servedBy.kind) {
@@ -1813,17 +1833,17 @@ const ruleLines = (evaluation) => {
 	const rulesById = new Map(evaluation.targetingRules.rules.map((rule) => [rule.id, rule]));
 	return alignedColumns(evaluation.rules.map((explanation, index) => {
 		const rule = rulesById.get(explanation.ruleId);
-		return [`${index + 1}. ${rule === void 0 ? explanation.ruleId : describeRule(rule, evaluation.segments)}`, RULE_OUTCOME_DESCRIPTIONS[explanation.outcome](explanation, conditionsOf(rule), evaluation.segments)];
+		return [`${index + 1}. ${rule === void 0 ? explanation.ruleId : describeRule(rule, evaluation.segments, evaluation.variations)}`, RULE_OUTCOME_DESCRIPTIONS[explanation.outcome](explanation, conditionsOf(rule), evaluation.segments)];
 	}));
 };
 const evaluationText = (evaluation, requested) => [
 	...oldKeyLines(requested.configKey, evaluation.key),
 	`${evaluation.key} in ${evaluation.environment.name} for ${contextDescription(evaluation, requested.contextForm)}`,
 	"",
-	`${evaluation.value ?? "no value"}, ${servedByDescription(evaluation)}`,
+	`${servedValueDescription(evaluation)}, ${servedByDescription(evaluation)}`,
 	"",
 	...ruleLines(evaluation),
-	`Default targeting rule: ${evaluation.targetingRules.defaultValue}`,
+	`Default targeting rule: ${describeValue(evaluation.targetingRules.defaultValue, evaluation.targetingRules.defaultVariationId, evaluation.variations)}`,
 	""
 ].join("\n");
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@configdirector/cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Command line tool for ConfigDirector, the managed configuration and feature flag service.",
   "license": "MIT",
   "author": "ConfigDirector",