@rio-cloud/cdk-v2-constructs 8.2.1 → 8.4.0-alpha.0

package/.jsii

@@ -9106,7 +9106,7 @@
   },
   "name": "@rio-cloud/cdk-v2-constructs",
   "readme": {
-    "markdown": "# RIO CDK Constructs\n\nThis package contains CDK2 constructs for RIO teams.\n\n> NPM: `@rio-cloud/cdk-v2-constructs`\n\n## Bootstrapping of CDK project\n\n```\n$ npx cdk init --language typescript\n```\n\n## Installation\n\n```\n$ npm install --save @rio-cloud/cdk-v2-constructs\n```\n\n## See also\n\n * [How to contribute](./docs/contribution.md)\n * [Changelog](./docs/changelog.md)\n * [brief API description](./docs/API.md)\n\n## Internal documentation for library devs\n[Documentation](./docs/developers-readme.md)\n\n## Constructs overview (Under construction...)\n\n### Watchful\n\nWatchful constructs help generate some default monitors based on the resources defined in your stack. E.g. - If your stack contains a lambda function, and you configure watchful construct, then it will create out of box metric monitors for Throttling, Lambda error and Log error monitors. The ever-growing list of resources that watchful creates monitors for as of today are:\n\n- Application load balancer\n- Cloudfront\n- Documentdb\n- Dynamodb\n- Fargate\n- Lambda\n- RDS\n\nSimply add the following to your CDK stack to get started.\n```\n  import * as rio from '@rio-cloud/cdk-v2-constructs';\n    ...\n    const dw = new rio.watchfulv2.Watchful(this, 'Watchful', {\n      serviceName,\n    });\n    dw.watchScope(this); // Generates alarms for all supported resources\n    ...\n```\n\nThere are options to override some defaults too. Please be aware that the library is very opinionated and is written with the most general use cases in mind. It is necessary to keep the use of the library simple enough, which means that there is only limited flexibility regarding the configuration options. Having said that, feel free to reach out to team CLAID over slack #rio-platform-support in case of feature requests.\n\nThe broad classification of the monitors created by watchful are\n- Log error monitors\n- Metrics Query monitors: Basically everything other than log error monitors\n\nFor Metrics query monitors, you can configure the priority (defaults as 3). For log error monitors, you can configure priority, renotification interval and can configure if the auto close of the monitor is disabled.\n```\n    ...\n    const dw = new Watchful(stack, 'Watchful2', {\n      logErrorMonitorConfig: {\n        disableAutoClose: true,\n        renotifyInterval: 150,\n        priority: 4,\n      },\n      queryErrorMonitorConfig: {\n        priority: 4\n      }\n    });\n    dw.watchScope(stack);\n```\n\nThere is an `overrideAlarmThreshold` method which can be used to override the default watchful thresholds. Please make sure to use the method before the `watchscope` function.\nE.g. -\n```\n...\nconst dw = new Watchful(stack, 'Watchful', {});\ndw.overrideAlarmThreshold({\n  monitoredResourceScope: lambdaA,\n  monitorType: MonitorType.ERRORS,\n  threshold: 5,\n});\ndw.watchScope(stack);\n```\n\n### ClassifyPipelineType\n\nThe pipelines can be tagged with key 'pipeline_type' to the following values:\n\n* deploy: To tag the production pipeline releasing the application\n* branch: The branch pipeline. Mostly used to test contributions / renovate updates\n* vulnerability: The vulnerability pipeline\n\nThe construct `ClassifyPipelineType` can be used to tag the pipeline accordingly. This tag is also picked up by the Datadog pipeline metric used to monitor the pipelines. It is added as a tag to the metric. This gives you more flexibility with managing the monitors also. E.g. some teams don't want to get alerted for branch pipelines. You can then leverage this metric tag to filter the pipelines.\n\nExample:\n\n```typescript\nconst pipeline = new pipelines.CodePipeline(this, 'Pipeline', {\n      ...\n    });\nrio.ClassifyPipelineType.apply(pipeline, rio.RioPipelineType.DEPLOY);\n```\n"
+    "markdown": "# RIO CDK Constructs\n\nThis package contains CDK2 constructs for RIO teams.\n\n> NPM: `@rio-cloud/cdk-v2-constructs`\n\n## Bootstrapping of CDK project\n\n```\n$ npx cdk init --language typescript\n```\n\n## Installation\n\n```\n$ npm install --save @rio-cloud/cdk-v2-constructs\n```\n\n## See also\n\n * [How to contribute](./docs/contribution.md)\n * [Changelog](./docs/changelog.md)\n * [brief API description](./docs/API.md)\n * [Agent documentation](./docs/AGENTS_DOCUMENTATION.md)\n\n## Internal documentation for library devs\n[Documentation](./docs/developers-readme.md)\n\n## Constructs overview (Under construction...)\n\n### Watchful\n\nWatchful constructs help generate some default monitors based on the resources defined in your stack. E.g. - If your stack contains a lambda function, and you configure watchful construct, then it will create out of box metric monitors for Throttling, Lambda error and Log error monitors. The ever-growing list of resources that watchful creates monitors for as of today are:\n\n- Application load balancer\n- Cloudfront\n- Documentdb\n- Dynamodb\n- Fargate\n- Lambda\n- RDS\n\nSimply add the following to your CDK stack to get started.\n```\n  import * as rio from '@rio-cloud/cdk-v2-constructs';\n    ...\n    const dw = new rio.watchfulv2.Watchful(this, 'Watchful', {\n      serviceName,\n    });\n    dw.watchScope(this); // Generates alarms for all supported resources\n    ...\n```\n\nThere are options to override some defaults too. Please be aware that the library is very opinionated and is written with the most general use cases in mind. It is necessary to keep the use of the library simple enough, which means that there is only limited flexibility regarding the configuration options. Having said that, feel free to reach out to team CLAID over slack #rio-platform-support in case of feature requests.\n\nThe broad classification of the monitors created by watchful are\n- Log error monitors\n- Metrics Query monitors: Basically everything other than log error monitors\n\nFor Metrics query monitors, you can configure the priority (defaults as 3). For log error monitors, you can configure priority, renotification interval and can configure if the auto close of the monitor is disabled.\n```\n    ...\n    const dw = new Watchful(stack, 'Watchful2', {\n      logErrorMonitorConfig: {\n        disableAutoClose: true,\n        renotifyInterval: 150,\n        priority: 4,\n      },\n      queryErrorMonitorConfig: {\n        priority: 4\n      }\n    });\n    dw.watchScope(stack);\n```\n\nThere is an `overrideAlarmThreshold` method which can be used to override the default watchful thresholds. Please make sure to use the method before the `watchscope` function.\nE.g. -\n```\n...\nconst dw = new Watchful(stack, 'Watchful', {});\ndw.overrideAlarmThreshold({\n  monitoredResourceScope: lambdaA,\n  monitorType: MonitorType.ERRORS,\n  threshold: 5,\n});\ndw.watchScope(stack);\n```\n\n### ClassifyPipelineType\n\nThe pipelines can be tagged with key 'pipeline_type' to the following values:\n\n* deploy: To tag the production pipeline releasing the application\n* branch: The branch pipeline. Mostly used to test contributions / renovate updates\n* vulnerability: The vulnerability pipeline\n\nThe construct `ClassifyPipelineType` can be used to tag the pipeline accordingly. This tag is also picked up by the Datadog pipeline metric used to monitor the pipelines. It is added as a tag to the metric. This gives you more flexibility with managing the monitors also. E.g. some teams don't want to get alerted for branch pipelines. You can then leverage this metric tag to filter the pipelines.\n\nExample:\n\n```typescript\nconst pipeline = new pipelines.CodePipeline(this, 'Pipeline', {\n      ...\n    });\nrio.ClassifyPipelineType.apply(pipeline, rio.RioPipelineType.DEPLOY);\n```\n"
   },
   "repository": {
     "type": "git",
@@ -9124,49 +9124,49 @@
     "@rio-cloud/cdk-v2-constructs.datadog": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 11
+        "line": 12
       },
       "symbolId": "src/datadog/index:"
     },
     "@rio-cloud/cdk-v2-constructs.datadogv2": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 12
