Update changesafety docs, help text, and test recording

- Add missing help entry for 'changerecord list' command
- Update Python classifiers to 3.9-3.12 (drop EOL 3.7/3.8)
- Expand HISTORY.rst with feature details and ChangeState->ChangeRecord rename
- Update test recording to use eastus2euap ARM endpoint

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Henry Dai

src/azure-changesafety/HISTORY.rst

@@ -5,4 +5,9 @@ Release History
 
 1.0.0b1
 ++++++
-* Initial release.
+* Initial release.
+* Manage ChangeRecord, StageMap, and StageProgression resources (API version ``2026-01-01-preview``).
+* Custom ``--targets`` parsing with key=value shorthand (e.g., ``resourceId=...,operation=DELETE``).
+* ``--stagemap-name`` shortcut to reference a StageMap by name.
+* Default scheduling: ``anticipatedStartTime`` defaults to now, ``anticipatedEndTime`` to +8 hours.
+* Supports ``--acquire-policy-token`` and ``--change-reference`` for guarded resource operations.

src/azure-changesafety/README.md

@@ -13,7 +13,7 @@ az extension add --name azure-changesafety
 ### ChangeRecord
 ```bash
 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 update  # Update metadata, rollout settings, or scheduling.
 az changesafety changerecord delete  # Delete a ChangeRecord resource.
 az changesafety changerecord show    # Display details for a ChangeRecord resource.
 az changesafety changerecord list    # List ChangeRecord resources.
@@ -64,7 +64,7 @@ Create a ChangeRecord for a manual touch operation (e.g., delete a Traffic Manag
 ```bash
 az changesafety changerecord create \
   -g MyResourceGroup \
-  -n changerecord-delete-tm \
+  -n delete-trafficmanager \
   --change-type ManualTouch \
   --rollout-type Hotfix \
   --targets "resourceId=/subscriptions/<subId>/resourceGroups/MyResourceGroup/providers/Microsoft.Network/trafficManagerProfiles/myProfile,operation=DELETE" \
@@ -83,6 +83,8 @@ az changesafety changerecord create \
   --links name=Runbook uri=https://contoso.com/runbook
 ```
 
+> **Scope:** When `-g` is omitted, the ChangeRecord is created at subscription scope. Use `-g` to scope it to a specific resource group.
+
 Update the ChangeRecord and add a comment:
 ```bash
 az changesafety changerecord update \

src/azure-changesafety/azext_changesafety/_help.py

@@ -51,22 +51,19 @@
       - name: --links
         short-summary: Add supporting links by repeating --links name=NAME uri=URL [description=TEXT].
     examples:
-      - name: Create with StageMap reference and status link
-        text: |-
-          az changesafety changerecord create -g MyResourceGroup -n changerecord002 --change-type ManualTouch --rollout-type Normal --stage-map "{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.ChangeSafety/stageMaps/rolloutStageMap}" --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PATCH" --links "[{name:status,uri:'https://contoso.com/change/rollout-002'}]"
-          az changesafety changerecord delete -g MyResourceGroup -n changerecord002 --yes
-      - name: Create a ChangeRecord for a VM rollout
-        text: |-
-          az changesafety changerecord create -g MyResourceGroup -n changerecord001 --change-type AppDeployment --rollout-type Normal --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PUT"
       - name: Create a ChangeRecord for deleting a Traffic Manager profile
         text: |-
           az changesafety changerecord create -g MyResourceGroup -n delete-trafficmanager --change-type ManualTouch --rollout-type Hotfix --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Network/trafficManagerProfiles/myProfile,operation=DELETE" --description "Delete Traffic Manager profile"
-      - name: Create with staging rollout configuration
-        text: |-
-          az changesafety changerecord create -g MyResourceGroup -n changerecord-ops01 --change-type AppDeployment --rollout-type Hotfix --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/myApp,operation=POST"
       - name: Reference a StageMap by name
         text: |-
           az changesafety changerecord create -g MyResourceGroup -n changerecord003 --change-type ManualTouch --rollout-type Normal --stagemap-name rolloutStageMap --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=DELETE"
