@go-to-k/cdkd 0.280.3 → 0.280.5

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { $ as DiffCalculator, $t as resolveBucketRegion, A as red, At as getDockerImageBySourceHash, B as isTerminationProtectionPropagationError, Bt as resolveStateBucketWithDefaultAndSource, C as isStatefulRecreateTargetSync, Ct as validateContainerRepoName, D as cyan, Dt as runDockerForeground, E as bold, En as withErrorHandling, Et as getDockerCmd, F as ProviderRegistry, Ft as resolveApp, G as normalizeAwsTagsToCfn, Gt as CFN_TEMPLATE_URL_LIMIT, H as cfnRefValueFromPhysicalId, Ht as stateBucketExistenceConfirmed, I as findActionableSilentDrops, It as resolveAutoAssetStorage, J as readConfigString, Jt as uploadCfnTemplate, K as resolveExplicitPhysicalId, Kt as MIGRATE_TMP_PREFIX, L as CloudControlProvider, Lt as resolveCaptureObservedState, M as IAMRoleProvider, Mt as synthesisStatusMessage, N as collectInlinePolicyNamesManagedBySiblings, Nt as getDefaultStateBucketName, O as gray, Ot as runDockerStreaming, P as clearOnUpdateRemoval, Pt as getLegacyStateBucketName, Q as applyRoleArnIfSet, R as slowCcOperationTimeoutMs, Rt as resolveSkipPrefix, S as MULTI_REGION_RECREATE_BLOCKED_TYPES, St as validateAssetBucketName, T as formatResourceLine, Tn as normalizeAwsError, Tt as formatDockerLoginError, U as refStateLookupFromResource, Ut as warnDeprecatedNoPrefixCliFlag, V as IntrinsicFunctionResolver, Vt as resolveUseCdkBootstrapAssets, W as WAFv2WebACLProvider, Wt as CFN_TEMPLATE_BODY_LIMIT, X as requireConfigArray, Xt as AssemblyReader, Y as replayWarn, Yt as expectedOwnerParam, Z as requireConfigString, Zt as processStackMessages, _ as createPreDeleteFinalSnapshot, _n as ResourceTimeoutError, _t as AssetModeResolver, a as DeploymentEventsStore, an as CdkdError, at as TemplateParser, b as unsupportedFinalSnapshotError, bn as StackTerminationProtectionError, bt as getBootstrapMarkerKey, c as replayFailedOperations, cn as DeployCancelledError, ct as rebuildClientForBucketRegion, d as IMPLICIT_DELETE_DEPENDENCIES, dn as LocalStartServiceError, dt as stringifyValue, en as AwsClients, et as describeTypeWithThrottleRetry, f as computeImplicitDeleteEdges, ft as WorkGraph, g as ccRoutedFinalSnapshotError, gn as ProvisioningError, gt as rewriteTemplateAssetReferences, h as buildFinalSnapshotIdentifier, hn as PartialFailureError, ht as loadPublishableAssetManifest, i as DeploymentEventsReader, it as DagBuilder, j as yellow, jt as Synthesizer, k as green, kt as AssetManifestLoader, l as replayRollback, ln as LocalInvokeBuildError$1, lt as shouldRetainResource, m as PRE_DELETE_SNAPSHOT_TYPES, mn as NestedStackChildDirectDestroyError, mt as createAssetRedirectResolver, n as DEFAULT_RESOURCE_WARN_AFTER_MS, nn as resetAwsClients, nt as isRetryableTransientError, o as planFailedOps, ot as LockManager, p as ATOMIC_FINAL_SNAPSHOT_TYPES, pn as MissingCdkCliError, pt as buildAssetRedirectMap, q as assertRegionMatch, qt as findLargeInlineResources, r as DeployEngine, rn as setAwsClients, rt as isThrottlingError, s as planRollback, st as S3StateBackend, t as DEFAULT_RESOURCE_TIMEOUT_MS, tn as getAwsClients, tt as withRetry, u as withResourceDeadline, un as LocalMigrateError, ut as AssetPublisher, v as isFinalSnapshotError, vn as ResourceUpdateNotSupportedError, vt as BOOTSTRAP_MARKER_PREFIX, w as renderStatefulReason, wt as buildDockerImage, x as extractDeploymentEventError, xt as parseBootstrapMarker, y as refusesFinalSnapshot, yn as StackHasActiveImportsError, yt as ensureAssetStorage, z as disableInstanceApiTermination, zt as resolveStateBucketWithDefault } from "./deploy-engine-Ca5ywZ1L.js";
+import { $ as DiffCalculator, $t as resolveBucketRegion, A as red, At as getDockerImageBySourceHash, B as isTerminationProtectionPropagationError, Bt as resolveStateBucketWithDefaultAndSource, C as isStatefulRecreateTargetSync, Ct as validateContainerRepoName, D as cyan, Dt as runDockerForeground, E as bold, En as withErrorHandling, Et as getDockerCmd, F as ProviderRegistry, Ft as resolveApp, G as normalizeAwsTagsToCfn, Gt as CFN_TEMPLATE_URL_LIMIT, H as cfnRefValueFromPhysicalId, Ht as stateBucketExistenceConfirmed, I as findActionableSilentDrops, It as resolveAutoAssetStorage, J as readConfigString, Jt as uploadCfnTemplate, K as resolveExplicitPhysicalId, Kt as MIGRATE_TMP_PREFIX, L as CloudControlProvider, Lt as resolveCaptureObservedState, M as IAMRoleProvider, Mt as synthesisStatusMessage, N as collectInlinePolicyNamesManagedBySiblings, Nt as getDefaultStateBucketName, O as gray, Ot as runDockerStreaming, P as clearOnUpdateRemoval, Pt as getLegacyStateBucketName, Q as applyRoleArnIfSet, R as slowCcOperationTimeoutMs, Rt as resolveSkipPrefix, S as MULTI_REGION_RECREATE_BLOCKED_TYPES, St as validateAssetBucketName, T as formatResourceLine, Tn as normalizeAwsError, Tt as formatDockerLoginError, U as refStateLookupFromResource, Ut as warnDeprecatedNoPrefixCliFlag, V as IntrinsicFunctionResolver, Vt as resolveUseCdkBootstrapAssets, W as WAFv2WebACLProvider, Wt as CFN_TEMPLATE_BODY_LIMIT, X as requireConfigArray, Xt as AssemblyReader, Y as replayWarn, Yt as expectedOwnerParam, Z as requireConfigString, Zt as processStackMessages, _ as createPreDeleteFinalSnapshot, _n as ResourceTimeoutError, _t as AssetModeResolver, a as DeploymentEventsStore, an as CdkdError, at as TemplateParser, b as unsupportedFinalSnapshotError, bn as StackTerminationProtectionError, bt as getBootstrapMarkerKey, c as replayFailedOperations, cn as DeployCancelledError, ct as rebuildClientForBucketRegion, d as IMPLICIT_DELETE_DEPENDENCIES, dn as LocalStartServiceError, dt as stringifyValue, en as AwsClients, et as describeTypeWithThrottleRetry, f as computeImplicitDeleteEdges, ft as WorkGraph, g as ccRoutedFinalSnapshotError, gn as ProvisioningError, gt as rewriteTemplateAssetReferences, h as buildFinalSnapshotIdentifier, hn as PartialFailureError, ht as loadPublishableAssetManifest, i as DeploymentEventsReader, it as DagBuilder, j as yellow, jt as Synthesizer, k as green, kt as AssetManifestLoader, l as replayRollback, ln as LocalInvokeBuildError$1, lt as shouldRetainResource, m as PRE_DELETE_SNAPSHOT_TYPES, mn as NestedStackChildDirectDestroyError, mt as createAssetRedirectResolver, n as DEFAULT_RESOURCE_WARN_AFTER_MS, nn as resetAwsClients, nt as isRetryableTransientError, o as planFailedOps, ot as LockManager, p as ATOMIC_FINAL_SNAPSHOT_TYPES, pn as MissingCdkCliError, pt as buildAssetRedirectMap, q as assertRegionMatch, qt as findLargeInlineResources, r as DeployEngine, rn as setAwsClients, rt as isThrottlingError, s as planRollback, st as S3StateBackend, t as DEFAULT_RESOURCE_TIMEOUT_MS, tn as getAwsClients, tt as withRetry, u as withResourceDeadline, un as LocalMigrateError, ut as AssetPublisher, v as isFinalSnapshotError, vn as ResourceUpdateNotSupportedError, vt as BOOTSTRAP_MARKER_PREFIX, w as renderStatefulReason, wt as buildDockerImage, x as extractDeploymentEventError, xt as parseBootstrapMarker, y as refusesFinalSnapshot, yn as StackHasActiveImportsError, yt as ensureAssetStorage, z as disableInstanceApiTermination, zt as resolveStateBucketWithDefault } from "./deploy-engine-C5xOvZbg.js";
 import { a as getLiveRenderer, c as PATTERN_B_RESOURCE_TYPES, d as generateResourceNameWithFallback, f as withSkipPrefix, i as runStackBuffered, n as getLogger, o as PATTERN_B_NAME_OPTIONS, p as withStackName, s as PATTERN_B_NAME_PROPERTIES, u as generateResourceName } from "./logger-BYMEE-BS.js";