+        "line": 13
       },
       "symbolId": "src/datadogv2/index:"
     },
     "@rio-cloud/cdk-v2-constructs.ecr": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 13
+        "line": 14
       },
       "symbolId": "src/ecr/index:"
     },
     "@rio-cloud/cdk-v2-constructs.fargate": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 14
+        "line": 15
       },
       "symbolId": "src/fargate/index:"
     },
     "@rio-cloud/cdk-v2-constructs.kafka": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 19
+        "line": 20
       },
       "symbolId": "src/kafka/index:"
     },
     "@rio-cloud/cdk-v2-constructs.ses": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 27
+        "line": 26
       },
       "symbolId": "src/ses/index:"
     },
     "@rio-cloud/cdk-v2-constructs.watchfulv2": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 30
+        "line": 29
       },
       "symbolId": "src/watchfulv2/index:"
     }
@@ -9866,6 +9866,7 @@
     "@rio-cloud/cdk-v2-constructs.BackupPolicy": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
+        "remarks": "Apply this to stateful resources that must be discovered by the RIO landing-zone backup solution.\n\nExample:\n```ts\nBackupPolicy.apply(table, Criticality.HIGH);\n```",
         "stability": "stable",
         "summary": "Helper function to tag constructs with correct backup values to be picked up by the rio landing zone backup solution."
       },
