@configdirector/cli 0.19.0 → 0.20.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@configdirector/cli` are documented here. The format fol
 
 ## [Unreleased]
 
+## [0.20.0] - 2026-11-06
+
+### Changed
+
+- `configdirector evaluate` says when a percentage rollout was skipped because the context has no identifier. The rule's line ends with `rollout skipped: the context has no identifier`, where it showed `not matched` with no reason, both for a percentage rule and for a conditional rule that serves a percentage rollout once its conditions matched. The rules after it show `not evaluated` and the context gets the default targeting rule value, as before. `--json` prints the Admin API's response as received, as before.
+
 ## [0.19.0] - 2026-11-04
 
 ### Added

package/README.md

@@ -159,7 +159,7 @@ true, served by rule 2
 Default targeting rule: false
 ```
 
-A rule that did not match names the first condition that failed and the context's value for it, as in `plan is one of pro, team, but it is "free"`, or the bucket a percentage rollout put the context in. A rule after the one that served the value is not evaluated, and a rule that could not be evaluated is shown as errored.
+A rule that did not match names the first condition that failed and the context's value for it, as in `plan is one of pro, team, but it is "free"`, or the bucket a percentage rollout put the context in. A context without an identifier gets no bucket: the first percentage rollout it reaches shows `rollout skipped: the context has no identifier`, and the context gets the default targeting rule value. A rule after the one that served the value, or after a skipped rollout, is not evaluated, and a rule that could not be evaluated is shown as errored.
 
 `--environment` takes the environment's slug and is required. Give the context one of three ways:
 

package/dist/configdirector.mjs

@@ -14,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.19.0";
+var version = "0.20.0";
 //#endregion
 //#region src/CliError.ts
 var CliError = class extends Error {
@@ -399,7 +399,6 @@ const ConditionExplanationSchema = v.union([
 	SegmentConditionExplanationSchema
 ]);
 const BucketSchema = v.object({
-	defaultedToPredefinedBucket: v.boolean(),
 	assignedPercentage: v.number(),
 	shares: v.array(v.object({
 		percentageId: v.string(),
@@ -417,7 +416,8 @@ const RuleExplanationSchema = v.object({
 		"errored"
 	]),
 	conditions: v.array(ConditionExplanationSchema),
-	bucket: v.optional(BucketSchema)
+	bucket: v.optional(BucketSchema),
+	rolloutSkippedNoIdentifier: v.boolean()
 });
 const ConfigEvaluationSchema = v.object({
 	key: v.string(),
@@ -2009,8 +2009,7 @@ const bucketPlacement = (bucket) => {
 	if (selectedShare !== void 0) return `${assigned} is in ${describeShareRange(selectedShare.from, selectedShare.to)}`;
 	return `${assigned} is outside ${describeShareRange(0, bucket.shares.at(-1)?.to ?? 0)}`;
 };
-const describeBucket = (bucket) => bucket.defaultedToPredefinedBucket ? `no identifier, so ${bucketPlacement(bucket)}` : bucketPlacement(bucket);
-const withBucket = (outcome, bucket) => bucket === void 0 ? outcome : `${outcome}: ${describeBucket(bucket)}`;
+const withBucket = (outcome, bucket) => bucket === void 0 ? outcome : `${outcome}: ${bucketPlacement(bucket)}`;
 const conditionsOf = (rule) => rule?.type === "conditional" ? rule.conditions : [];
 const segmentMismatchEvidence = (explanation) => {
 	if (!explanation.segmentFound) return "the segment was not found";
@@ -2032,17 +2031,19 @@ const describeNotMatched = (explanation, conditions, segments) => {
 	const failingCondition = failingConditionDescription(explanation, conditions, segments);
 	return failingCondition === void 0 ? withBucket("not matched", explanation.bucket) : `not matched: ${failingCondition}`;
 };
+const evaluatorRuleOutcomeOf = (explanation) => explanation.rolloutSkippedNoIdentifier ? "rollout-skipped-no-identifier" : explanation.outcome;
 const RULE_OUTCOME_DESCRIPTIONS = {
 	matched: (explanation) => withBucket("matched", explanation.bucket),
 	"not-matched": describeNotMatched,
 	"not-evaluated": () => "not evaluated",
-	errored: () => "errored"
+	errored: () => "errored",
+	"rollout-skipped-no-identifier": () => "rollout skipped: the context has no identifier"
 };
 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, evaluation.variations)}`, 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[evaluatorRuleOutcomeOf(explanation)](explanation, conditionsOf(rule), evaluation.segments)];
 	}));
 };
 const evaluationText = (evaluation, requested) => [

package/package.json

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