-import { t as ASGProvider } from "./asg-provider-C-Mym0XH.js";
+import { t as ASGProvider } from "./asg-provider-DINOy61N.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import { CopyObjectCommand, CreateBucketCommand, DeleteBucketAnalyticsConfigurationCommand, DeleteBucketCommand, DeleteBucketCorsCommand, DeleteBucketEncryptionCommand, DeleteBucketIntelligentTieringConfigurationCommand, DeleteBucketInventoryConfigurationCommand, DeleteBucketLifecycleCommand, DeleteBucketMetricsConfigurationCommand, DeleteBucketOwnershipControlsCommand, DeleteBucketPolicyCommand, DeleteBucketReplicationCommand, DeleteBucketTaggingCommand, DeleteBucketWebsiteCommand, DeleteObjectsCommand, GetBucketAccelerateConfigurationCommand, GetBucketCorsCommand, GetBucketEncryptionCommand, GetBucketLifecycleConfigurationCommand, GetBucketLocationCommand, GetBucketLoggingCommand, GetBucketNotificationConfigurationCommand, GetBucketOwnershipControlsCommand, GetBucketPolicyCommand, GetBucketReplicationCommand, GetBucketTaggingCommand, GetBucketVersioningCommand, GetBucketWebsiteCommand, GetObjectCommand, GetObjectLockConfigurationCommand, GetPublicAccessBlockCommand, HeadBucketCommand, ListBucketAnalyticsConfigurationsCommand, ListBucketIntelligentTieringConfigurationsCommand, ListBucketInventoryConfigurationsCommand, ListBucketMetricsConfigurationsCommand, ListObjectVersionsCommand, ListObjectsV2Command, NoSuchBucket, PutBucketAccelerateConfigurationCommand, PutBucketAnalyticsConfigurationCommand, PutBucketCorsCommand, PutBucketEncryptionCommand, PutBucketIntelligentTieringConfigurationCommand, PutBucketInventoryConfigurationCommand, PutBucketLifecycleConfigurationCommand, PutBucketLoggingCommand, PutBucketMetricsConfigurationCommand, PutBucketNotificationConfigurationCommand, PutBucketOwnershipControlsCommand, PutBucketPolicyCommand, PutBucketReplicationCommand, PutBucketTaggingCommand, PutBucketVersioningCommand, PutBucketWebsiteCommand, PutObjectCommand, PutObjectLockConfigurationCommand, PutPublicAccessBlockCommand, S3Client, S3ServiceException } from "@aws-sdk/client-s3";
@@ -43,7 +43,7 @@ import readline from "node:readline/promises";
 import { writeFileSync as writeFileSync$1 } from "fs";
 import * as zlib from "node:zlib";
 import { ApplicationAutoScalingClient, DeleteScalingPolicyCommand, DeregisterScalableTargetCommand, DescribeScalableTargetsCommand, DescribeScalingPoliciesCommand, PutScalingPolicyCommand, RegisterScalableTargetCommand } from "@aws-sdk/client-application-auto-scaling";