@@ -9878,7 +9879,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/backup/backup-policy.ts",
-        "line": 17
+        "line": 24
       },
       "methods": [
         {
@@ -9887,7 +9888,7 @@
           },
           "locationInModule": {
             "filename": "src/backup/backup-policy.ts",
-            "line": 18
+            "line": 25
           },
           "name": "apply",
           "parameters": [
@@ -10216,7 +10217,7 @@
     "@rio-cloud/cdk-v2-constructs.ClassifyPipelineType": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
-        "remarks": "These tags are eventually used in datadog pipeline metrics to filter specific pipeline types\nEg - you can decide to not monitor branch pipelines",
+        "remarks": "These tags are eventually used in datadog pipeline metrics to filter specific pipeline types\nEg - you can decide to not monitor branch pipelines\n\nExample:\n```ts\nClassifyPipelineType.apply(pipeline, RioPipelineType.DEPLOY);\n```",
         "stability": "stable",
         "summary": "Helper function to tag the pipeline with correct pipeline type."
       },
@@ -10229,7 +10230,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/pipeline/rio-pipeline-type.ts",
-        "line": 29
+        "line": 34
       },
       "methods": [
         {
@@ -10238,7 +10239,7 @@
           },
           "locationInModule": {
             "filename": "src/pipeline/rio-pipeline-type.ts",
-            "line": 30
+            "line": 35
           },
           "name": "apply",
           "parameters": [
@@ -12555,6 +12556,88 @@
       ],
       "symbolId": "src/contributions/team-claid/datadog-usage-monitoring/datadog-usage-monitoring:DatadogUsageMonitoringProps"
     },
