@configdirector/cli 0.17.0 → 0.18.1

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `@configdirector/cli` are documented here. The format fol
 
 ## [Unreleased]
 
+## [0.18.1] - 2026-11-03
+
+### Fixed
+
+- Commands no longer fail with `Could not reach the Admin API` when opening a connection takes longer than a quarter of a second, as it sometimes does on GitHub-hosted runners, which find the Admin API's IPv6 addresses but cannot reach them. Each of the Admin API's addresses now gets two seconds to connect before the CLI tries the next.
+- When none of the Admin API's addresses can be reached, `Could not reach the Admin API` says why each one failed, where it showed empty brackets.
+- Commands no longer fail the first time the network drops a connection to the Admin API. When a connection cannot be opened, the CLI tries again up to twice, half a second and then a second later. When the network breaks a connection after a request went out, it tries again only for requests that read, replace or delete; the others, such as `configs create`, still exit with 2, because ConfigDirector may already have received them.
+
+## [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

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
+import { setDefaultAutoSelectFamilyAttemptTimeout } from "node:net";
 import { homedir } from "node:os";
 import { Command, CommanderError, Option } from "commander";
+import { setTimeout } from "node:timers/promises";
 import * as v from "valibot";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { mkdir, open, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
@@ -12,7 +14,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.1";
 //#endregion
 //#region src/CliError.ts
 var CliError = class extends Error {
@@ -84,9 +86,11 @@ var ServiceSuspendedError = class extends CliError {
 		super(`Your organization's service is suspended, so ConfigDirector refuses Admin API requests. The dashboard's billing page shows why and how to reinstate it. Retry after ${retryAfterSeconds} seconds.`);
 	}
 };
+const messageOf = (failure) => failure instanceof Error ? failure.message : String(failure);
+const connectionFailureReasonOf = (failure) => failure instanceof AggregateError ? failure.errors.map(messageOf).join("; ") : failure.message;
 var ApiUnreachableError = class extends CliError {
 	constructor(baseUrl, cause) {
-		const reason = cause instanceof Error && cause.cause instanceof Error ? cause.cause.message : String(cause);
+		const reason = cause instanceof Error && cause.cause instanceof Error ? connectionFailureReasonOf(cause.cause) : String(cause);
 		super(`Could not reach the Admin API at ${baseUrl} (${reason}). Check the network connection, --base-url or CONFIGDIRECTOR_BASE_URL.`);
 	}
 };
@@ -127,6 +131,40 @@ const CreatedConfigSchema = v.object({
 	server: v.boolean()
 });
 //#endregion
+//#region src/admin-api/connection-failure-retry.ts
+const millisecondsBeforeEachRetry = [500, 1e3];
+const repeatableMethods = new Set([
+	"GET",
+	"PUT",
+	"DELETE"
+]);
+const retriesAfter = {
+	"never-opened": () => true,
+	dropped: (method) => repeatableMethods.has(method),
+	"not-transient": () => false
+};
+const neverOpenedCodes = new Set(["UND_ERR_CONNECT_TIMEOUT", "EAI_AGAIN"]);
+const droppedCodes = new Set([
+	"ECONNRESET",
+	"EPIPE",
+	"UND_ERR_SOCKET"
+]);
+const connectionFailureOf = (failure) => {
+	const cause = failure instanceof Error ? failure.cause : void 0;
+	if (cause instanceof AggregateError) return "never-opened";
+	if (!(cause instanceof Error)) return "not-transient";
+	const { code = "", syscall } = cause;
+	if (syscall === "connect" || neverOpenedCodes.has(code)) return "never-opened";
+	return droppedCodes.has(code) ? "dropped" : "not-transient";
+};
+const retryDecisionAfter = (method, failure, attemptsMade) => {
+	const waitMilliseconds = millisecondsBeforeEachRetry[attemptsMade - 1];
+	return waitMilliseconds !== void 0 && retriesAfter[connectionFailureOf(failure)](method) ? {
+		decision: "retry",
+		waitMilliseconds
+	} : { decision: "give-up" };
+};
+//#endregion
 //#region src/admin-api/targeting-rules.ts
 const RuleValueSchema = v.union([
 	v.string(),
@@ -154,14 +192,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 +214,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 +227,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 +286,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 +396,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 +404,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
@@ -606,20 +657,25 @@ var AdminApiClient = class {
 			"User-Agent": `configdirector-cli/${version}`,
 			"X-SourceClient": "cli"
 		};
-		try {
-			return await fetch(url, "body" in request ? {
-				method: request.method,
-				headers: {
-					...headers,
-					"Content-Type": "application/json"
-				},
-				body: JSON.stringify(request.body)
-			} : {
-				method: request.method,
-				headers
-			});
-		} catch (error) {
-			throw new ApiUnreachableError(this.connection.baseUrl, error);
+		const requestInit = "body" in request ? {
+			method: request.method,
+			headers: {
+				...headers,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(request.body)
+		} : {
+			method: request.method,
+			headers
+		};
+		for (let attemptsMade = 1;; attemptsMade += 1) try {
+			return await fetch(url, requestInit);
+		} catch (failure) {
+			const retry = retryDecisionAfter(request.method, failure, attemptsMade);
+			switch (retry.decision) {
+				case "give-up": throw new ApiUnreachableError(this.connection.baseUrl, failure);
+				case "retry": await setTimeout(retry.waitMilliseconds);
+			}
 		}
 	}
 };
@@ -961,10 +1017,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 +1059,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 +1522,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 +1533,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 +1828,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 +1876,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
@@ -5223,6 +5286,7 @@ const run = async (invocation) => {
 };
 //#endregion
 //#region src/main.ts
+setDefaultAutoSelectFamilyAttemptTimeout(2e3);
 process.exitCode = await run({
 	commandLineArguments: process.argv.slice(2),
 	environmentVariables: process.env,

package/package.json

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