@go-to-k/cdkd 0.289.4 → 0.289.6

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as isVersionOnlyInvocation, t as getCdkdVersion } from "./version-C3wRsCF2.js";
+import { n as isVersionOnlyInvocation, t as getCdkdVersion } from "./version-DCxqZhgp.js";
 
 //#region src/cli/pipe-close-handler.ts
 /**
@@ -74,7 +74,7 @@ async function main() {
 		console.log(getCdkdVersion());
 		return;
 	}
-	const { buildProgram } = await import("./program-CyIOIvtX.js");
+	const { buildProgram } = await import("./program-B3I46yaG.js");
 	const program = buildProgram();
 	const args = reorderArgs(process.argv);
 	await program.parseAsync(args);

package/dist/{deploy-engine-BEpYvI14.js → deploy-engine-CpmvgRtm.js}

@@ -1,6 +1,6 @@
-import { d as applyDefaultNameForFallback, f as explicitNamePropertyFor, g as looksLikeCdkdGeneratedName, h as getCurrentStackName, m as generateResourceNameWithFallback, n as getLogger, p as generateResourceName, r as isStdoutReservedForPayload, s as getLiveRenderer, v as withStackName, y as displaySafe } from "./logger-CecsQ1UT.js";
+import { d as applyDefaultNameForFallback, f as explicitNamePropertyFor, g as looksLikeCdkdGeneratedName, h as getCurrentStackName, m as generateResourceNameWithFallback, n as getLogger, p as generateResourceName, r as isStdoutReservedForPayload, s as getLiveRenderer, v as withStackName, y as displaySafe } from "./logger-BK-B0slT.js";
 import { t as awsClientDefaults } from "./aws-client-defaults-D-iYiIJ6.js";
-import { t as getCdkdVersion } from "./version-C3wRsCF2.js";
+import { t as getCdkdVersion } from "./version-DCxqZhgp.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { createHash, randomUUID } from "node:crypto";
 import { CreateBucketCommand, DeleteObjectCommand, DeleteObjectsCommand, GetBucketLocationCommand, GetBucketReplicationCommand, GetObjectCommand, HeadBucketCommand, HeadObjectCommand, ListObjectVersionsCommand, ListObjectsV2Command, NoSuchKey, PutBucketEncryptionCommand, PutBucketPolicyCommand, PutObjectCommand, PutPublicAccessBlockCommand, S3Client, S3ServiceException } from "@aws-sdk/client-s3";
@@ -10286,17 +10286,23 @@ var S3StateBackend = class {
 	* silently lose data on the next save.
 	*/
 	parseStateBody(bodyString, stackName) {
-		let parsed;
+		let root;
 		try {
-			parsed = JSON.parse(bodyString);
+			root = JSON.parse(bodyString);
 		} catch (error) {
 			const raw = error instanceof Error ? error.message : String(error);
 			const detail = displaySafe(raw, { asciiOnly: true }) || "<unrenderable>";
 			throw new StateError(`State file for stack '${this.displayName(stackName)}' is not valid JSON: ${detail}`, error instanceof Error ? error : void 0);
 		}
+		if (root === null || typeof root !== "object" || Array.isArray(root)) {
+			const got = root === null ? "null" : Array.isArray(root) ? "an array" : `a ${typeof root}`;
+			throw new StateError(`State file for stack '${this.displayName(stackName)}' is not a JSON object (it parses to ${got}), so cdkd cannot read it as a state record.`);
+		}
+		const parsed = root;
 		const v = parsed.version;
 		if (v !== void 0 && !STATE_SCHEMA_VERSIONS_READABLE.includes(v)) {
-			const shown = displaySafe(String(v), { asciiOnly: true }) || "<unrenderable>";
+			const vShown = v;
+			const shown = displaySafe(vShown === null ? "null" : vShown, { asciiOnly: true }) || "<unrenderable>";
 			throw new StateError(`Unsupported state schema version ${shown} for stack '${this.displayName(stackName)}'. This cdkd binary supports versions ${STATE_SCHEMA_VERSIONS_READABLE.join(", ")}. Upgrade cdkd to a version that supports schema ${shown}.`);
 		}
 		return parsed;
@@ -10624,7 +10630,8 @@ var LockManager = class {
 			const lockInfo = {
 				...parsed,
 				owner: displaySafe(parsed.owner),
-				...parsed.operation !== void 0 && { operation: displaySafe(parsed.operation) }
+				...parsed.operation !== void 0 && { operation: displaySafe(parsed.operation) },
+				expiresAt: nanIfUncoercible(parsed.expiresAt)
 			};
 			this.logger.debug(`Lock info for stack: ${shownStack}:`, lockInfo);
 			return {
@@ -11150,6 +11157,21 @@ var LockManager = class {
 		throw new LockError(`Failed to acquire lock for stack '${safeStack}' (${safeRegion}) after ${maxRetries + 1} attempts. ` + (lockInfo ? `Locked by: ${lockInfo.owner}${lockInfo.operation ? `, operation: ${lockInfo.operation}` : ""}, expires in: ${expiresIn}. ` + recovery : `Lock exists but could not read lock info. ${recovery}`));
 	}
 };
+/**
+* `value` itself, unless coercing it to a number THROWS — then `NaN`.
+*
+* Deliberately not a conversion: see the `expiresAt` note in `getLockRecord`.
+* The call is the probe — `Number` throws on exactly the values the readers'
+* arithmetic would throw on, and on nothing else.
+*/
+function nanIfUncoercible(value) {
+	try {
+		Number(value);
+		return value;
+	} catch {
+		return NaN;
+	}
+}
 
 //#endregion
 //#region src/deployment/secret-redaction.ts
@@ -11279,7 +11301,8 @@ function resolvedExpressionsOf(secrets) {
 * for the object it is handed. A copy of the bag, a derived needle map, a
 * previous generation's record, a scrub / drift walk and a bag nobody marked
 * all answer `false` and keep the fall-through. `cdkd import` marks the one
-* bag its own resolver produced (the sixth site below, issue #2745).
+* bag its own resolver produced (the sixth site below, issue #2745), and the
+* nested-stack recorder marks the COPY it positions (the seventh, same issue).
 *
 * A `WeakSet` for the reason {@link resolvedPairsOf} is a `WeakMap`: the mark
 * dies with the object it is on, and nothing has to clear it.
@@ -11314,9 +11337,9 @@ const sameGenerationBags = /* @__PURE__ */ new WeakSet();
 * and may skip it entirely. "Every leaf this pass produced" is false for the
 * auto-refresh readback of an UNCHANGED resource, where nothing was resolved
 * at all — there the safety comes from the empty secrets map, not from the
-* mark. Read the per-site list below rather than a rule over all six.
+* mark. Read the per-site list below rather than a rule over all seven.
 *
-* The six call sites, and which of them the record HOLDS, because the earlier
+* The seven call sites, and which of them the record HOLDS, because the earlier
 * "two never-installed copies" reading of this paragraph was false once the
 * third copy arrived:
 * - `propertiesToRecord` — the record's `properties`, installed. The resolved
@@ -11361,6 +11384,20 @@ const sameGenerationBags = /* @__PURE__ */ new WeakSet();
 *   it does NOT claim is that AWS holds the value: `observedProperties` is
 *   captured separately, against the redacted record, and is never marked
 *   here.
+* - `recordNestedStackParameterExpressions` (issue #2745) — a shallow COPY of
+*   a nested-stack row's resolved `Parameters` sub-bag, marked as the
+*   position pass's input so a sub-floor middle a literal frame embeds is
+*   written as its token there, which is what the recorder's sub-floor
+*   carry reads. NOT installed: the caller's own object is untouched, and
+*   whether THAT gets marked is decided at the caller (the deploy engine's
+*   two sites mark it later, in `propertiesToRecord`; the replay's three
+*   never do). Pair provenance holds at all five callers: the engine's two
+*   resolve the row in the pass that recorded the pairs, and the replay's
+*   three hand it the bag `resolveReplayProps` filled through
+*   `recordResolvedPair` from the journal rows it resolved just before -- the
+*   desired row, and on the update and failed-op arms the current or
+*   attempted row as well -- all within one replay, so every pair in it is
+*   that pass's own.
 */
 function markSameGenerationBag(bag) {
 	sameGenerationBags.add(bag);
@@ -11691,6 +11728,21 @@ function substringNeedlesOf(secrets) {
 * documented as "the expressions this pass recorded" must not silently contain
 * something that is not one: the day a candidate test stops requiring token
 * SHAPE, the sentinel would be live in it.
+*
+* A SECOND non-token class passes the filter, and is meant to: the FRAMED
+* whole-value entry `recordNestedStackParameterExpressions` writes for a
+* sub-floor carry (issue #2745) has a `port:{{resolve:...}}` value. It
+* enters the skeleton and frame candidate unions. The frame pattern is
+* anchored to the source's token and cannot match it; the SKELETON pattern of
+* an `Fn::Join` / `Fn::Sub` spelling the same frame around the same token
+* CAN, and then names that leaf's own frame around this pass's token -- the
+* correct expression for it, and one `isKnownSecretExpression` reads as
+* secret anyway, since the value is a map entry. What it DOES cost is the
+* length cap -- a framed value longer than
+* `MAX_SKELETON_CANDIDATE_LENGTH` makes both intrinsic arms refuse every
+* INTRINSIC-sourced leaf of the resource whose bag holds it; a literal-source
+* leaf keeps the span arm, which reads no candidate list (the recorder's doc
+* lists it).
 */
 function recordedExpressionsOf(secrets) {
 	const expressions = /* @__PURE__ */ new Set();
@@ -12060,6 +12112,14 @@ const NESTED_STACK_RESOURCE_TYPE$2 = "AWS::CloudFormation::Stack";
 */
 const nestedStackParameterExpressions = /* @__PURE__ */ new WeakMap();
 /**
+* Condition (iv)'s key (see {@link recordNestedStackParameterExpressions}) for
+* a `Parameters` spelling that is not a single-span literal frame of its
+* resolved value carrying this pass's pair for its token: an object source, a
+* plain literal, a two-span literal, a bag equal to its source, and a frame
+* whose token this pass never resolved to the middle (a PUBLIC sibling).
+*/
+const UNFRAMED_SPELLING = Symbol("cdkd.nested-parameter.unframed-spelling");
+/**
 * Record, for the pass that owns `secrets`, which `{{resolve:...}}` expression
 * each `Parameters` entry of a nested-stack row was resolved FROM (issue
 * #2291). No-op for every other resource type.
@@ -12133,6 +12193,127 @@ const nestedStackParameterExpressions = /* @__PURE__ */ new WeakMap();
 *    `return source`, which is the same string again), so both callers reach it.
 *    Fenced by the self-referential case in
 *    `secret-redaction-nested-parameter-source.test.ts`.
+*
+* THE SUB-FLOOR CARRY (issue #2745, its nested-stack site). A parameter the
+* parent spelled as a LITERAL frame around one token -- `Pin:
+* 'port:{{resolve:secretsmanager:S:SecretString:pin::}}'` -- resolves to
+* `port:q7`: not a key of the map (refusal 1), with a middle below
+* `MIN_NEEDLE_LENGTH`, so the child's carry (`inheritedSecretsCarriedBy`:
+* whole value at any length, substring at or above the floor) misses it both
+* ways and the child persisted `port:q7`. This recorder is the only point
+* holding the literal frame beside the pair, so the carry is written HERE:
+* the position pass runs over a MARKED shallow copy, on which
+* {@link positionByEmbeddedSpan} writes the frame on pair evidence, and a
+* second walk records `resolvedValue -> sourceLeaf`
+* (`'port:q7' -> 'port:{{resolve:...}}'`) as an ordinary WHOLE-VALUE entry of
+* the parent's own bag, under five conditions:
+*
+*   (i)   `positioned[name] === sourceLeaf` -- the pass CERTIFIED the leaf.
+*         On a literal source the span arm returns the source verbatim, so a
+*         mismatch proves it did not fire -- refusal 2b's test, applied to
+*         a literal source; pinned by the "map NO RESOLVER populated" case,
+*         where (ii) and (iii) both pass and only the missing pair refuses.
+*   (ii)  `redactSecretsForState(resolvedValue, secrets) === resolvedValue`
+*         -- the value scan is SILENT on it: the sub-floor gate, byte-for-byte
+*         the bound the span arm accepted. What it refuses is a middle at or
+*         above the floor, whose substring carry the child already has (the
+*         only refusal a test can see: the others coincide with (i) or with
+*         the map's own entry, as a whole-token source's would).
+*   (iii) `secrets.get(middle) === token` -- the token IS the map's survivor
+*         for the middle. Load-bearing: two framed parameters over ONE middle
+*         (`pin::` and `pin:AWSCURRENT:`) keep their own tokens on this row's
+*         record today because each reaches the span arm with the scan
+*         silent; once a `'port:q7'` entry exists the scan answers for the
+*         whole leaf and the arm's bound (`scanned === prefix + survivor +
+*         suffix`) decides. Recording only the frame whose token is the
+*         middle's survivor makes every parent leaf keep its own token by
+*         construction rather than by recording order.
+*   (iv)  ONE FRAME per VALUE, across the whole row. Once the entry exists
+*         the scan is no longer silent on the value, so on the parent's
+*         record every leaf holding it answers against the entry through the
+*         span arm's bound (`scanned === prefix + survivor + suffix`). The
+*         SAME frame around another token -- the (iii) shape, `port:` + A
+*         beside `port:` + B -- passes that bound and keeps its own token. A
+*         DIFFERENT frame (`port:` + `q7` beside `port` + `:q7`, each passing
+*         (i)-(iii) on its own), a leaf (iii) refused under a different
+*         frame, an object spelling and a plain literal equal to the value
+*         all fail it and would take the entry's frame -- and so would a
+*         same-frame sibling whose token this pass never resolved to the
+*         middle: a PUBLIC `ssm` reference in the same `port:` frame holding
+*         the same two characters is kept RESOLVED on the record, and the
+*         entry would rewrite it to the secret sibling's expression. So the
+*         frames (prefix + suffix) of every spelling of every string value in
+*         the row are gathered BEFORE the conditions run, a spelling that is
+*         not a single-span literal frame with this pass's pair for its token
+*         (`resolvedPlaintextOf`) counting as its own, and a value is
+*         recorded only when its certified frame is the row's only one.
+*   (v)   No OTHER string leaf of the ROW would be rewritten by the entry,
+*         read over every leaf of the resolved row since the bag is per
+*         resource, not per `Parameters`. Two arms of the persist walk read
+*         a map entry. The WHOLE-VALUE arm is floorless, so a leaf EQUAL to
+*         the value OUTSIDE `Parameters` (a `TemplateURL` that happens to
+*         equal it has no frame of its own and escapes (iv)) or inside a
+*         LIST-valued sibling parameter (an array here; `extractParameters`
+*         joins it back for the wire) refuses at any length; equality
+*         between string parameters is (iv)'s frame identity. The SUBSTRING
+*         arm is reached only by a value at or above `MIN_NEEDLE_LENGTH`
+*         (`port:q7` clears the floor its bare middle sits under), so a
+*         sibling merely CONTAINING the value -- `x-port` + `:q7` from
+*         another token, a plain literal `literal-port:q7-end` -- refuses
+*         only then, or it would be spliced with this frame on the parent's
+*         record, exactly the #2087 splice the child side is scoped against;
+*         a 3-character `pq7` beside such a sibling is carried, since no
+*         needle exists for it.
+*
+* Written AFTER the walk, so no iteration reads the recorder's own write --
+* a statement of intent rather than a pinned behaviour: under (iv) and (v)
+* an in-loop write is EQUIVALENT (a later value the entry would rewrite is
+* refused by (v), an equal one by (iv) or as the same entry), so no test can
+* red on the order, and it is kept so (ii)'s reading of the map cannot come
+* to depend on iteration order. No pair and no pin are recorded for the
+* entry: it is not a token
+* ({@link recordedExpressionsOf} names the class), and no consumer needs one
+* -- the child's carry, the child's persist (the floorless whole-value arm),
+* the diff side (`redactParametersForDiff`'s fallback) and the parent's
+* rollback record all read the map by whole value. Refusal 3's
+* self-referential shape cannot reach the write: {@link singleSpanFrame}
+* refuses a middle that is itself a token, which is what a bag equal to its
+* source has.
+*
+* WHAT STAYS OPEN, weighed against the three live consumers named on
+* {@link positionByIntrinsicFrame} (`cdkd rollback`, `drift --revert`, a
+* consumer's cross-stack read). (a) Over one middle with TWO tokens, (iii)
+* records the survivor's frames only, never a loser's, so the loser's child
+* leaf takes the survivor's frame when the two frames MATCH (`port:` + either
+* token: the survivor's entry is the loser's whole value too) and stays
+* PLAINTEXT when they differ (`port:` + A beside `url:` + B: no entry names
+* `port:q7`). Either is the pre-#2291 answer for this shape; on a match it is
+* the wrong reference those consumers re-resolve -- after the sibling
+* rotates, a rollback or `--revert` of the child hands the sibling's
+* plaintext to the loser's live property. The PARENT's record stays per leaf
+* by (iii) and (iv). One token framed two ways (`port:` + T and `url:` + T)
+* is two values and two entries, not this shape. (b) The framed
+* value is a SUBSTRING needle (7 characters here) in every child resource
+* that consumed the parameter, so an unrelated literal there containing it
+* is spliced -- the #2087 class, bounded to resources whose own resolution
+* consumed the parameter; on the parent's own row (v) refuses the entry
+* instead, over the leaves visible at record time -- a readback leaf AWS
+* rewrote to contain the value is spliced like any 4+ character needle's.
+* (c) A frame longer than
+* `MAX_SKELETON_CANDIDATE_LENGTH` makes both intrinsic arms refuse every
+* INTRINSIC-sourced leaf of that child resource, which then falls to the
+* value scan (a literal-source leaf keeps the span arm). (d) A child
+* OUTPUT carrying the framed value re-resolves in the parent to `port:q7`,
+* where the cross-stack seam refuses a non-token and the consumer's leaf
+* persists the plaintext -- the same class as the nonliteral-frame deferral.
+* (e) An OBJECT-spelled parameter source (`Fn::Join` / `Fn::Sub` in the
+* parent's own `Parameters` block) is out of this arm's reach -- (i) cannot
+* hold for one. #2745 scopes this site to the literal spelling; the object
+* spelling is issue #3062. (f) A child record persisted BEFORE this carry
+* keeps `port:q7` until the child is next redeployed: the parent's own row
+* already held the frame (the literal arm), so a parent deploy whose child
+* row is unchanged never re-runs the child, and `cdkd scrub` cannot repair
+* it either -- it walks the child's stored bag with no inherited bag.
 */
 function recordNestedStackParameterExpressions(secrets, resourceType, resolvedProperties, sourceProperties, rules = TEMPLATE_DERIVED_RULES) {
 	if (resourceType !== NESTED_STACK_RESOURCE_TYPE$2) return;
@@ -12143,7 +12324,7 @@ function recordNestedStackParameterExpressions(secrets, resourceType, resolvedPr
 	const resolvedParameters = resolvedProperties["Parameters"];
 	const sourceParameters = sourceProperties["Parameters"];
 	if (!isPlainObject$2(resolvedParameters) || !isPlainObject$2(sourceParameters)) return;
-	const positioned = redactSecretsForState(resolvedParameters, secrets, sourceParameters, rules);
+	const positioned = redactSecretsForState(markSameGenerationBag({ ...resolvedParameters }), secrets, sourceParameters, rules);
 	let table = nestedStackParameterExpressions.get(secrets);
 	for (const [name, resolvedValue] of Object.entries(resolvedParameters)) {
 		if (typeof resolvedValue !== "string" || !secrets.has(resolvedValue)) continue;
@@ -12161,6 +12342,49 @@ function recordNestedStackParameterExpressions(secrets, resourceType, resolvedPr
 		}
 		storeAssociation(table, name, expression, resolvedValue);
 	}
+	const framesByValue = /* @__PURE__ */ new Map();
+	for (const [name, resolvedValue] of Object.entries(resolvedParameters)) {
+		if (typeof resolvedValue !== "string") continue;
+		const sourceLeaf = sourceParameters[name];
+		const frame = typeof sourceLeaf === "string" ? singleSpanFrame(resolvedValue, sourceLeaf) : void 0;
+		const frames = framesByValue.get(resolvedValue) ?? /* @__PURE__ */ new Set();
+		frames.add(frame === void 0 || resolvedPlaintextOf(secrets, frame.token) !== frame.middle ? UNFRAMED_SPELLING : `${frame.prefix.length}:${frame.prefix}${frame.suffix}`);
+		framesByValue.set(resolvedValue, frames);
+	}
+	const rowWithoutParameters = {};
+	for (const [key, value] of Object.entries(resolvedProperties)) if (key !== "Parameters") rowWithoutParameters[key] = value;
+	const outsideLeaves = wholeStringLeavesOf(rowWithoutParameters);
+	const framed = /* @__PURE__ */ new Map();
+	for (const [name, resolvedValue] of Object.entries(resolvedParameters)) {
+		const sourceLeaf = sourceParameters[name];
+		if (typeof resolvedValue !== "string" || typeof sourceLeaf !== "string") continue;
+		if (positioned[name] !== sourceLeaf) continue;
+		if (redactSecretsForState(resolvedValue, secrets) !== resolvedValue) continue;
+		const frame = singleSpanFrame(resolvedValue, sourceLeaf);
+		if (frame === void 0 || secrets.get(frame.middle) !== frame.token) continue;
+		if (framesByValue.get(resolvedValue)?.size !== 1) continue;
+		const isNeedle = resolvedValue.length >= 4;
+		const rewrites = (leaf) => leaf === resolvedValue || isNeedle && leaf.includes(resolvedValue);
+		let embedded = false;
+		for (const leaf of outsideLeaves) if (rewrites(leaf)) {
+			embedded = true;
+			break;
+		}
+		for (const other of Object.values(resolvedParameters)) {
+			if (embedded) break;
+			if (typeof other === "string") {
+				if (other !== resolvedValue && rewrites(other)) embedded = true;
+				continue;
+			}
+			for (const leaf of wholeStringLeavesOf(other)) if (rewrites(leaf)) {
+				embedded = true;
+				break;
+			}
+		}
+		if (embedded) continue;
+		framed.set(resolvedValue, sourceLeaf);
+	}
+	for (const [plaintext, expression] of framed) secrets.set(plaintext, expression);
 }
 /**
 * Copy a parent pass's per-PARAMETER associations onto a nested-stack CHILD
@@ -13026,10 +13250,14 @@ function positionByCrossStackSource(bag, source, secrets) {
 * template text, which genuinely can be a PUBLIC ssm reference that must stay
 * resolved in state (issue #1901), so it has to be tested. Here the candidates
 * come only from {@link recordedSecretExpressions} and from the values of a
-* {@link RecordedSecretValues} map, both of which the resolver populates ONLY
-* on a proven-secret verdict — so the test could never answer `false`, and an
-* unfalsifiable guard reads as protection while fencing nothing. Widening
-* either candidate source is what would make it necessary again.
+* {@link RecordedSecretValues} map, which the resolver populates ONLY on a
+* proven-secret verdict — and, since issue #2745, the nested-stack recorder's
+* framed carry entries ({@link recordedExpressionsOf}), which are not
+* references but ARE map values, so the same membership test reads them as
+* secret too. So the test could never answer `false`, and an
+* unfalsifiable guard reads as protection while fencing nothing. Widening the
+* candidate sources to a reference that can be public is what would make it
+* necessary again.
 */
 function positionByIntrinsicSkeleton(bag, source, secrets, secretExpressions) {
 	if (bag === "" || !secrets.has(bag)) return void 0;
@@ -21280,6 +21508,61 @@ function configBooleanRefusal(container, key, containerPath) {
 	if (coerceCfnBoolean(value) !== void 0) return void 0;
 	return `${containerPath}.${key} must be a boolean ${malformedShapeDetail(value)}`;
 }
+/**
+* Coerce a CFn integer, which may arrive as the string `"32"`.
+*
+* Same reason as {@link coerceCfnBoolean}: CloudFormation is stringly typed, so
+* an imported or hand-written template legitimately spells `PasswordLength:
+* "32"`. A safe whole number, or a string that is a DECIMAL INTEGER LITERAL
+* (optional sign, then digits, nothing else), is the value; anything else —
+* `null`, `''`, `'abc'`, `3.5`, `'1e2'`, `'0x10'`, `' 32 '`, an object,
+* an unresolved intrinsic — is `undefined`, so a caller that indexed
+* `(x as number) || 32` cannot read a malformed member as its default. The
+* string grammar is exactly what CloudFormation's own validator accepts,
+* MEASURED (us-east-1, 2026-09-13, `AWS::SecretsManager::Secret
+* GenerateSecretString.PasswordLength`): `"+12"` and `"007"` pass, `" 12 "` fails
+* `expected type: Integer, found: String`, `"1e1"` fails `found: Float` —
+* so a padded string is refused HERE rather than minted from a template the
+* service rejects, and a signed one is accepted. Both branches use
+* `Number.isSafeInteger`, so one value gets one verdict whatever its
+* spelling.
+*
+* @returns the integer, or `undefined` when the value is not one.
+*/
+function coerceCfnInteger(value) {
+	if (typeof value === "number") return Number.isSafeInteger(value) ? value : void 0;
+	if (typeof value !== "string" || !/^[+-]?\d+$/.test(value)) return void 0;
+	const n = Number(value);
+	return Number.isSafeInteger(n) ? n : void 0;
+}
+/**
+* The integer twin of {@link configBooleanRefusal} (issue #3056): the same
+* CONTAINER-then-FIELD halves, the FIELD half being {@link coerceCfnInteger} —
+* the function the wire read calls. Exists for the member shape neither
+* sibling sees: `(config['PasswordLength'] as number) || 32` read a
+* malformed length as the default, and a non-numeric STRING (truthy) reached
+* `new Uint8Array('abc')` and minted an EMPTY password with no warning.
+*
+* @param min the smallest integer that is usable (a generated-password length
+*   of `0` is a value, not a refusal, to `Number.isInteger`, and it mints an
+*   empty secret); pass `1` for a count, `0` where zero is legitimate.
+* @param max the largest, when the API documents one — a value the service
+*   would reject is refused HERE, before a local consumer spends the work
+*   (`new Uint8Array(1e9)` allocates and spins before AWS ever sees the
+*   length). Omit when the API states no cap.
+* @returns The refusal sentence (`<path> must be …`), or `undefined` when the
+*   value is usable — including the ABSENT container / ABSENT key cases, which
+*   legitimately take the caller's default.
+*/
+function configIntegerRefusal(container, key, containerPath, min, max) {
+	if (container === void 0 || container === null) return void 0;
+	if (!isPlainObject$1(container) || isUnresolvedIntrinsicContainer(container)) return `${containerPath} must be an object ${malformedShapeDetail(container)}`;
+	const value = container[key];
+	if (value === void 0) return void 0;
+	const n = coerceCfnInteger(value);
+	if (n !== void 0 && n >= min && (max === void 0 || n <= max)) return void 0;
+	return `${containerPath}.${key} must be an integer ${max === void 0 ? `>= ${min}` : `between ${min} and ${max}`} ${malformedShapeDetail(value)}`;
+}
 /** The FIELD half of {@link configStringRefusal}, shared with {@link requireConfigString}. */
 function configValueRefusal(value, fallback, path, options) {
 	if (value === void 0) return void 0;
@@ -21359,9 +21642,10 @@ const NAMEABLE_INTRINSIC_KEYS = /* @__PURE__ */ new Set([
 * (`DeploymentController`) and `codebuild-provider.ts` (reached from `update()`
 * through `mapProperties`). `secretsmanager-secret-provider.ts` was on this
 * list until issue #3048 moved its update path to a SKIP (the container is
-* refused by `requireConfigObject` before `generateSecretString` reads it;
-* `create()` still throws, and so does the MEMBER-level `ExcludeCharacters`
-* read inside a well-formed container -- issue #3056). Not a count, for the same
+* refused by `requireConfigObject` before `generateSecretString` reads it,
+* and since issue #3056 every MEMBER read inside it takes the same skip
+* through an `onUnusable` callback; `create()` still throws on both). Not a
+* count, for the same
 * reason as the near-copy list below: two successive reviews each found
 * another. Re-derive with
 * `grep -rn 'readConfigString(' src/provisioning/providers/`.
@@ -28041,7 +28325,7 @@ var CloudControlProvider = class {
 		const indeterminateGuard = await this.confirmDeleteTargetIdentity(logicalId, resourceType, physicalId, context);
 		if (context?.removeProtection === true && resourceType === "AWS::AutoScaling::AutoScalingGroup") {
 			this.logger.debug(`Delegating protected AutoScalingGroup ${logicalId} delete to the SDK ASGProvider (Cloud Control cannot force-delete a protected ASG)`);
-			const { ASGProvider } = await import("./asg-provider-CpxZ9sVH.js").then((n) => n.n);
+			const { ASGProvider } = await import("./asg-provider-eIVYMrmW.js").then((n) => n.n);
 			const asgProvider = new ASGProvider();
 			return withIndeterminateGuard(await asgProvider.delete(logicalId, physicalId, resourceType, _properties, context), indeterminateGuard);
 		}
@@ -40487,5 +40771,5 @@ var DeployEngine = class DeployEngine {
 };
 
 //#endregion
-export { collectInlinePolicyNamesManagedBySiblings as $, buildDockerImage as $n, LocalInvokeBuildError as $r, DagBuilder as $t, isStatefulRecreateTargetForReplace as A, importableOutputs as An, findLargeInlineResources as Ar, coerceCfnBoolean as At, gray as B, rewriteTemplateAssetReferences as Bn, resolveBucketRegion as Br, withSharedDrainBudget as Bt, refusesFinalSnapshot as C, buildLockContentionMessage as Cn, resolveStateBucketWithDefaultAndSource as Cr, isUnboundTemplateParameter as Ct, makeSiblingClaimReader as D, DEFAULT_STATE_PREFIX as Dn, CFN_TEMPLATE_BODY_LIMIT as Dr, normalizeAwsTagsToCfn as Dt, extractDeploymentEventError as E, CUSTOM_RESOURCE_RESPONSE_PREFIX as En, warnDeprecatedNoPrefixCliFlag as Er, WAFv2WebACLProvider as Et, isWarmThroughputDecrease as F, stringifyValue as Fn, canonicalizeRegion as Fr, requireConfigArray as Ft, collectPublishedOutputNames as G, getBootstrapMarkerKey as Gn, AssetError as Gr, s3BucketWebsiteUrl as Gt, red as H, BOOTSTRAP_MARKER_PREFIX as Hn, getAwsClients as Hr, s3BucketDomainName as Ht, toFiniteNumber as I, WorkGraph as In, derivePartitionAndUrlSuffix as Ir, requireConfigObject as It, secretBearing as J, readBootstrapMarkerBody as Jn, CrossAccountSecretRefusalError as Jr, INTRINSIC_KEYS as Jt, exportAliasCollisionScrubWarning as K, isCrossRegionRedirect as Kn, CdkdError as Kr, applyRoleArnIfSet as Kt, formatResourceLine as L, buildAssetRedirectMap as Ln, AssemblyReader as Lr, requireConfigString as Lt, renderStatefulReason as M, orphansCarriedFrom as Mn, CUSTOM_RESOURCE_RESPONSE_OBJECT_DESCRIPTION as Mr, configStringRefusal as Mt, WARM_THROUGHPUT_MEMBERS as N, shouldRetainResource as Nn, expectedOwnerParam as Nr, readConfigString as Nt, planOrphanAdoption as O, exportNamesCarriedFrom as On, CFN_TEMPLATE_URL_LIMIT as Or, resolveExplicitPhysicalId as Ot, coerceWarmThroughput as P, AssetPublisher as Pn, PARTITION_TABLE as Pr, replayWarn as Pt, IAMRoleProvider as Q, describeAwsFailure as Qn, IntrinsicResolutionRefusalError as Qr, withRetry as Qt, bold as R, createAssetRedirectResolver as Rn, processStackMessages as Rr, classifyReplaySecretRegion as Rt, isFinalSnapshotError as S, __exportAll as Si, buildForceUnlockCommand as Sn, resolveStateBucketWithDefault as Sr, getAccountInfo as St, makeCanonicalizePropertiesFn as T, shellQuote as Tn, stateBucketExistenceConfirmed as Tr, refStateLookupFromResource as Tt, yellow as U, assertAssetBucketRegion as Un, resetAwsClients as Ur, s3BucketDualStackDomainName as Ut, green as V, AssetModeResolver as Vn, AwsClients as Vr, s3BucketArn as Vt, collectDeclaredOutputNames as W, ensureAssetStorage as Wn, setAwsClients as Wr, s3BucketRegionalDomainName as Wt, secretSafeKeyDisplay as X, validateContainerRepoName as Xn, DeployCancelledError as Xr, findSilentDropProperties as Xt, secretBearingStateKeyWarning as Y, validateAssetBucketName as Yn, DependencyError as Yr, findActionableSilentDrops as Yt, getCurrentResourceSecrets as Z, buildDenyExternalAccessPolicy as Zn, DynamicReferenceRegionAmbiguousError as Zr, describeTypeWithThrottleRetry as Zt, ATOMIC_FINAL_SNAPSHOT_TYPES as _, isThrottlingError as _i, scrubResourceRecord as _n, getLegacyStateBucketName as _r, isTerminationProtectionPropagationError as _t, DeploymentEventsStore as a, ResourceTimeoutError as ai, carriesSecretMask as an, getDockerCmd as ar, maskerOrIdentity as at, ccRoutedFinalSnapshotError as b, markRedactedCause as bi, rebuildClientForBucketRegion as bn, resolveCaptureObservedState as br, cfnRefValueFromPhysicalId as bt, replayFailedOperations as c, StackTerminationProtectionError as ci, errorCauseChain as cn, runDockerForeground as cr, interruptWatchListenerCount as ct, updatePartialReason as d, formatError as di, markSameGenerationBag as dn, stripControlChars as dr, CloudControlProvider as dt, LocalStartServiceError as ei, TemplateParser as en, describeDockerCapturedOutput as er, clearOnUpdateRemoval as et, withResourceDeadline as f, isCdkdError as fi, maskSecretsInError as fn, AssetManifestLoader as fr, slowCcOperationTimeoutMs as ft, bindingSkippedOutputs as g, isRetryableTransientError as gi, redactSecretsForState as gn, getDefaultStateBucketName as gr, disableInstanceApiTermination as gt, computeImplicitDeleteEdges as h, isMarkedNonRetryable as hi, recoverMaskedOutput as hn, synthesisStatusMessage as hr, deleteSkipReason as ht, DeploymentEventsReader as i, ProvisioningError as ii, TEMPLATE_SOURCED_RULES as in, formatDockerLoginError as ir, maskDeep as it, isStatefulRecreateTargetSync as j, orphansAfterRollback as jn, uploadCfnTemplate as jr, configBooleanRefusal as jt, MULTI_REGION_RECREATE_BLOCKED_TYPES as k, importableOutputKeys as kn, MIGRATE_TMP_PREFIX as kr, assertRegionMatch as kt, replayRollback as l, StateError as li, identityKeyFor as ln, runDockerStreaming as lr, isInterruptedWaitError as lt, IMPLICIT_DELETE_DEPENDENCIES as m, withErrorHandling as mi, recordMaskOnlyValue as mn, Synthesizer as mr, deleteIndeterminateGuards as mt, DEFAULT_RESOURCE_WARN_AFTER_MS as n, NestedStackChildDirectDestroyError as ni, STATE_SOURCED_CROSS_GENERATION_RULES as nn, describeDockerFailure as nr, wouldReturnToSdkProvider as nt, planFailedOps as o, ResourceUpdateNotSupportedError as oi, createSecretMasker as on, partitionSensitiveEnv as or, beginCommandInterruptScope as ot, maskingRetryLogger as p, normalizeAwsError as pi, maskSecretsInText as pn, getDockerImageBySourceHash as pr, UNSPECIFIED_SKIP_REASON as pt, isExportAliasCollision as q, parseBootstrapMarker as qn, ConfigError as qr, DiffCalculator as qt, DeployEngine as r, PartialFailureError as ri, STATE_SOURCED_READBACK_RULES as rn, dockerSpawnEnvWithSensitive as rr, createMaskedRetryLogger as rt, planRollback as s, StackHasActiveImportsError as si, dynamicReferenceTokens as sn, redactDockerArgvValues as sr, endCommandInterruptScope as st, DEFAULT_RESOURCE_TIMEOUT_MS as t, LockError as ti, STATE_SOURCED_BASELINE_RULES as tn, describeDockerExecFailure as tr, ProviderRegistry as tt, updatePartialMessage as u, SynthesisError as ui, isSingleDynamicReferenceToken as un, escapeRegExp$1 as ur, startInterruptWatch as ut, PRE_DELETE_SNAPSHOT_TYPES as v, isTransientServerError as vi, LockManager as vn, resolveApp as vr, IntrinsicFunctionResolver as vt, unsupportedFinalSnapshotError as w, forceQuitRecoveryClause as wn, resolveUseCdkBootstrapAssets as wr, parameterTypeMayLoseSecretIdentity as wt, createPreDeleteFinalSnapshot as x, retryClassificationText as xi, UNRENDERABLE as xn, resolveSkipPrefix as xr, coerceParameterTypedValue as xt, buildFinalSnapshotIdentifier as y, markNonRetryable as yi, S3StateBackend as yn, resolveAutoAssetStorage as yr, carriesDynamicReference as yt, cyan as z, loadPublishableAssetManifest as zn, clearBucketRegionCache as zr, producerRegionsFromState as zt };
-//# sourceMappingURL=deploy-engine-BEpYvI14.js.map
+export { collectInlinePolicyNamesManagedBySiblings as $, buildDenyExternalAccessPolicy as $n, DynamicReferenceRegionAmbiguousError as $r, describeTypeWithThrottleRetry as $t, isStatefulRecreateTargetForReplace as A, exportNamesCarriedFrom as An, CFN_TEMPLATE_URL_LIMIT as Ar, coerceCfnBoolean as At, gray as B, createAssetRedirectResolver as Bn, processStackMessages as Br, classifyReplaySecretRegion as Bt, refusesFinalSnapshot as C, retryClassificationText as Ci, UNRENDERABLE as Cn, resolveSkipPrefix as Cr, isUnboundTemplateParameter as Ct, makeSiblingClaimReader as D, shellQuote as Dn, stateBucketExistenceConfirmed as Dr, normalizeAwsTagsToCfn as Dt, extractDeploymentEventError as E, forceQuitRecoveryClause as En, resolveUseCdkBootstrapAssets as Er, WAFv2WebACLProvider as Et, isWarmThroughputDecrease as F, shouldRetainResource as Fn, expectedOwnerParam as Fr, readConfigString as Ft, collectPublishedOutputNames as G, assertAssetBucketRegion as Gn, resetAwsClients as Gr, s3BucketDualStackDomainName as Gt, red as H, rewriteTemplateAssetReferences as Hn, resolveBucketRegion as Hr, withSharedDrainBudget as Ht, toFiniteNumber as I, AssetPublisher as In, PARTITION_TABLE as Ir, replayWarn as It, secretBearing as J, isCrossRegionRedirect as Jn, CdkdError as Jr, applyRoleArnIfSet as Jt, exportAliasCollisionScrubWarning as K, ensureAssetStorage as Kn, setAwsClients as Kr, s3BucketRegionalDomainName as Kt, formatResourceLine as L, stringifyValue as Ln, canonicalizeRegion as Lr, requireConfigArray as Lt, renderStatefulReason as M, importableOutputs as Mn, findLargeInlineResources as Mr, configBooleanRefusal as Mt, WARM_THROUGHPUT_MEMBERS as N, orphansAfterRollback as Nn, uploadCfnTemplate as Nr, configIntegerRefusal as Nt, planOrphanAdoption as O, CUSTOM_RESOURCE_RESPONSE_PREFIX as On, warnDeprecatedNoPrefixCliFlag as Or, resolveExplicitPhysicalId as Ot, coerceWarmThroughput as P, orphansCarriedFrom as Pn, CUSTOM_RESOURCE_RESPONSE_OBJECT_DESCRIPTION as Pr, configStringRefusal as Pt, IAMRoleProvider as Q, validateContainerRepoName as Qn, DeployCancelledError as Qr, findSilentDropProperties as Qt, bold as R, WorkGraph as Rn, derivePartitionAndUrlSuffix as Rr, requireConfigObject as Rt, isFinalSnapshotError as S, markRedactedCause as Si, rebuildClientForBucketRegion as Sn, resolveCaptureObservedState as Sr, getAccountInfo as St, makeCanonicalizePropertiesFn as T, buildLockContentionMessage as Tn, resolveStateBucketWithDefaultAndSource as Tr, refStateLookupFromResource as Tt, yellow as U, AssetModeResolver as Un, AwsClients as Ur, s3BucketArn as Ut, green as V, loadPublishableAssetManifest as Vn, clearBucketRegionCache as Vr, producerRegionsFromState as Vt, collectDeclaredOutputNames as W, BOOTSTRAP_MARKER_PREFIX as Wn, getAwsClients as Wr, s3BucketDomainName as Wt, secretSafeKeyDisplay as X, readBootstrapMarkerBody as Xn, CrossAccountSecretRefusalError as Xr, INTRINSIC_KEYS as Xt, secretBearingStateKeyWarning as Y, parseBootstrapMarker as Yn, ConfigError as Yr, DiffCalculator as Yt, getCurrentResourceSecrets as Z, validateAssetBucketName as Zn, DependencyError as Zr, findActionableSilentDrops as Zt, ATOMIC_FINAL_SNAPSHOT_TYPES as _, isMarkedNonRetryable as _i, recoverMaskedOutput as _n, synthesisStatusMessage as _r, isTerminationProtectionPropagationError as _t, DeploymentEventsStore as a, PartialFailureError as ai, STATE_SOURCED_READBACK_RULES as an, dockerSpawnEnvWithSensitive as ar, maskerOrIdentity as at, ccRoutedFinalSnapshotError as b, isTransientServerError as bi, LockManager as bn, resolveApp as br, cfnRefValueFromPhysicalId as bt, replayFailedOperations as c, ResourceUpdateNotSupportedError as ci, createSecretMasker as cn, partitionSensitiveEnv as cr, interruptWatchListenerCount as ct, updatePartialReason as d, StateError as di, identityKeyFor as dn, runDockerStreaming as dr, CloudControlProvider as dt, IntrinsicResolutionRefusalError as ei, withRetry as en, describeAwsFailure as er, clearOnUpdateRemoval as et, withResourceDeadline as f, SynthesisError as fi, isSingleDynamicReferenceToken as fn, escapeRegExp$1 as fr, slowCcOperationTimeoutMs as ft, bindingSkippedOutputs as g, withErrorHandling as gi, recordMaskOnlyValue as gn, Synthesizer as gr, disableInstanceApiTermination as gt, computeImplicitDeleteEdges as h, normalizeAwsError as hi, maskSecretsInText as hn, getDockerImageBySourceHash as hr, deleteSkipReason as ht, DeploymentEventsReader as i, NestedStackChildDirectDestroyError as ii, STATE_SOURCED_CROSS_GENERATION_RULES as in, describeDockerFailure as ir, maskDeep as it, isStatefulRecreateTargetSync as j, importableOutputKeys as jn, MIGRATE_TMP_PREFIX as jr, coerceCfnInteger as jt, MULTI_REGION_RECREATE_BLOCKED_TYPES as k, DEFAULT_STATE_PREFIX as kn, CFN_TEMPLATE_BODY_LIMIT as kr, assertRegionMatch as kt, replayRollback as l, StackHasActiveImportsError as li, dynamicReferenceTokens as ln, redactDockerArgvValues as lr, isInterruptedWaitError as lt, IMPLICIT_DELETE_DEPENDENCIES as m, isCdkdError as mi, maskSecretsInError as mn, AssetManifestLoader as mr, deleteIndeterminateGuards as mt, DEFAULT_RESOURCE_WARN_AFTER_MS as n, LocalStartServiceError as ni, TemplateParser as nn, describeDockerCapturedOutput as nr, wouldReturnToSdkProvider as nt, planFailedOps as o, ProvisioningError as oi, TEMPLATE_SOURCED_RULES as on, formatDockerLoginError as or, beginCommandInterruptScope as ot, maskingRetryLogger as p, formatError as pi, markSameGenerationBag as pn, stripControlChars as pr, UNSPECIFIED_SKIP_REASON as pt, isExportAliasCollision as q, getBootstrapMarkerKey as qn, AssetError as qr, s3BucketWebsiteUrl as qt, DeployEngine as r, LockError as ri, STATE_SOURCED_BASELINE_RULES as rn, describeDockerExecFailure as rr, createMaskedRetryLogger as rt, planRollback as s, ResourceTimeoutError as si, carriesSecretMask as sn, getDockerCmd as sr, endCommandInterruptScope as st, DEFAULT_RESOURCE_TIMEOUT_MS as t, LocalInvokeBuildError as ti, DagBuilder as tn, buildDockerImage as tr, ProviderRegistry as tt, updatePartialMessage as u, StackTerminationProtectionError as ui, errorCauseChain as un, runDockerForeground as ur, startInterruptWatch as ut, PRE_DELETE_SNAPSHOT_TYPES as v, isRetryableTransientError as vi, redactSecretsForState as vn, getDefaultStateBucketName as vr, IntrinsicFunctionResolver as vt, unsupportedFinalSnapshotError as w, __exportAll as wi, buildForceUnlockCommand as wn, resolveStateBucketWithDefault as wr, parameterTypeMayLoseSecretIdentity as wt, createPreDeleteFinalSnapshot as x, markNonRetryable as xi, S3StateBackend as xn, resolveAutoAssetStorage as xr, coerceParameterTypedValue as xt, buildFinalSnapshotIdentifier as y, isThrottlingError as yi, scrubResourceRecord as yn, getLegacyStateBucketName as yr, carriesDynamicReference as yt, cyan as z, buildAssetRedirectMap as zn, AssemblyReader as zr, requireConfigString as zt };
+//# sourceMappingURL=deploy-engine-CpmvgRtm.js.map