+    "@rio-cloud/cdk-v2-constructs.DeliveryPerformanceMonitoringOverride": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "docs": {
+        "remarks": "Example:\n```typescript\nimport { DeliveryPerformanceMonitoringOverride } from '@rio-cloud/cdk-v2-constructs'\nimport { pipeline } from './pipeline'\n\nDeliveryPerformanceMonitoringOverride.include(pipeline)\nDeliveryPerformanceMonitoringOverride.exclude(pipeline)\n```",
+        "see": "https://bitbucket.collaboration-man.com/projects/RIODEV/repos/delivery-performance-monitoring/browse",
+        "stability": "stable",
+        "summary": "Convenience helpers to enforce including or excluding CodePipeline pipelines from delivery-performance-monitoring regardless of the default detection mechanism."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.DeliveryPerformanceMonitoringOverride",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/pipeline/delivery-performance-monitoring-override.ts",
+        "line": 30
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Marks the pipeline as never tracked by delivery-performance-monitoring."
+          },
+          "locationInModule": {
+            "filename": "src/pipeline/delivery-performance-monitoring-override.ts",
+            "line": 41
+          },
+          "name": "exclude",
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "union": {
+                  "types": [
+                    {
+                      "fqn": "aws-cdk-lib.pipelines.PipelineBase"
+                    },
+                    {
+                      "fqn": "aws-cdk-lib.aws_codepipeline.IPipeline"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Marks the pipeline as always tracked by delivery-performance-monitoring account-module."
+          },
+          "locationInModule": {
+            "filename": "src/pipeline/delivery-performance-monitoring-override.ts",
+            "line": 34
+          },
+          "name": "include",
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "union": {
+                  "types": [
+                    {
+                      "fqn": "aws-cdk-lib.pipelines.PipelineBase"
+                    },
+                    {
+                      "fqn": "aws-cdk-lib.aws_codepipeline.IPipeline"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "static": true
+        }
+      ],
+      "name": "DeliveryPerformanceMonitoringOverride",
+      "symbolId": "src/pipeline/delivery-performance-monitoring-override:DeliveryPerformanceMonitoringOverride"
+    },
     "@rio-cloud/cdk-v2-constructs.DownloadableDatadogDashboard": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "aws-cdk-lib.CfnResource",
@@ -13987,8 +14070,9 @@
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
       "docs": {
+        "remarks": "Prefer this construct for new topics. Keep the default retention and partition count unless there is a concrete\noperational requirement to change them. Partition increases are permanent and may require coordination with CLAID\nwhen service limits are exceeded.\n\nExample:\n```ts\nnew KafkaTopicV4(this, 'EventsTopic', {\n  name: 'billing-view.events',\n  metadata: {\n    description: 'Domain events emitted by Billing View.',\n    audience: 'company-internal',\n    recoveryPolicy: 'recoverable',\n  },\n  acl: {\n    write: ['billing-view'],\n    read: ['billing-consumer'],\n  },\n  isLogCompacted: false,\n});\n```",
         "stability": "stable",
-        "summary": "Construct to create a kafka topic."
+        "summary": "Construct to create a version 4 RIO Kafka topic."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.KafkaTopicV4",
       "initializer": {
@@ -13997,7 +14081,7 @@
         },
         "locationInModule": {
           "filename": "src/kafka/kafka-topic.ts",
-          "line": 281
+          "line": 302
         },
         "parameters": [
           {
@@ -14023,7 +14107,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/kafka/kafka-topic.ts",
-        "line": 280
+        "line": 301
       },
       "name": "KafkaTopicV4",
       "symbolId": "src/kafka/kafka-topic:KafkaTopicV4"
@@ -14849,197 +14933,763 @@
         {
           "docs": {
             "stability": "stable",
-            "summary": "Read throttle events for dynamodb."
+            "summary": "Read throttle events for dynamodb."
+          },
+          "name": "READ_THROTTLE_EVENTS"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Write throttle events for dynamodb."
+          },
+          "name": "WRITE_THROTTLE_EVENTS"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Throttle request evebts for dynamodb."
+          },
+          "name": "THROTTLED_REQUESTS_EVENTS"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Memory utilization for ECS."
+          },
+          "name": "MEMORY_UTILIZATION"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Log error monitor for ECS and lambda."
+          },
+          "name": "LOG_ERROR_MONITOR"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Inovation errors with lambda."
+          },
+          "name": "ERRORS"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Throttle metrics for lambda."
+          },
+          "name": "THROTTLES"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Runtime duration metrics for lambda."
+          },
+          "name": "DURATION"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Free memory for Document DB and RDS."
+          },
+          "name": "FREEABLE_MEMORY"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Connection error metrics for Application load balancer target group."
+          },
+          "name": "CONNECTION_ERROR"
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Running fargate tasks monitor."
+          },
+          "name": "RUNNING_TASKS"
+        }
+      ],
+      "name": "MonitorType",
+      "symbolId": "src/watchful/monitor-type:MonitorType"
+    },
+    "@rio-cloud/cdk-v2-constructs.NormalizedTestTemplate": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "docs": {
+        "example": "  const appStack = new AppStack()\n  const template = Template.fromStack(appStack);\n  expect(NormalizedTemplate.from(template).toMatchSnapshot();",
+        "remarks": "The fromTemplate() method works by applying replacements for specific values with a\nplaceholder value. This is particularly useful because elements like the S3\nkeys for Lambda code assets include hash strings that change with every dependency update. Normalizing\nthese values prevents false negatives during template object comparisons.\n\nCurrent replacements:\n- SHA-256 hash strings (64 alphanumeric characters) are replaced with 'dummy-cdk-asset'.\n- Tags with Key 'dd_cdk_construct' are replaced with 'dummy-datadog-version'.\n- LatestNodeRuntimeMap with 'dummyKey': 'dummyValue'",
+        "stability": "stable",
+        "summary": "A utility class that normalizes a Template object to simplify template comparisons in tests."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.NormalizedTestTemplate",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/test/normalized-test-template.ts",
+        "line": 20
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/test/normalized-test-template.ts",
+            "line": 21
+          },
+          "name": "fromTemplate",
+          "parameters": [
+            {
+              "name": "template",
+              "type": {
+                "fqn": "aws-cdk-lib.assertions.Template"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.assertions.Template"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "NormalizedTestTemplate",
+      "symbolId": "src/test/normalized-test-template:NormalizedTestTemplate"
+    },
+    "@rio-cloud/cdk-v2-constructs.OverrideAlarmThresholdProps": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.OverrideAlarmThresholdProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/watchful/watchful.ts",
+        "line": 59
+      },
+      "name": "OverrideAlarmThresholdProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The scope of the resource for which the threshold needs to be overriden."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/watchful/watchful.ts",
+            "line": 63
+          },
+          "name": "monitoredResourceScope",
+          "type": {
+            "fqn": "constructs.Construct"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Eg - Errors, Thresholds, LogErrorMonitor",
+            "stability": "stable",
+            "summary": "Id of the monitor that needs to be overriden."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/watchful/watchful.ts",
+            "line": 69
+          },
+          "name": "monitorType",
+          "type": {
+            "fqn": "@rio-cloud/cdk-v2-constructs.MonitorType"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The threshold that needs to be set."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/watchful/watchful.ts",
+            "line": 74
+          },
+          "name": "threshold",
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "src/watchful/watchful:OverrideAlarmThresholdProps"
+    },
+    "@rio-cloud/cdk-v2-constructs.ParallelBuildProject": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "base": "aws-cdk-lib.aws_codebuild.PipelineProject",
+      "docs": {
+        "stability": "stable",
+        "summary": "CodeBuild project for parallel pipeline build work."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.ParallelBuildProject",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+          "line": 142
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@rio-cloud/cdk-v2-constructs.ParallelBuildProjectProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+        "line": 136
+      },
+      "name": "ParallelBuildProject",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Hash of buildspec, project environment, and action-level environment inputs."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 140
+          },
+          "name": "projectConfigHash",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project:ParallelBuildProject"
+    },
+    "@rio-cloud/cdk-v2-constructs.ParallelBuildProjectProps": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Properties for a CodeBuild project that is injected as a parallel CodePipeline action."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.ParallelBuildProjectProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+        "line": 17
+      },
+      "name": "ParallelBuildProjectProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Path to the buildspec yaml file, resolved from the consuming CDK app's current working directory."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 21
+          },
+          "name": "buildSpecPath",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Name of the hosted zone."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 31
+          },
+          "name": "hostedZoneName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Name of the service."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 26
+          },
+          "name": "serviceName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Additional project-level environment variables."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 67
+          },
+          "name": "additionalEnvironmentVariables",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_codebuild.BuildEnvironmentVariable"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Defaults to the ARM Amazon Linux 2023 standard image used by WebEDI-style services.",
+            "stability": "stable",
+            "summary": "Build image for the project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 55
+          },
+          "name": "buildImage",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codebuild.IBuildImage"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Caching strategy to use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 48
+          },
+          "name": "cache",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codebuild.Cache"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Defaults to `BUILD_GENERAL1_LARGE`.",
+            "stability": "stable",
+            "summary": "Compute type for the project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 62
+          },
+          "name": "computeType",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codebuild.ComputeType"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Action-level environment values used when calculating `projectConfigHash`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 43
+          },
+          "name": "env",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "When provided, its URI is exposed as `REPO_URI`.",
+            "stability": "stable",
+            "summary": "Repository used by image build steps."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 38
+          },
+          "name": "repo",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ecr.IRepository"
+          }
+        }
+      ],
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project:ParallelBuildProjectProps"
+    },
+    "@rio-cloud/cdk-v2-constructs.PipelineBuildActionProps": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Properties for a CodeBuild action added by `PipelineBuildStageActions`."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildActionProps",
+      "interfaces": [
+        "aws-cdk-lib.aws_codepipeline.CommonAwsActionProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+        "line": 25
+      },
+      "name": "PipelineBuildActionProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The action's CodeBuild project."
           },
