Merge remote-tracking branch 'other-repo/henrydai/ImplementCRUDforChangeState' into henrydai/implementChangeStateCRUD0901

Author: Henry Dai

src/azure-changesafety/README.md

@@ -1,5 +1,5 @@
 # Azure CLI Change Safety Extension
-Azure CLI extension for managing Change Safety `ChangeState` resources used to coordinate operational changes across Azure targets.
+Azure CLI extension for managing Change Safety `ChangeRecord` resources. A ChangeRecord describes a planned change to one or more Azure resources, enabling coordination, tracking, and safe deployment across your environment.
 
 ## Installation
 ```bash
@@ -10,23 +10,35 @@ az extension add --name azure-changesafety
 
 ## Commands
 ```bash
-az changesafety changerecord create  # Create a ChangeState definition for one or more targets.
+az changesafety changerecord create  # Create a ChangeRecord for one or more targets.
 az changesafety changerecord update  # Update metadata, rollout configuration, or target definitions.
-az changesafety changerecord delete  # Delete a ChangeState resource.
-az changesafety changerecord show    # Display details for a ChangeState resource.
+az changesafety changerecord delete  # Delete a ChangeRecord resource.
+az changesafety changerecord show    # Display details for a ChangeRecord resource.
 ```
 
 Run `az changesafety changerecord -h` to see full parameter details and examples.
 
 ## Examples
-Create a ChangeState describing a web app rollout:
+Create a ChangeRecord for a manual touch operation (e.g., VM maintenance):
+```bash
+az changesafety changerecord create \
+  -g MyResourceGroup \
+  -n changerecord-vm-maintenance \
+  --change-type ManualTouch \
+  --rollout-type Normal \
+  --targets "resourceId=/subscriptions/<subId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PATCH" \
+  --stagemap-name myStageMap
+```
+
+Create a ChangeRecord for an app deployment with a StageMap reference:
 ```bash
 az changesafety changerecord create \
   -g MyResourceGroup \
   -n changerecord-webapp-rollout \
   --change-type AppDeployment \
   --rollout-type Normal \
-  --targets "resourceId=/subscriptions/<subId>/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/myApp,operation=create" \
+  --targets "resourceId=/subscriptions/<subId>/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/myApp,operation=PUT" \
+  --stage-map "{resource-id:/subscriptions/<subId>/resourceGroups/MyResourceGroup/providers/Microsoft.ChangeSafety/stageMaps/rolloutStageMap}" \
   --links name=Runbook uri=https://contoso.com/runbook
 ```
 
@@ -39,7 +51,7 @@ az changesafety changerecord update \
   --comments "Escalated due to customer impact"
 ```
 
-Delete a ChangeState:
+Delete a ChangeRecord:
 ```bash
 az changesafety changerecord delete -g MyResourceGroup -n changerecord-webapp-rollout --yes
 ```

src/azure-changesafety/azext_changesafety/__init__.py

@@ -9,7 +9,7 @@
 from azext_changesafety._help import helps  # pylint: disable=unused-import
 
 
-class ChangeStateCommandsLoader(AzCommandsLoader):
+class ChangeRecordCommandsLoader(AzCommandsLoader):
 
     def __init__(self, cli_ctx=None):
         from azure.cli.core.commands import CliCommandType
@@ -39,4 +39,4 @@ def load_arguments(self, command):
         load_arguments(self, command)
 
 
-COMMAND_LOADER_CLS = ChangeStateCommandsLoader
+COMMAND_LOADER_CLS = ChangeRecordCommandsLoader

src/azure-changesafety/azext_changesafety/_help.py

@@ -17,14 +17,14 @@
 
 helps['changesafety changerecord'] = """
     type: group
-    short-summary: Manage ChangeState resources that describe planned changes across targets.
+    short-summary: Manage ChangeRecord resources that describe planned changes across targets.
 """
 
 helps['changesafety changerecord create'] = """
     type: command
-    short-summary: Create a ChangeState resource.
+    short-summary: Create a ChangeRecord resource.
     long-summary: >
-        Provide at least one target definition to describe which resources or operations the ChangeState
+        Provide at least one target definition to describe which resources or operations the ChangeRecord
         will affect. Targets are expressed as comma or semicolon separated key=value pairs such as
         resourceId=RESOURCE_ID,operation=DELETE. The command is also available through the alias
         `az changesafety changerecord`. If you omit scheduling flags, the anticipated start time defaults
@@ -66,10 +66,10 @@
 
 helps['changesafety changerecord update'] = """
     type: command
-    short-summary: Update an existing ChangeState resource.
+    short-summary: Update an existing ChangeRecord resource.
     long-summary: >
         Use this command to modify descriptive metadata, rollout settings, or replace targets for an
-        existing ChangeState. When you pass --targets, the supplied definitions overwrite the previous set.
+        existing ChangeRecord. When you pass --targets, the supplied definitions overwrite the previous set.
         This command is also available through the alias `az change-safety change-record`.
     parameters:
       - name: --targets