-import { ApiGatewayV2Client, CreateApiCommand, CreateAuthorizerCommand as CreateAuthorizerCommand$1, CreateIntegrationCommand, CreateRouteCommand as CreateRouteCommand$1, CreateStageCommand as CreateStageCommand$1, DeleteApiCommand, DeleteAuthorizerCommand as DeleteAuthorizerCommand$1, DeleteCorsConfigurationCommand, DeleteIntegrationCommand, DeleteRouteCommand as DeleteRouteCommand$1, DeleteStageCommand as DeleteStageCommand$1, GetApiCommand, GetAuthorizerCommand as GetAuthorizerCommand$1, GetIntegrationCommand, GetRouteCommand, GetStageCommand as GetStageCommand$1, NotFoundException as NotFoundException$3, UpdateApiCommand, UpdateAuthorizerCommand as UpdateAuthorizerCommand$1, UpdateIntegrationCommand, UpdateRouteCommand, UpdateStageCommand as UpdateStageCommand$1 } from "@aws-sdk/client-apigatewayv2";
+import { ApiGatewayV2Client, CreateApiCommand, CreateAuthorizerCommand as CreateAuthorizerCommand$1, CreateIntegrationCommand, CreateRouteCommand as CreateRouteCommand$1, CreateStageCommand as CreateStageCommand$1, DeleteAccessLogSettingsCommand, DeleteApiCommand, DeleteAuthorizerCommand as DeleteAuthorizerCommand$1, DeleteCorsConfigurationCommand, DeleteIntegrationCommand, DeleteRouteCommand as DeleteRouteCommand$1, DeleteRouteRequestParameterCommand, DeleteRouteSettingsCommand, DeleteStageCommand as DeleteStageCommand$1, GetApiCommand, GetAuthorizerCommand as GetAuthorizerCommand$1, GetIntegrationCommand, GetRouteCommand, GetStageCommand as GetStageCommand$1, NotFoundException as NotFoundException$3, UpdateApiCommand, UpdateAuthorizerCommand as UpdateAuthorizerCommand$1, UpdateIntegrationCommand, UpdateRouteCommand, UpdateStageCommand as UpdateStageCommand$1 } from "@aws-sdk/client-apigatewayv2";
 import { CreateStateMachineCommand, DeleteStateMachineCommand, DescribeStateMachineCommand, ListTagsForResourceCommand as ListTagsForResourceCommand$11, SFNClient, StateMachineDoesNotExist, TagResourceCommand as TagResourceCommand$13, UntagResourceCommand as UntagResourceCommand$13, UpdateStateMachineCommand } from "@aws-sdk/client-sfn";
 import { CreateClusterCommand, CreateServiceCommand, DeleteClusterCommand, DeleteServiceCommand, DeregisterTaskDefinitionCommand, DescribeClustersCommand, DescribeServicesCommand, DescribeTaskDefinitionCommand, ECSClient, PutClusterCapacityProvidersCommand, RegisterTaskDefinitionCommand, TagResourceCommand as TagResourceCommand$14, UntagResourceCommand as UntagResourceCommand$14, UpdateClusterCommand, UpdateServiceCommand, waitUntilServicesStable } from "@aws-sdk/client-ecs";
 import { AddTagsToResourceCommand as AddTagsToResourceCommand$3, CreateDBClusterCommand as CreateDBClusterCommand$1, CreateDBInstanceCommand as CreateDBInstanceCommand$1, CreateDBSubnetGroupCommand as CreateDBSubnetGroupCommand$1, DeleteDBClusterCommand as DeleteDBClusterCommand$1, DeleteDBInstanceCommand as DeleteDBInstanceCommand$1, DeleteDBSubnetGroupCommand as DeleteDBSubnetGroupCommand$1, DescribeDBClustersCommand as DescribeDBClustersCommand$1, DescribeDBInstancesCommand as DescribeDBInstancesCommand$1, DescribeDBSubnetGroupsCommand as DescribeDBSubnetGroupsCommand$1, DocDBClient, ListTagsForResourceCommand as ListTagsForResourceCommand$12, ModifyDBClusterCommand as ModifyDBClusterCommand$1, ModifyDBInstanceCommand as ModifyDBInstanceCommand$1, ModifyDBSubnetGroupCommand as ModifyDBSubnetGroupCommand$1, RemoveTagsFromResourceCommand as RemoveTagsFromResourceCommand$3 } from "@aws-sdk/client-docdb";