-          "name": "READ_THROTTLE_EVENTS"
-        },
-        {
-          "docs": {
-            "stability": "stable",
-            "summary": "Write throttle events for dynamodb."
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 39
           },
-          "name": "WRITE_THROTTLE_EVENTS"
+          "name": "project",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codebuild.IProject"
+          }
         },
         {
+          "abstract": true,
           "docs": {
+            "default": "CodeBuildActionType.BUILD",
             "stability": "stable",
-            "summary": "Throttle request evebts for dynamodb."
+            "summary": "The type of CodeBuild action."
           },
-          "name": "THROTTLED_REQUESTS_EVENTS"
-        },
-        {
-          "docs": {
-            "stability": "stable",
-            "summary": "Memory utilization for ECS."
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 46
           },
-          "name": "MEMORY_UTILIZATION"
+          "name": "actionType",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codepipeline_actions.CodeBuildActionType"
+          }
         },
         {
+          "abstract": true,
           "docs": {
+            "default": "true",
             "stability": "stable",
-            "summary": "Log error monitor for ECS and lambda."
+            "summary": "Whether to check for secrets in plaintext environment variables."
           },
-          "name": "LOG_ERROR_MONITOR"
-        },
-        {
-          "docs": {
-            "stability": "stable",
-            "summary": "Inovation errors with lambda."
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 58
           },
-          "name": "ERRORS"
+          "name": "checkSecretsInPlainTextEnvVariables",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
         },
         {
+          "abstract": true,
           "docs": {
+            "default": "false",
             "stability": "stable",
-            "summary": "Throttle metrics for lambda."
+            "summary": "Combine build artifacts for batch builds."
           },
-          "name": "THROTTLES"
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 72
+          },
+          "name": "combineBatchBuildArtifacts",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
         },
         {
+          "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Runtime duration metrics for lambda."
+            "summary": "Environment variables to pass to the CodeBuild project when this action executes."
           },
-          "name": "DURATION"
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 51
+          },
+          "name": "environmentVariables",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_codebuild.BuildEnvironmentVariable"
+              },
+              "kind": "map"
+            }
+          }
         },
         {
+          "abstract": true,
           "docs": {
+            "default": "false",
             "stability": "stable",
-            "summary": "Free memory for Document DB and RDS."
+            "summary": "Trigger a batch build."
           },
-          "name": "FREEABLE_MEMORY"
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 65
+          },
+          "name": "executeBatchBuild",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
         },
         {
+          "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Connection error metrics for Application load balancer target group."
+            "summary": "The list of additional input artifacts for this action."
           },
-          "name": "CONNECTION_ERROR"
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 29
+          },
+          "name": "extraInputs",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_codepipeline.Artifact"
+              },
+              "kind": "array"
+            }
+          }
         },
         {
+          "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Running fargate tasks monitor."
+            "summary": "The list of output artifacts for this action."
           },
-          "name": "RUNNING_TASKS"
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 34
+          },
+          "name": "outputs",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_codepipeline.Artifact"
+              },
+              "kind": "array"
+            }
+          }
         }
       ],
-      "name": "MonitorType",
-      "symbolId": "src/watchful/monitor-type:MonitorType"
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions:PipelineBuildActionProps"
     },
-    "@rio-cloud/cdk-v2-constructs.NormalizedTestTemplate": {
+    "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActions": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
+      "base": "constructs.Construct",
       "docs": {
-        "example": "  const appStack = new AppStack()\n  const template = Template.fromStack(appStack);\n  expect(NormalizedTemplate.from(template).toMatchSnapshot();",
-        "remarks": "The fromTemplate() method works by applying replacements for specific values with a\nplaceholder value. This is particularly useful because elements like the S3\nkeys for Lambda code assets include hash strings that change with every dependency update. Normalizing\nthese values prevents false negatives during template object comparisons.\n\nCurrent replacements:\n- SHA-256 hash strings (64 alphanumeric characters) are replaced with 'dummy-cdk-asset'.\n- Tags with Key 'dd_cdk_construct' are replaced with 'dummy-datadog-version'.\n- LatestNodeRuntimeMap with 'dummyKey': 'dummyValue'",
         "stability": "stable",
-        "summary": "A utility class that normalizes a Template object to simplify template comparisons in tests."
+        "summary": "Adds CodeBuild actions next to an existing action in the same pipeline stage."
       },
-      "fqn": "@rio-cloud/cdk-v2-constructs.NormalizedTestTemplate",
+      "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActions",
       "initializer": {
         "docs": {
           "stability": "stable"
-        }
+        },
+        "locationInModule": {
+          "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+          "line": 89
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActionsProps"
+            }
+          }
+        ]
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/test/normalized-test-template.ts",
-        "line": 20
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+        "line": 78
       },
       "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Adds a CodeBuild action using the located action's first input artifact."
           },
           "locationInModule": {
-            "filename": "src/test/normalized-test-template.ts",
-            "line": 21
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 107
           },
