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

Author: Henry Dai

src/change-state/HISTORY.rst src/azure-changesafety/HISTORY.rstsrc/change-state/HISTORY.rst renamed to src/azure-changesafety/HISTORY.rst

@@ -0,0 +1,49 @@
+# Azure CLI Change Safety Extension
+Azure CLI extension for managing Change Safety `ChangeState` resources used to coordinate operational changes across Azure targets.
+
+## Installation
+```bash
+az extension add --source <path-to-extension-dist> --yes
+# or install the latest published build
+az extension add --name azure-changesafety
+```
+
+## Commands
+```bash
+az changesafety changestate create  # Create a ChangeState definition for one or more targets.
+az changesafety changestate update  # Update metadata, rollout configuration, or target definitions.
+az changesafety changestate delete  # Delete a ChangeState resource.
+az changesafety changestate show    # Display details for a ChangeState resource.
+```
+
+Run `az changesafety changestate -h` to see full parameter details and examples.
+
+## Examples
+Create a ChangeState describing a web app rollout:
+```bash
+az changesafety changestate create \
+  -g MyResourceGroup \
+  -n webapp-rollout-01 \
+  --change-type AppDeployment \
+  --rollout-type Normal \
+  --targets "resourceId=/subscriptions/<subId>/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/myApp,operation=create" \
+  --links name=Runbook uri=https://contoso.com/runbook
+```
+
+Update the rollout type and add a comment:
+```bash
+az changesafety changestate update \
+  -g MyResourceGroup \
+  -n webapp-rollout-01 \
+  --rollout-type Emergency \
+  --comments "Escalated due to customer impact"
+```
+
+Delete a ChangeState:
+```bash
+az changesafety changestate delete -g MyResourceGroup -n webapp-rollout-01 --yes
+```
+
+## Additional Information
+- View command documentation: `az changesafety changestate -h`
+- Remove the extension when no longer needed: `az extension remove --name azure-changesafety`

src/azure-changesafety/README.md

@@ -0,0 +1,96 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: disable=line-too-long
+# pylint: disable=too-many-lines
+
+from knack.help_files import helps  # pylint: disable=unused-import
+
+helps['changesafety'] = """
+    type: group
+    short-summary: Manage Change Safety resources.
+"""
+
+helps['changesafety changestate'] = """
+    type: group
+    short-summary: Manage ChangeState resources that describe planned changes across targets.
+"""
+
+helps['changesafety changestate create'] = """
+    type: command
+    short-summary: Create a ChangeState resource.
+    long-summary: >
+        Provide at least one target definition to describe which resources or operations the change
+        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 change-safety change-state`.
+    parameters:
+      - name: --targets
+        short-summary: >
+            One or more target definitions expressed as key=value pairs (for example
+            resourceId=RESOURCE_ID,operation=CREATE,resourceType=Microsoft.Compute/virtualMachines).
+      - name: --change-type
+        short-summary: Classify the change such as AppDeployment, Config, ManualTouch, or PolicyDeployment.
+      - name: --rollout-type
+        short-summary: Specify the rollout urgency (Normal, Hotfix, or Emergency).
+      - name: --stage-map
+        short-summary: Reference an existing StageMap resource using resource-id=RESOURCE_ID and optional parameters key=value pairs.
+      - name: --links
+        short-summary: Add supporting links by repeating --links name=NAME uri=URL [description=TEXT].
+    examples:
+      - name: Create a change state for a VM rollout
+        text: |-
+          az changesafety changestate create -g MyResourceGroup -n deploy-001 --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 with staging rollout configuration
+        text: |-
+          az changesafety changestate create -g MyResourceGroup -n ops-change-01 --rollout-type Hotfix --targets resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/myApp,operation=POST
+"""
+
+helps['changesafety changestate update'] = """
+    type: command
+    short-summary: Update an existing ChangeState resource.
+    long-summary: >
+        Use this command to modify descriptive metadata, rollout settings, or replace targets for an
+        existing change. When you pass --targets, the supplied definitions overwrite the previous set.
+        This command is also available through the alias `az change-safety change-state`.
+    parameters:
+      - name: --targets
+        short-summary: >
+            Optional target definitions to replace the existing list. Provide key=value pairs such as
+            resourceId=RESOURCE_ID,operation=DELETE.
+      - name: --comments
+        short-summary: Provide notes about the latest update to the change state.
+      - name: --anticipated-start-time
+        short-summary: Update the expected start time in ISO 8601 format.
+      - name: --anticipated-end-time
+        short-summary: Update the expected completion time in ISO 8601 format.
+    examples:
+      - name: Adjust rollout type and add a comment
+        text: |-
+          az changesafety changestate update -g MyResourceGroup -n deploy-001 --rollout-type Emergency --comments "Escalated to emergency rollout"
+      - name: Replace the target definition
+        text: |-
+          az changesafety changestate update -g MyResourceGroup -n deploy-001 --targets resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Sql/servers/myServer,operation=PATCH
+"""
+
+helps['changesafety changestate delete'] = """
+    type: command
+    short-summary: Delete a ChangeState resource.
+    examples:
+      - name: Delete a change state without confirmation
+        text: |-
+          az changesafety changestate delete -g MyResourceGroup -n deploy-001 --yes
+"""
+
+helps['changesafety changestate show'] = """
+    type: command
+    short-summary: Show details for a ChangeState resource.
+    examples:
+      - name: Show a change state
+        text: |-
+          az changesafety changestate show -g MyResourceGroup -n deploy-001
+"""

…nge-state/azext_change_state/__init__.py …ngesafety/azext_change_state/__init__.pysrc/change-state/azext_change_state/__init__.py renamed to src/azure-changesafety/azext_change_state/__init__.py src/change-state/azext_change_state/__init__.py renamed to src/azure-changesafety/azext_change_state/__init__.py

@@ -12,7 +12,7 @@
 
 
 @register_command_group(
-    "change-safety",
+    "changesafety",
 )
 class __CMDGroup(AAZCommandGroup):
     """Manage Change Safety

src/azure-changesafety/azext_change_state/_help.py

@@ -12,7 +12,7 @@
 
 
 @register_command_group(
-    "change-safety change-state",
+    "changesafety changestate",
 )
 class __CMDGroup(AAZCommandGroup):
     """Manage Change State