@@ -100,18 +100,18 @@
 
 helps['changesafety changerecord delete'] = """
     type: command
-    short-summary: Delete a ChangeState resource.
+    short-summary: Delete a ChangeRecord resource.
     examples:
-      - name: Delete a change state without confirmation
+      - name: Delete a ChangeRecord without confirmation
         text: |-
           az changesafety changerecord delete -g MyResourceGroup -n changerecord001 --yes
 """
 
 helps['changesafety changerecord show'] = """
     type: command
-    short-summary: Show details for a ChangeState resource.
+    short-summary: Show details for a ChangeRecord resource.
     examples:
-      - name: Show a change state
+      - name: Show a ChangeRecord
         text: |-
           az changesafety changerecord show -g MyResourceGroup -n changerecord001
 """

src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/change_state/_create.py

@@ -15,7 +15,7 @@
     "changesafety changestate create",
 )
 class Create(AAZCommand):
-    """Create a ChangeState
+    """Create a ChangeRecord
     """
 
     _aaz_info = {
@@ -44,7 +44,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema = cls._args_schema
         _args_schema.change_state_name = AAZStrArg(
             options=["-n", "--name", "--change-record-name"],
-            help="The name of the ChangeState resource.",
+            help="The name of the ChangeRecord resource.",
             required=True,
             fmt=AAZStrArgFormat(
                 pattern="^[a-zA-Z0-9-]{3,100}$",
@@ -88,7 +88,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema.comments = AAZStrArg(
             options=["--comments"],
             arg_group="Properties",
-            help="Comments about the last update to the changeState resource.",
+            help="Comments about the last update to the ChangeRecord resource.",
             fmt=AAZStrArgFormat(
                 max_length=2000,
             ),

src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/change_state/_delete.py

@@ -16,7 +16,7 @@
     confirmation="Are you sure you want to perform this operation?",
 )
 class Delete(AAZCommand):
-    """Delete a ChangeState
+    """Delete a ChangeRecord
     """
 
     _aaz_info = {
@@ -44,7 +44,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema = cls._args_schema
         _args_schema.change_state_name = AAZStrArg(
             options=["-n", "--name", "--change-record-name"],
-            help="The name of the ChangeState resource.",
+            help="The name of the ChangeRecord resource.",
             required=True,
             id_part="name",
             fmt=AAZStrArgFormat(

src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/change_state/_show.py

@@ -15,7 +15,7 @@
     "changesafety changestate show",
 )
 class Show(AAZCommand):
-    """Get a ChangeState
+    """Get a ChangeRecord
     """
 
     _aaz_info = {
@@ -44,7 +44,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema = cls._args_schema
         _args_schema.change_state_name = AAZStrArg(
             options=["-n", "--name", "--change-record-name"],
-            help="The name of the ChangeState resource.",
+            help="The name of the ChangeRecord resource.",
             required=True,
             id_part="name",
             fmt=AAZStrArgFormat(

src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/change_state/_update.py

@@ -15,7 +15,7 @@
     "changesafety changestate update",
 )
 class Update(AAZCommand):
-    """Update a ChangeState
+    """Update a ChangeRecord
     """
 
     _aaz_info = {
@@ -46,7 +46,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema = cls._args_schema
         _args_schema.change_state_name = AAZStrArg(
             options=["-n", "--name", "--change-record-name"],
-            help="The name of the ChangeState resource.",
+            help="The name of the ChangeRecord resource.",
             required=True,
             id_part="name",
             fmt=AAZStrArgFormat(
@@ -92,7 +92,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema.comments = AAZStrArg(
             options=["--comments"],
             arg_group="Properties",
-            help="Comments about the last update to the changeState resource.",
+            help="Comments about the last update to the ChangeRecord resource.",
             nullable=True,
             fmt=AAZStrArgFormat(
                 max_length=2000,

src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/stage_progression/_create.py

@@ -44,7 +44,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema = cls._args_schema
         _args_schema.change_state_name = AAZStrArg(
             options=["--change-record-name"],
-            help="The name of the ChangeState resource.",
+            help="The name of the ChangeRecord resource.",
             required=True,
             fmt=AAZStrArgFormat(
                 pattern="^[a-zA-Z0-9-]{3,100}$",

src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/stage_progression/_delete.py

@@ -45,7 +45,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema = cls._args_schema
         _args_schema.change_state_name = AAZStrArg(
             options=["--change-record-name"],
-            help="The name of the ChangeState resource.",
+            help="The name of the ChangeRecord resource.",
             required=True,
             id_part="name",
             fmt=AAZStrArgFormat(

src/azure-changesafety/azext_changesafety/aaz/latest/change_safety/stage_progression/_show.py

@@ -44,7 +44,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
         _args_schema = cls._args_schema
         _args_schema.change_state_name = AAZStrArg(
             options=["--change-record-name"],
-            help="The name of the ChangeState resource.",
+            help="The name of the ChangeRecord resource.",
             required=True,
             id_part="name",
             fmt=AAZStrArgFormat(