-          "name": "fromTemplate",
+          "name": "addBuildAction",
           "parameters": [
             {
-              "name": "template",
+              "name": "props",
               "type": {
-                "fqn": "aws-cdk-lib.assertions.Template"
+                "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildActionProps"
               }
             }
-          ],
-          "returns": {
-            "type": {
-              "fqn": "aws-cdk-lib.assertions.Template"
-            }
-          },
-          "static": true
+          ]
         }
       ],
-      "name": "NormalizedTestTemplate",
-      "symbolId": "src/test/normalized-test-template:NormalizedTestTemplate"
-    },
-    "@rio-cloud/cdk-v2-constructs.OverrideAlarmThresholdProps": {
-      "assembly": "@rio-cloud/cdk-v2-constructs",
-      "datatype": true,
-      "docs": {
-        "stability": "stable"
-      },
-      "fqn": "@rio-cloud/cdk-v2-constructs.OverrideAlarmThresholdProps",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "src/watchful/watchful.ts",
-        "line": 59
-      },
-      "name": "OverrideAlarmThresholdProps",
+      "name": "PipelineBuildStageActions",
       "properties": [
         {
-          "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "The scope of the resource for which the threshold needs to be overriden."
+            "summary": "First input artifact of the located action."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/watchful/watchful.ts",
-            "line": 63
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 87
           },
-          "name": "monitoredResourceScope",
+          "name": "sourceArtifact",
           "type": {
-            "fqn": "constructs.Construct"
+            "fqn": "aws-cdk-lib.aws_codepipeline.Artifact"
           }
         },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Stage that contains the located action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 82
+          },
+          "name": "stage",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codepipeline.IStage"
+          }
+        }
+      ],
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions:PipelineBuildStageActions"
+    },
+    "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActionsProps": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Properties for locating an existing generated CodePipeline action."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActionsProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+        "line": 10
+      },
+      "name": "PipelineBuildStageActionsProps",
+      "properties": [
         {
           "abstract": true,
           "docs": {
-            "remarks": "Eg - Errors, Thresholds, LogErrorMonitor",
             "stability": "stable",
-            "summary": "Id of the monitor that needs to be overriden."
+            "summary": "Name of the action whose input artifact should be reused."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/watchful/watchful.ts",
-            "line": 69
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 19
           },
-          "name": "monitorType",
+          "name": "actionName",
           "type": {
-            "fqn": "@rio-cloud/cdk-v2-constructs.MonitorType"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "The threshold that needs to be set."
+            "summary": "The underlying CodePipeline generated by `aws-cdk-lib/pipelines.CodePipeline`."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/watchful/watchful.ts",
-            "line": 74
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 14
           },
-          "name": "threshold",
+          "name": "pipeline",
           "type": {
-            "primitive": "number"
+            "fqn": "aws-cdk-lib.aws_codepipeline.Pipeline"
           }
         }
       ],
-      "symbolId": "src/watchful/watchful:OverrideAlarmThresholdProps"
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions:PipelineBuildStageActionsProps"
     },
     "@rio-cloud/cdk-v2-constructs.PipelineFeatures": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