@@ -12954,7 +12954,8 @@ var DynamoDBGlobalTableProvider = class {
 			if (tableArn) await this.applyTagDiff(tableArn, extractLocalTags(previousProperties), extractLocalTags(properties));
 			const recordedOldBilling = previousProperties["BillingMode"];
 			const recordedOldBillingUsable = recordedOldBilling === void 0 || typeof recordedOldBilling === "string" && recordedOldBilling.trim() !== "";
-			const oldBilling = recordedOldBillingUsable ? recordedOldBilling ?? "PAY_PER_REQUEST" : describeResp.Table?.BillingModeSummary?.BillingMode ?? "PROVISIONED";
+			const liveBillingMode = describeResp.Table?.BillingModeSummary?.BillingMode ?? "PROVISIONED";
+			const oldBilling = recordedOldBillingUsable ? recordedOldBilling ?? "PAY_PER_REQUEST" : liveBillingMode;
 			if (!recordedOldBillingUsable) this.logger.warn(`AWS::DynamoDB::GlobalTable ${logicalId}: the recorded previous BillingMode is unusable (${JSON.stringify(recordedOldBilling)}) — using the table's actual billing mode (${oldBilling}) as the comparison baseline for this update so a corrected template does not issue a same-mode UpdateTable.`);
 			let billingUnusable = false;
 			const requestedBilling = requireConfigString(properties["BillingMode"], "PAY_PER_REQUEST", "AWS::DynamoDB::GlobalTable BillingMode", { onUnusable: (message) => {
@@ -12970,12 +12971,12 @@ var DynamoDBGlobalTableProvider = class {
 			let desiredGsiUnusable = false;
 			const onUnusableGsiBlock = (message) => {
 				desiredGsiUnusable = true;
-				this.logger.warn(`${message} No GlobalSecondaryIndexes change is applied by this update; the table's existing indexes are left untouched.`);
+				this.logger.warn(`AWS::DynamoDB::GlobalTable ${logicalId}: ${message} No GlobalSecondaryIndexes change is applied by this update; the table's existing indexes are left untouched.`);
 			};
 			let previousGsiUnusable = false;
 			const onUnusablePreviousGsiBlock = (message) => {
 				previousGsiUnusable = true;
-				this.logger.warn(`${message} (recorded in cdkd state, not in the template) — using the table's LIVE indexes as the comparison baseline for this update, so a corrected template still applies.`);
+				this.logger.warn(`AWS::DynamoDB::GlobalTable ${logicalId}: ${message} (recorded in cdkd state, not in the template) — using the table's LIVE indexes as the comparison baseline for this update, so a corrected template still applies.`);
 			};
 			const liveIndexNames = new Set((describeResp.Table?.GlobalSecondaryIndexes ?? []).map((live) => live.IndexName).filter((name) => typeof name === "string"));
 			const desiredSdkIndexes = toSdkGlobalSecondaryIndexes(properties, currentRegion, newBilling, "min", flippingToProvisioned ? void 0 : diagnostics, onUnusableGsiBlock);
@@ -13182,11 +13183,15 @@ var DynamoDBGlobalTableProvider = class {
 				await this.waitForReplicaActive(physicalId, region, logicalId);
 			}
 			const previousTranslatedIndexes = toSdkGlobalSecondaryIndexes(previousProperties, currentRegion, oldBilling, "min", void 0, onUnusablePreviousGsiBlock);
-			const previousSdkIndexes = previousGsiUnusable ? desiredSdkIndexes.filter((gsi) => typeof gsi.IndexName === "string" && liveIndexNames.has(gsi.IndexName)) : previousTranslatedIndexes;
+			const previousSdkIndexes = previousGsiUnusable ? buildLiveRecoveryGsiBaseline(desiredSdkIndexes, describeResp.Table?.GlobalSecondaryIndexes, {
+				carryLiveValues: oldBilling === newBilling && liveBillingMode === newBilling,
+				liveBillingMode,
+				uncomparableCapacityIndexNames: collectUncomparableCapacityGsiNames(properties, currentRegion)
+			}) : previousTranslatedIndexes;
 			if (previousGsiUnusable) {
 				const desiredNames = new Set(desiredSdkIndexes.map((gsi) => gsi.IndexName).filter((name) => typeof name === "string"));
 				const liveOnly = [...liveIndexNames].filter((name) => !desiredNames.has(name));
-				if (liveOnly.length > 0) this.logger.warn(`AWS::DynamoDB::GlobalTable ${logicalId}: ${liveOnly.join(", ")} exist(s) on the table but not in the template. No Delete is issued while the recorded GlobalSecondaryIndexes are unusable — a junk state record cannot prove cdkd created them. Re-deploy once state carries a valid block to remove them.`);
+				if (liveOnly.length > 0) this.logger.warn(`AWS::DynamoDB::GlobalTable ${logicalId}: ${liveOnly.join(", ")} exist(s) on the table but not in the template. No Delete is issued while the recorded GlobalSecondaryIndexes are unusable — a junk state record cannot prove cdkd created them, and an index delete is irreversible. This does NOT self-heal, and no later cdkd deploy will remove them: delete the index directly, e.g. aws dynamodb update-table --table-name ${physicalId} --global-secondary-index-updates '[{"Delete":{"IndexName":"<name>"}}]'.`);
 			}
 			const gsiDiff = desiredGsiUnusable ? {
 				added: [],
@@ -14941,6 +14946,159 @@ function collectRawOnDemandDeclarations(properties, region) {
 	return out;
 }
 /**
+* Names of the GSIs whose PROVISIONED capacity must NOT be compared against
+* the live table (issue #1571). Two disjoint reasons, and both are about the
+* DESIRED side being a number the template did not actually choose:
+*
+* - **auto-scaled** — the live number is owned by Application Auto Scaling
+*   while the translation takes `MinCapacity` (see {@link CapacitySource}), so
+*   a live 10 against a template min of 1 reads as a scale-down NOBODY ASKED
+*   FOR. This was one of the three measured failure modes of the first
+*   value-carrying baseline (#1551), and the only one that cannot be resolved
+*   by reading the live side more carefully — both numbers are correct, they
+*   answer different questions.
+* - **not template-determined** — no capacity resolves to a finite number, so
+*   `toSdkGlobalSecondaryIndexes` substitutes `DEFAULT_CAPACITY_UNITS` (5/5,
+*   the issue #1511 class). Comparing that invented default against the live
+*   value turns it into a WRITE. Found by review, not by the first cut.
+*
+* Walks the same two sources as {@link toSdkGlobalSecondaryIndexes} and
+* {@link collectRawOnDemandDeclarations} — the LOCAL replica's index entry
+* first (the canonical CDK spelling), the GSI-level block as the
+* hand-authored fallback for read, the top-level GSI for write. A divergence
+* between the three is what would re-open the bug, so they are kept adjacent.
+*
+* The auto-scaling arm tests PRESENCE of the `*CapacityAutoScalingSettings`
+* key, not whether its members coerce: a block that is itself an unresolved
+* intrinsic still means "this index is autoscaled", and "might be" must read
+* as "is" — a false negative issues an unrequested scale-down.
+*
+* KNOWN BOUND: detection is TEMPLATE-side only. An index autoscaled OUT OF
+* BAND (no `*CapacityAutoScalingSettings` in the template) has a
+* template-determined capacity, so its live value IS compared and the recovery
+* deploy re-asserts the template's number — which is what a clean previous
+* side would also have done, so this matches ordinary cdkd semantics rather
+* than being a recovery-path defect.
+*
+* And the cost of a false positive is a PERMANENT divergence, not "one deploy
+* of lag": the deploy records the template value as state, so the next diff
+* sees previous == desired and never revisits it. That is the same self-heal
+* fallacy this PR corrects in the live-only warning; it is accepted here
+* because the alternative is writing a number the user never asked for.
+*/
+function collectUncomparableCapacityGsiNames(properties, region) {
+	const out = /* @__PURE__ */ new Set();
+	const rawIndexes = properties["GlobalSecondaryIndexes"];
+	if (!Array.isArray(rawIndexes)) return out;
+	const replicas = properties["Replicas"];
+	const localReplicaIndexes = asRecord$1(Array.isArray(replicas) ? replicas.find((r) => asRecord$1(r)?.["Region"] === region) : void 0)?.["GlobalSecondaryIndexes"];
+	const localByName = /* @__PURE__ */ new Map();
+	if (Array.isArray(localReplicaIndexes)) for (const entry of localReplicaIndexes) {
+		const record = asRecord$1(entry);
+		const name = record?.["IndexName"];
+		if (record && typeof name === "string") localByName.set(name, record);
+	}
+	for (const entry of rawIndexes) {
+		const gsi = asRecord$1(entry);
+		const name = gsi?.["IndexName"];
+		if (!gsi || typeof name !== "string") continue;
+		const readBlocks = [localByName.get(name)?.["ReadProvisionedThroughputSettings"], gsi["ReadProvisionedThroughputSettings"]];
+		const writeBlock = gsi["WriteProvisionedThroughputSettings"];
+		if (readBlocks.some((block) => asRecord$1(block)?.["ReadCapacityAutoScalingSettings"] !== void 0 || isUnresolvedIntrinsicBlock(block)) || asRecord$1(writeBlock)?.["WriteCapacityAutoScalingSettings"] !== void 0 || isUnresolvedIntrinsicBlock(writeBlock)) {
+			out.add(name);
+			continue;
+		}
+		const explicitProvisioned = asRecord$1(gsi["ProvisionedThroughput"]);
+		const derivedRead = toFiniteNumber(explicitProvisioned?.["ReadCapacityUnits"]) ?? deriveReadCapacityUnits(asRecord$1(readBlocks[0])) ?? deriveReadCapacityUnits(asRecord$1(readBlocks[1]));
+		const derivedWrite = toFiniteNumber(explicitProvisioned?.["WriteCapacityUnits"]) ?? deriveWriteCapacityUnits(asRecord$1(writeBlock));
+		if (derivedRead === void 0 || derivedWrite === void 0) out.add(name);
+	}
+	return out;
+}
+/**
+* Build the GSI diff baseline used when the cdkd STATE record's
+* `GlobalSecondaryIndexes` is present-but-unusable (issue #1571, closing the
+* residual #1551 / PR #1562 measured and deliberately left open).
+*
+* The entries are the DESIRED indexes filtered to the names that EXIST live —
+* the live table is the only side that can answer "does this index exist",
+* which is what stops the permanent index loss #1562 was about. What #1562
+* could not settle was the VALUES: it copied the desired entry verbatim, so
+* the diff could only ever produce ADDs and every capacity / ceiling edit
+* silently lagged one deploy.
+*
+* This carries live VALUES, but only the ones that are safe to compare, and
+* the exclusions are the three measured failure modes of the first attempt
+* (recorded at the `liveIndexNames` call site) rather than a guess:
+*
+*  - **`ProvisionedThroughput` is gated on the LIVE billing mode.**
+*    `DescribeTable` reports `{ReadCapacityUnits: 0, WriteCapacityUnits: 0}`
+*    for every index of a PAY_PER_REQUEST table, so an ungated read produced a
+*    "modified" on every index and re-sent `{0, 0}`, which AWS rejects.
+*  - **An AUTOSCALED index keeps identity-only capacity.** The live number
+*    belongs to Application Auto Scaling; the desired side is `MinCapacity`.
+*    Comparing them reads as a scale-down the user never asked for.
+*  - **`KeySchema` / `Projection` / `WarmThroughput` are always the desired
+*    side.** All three are copied from `desired`, so they can never DIFFER —
+*    deliberately. `KeySchema` and `Projection` are immutable on an existing
+*    index (a difference produces only a "recreate the index" warning, and
+*    AWS's `Projection.NonKeyAttributes` READBACK ORDER is not guaranteed, so
+*    the comparison would be a coin flip); `WarmThroughput` reads back with a
+*    `Status` member the translated shape does not carry, and DynamoDB warm
+*    throughput is increase-only, so a manufactured difference is a real
+*    AWS-side risk.
+*
+* `OnDemandThroughput` IS carried from live on an on-demand table, and that is
+* the second thing this fixes: the `modified` loop derives the `-1` ceiling
+* RESET (the #1160 absent-field-removal class) from the PREVIOUS side, so with
+* a desired-copy baseline a template that dropped `MaxReadRequestUnits` left
+* the old ceiling live in AWS forever while cdkd reported success.
+*
+* REMOVES are still not derivable here and are deliberately absent: an index
+* live but not in the template is in NEITHER side, so no `Delete` is issued.
+* A junk state record cannot distinguish "cdkd created this and the template
+* dropped it" from "somebody added it out of band", the delete is irreversible
+* and a re-create costs a full backfill. The caller names the live-only
+* indexes and points at the remedy.
+*/
+function buildLiveRecoveryGsiBaseline(desiredSdkIndexes, liveIndexes, options) {
+	const liveByName = /* @__PURE__ */ new Map();
+	for (const live of liveIndexes ?? []) if (typeof live.IndexName === "string") liveByName.set(live.IndexName, live);
+	const baseline = [];
+	for (const desired of desiredSdkIndexes) {
+		if (typeof desired.IndexName !== "string") continue;
+		const live = liveByName.get(desired.IndexName);
+		if (!live) continue;
+		const entry = { ...desired };
+		if (!options.carryLiveValues) {
+			baseline.push(entry);
+			continue;
+		}
+		if (options.liveBillingMode === "PROVISIONED") {
+			if (options.uncomparableCapacityIndexNames.has(desired.IndexName)) {
+				baseline.push(entry);
+				continue;
+			}
+			const liveRead = toFiniteNumber(live.ProvisionedThroughput?.ReadCapacityUnits);
+			const liveWrite = toFiniteNumber(live.ProvisionedThroughput?.WriteCapacityUnits);
+			if (desired.ProvisionedThroughput && liveRead !== void 0 && liveWrite !== void 0) entry.ProvisionedThroughput = {
+				ReadCapacityUnits: liveRead,
+				WriteCapacityUnits: liveWrite
+			};
+		} else {
+			const liveRead = toFiniteNumber(live.OnDemandThroughput?.MaxReadRequestUnits);
+			const liveWrite = toFiniteNumber(live.OnDemandThroughput?.MaxWriteRequestUnits);
+			if (liveRead === void 0 && liveWrite === void 0) delete entry.OnDemandThroughput;
+			else entry.OnDemandThroughput = {
+				...liveRead !== void 0 && { MaxReadRequestUnits: liveRead },
+				...liveWrite !== void 0 && { MaxWriteRequestUnits: liveWrite }
+			};
+		}
+		baseline.push(entry);
+	}
+	return baseline;
+}
+/**
 * Translate a CFn `Replicas[].GlobalSecondaryIndexes[]` blob (the
 * `ReplicaGlobalSecondaryIndexSpecification` shape) into the SDK's
 * `ReplicaGlobalSecondaryIndex[]` used by `CreateReplicationGroupMemberAction`
@@ -21781,7 +21939,11 @@ var ApiGatewayV2Provider = class {
 			"Description",
 			"Tags",
 			"StageVariables",
-			"DefaultRouteSettings"
+			"DefaultRouteSettings",
+			"AccessLogSettings",
+			"ClientCertificateId",
+			"DeploymentId",
+			"RouteSettings"
 		])],
 		["AWS::ApiGatewayV2::Integration", /* @__PURE__ */ new Set([
 			"ApiId",
@@ -21800,7 +21962,12 @@ var ApiGatewayV2Provider = class {
 			"AuthorizationType",
 			"AuthorizerId",
 			"AuthorizationScopes",
-			"OperationName"
+			"OperationName",
+			"ApiKeyRequired",
+			"ModelSelectionExpression",
+			"RequestModels",
+			"RequestParameters",
+			"RouteResponseSelectionExpression"
 		])],
 		["AWS::ApiGatewayV2::Authorizer", /* @__PURE__ */ new Set([
 			"ApiId",
@@ -21959,6 +22126,10 @@ var ApiGatewayV2Provider = class {
 				Description: properties["Description"],
 				StageVariables: properties["StageVariables"],
 				DefaultRouteSettings: properties["DefaultRouteSettings"],
+				AccessLogSettings: properties["AccessLogSettings"],
+				ClientCertificateId: properties["ClientCertificateId"],
+				DeploymentId: properties["DeploymentId"],
+				RouteSettings: properties["RouteSettings"],
 				Tags: this.cfnTagsToRecord(properties["Tags"])
 			}));
 			this.logger.debug(`Successfully created API Gateway V2 Stage ${logicalId}: ${stageName}`);
@@ -22056,7 +22227,12 @@ var ApiGatewayV2Provider = class {
 				AuthorizationType: properties["AuthorizationType"],
 				AuthorizerId: properties["AuthorizerId"],
 				AuthorizationScopes: properties["AuthorizationScopes"],
-				OperationName: properties["OperationName"]
+				OperationName: properties["OperationName"],
+				ApiKeyRequired: properties["ApiKeyRequired"],
+				ModelSelectionExpression: properties["ModelSelectionExpression"],
+				RequestModels: properties["RequestModels"],
+				RequestParameters: properties["RequestParameters"],
+				RouteResponseSelectionExpression: properties["RouteResponseSelectionExpression"]
 			}))).RouteId;
 			this.logger.debug(`Successfully created API Gateway V2 Route ${logicalId}: ${routeId}`);
 			return {
@@ -22196,6 +22372,10 @@ var ApiGatewayV2Provider = class {
 			result["Description"] = resp.Description ?? "";
 			if (resp.StageVariables !== void 0) result["StageVariables"] = resp.StageVariables;
 			if (resp.DefaultRouteSettings !== void 0) result["DefaultRouteSettings"] = resp.DefaultRouteSettings;
+			if (resp.AccessLogSettings !== void 0) result["AccessLogSettings"] = resp.AccessLogSettings;
+			if (resp.ClientCertificateId !== void 0) result["ClientCertificateId"] = resp.ClientCertificateId;
+			if (properties?.["DeploymentId"] !== void 0 && resp.DeploymentId !== void 0) result["DeploymentId"] = resp.DeploymentId;
+			if (resp.RouteSettings !== void 0) result["RouteSettings"] = resp.RouteSettings;
 			return result;
 		} catch (err) {
 			if (err instanceof NotFoundException$3) return void 0;
@@ -22241,6 +22421,11 @@ var ApiGatewayV2Provider = class {
 				result["AuthorizationScopes"] = resp.AuthorizationScopes ? [...resp.AuthorizationScopes] : [];
 			}
 			if (resp.OperationName !== void 0) result["OperationName"] = resp.OperationName;
+			result["ApiKeyRequired"] = resp.ApiKeyRequired ?? false;
+			if (resp.ModelSelectionExpression !== void 0) result["ModelSelectionExpression"] = resp.ModelSelectionExpression;
+			if (resp.RequestModels !== void 0) result["RequestModels"] = resp.RequestModels;
+			if (resp.RequestParameters !== void 0) result["RequestParameters"] = resp.RequestParameters;
+			if (resp.RouteResponseSelectionExpression !== void 0) result["RouteResponseSelectionExpression"] = resp.RouteResponseSelectionExpression;
 			return result;
 		} catch (err) {
 			if (err instanceof NotFoundException$3) return void 0;
@@ -22400,8 +22585,11 @@ var ApiGatewayV2Provider = class {
 	* `UpdateStage` keys on `(ApiId, StageName)` — `StageName` is the
 	* physicalId and immutable. Mutable fields cdkd manages:
 	* `AutoDeploy` / `Description` / `StageVariables` /
-	* `DefaultRouteSettings`. `ApiId` is also immutable (a stage cannot be
-	* moved between APIs).
+	* `DefaultRouteSettings` / `AccessLogSettings` / `ClientCertificateId` /
+	* `DeploymentId` / `RouteSettings`. `ApiId` is also immutable (a stage
+	* cannot be moved between APIs). `AccessLogSettings` and per-key
+	* `RouteSettings` can only be CLEARED through their dedicated delete APIs —
+	* see {@link applyStageRemovals}.
 	*/
 	async updateStage(logicalId, physicalId, resourceType, properties, previousProperties) {
 		const apiId = properties["ApiId"] ?? previousProperties["ApiId"];
@@ -22435,7 +22623,40 @@ var ApiGatewayV2Provider = class {
 			input.DefaultRouteSettings = properties["DefaultRouteSettings"];
 			changed = true;
 		}
+		if (properties["AccessLogSettings"] !== void 0 && !this.deepEqual(properties["AccessLogSettings"], previousProperties["AccessLogSettings"])) {
+			input.AccessLogSettings = properties["AccessLogSettings"];
+			changed = true;
+		}
+		const accessLogRemoved = properties["AccessLogSettings"] === void 0 && previousProperties["AccessLogSettings"] !== void 0;
+		if (properties["RouteSettings"] !== void 0 && !this.deepEqual(properties["RouteSettings"], previousProperties["RouteSettings"])) {
+			input.RouteSettings = properties["RouteSettings"];
+			changed = true;
+		}
+		const droppedRouteSettingKeys = this.droppedKeys(properties["RouteSettings"], previousProperties["RouteSettings"]);
+		{
+			const r = this.clearableUpdate(properties["ClientCertificateId"], previousProperties["ClientCertificateId"], "");
+			if (r.changed) {
+				input.ClientCertificateId = r.value;
+				changed = true;
+			}
+		}
+		if (properties["DeploymentId"] !== void 0 && properties["DeploymentId"] !== previousProperties["DeploymentId"]) {
+			input.DeploymentId = properties["DeploymentId"];
+			changed = true;
+		}
 		if (!changed) {
+			if (accessLogRemoved || droppedRouteSettingKeys.length > 0) {
+				try {
+					await this.applyStageRemovals(apiId, physicalId, accessLogRemoved, droppedRouteSettingKeys);
+				} catch (error) {
+					const cause = error instanceof Error ? error : void 0;
+					throw new ProvisioningError(`Failed to update API Gateway V2 Stage ${logicalId}: ${error instanceof Error ? error.message : String(error)}`, resourceType, logicalId, physicalId, cause);
+				}
+				return {
+					physicalId,
+					wasReplaced: false
+				};
+			}
 			this.logger.debug(`No mutable Stage fields changed for ${logicalId}; skipping UpdateStage`);
 			return {
 				physicalId,
@@ -22445,6 +22666,7 @@ var ApiGatewayV2Provider = class {
 		this.logger.debug(`Updating API Gateway V2 Stage ${logicalId}: ${physicalId}`);
 		try {
 			await this.getClient().send(new UpdateStageCommand$1(input));
+			await this.applyStageRemovals(apiId, physicalId, accessLogRemoved, droppedRouteSettingKeys);
 			return {
 				physicalId,
 				wasReplaced: false
@@ -22525,7 +22747,9 @@ var ApiGatewayV2Provider = class {
 	/**
 	* `UpdateRoute` keys on `(ApiId, RouteId)`. Mutable fields cdkd
 	* manages: `RouteKey` / `Target` / `AuthorizationType` /
-	* `AuthorizerId` / `AuthorizationScopes` / `OperationName`.
+	* `AuthorizerId` / `AuthorizationScopes` / `OperationName` /
+	* `ApiKeyRequired` / `RequestModels` / `RequestParameters` /
+	* `ModelSelectionExpression` / `RouteResponseSelectionExpression`.
 	*/
 	async updateRoute(logicalId, physicalId, resourceType, properties, previousProperties) {
 		const apiId = properties["ApiId"] ?? previousProperties["ApiId"];
@@ -22572,7 +22796,46 @@ var ApiGatewayV2Provider = class {
 				changed = true;
 			}
 		}
+		{
+			const r = this.clearableUpdate(properties["ApiKeyRequired"], previousProperties["ApiKeyRequired"], false);
+			if (r.changed) {
+				input.ApiKeyRequired = r.value;
+				changed = true;
+			}
+		}
+		{
+			const merged = this.mapWithRemovals(properties["RequestModels"], previousProperties["RequestModels"]);
+			if (merged !== void 0) {
+				input.RequestModels = merged;
+				changed = true;
+			}
+		}
+		if (properties["RequestParameters"] !== void 0 && !this.deepEqual(properties["RequestParameters"], previousProperties["RequestParameters"])) {
+			input.RequestParameters = properties["RequestParameters"];
+			changed = true;
+		}
+		const droppedRequestParameterKeys = this.droppedKeys(properties["RequestParameters"], previousProperties["RequestParameters"]);
+		if (properties["ModelSelectionExpression"] !== void 0 && properties["ModelSelectionExpression"] !== previousProperties["ModelSelectionExpression"]) {
+			input.ModelSelectionExpression = properties["ModelSelectionExpression"];
+			changed = true;
+		}
+		if (properties["RouteResponseSelectionExpression"] !== void 0 && properties["RouteResponseSelectionExpression"] !== previousProperties["RouteResponseSelectionExpression"]) {
+			input.RouteResponseSelectionExpression = properties["RouteResponseSelectionExpression"];
+			changed = true;
+		}
 		if (!changed) {
+			if (droppedRequestParameterKeys.length > 0) {
+				try {
+					await this.deleteRouteRequestParameters(apiId, physicalId, droppedRequestParameterKeys);
+				} catch (error) {
+					const cause = error instanceof Error ? error : void 0;
+					throw new ProvisioningError(`Failed to update API Gateway V2 Route ${logicalId}: ${error instanceof Error ? error.message : String(error)}`, resourceType, logicalId, physicalId, cause);
+				}
+				return {
+					physicalId,
+					wasReplaced: false
+				};
+			}
 			this.logger.debug(`No mutable Route fields changed for ${logicalId}; skipping UpdateRoute`);
 			return {
 				physicalId,
@@ -22582,6 +22845,7 @@ var ApiGatewayV2Provider = class {
 		this.logger.debug(`Updating API Gateway V2 Route ${logicalId}: ${physicalId}`);
 		try {
 			await this.getClient().send(new UpdateRouteCommand(input));
+			await this.deleteRouteRequestParameters(apiId, physicalId, droppedRequestParameterKeys);
 			return {
 				physicalId,
 				wasReplaced: false
@@ -22722,16 +22986,85 @@ var ApiGatewayV2Provider = class {
 		};
 	}
 	/**
-	* Resolve a `Record<string, string>` update field (`StageVariables`,
-	* Integration `RequestParameters`) with per-key removal awareness.
+	* Keys present in `previous` but absent from `next` — the set a
+	* merge-semantics map silently keeps unless each is deleted BY NAME. A
+	* whole-block removal (`next` undefined) therefore yields every previous key.
+	*/
+	droppedKeys(next, previous) {
+		if (previous == null || typeof previous !== "object" || Array.isArray(previous)) return [];
+		const prevMap = previous;
+		const nextMap = next != null && typeof next === "object" && !Array.isArray(next) ? next : {};
+		return Object.keys(prevMap).filter((key) => !Object.prototype.hasOwnProperty.call(nextMap, key));
+	}
+	/**
+	* Send a delete that is idempotent by intent.
+	*
+	* These removal deletes run AFTER the merge-Update in the same update, so a
+	* partial failure (throttle on the second of two) leaves state unsaved and
+	* the next deploy recomputes the SAME dropped-key set and re-issues an
+	* already-applied delete. A console-side removal produces the same shape.
+	* Treating NotFound as success is what keeps that from becoming a permanent
+	* failure loop.
+	*/
+	async sendTolerantOfNotFound(send) {
+		try {
+			await send();
+		} catch (error) {
+			if (error instanceof NotFoundException$3) return;
+			throw error;
+		}
+	}
+	/**
+	* The two Stage members `UpdateStage` cannot clear.
+	*
+	* Both MERGE server-side — live-probed 2026-08-11: a stage keeps its
+	* `AccessLogSettings` verbatim through an `UpdateStage` that omits the
+	* member — so a removal that only omits the field is the silent no-op issue
+	* #1160 tracks (access logging, and its billing, keep running). AWS ships
+	* dedicated delete APIs for both; this mirrors the `DeleteCorsConfiguration`
+	* path on `::Api`.
+	*
+	* KNOWN BOUND: `DeleteRouteSettings` removes a whole ROUTE KEY, so dropping
+	* one member INSIDE a kept entry (`LoggingLevel` while `ThrottlingRateLimit`
+	* stays) still merges and survives — the #1225 sub-field class, one level
+	* below what this closes. Same for a partial `AccessLogSettings`.
+	*/
+	async applyStageRemovals(apiId, stageName, accessLogRemoved, droppedRouteSettingKeys) {
+		if (accessLogRemoved) await this.sendTolerantOfNotFound(() => this.getClient().send(new DeleteAccessLogSettingsCommand({
+			ApiId: apiId,
+			StageName: stageName
+		})));
+		for (const routeKey of droppedRouteSettingKeys) await this.sendTolerantOfNotFound(() => this.getClient().send(new DeleteRouteSettingsCommand({
+			ApiId: apiId,
+			StageName: stageName,
+			RouteKey: routeKey
+		})));
+	}
+	/**
+	* `RequestParameters` on a Route is an OBJECT-valued merge map, so a dropped
+	* key needs the per-key delete API (live-probed 2026-08-11:
+	* `DeleteRouteRequestParameter` clears exactly one parameter).
+	*/
+	async deleteRouteRequestParameters(apiId, routeId, droppedKeys) {
+		for (const key of droppedKeys) await this.sendTolerantOfNotFound(() => this.getClient().send(new DeleteRouteRequestParameterCommand({
+			ApiId: apiId,
+			RouteId: routeId,
+			RequestParameterKey: key
+		})));
+	}
+	/**
+	* Resolve a `Record<string, string>` update field (`StageVariables`, Route
+	* `RequestModels`, Integration `RequestParameters`) with per-key removal
+	* awareness.
 	*
 	* These maps also merge on the AWS side: sending `{}` (or a map missing
 	* a previously-present key) does NOT delete the dropped key — it is kept
-	* live. Live-probed 2026-07-22: a key is cleared only by sending it with
-	* an empty-string value. So the resolved map is `next` plus every key
-	* present in `previous` but absent from `next`, set to `''`. Whole-block
-	* removal (next `undefined`, previous populated) therefore sends every
-	* old key as `''`. Returns `undefined` when nothing changed.
+	* live. Live-probed 2026-07-22 (and again 2026-08-11 for `RequestModels`):
+	* a key is cleared only by sending it with an empty-string value. So the
+	* resolved map is `next` plus every key present in `previous` but absent
+	* from `next`, set to `''`. Whole-block removal (next `undefined`, previous
+	* populated) therefore sends every old key as `''`. Returns `undefined` when
+	* nothing changed.
 	*/
 	mapWithRemovals(next, previous) {
 		if (this.deepEqual(next, previous)) return void 0;
@@ -68374,7 +68707,7 @@ function createMigrateCommand() {
 */
 function buildProgram() {
 	const program = new Command();
-	program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.280.3");
+	program.name("cdkd").description("CDK Direct - Deploy AWS CDK apps directly via SDK/Cloud Control API").version("0.280.5");
 	program.hook("preAction", (_thisCommand, actionCommand) => {
 		const { profile } = actionCommand.optsWithGlobals();
 		if (profile !== void 0) process.env["AWS_PROFILE"] = profile;