docs: standardize environment variable tables and refactor settings

- Add 'Required' and 'Default' columns to all environment variable documentation tables.
- Refactor all Settings classes to inherit from a new CommonSettings base class in templates/settings.py.
- Ensure 'service_name' and 'metrics_namespace' have template-specific defaults in each subclass.
- Fix Environment variables table ordering in EventBridge documentation.
- Update EventBridge property tests to reflect optional settings.
- Document UX learnings in .jules/palette.md.

Author: google-labs-jules[bot]

templates/agent/settings.py

@@ -7,5 +7,5 @@ class Settings(CommonSettings, case_sensitive=False):
     """Configuration settings for the Bedrock Agent Lambda function."""
 
     table_name: str = Field(description="Name of the DynamoDB table to store agent items.")
-    service_name: str = Field(description="Name of the service for logging and tracing.", default="bedrock-agent")
-    metrics_namespace: str = Field(description="Namespace for custom CloudWatch metrics.", default="BedrockAgent")
+    service_name: str = "bedrock-agent"
+    metrics_namespace: str = "BedrockAgent"

templates/api/settings.py

@@ -5,5 +5,5 @@
 
 class Settings(CommonSettings):
     table_name: str = Field(description="DynamoDB table name")
-    service_name: str = Field(description="Powertools service name", default="rest-api")
-    metrics_namespace: str = Field(description="Powertools metrics namespace", default="RestApi")
+    service_name: str = "rest-api"
+    metrics_namespace: str = "RestApi"

templates/eventbridge/settings.py

@@ -8,5 +8,5 @@ class Settings(CommonSettings, case_sensitive=False):
     api_timeout_seconds: int = Field(description="Timeout for the external API call in seconds", default=10)
     secret_name: str = Field(description="AWS Secrets Manager secret name holding the API token")
     table_name: str = Field(description="DynamoDB table name for persisting API responses")
-    service_name: str = Field(description="Powertools service name used for Logger and Tracer", default="eventbridge")
-    metrics_namespace: str = Field(description="CloudWatch namespace for Powertools Metrics", default="EventBridge")
+    service_name: str = "eventbridge"
+    metrics_namespace: str = "EventBridge"

templates/graphql/settings.py

@@ -7,5 +7,5 @@ class Settings(CommonSettings):
     """Configuration settings for the GraphQL Lambda function."""
 
     table_name: str = Field(description="The name of the DynamoDB table.")
-    service_name: str = Field(description="The name of the service.", default="graphql-api")
-    metrics_namespace: str = Field(description="The CloudWatch Metrics namespace.", default="GraphQLApi")
+    service_name: str = "graphql-api"
+    metrics_namespace: str = "GraphQLApi"

templates/s3/settings.py

@@ -6,8 +6,8 @@
 class Settings(CommonSettings, case_sensitive=False):
     queue_url: str = Field(description="SQS queue URL to publish processed messages to")
     queue_region: str = Field(default="us-east-1", description="AWS region for the SQS client")
-    service_name: str = Field(default="s3-processor", description="Powertools service name")
-    metrics_namespace: str = Field(default="S3Processor", description="CloudWatch Metrics namespace")
+    service_name: str = "s3-processor"
+    metrics_namespace: str = "S3Processor"
     log_level: str = Field(default="INFO", description="Log level for the Lambda Logger")
 
     @field_validator("queue_url")

templates/settings.py

@@ -5,5 +5,5 @@
 class CommonSettings(BaseSettings):
     """Base configuration settings shared by all Lambda functions."""
 
-    service_name: str = Field(description="Powertools service name", default="service-name")
-    metrics_namespace: str = Field(description="Powertools metrics namespace", default="MetricsNamespace")
+    service_name: str = Field(description="Powertools service name")
+    metrics_namespace: str = Field(description="Powertools metrics namespace")

templates/sqs/settings.py

@@ -7,5 +7,5 @@ class Settings(CommonSettings, case_sensitive=False):
     """Configuration settings for the SQS Lambda function."""
 
     table_name: str = Field(description="Name of the DynamoDB table to store processed items.")
-    service_name: str = Field(description="Name of the service for logging and tracing.", default="sqs-processor")
-    metrics_namespace: str = Field(description="Namespace for custom CloudWatch metrics.", default="SqsProcessor")
+    service_name: str = "sqs-processor"
+    metrics_namespace: str = "SqsProcessor"

templates/stream/settings.py

@@ -5,5 +5,5 @@
 
 class Settings(CommonSettings, case_sensitive=False):
     destination_table_name: str = Field(description="Destination DynamoDB table name")
-    service_name: str = Field(description="Powertools service name", default="dynamodb-stream")
-    metrics_namespace: str = Field(description="Powertools metrics namespace", default="DynamoDBStream")
+    service_name: str = "dynamodb-stream"
+    metrics_namespace: str = "DynamoDBStream"