@@ -15971,7 +16621,9 @@
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable"
+        "remarks": "This construct bundles the pieces that most RIO backend services need:\nan ECS task definition, the application container, a Datadog sidecar,\noptional FireLens log routing, optional ALB target group wiring, and the\nECS Fargate service itself.\n\nIt also derives Datadog tags and environment variables from `stage`,\n`serviceName`, `version`, the AWS account, and the standard RIO landing-zone\nSSM parameters. Do not set `DD_ENV`, `DD_SERVICE`, `DD_VERSION`, `DD_TAGS`,\nor `DD_LOGS_INJECTION` manually in the application container environment.\n\nUse this construct when you want the RIO paved road for a web-facing or\nservice-style Fargate workload and you want the defaults for observability,\nDatadog service catalog registration, and common AWS wiring to be handled\nfor you.\nIf you need a fully custom ECS setup, or a different deployment strategy\nsuch as blue/green, use a lower-level construct or the blue/green variant\ninstead.\n\nTo use it, provide:\n- `stage`, `serviceName`, and `version` for service identity\n- `vpc` and optionally an existing `cluster`\n- `containerDefinitionOption.image` for the application image\n- `fargateOptions.cpu` and `fargateOptions.memoryLimitMiB` for task sizing\n- optional `datadogOptions`, `frameworks`, and `loadBalancerOptions`\n\nExample:\n```ts\nconst service = new RioFargateService(this, 'Service', {\n  stage: 'prod',\n  serviceName: 'billing-view',\n  version: process.env.GIT_VERSION ?? 'local',\n  vpc: RioLandingZone.getDefaultVpc(this),\n  containerDefinitionOption: {\n    image: ecs.ContainerImage.fromRegistry('example/billing-view:latest'),\n  },\n  fargateOptions: {\n    cpu: 512,\n    memoryLimitMiB: 1024,\n  },\n});\n```",
+        "stability": "stable",
+        "summary": "Creates an opinionated ECS Fargate service for RIO applications."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.RioFargateService",
       "initializer": {
@@ -15980,7 +16632,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate/rio-fargate-service.ts",
-          "line": 406
+          "line": 451
         },
         "parameters": [
           {
@@ -16009,7 +16661,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 365
+        "line": 410
       },
       "name": "RioFargateService",
       "properties": [
@@ -16021,7 +16673,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 402
+            "line": 447
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -16036,7 +16688,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 398
+            "line": 443
           },
           "name": "datadogSideCarContainerDefinition",
           "type": {
@@ -16050,7 +16702,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 403
+            "line": 448
           },
           "name": "service",
           "type": {
@@ -16064,7 +16716,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 397
+            "line": 442
           },
           "name": "serviceContainerDefinition",
           "type": {
@@ -16078,7 +16730,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 400
+            "line": 445
           },
           "name": "taskDefinition",
           "type": {
@@ -16092,7 +16744,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 399
+            "line": 444
           },
           "name": "logRouterContainerDefinition",
           "optional": true,
@@ -16107,7 +16759,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 404
+            "line": 449
           },
           "name": "targetGroup",
           "optional": true,
@@ -16816,8 +17468,9 @@
     "@rio-cloud/cdk-v2-constructs.RioLandingZone": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
+        "remarks": "Use these helpers instead of hard-coded VPC IDs, hosted-zone IDs, subnet IDs, or standard team/account SSM parameter\nnames.\n\nExample:\n```ts\nconst vpc = RioLandingZone.getDefaultVpc(this);\nconst hostedZone = RioLandingZone.getDefaultHostedZone(this);\nconst teamIdentifier = RioLandingZone.getTeamIdentifierParameter(this).stringValue;\n```",
         "stability": "stable",