+      - name: Create with StageMap reference and status link
+        text: |-
+          az changesafety changerecord create -g MyResourceGroup -n changerecord002 --change-type ManualTouch --rollout-type Normal --stage-map "{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ChangeSafety/stageMaps/rolloutStageMap}" --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PATCH" --links "[{name:status,uri:'https://contoso.com/change/rollout-002'}]"
+          az changesafety changerecord delete -g MyResourceGroup -n changerecord002 --yes
+      - name: Create at subscription scope (no resource group)
+        text: |-
+          az changesafety changerecord create -n changerecord-sub-scope --change-type AppDeployment --rollout-type Normal --stagemap-name rolloutStageMap --targets "subscriptionId=00000000-0000-0000-0000-000000000000"
 """
 
 helps['changesafety changerecord update'] = """
@@ -94,7 +91,7 @@
           az changesafety changerecord update -g MyResourceGroup -n changerecord001 --rollout-type Emergency --comments "Escalated to emergency rollout"
       - name: Update scheduling window
         text: |-
-          az changesafety changerecord update -g MyResourceGroup -n changerecord001 --anticipated-start-time "2024-09-01T08:00:00Z" --anticipated-end-time "2024-09-01T12:00:00Z"
+          az changesafety changerecord update -g MyResourceGroup -n changerecord001 --anticipated-start-time "2026-09-01T08:00:00Z" --anticipated-end-time "2026-09-01T12:00:00Z"
       - name: Update description
         text: |-
           az changesafety changerecord update -g MyResourceGroup -n changerecord001 --description "Updated rollout for production deployment"

src/azure-changesafety/azext_changesafety/custom.py

@@ -41,6 +41,7 @@
     Update as _ChangeRecordUpdate,
     Show as _ChangeRecordShow,
     Delete as _ChangeRecordDelete,
+    List as _ChangeRecordList,
 )
 # Import for schema building - used by _build_custom_show_schema
 from azext_changesafety.aaz.latest.changesafety.changerecord._show import (
@@ -627,17 +628,18 @@ class ChangeRecordDelete(_ChangeRecordDelete):
                 "az changesafety changerecord create -g MyResourceGroup -n changerecord002 "
                 "--change-type ManualTouch --rollout-type Normal "
                 "--stage-map \"{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/"
-                "resourceGroups/MyResourceGroup/providers/Microsoft.ChangeSafety/stageMaps/rolloutStageMap}\" "
+                "providers/Microsoft.ChangeSafety/stageMaps/rolloutStageMap}\" "
                 "--targets \"resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/"
                 "resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PATCH\" "
                 "--links \"[{name:status,uri:'https://contoso.com/change/rollout-002'}]\"\n"
             ),
         },
         {
-            "name": "Create a ChangeRecord for a VM rollout",
+            "name": "Create a ChangeRecord for an app deployment with StageMap",
             "text": (
                 "az changesafety changerecord create -g MyResourceGroup -n changerecord001 "
                 "--change-type AppDeployment --rollout-type Normal "
+                "--stagemap-name rolloutStageMap "
                 "--targets \"resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/"
                 "resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PUT\""
             ),
@@ -698,8 +700,8 @@ class ChangeRecordDelete(_ChangeRecordDelete):
             "name": "Update scheduling window",
             "text": (
                 "az changesafety changerecord update -g MyResourceGroup -n changerecord001 "
-                "--anticipated-start-time \"2024-09-01T08:00:00Z\" "
-                "--anticipated-end-time \"2024-09-01T12:00:00Z\""
+                "--anticipated-start-time \"2026-09-01T08:00:00Z\" "
+                "--anticipated-end-time \"2026-09-01T12:00:00Z\""
             ),
         },
         {
@@ -732,6 +734,22 @@ class ChangeRecordDelete(_ChangeRecordDelete):
     ],
 }
 
+_ChangeRecordList.AZ_HELP = {
+    **_ChangeRecordList.AZ_HELP,
+    "short-summary": "List ChangeRecord resources.",
+    "long-summary": "List all ChangeRecord resources in a subscription or resource group.",
+    "examples": [
+        {
+            "name": "List all ChangeRecords in the current subscription",
+            "text": "az changesafety changerecord list",
+        },
+        {
+            "name": "List ChangeRecords in a specific resource group",
+            "text": "az changesafety changerecord list -g MyResourceGroup",
+        },
+    ],
+}
+
 
 # -----------------------------------------------------------------------------
 # StageMap Help Examples