-        "summary": "A wrapper to access infrastructure provided by RIO LandingZone setup (like VPC, HostedZone)."
+        "summary": "A wrapper to access infrastructure provided by the RIO Landing Zone setup, such as VPC, HostedZone, and standard team/account SSM parameters."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.RioLandingZone",
       "initializer": {
@@ -16828,7 +17481,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/rio-landing-zone.ts",
-        "line": 10
+        "line": 21
       },
       "methods": [
         {
@@ -16837,7 +17490,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 75
+            "line": 86
           },
           "name": "getAccountNameParameter",
           "parameters": [
@@ -16862,7 +17515,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 52
+            "line": 63
           },
           "name": "getDefaultHostedZone",
           "parameters": [
@@ -16887,7 +17540,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 14
+            "line": 25
           },
           "name": "getDefaultVpc",
           "parameters": [
@@ -16911,7 +17564,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 71
+            "line": 82
           },
           "name": "getTeamAlertSlackChannelParameter",
           "parameters": [
@@ -16935,7 +17588,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 67
+            "line": 78
           },
           "name": "getTeamEmailParameter",
           "parameters": [
@@ -16959,7 +17612,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 63
+            "line": 74
           },
           "name": "getTeamIdentifierParameter",
           "parameters": [
@@ -16983,7 +17636,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 59
+            "line": 70
           },
           "name": "getTeamNameParameter",
           "parameters": [
@@ -20286,6 +20939,7 @@
     "@rio-cloud/cdk-v2-constructs.backup.BackupPolicy": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
+        "remarks": "Apply this to stateful resources that must be discovered by the RIO landing-zone backup solution.\n\nExample:\n```ts\nBackupPolicy.apply(table, Criticality.HIGH);\n```",
         "stability": "stable",
         "summary": "Helper function to tag constructs with correct backup values to be picked up by the rio landing zone backup solution."
       },
@@ -20298,7 +20952,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/backup/backup-policy.ts",
-        "line": 17
+        "line": 24
       },
       "methods": [
         {
@@ -20307,7 +20961,7 @@
           },
           "locationInModule": {
             "filename": "src/backup/backup-policy.ts",
-            "line": 18
+            "line": 25
           },
           "name": "apply",
           "parameters": [
@@ -24104,7 +24758,7 @@
         },
         "locationInModule": {
           "filename": "src/datadogv2/datadog-slo.ts",
-          "line": 103
+          "line": 110
         },
         "parameters": [
           {
@@ -24130,7 +24784,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/datadogv2/datadog-slo.ts",
-        "line": 100
+        "line": 107
       },
       "name": "DatadogSlo",
       "namespace": "datadogv2",
@@ -24142,7 +24796,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/datadogv2/datadog-slo.ts",
-            "line": 149
+            "line": 156
           },
           "name": "sloId",
           "type": {
@@ -25793,7 +26447,9 @@
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable"
+        "remarks": "This construct bundles the pieces that most RIO backend services need:\nan ECS task definition, the application container, a Datadog sidecar,\noptional FireLens log routing, optional ALB target group wiring, and the\nECS Fargate service itself.\n\nIt also derives Datadog tags and environment variables from `stage`,\n`serviceName`, `version`, the AWS account, and the standard RIO landing-zone\nSSM parameters. Do not set `DD_ENV`, `DD_SERVICE`, `DD_VERSION`, `DD_TAGS`,\nor `DD_LOGS_INJECTION` manually in the application container environment.\n\nUse this construct when you want the RIO paved road for a web-facing or\nservice-style Fargate workload and you want the defaults for observability,\nDatadog service catalog registration, and common AWS wiring to be handled\nfor you.\nIf you need a fully custom ECS setup, or a different deployment strategy\nsuch as blue/green, use a lower-level construct or the blue/green variant\ninstead.\n\nTo use it, provide:\n- `stage`, `serviceName`, and `version` for service identity\n- `vpc` and optionally an existing `cluster`\n- `containerDefinitionOption.image` for the application image\n- `fargateOptions.cpu` and `fargateOptions.memoryLimitMiB` for task sizing\n- optional `datadogOptions`, `frameworks`, and `loadBalancerOptions`\n\nExample:\n```ts\nconst service = new RioFargateService(this, 'Service', {\n  stage: 'prod',\n  serviceName: 'billing-view',\n  version: process.env.GIT_VERSION ?? 'local',\n  vpc: RioLandingZone.getDefaultVpc(this),\n  containerDefinitionOption: {\n    image: ecs.ContainerImage.fromRegistry('example/billing-view:latest'),\n  },\n  fargateOptions: {\n    cpu: 512,\n    memoryLimitMiB: 1024,\n  },\n});\n```",
+        "stability": "stable",
+        "summary": "Creates an opinionated ECS Fargate service for RIO applications."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.fargate.RioFargateService",
       "initializer": {
@@ -25802,7 +26458,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate/rio-fargate-service.ts",
-          "line": 406
+          "line": 451
         },
         "parameters": [
           {
@@ -25831,7 +26487,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 365
+        "line": 410
       },
       "name": "RioFargateService",
       "namespace": "fargate",
@@ -25844,7 +26500,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 402
+            "line": 447
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -25859,7 +26515,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 398
+            "line": 443
           },
           "name": "datadogSideCarContainerDefinition",
           "type": {
@@ -25873,7 +26529,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 403
+            "line": 448
           },
           "name": "service",
           "type": {
@@ -25887,7 +26543,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 397
+            "line": 442
           },
           "name": "serviceContainerDefinition",
           "type": {
@@ -25901,7 +26557,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 400
+            "line": 445
           },
           "name": "taskDefinition",
           "type": {
@@ -25915,7 +26571,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 399
+            "line": 444
           },
           "name": "logRouterContainerDefinition",
           "optional": true,
@@ -25930,7 +26586,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 404
+            "line": 449
           },
           "name": "targetGroup",
           "optional": true,
@@ -27150,8 +27806,9 @@
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
       "docs": {
+        "remarks": "Prefer this construct for new topics. Keep the default retention and partition count unless there is a concrete\noperational requirement to change them. Partition increases are permanent and may require coordination with CLAID\nwhen service limits are exceeded.\n\nExample:\n```ts\nnew KafkaTopicV4(this, 'EventsTopic', {\n  name: 'billing-view.events',\n  metadata: {\n    description: 'Domain events emitted by Billing View.',\n    audience: 'company-internal',\n    recoveryPolicy: 'recoverable',\n  },\n  acl: {\n    write: ['billing-view'],\n    read: ['billing-consumer'],\n  },\n  isLogCompacted: false,\n});\n```",
         "stability": "stable",
-        "summary": "Construct to create a kafka topic."
+        "summary": "Construct to create a version 4 RIO Kafka topic."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.kafka.KafkaTopicV4",
       "initializer": {
@@ -27160,7 +27817,7 @@
         },
         "locationInModule": {
           "filename": "src/kafka/kafka-topic.ts",
-          "line": 281
+          "line": 302
         },
         "parameters": [
           {
@@ -27186,7 +27843,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/kafka/kafka-topic.ts",
-        "line": 280
+        "line": 301
       },
       "name": "KafkaTopicV4",
       "namespace": "kafka",
@@ -28278,5 +28935,5 @@
     }
   },
   "version": "0.0.0",
-  "fingerprint": "htSiH80vb8mZqAguG/U3h7juRKKLb/zChpLkJiDFqWQ="
+  "fingerprint": "wcpR/g1VxxywWd5SoWGCaeAUBujlAZAJEHSBxLIp3+c="
 }