feat: org transfer

package.json

@@ -34,7 +34,7 @@
     "next-sitemap": "^4.2.3",
     "postcss": "^8.4.31",
     "postcss-focus-visible": "^6.0.4",
-    "posthog-js": "^1.314.0",
+    "posthog-js": "^1.342.1",
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "react-highlight-words": "^0.20.0",

public/access-control/roles.md

@@ -27,7 +27,7 @@ Phase provides managed roles out of the box to every organization.
 
 ### Owner
 
-The organization owner. This role is automatically assigned when a user creates a new organization. It is unique to a single user and grants access to all resources and actions.
+The organization owner. This role is automatically assigned when a user creates a new organization. It is unique to a single user and grants access to all resources and actions. Ownership can be [transferred](/console/organisation#transfer-ownership) to another Admin member from the Organisation Settings.
 
 #### Organization-level permissions:
 

public/console/organisation.md

@@ -41,3 +41,27 @@ You are limited to selecting a non Global Access role when inviting a new member
 This page shows your account and recovery info related to this Organisation. You can view your current role, preferences and download your account recovery kit from this screen. This page will also show you the current billing status of your Organisation.
 
 ![organsation settings](/assets/images/console/organisation/organisation-settings.png)
+
+## Transfer Ownership
+
+Organisation Owners can transfer ownership to another member who has the [Admin](/access-control/roles#admin) role. This is useful when an organisation needs to change hands, such as when the current owner is leaving the team or delegating responsibilities.
+
+<Warning>
+  Make sure the new Owner has access to their **account recovery kit** before transferring ownership. After the transfer, the new Owner's recovery kit will be the **only** way to restore access to the organisation if they forget their `sudo` password.
+</Warning>
+
+
+To transfer ownership:
+
+1. Log in as the Organisation **Owner** and navigate to your Organisation **Settings**. Scroll down to the **Danger Zone** section and click **Transfer Ownership**.
+![transfer ownership settings](/assets/images/console/organisation/organisation-transfer-ownership-1.png)
+2. Select the Admin member you want to make the new Owner. Only members with the Admin role are eligible.
+![select new owner](/assets/images/console/organisation/organisation-transfer-ownership-2.png)
+3. Review the changes, confirm that the new Owner has backed up their account recovery kit, and acknowledge that you will lose your Owner privileges. Click **Transfer Ownership** to complete the transfer. If you are using Phase Cloud, you will see a section for updating the billing email address.
+![confirm transfer](/assets/images/console/organisation/organisation-transfer-ownership-3.png)
+
+Once the transfer is complete:
+
+- The selected member becomes the new **Owner** of the organisation.
+- You will be demoted to an **Admin** and will continue to remain a member of the organisation until removed.
+- Both the old and new Owner will receive an email notification about the transfer.

public/console/users.md

@@ -50,7 +50,7 @@ You can also copy the entire contents of the recovery kit to store as a secure n
 
 </Warning>
 
-If a non-owner user forgets their account sudo password and cannot access their recovery phrase, they can be removed from the organisation and re-added by another user. However, if the Organisation **Owner** forgets their sudo password and cannot access their account recovery phrase they will have lost access to the account permanently.
+If a non-owner user forgets their account sudo password and cannot access their recovery phrase, they can be removed from the organisation and re-added by another user. However, if the Organisation **Owner** forgets their sudo password and cannot access their account recovery phrase they will have lost access to the account permanently. To mitigate this risk, ownership can be [transferred](/console/organisation#transfer-ownership) to another Admin member who has access to their recovery kit.
 
 ## The `sudo` password
 

src/pages/access-control/roles.mdx

@@ -27,7 +27,7 @@ Phase provides managed roles out of the box to every organization.
 
 ### Owner
 
-The organization owner. This role is automatically assigned when a user creates a new organization. It is unique to a single user and grants access to all resources and actions.
+The organization owner. This role is automatically assigned when a user creates a new organization. It is unique to a single user and grants access to all resources and actions. Ownership can be [transferred](/console/organisation#transfer-ownership) to another Admin member from the Organisation Settings.
 
 #### Organization-level permissions:
 

src/pages/console/organisation.mdx

@@ -41,3 +41,27 @@ You are limited to selecting a non Global Access role when inviting a new member
 This page shows your account and recovery info related to this Organisation. You can view your current role, preferences and download your account recovery kit from this screen. This page will also show you the current billing status of your Organisation.
 
 ![organsation settings](/assets/images/console/organisation/organisation-settings.png)
+
+## Transfer Ownership
+
+Organisation Owners can transfer ownership to another member who has the [Admin](/access-control/roles#admin) role. This is useful when an organisation needs to change hands, such as when the current owner is leaving the team or delegating responsibilities.
+
+<Warning>
+  Make sure the new Owner has access to their **account recovery kit** before transferring ownership. After the transfer, the new Owner's recovery kit will be the **only** way to restore access to the organisation if they forget their `sudo` password.
+</Warning>
+
+
+To transfer ownership:
+
+1. Log in as the Organisation **Owner** and navigate to your Organisation **Settings**. Scroll down to the **Danger Zone** section and click **Transfer Ownership**.
+![transfer ownership settings](/assets/images/console/organisation/organisation-transfer-ownership-1.png)
+2. Select the Admin member you want to make the new Owner. Only members with the Admin role are eligible.
+![select new owner](/assets/images/console/organisation/organisation-transfer-ownership-2.png)
+3. Review the changes, confirm that the new Owner has backed up their account recovery kit, and acknowledge that you will lose your Owner privileges. Click **Transfer Ownership** to complete the transfer. If you are using Phase Cloud, you will see a section for updating the billing email address.
+![confirm transfer](/assets/images/console/organisation/organisation-transfer-ownership-3.png)
+
+Once the transfer is complete:
+
+- The selected member becomes the new **Owner** of the organisation.
+- You will be demoted to an **Admin** and will continue to remain a member of the organisation until removed.
+- Both the old and new Owner will receive an email notification about the transfer.

src/pages/console/users.mdx

@@ -50,7 +50,7 @@ You can also copy the entire contents of the recovery kit to store as a secure n
 
 </Warning>
 
-If a non-owner user forgets their account sudo password and cannot access their recovery phrase, they can be removed from the organisation and re-added by another user. However, if the Organisation **Owner** forgets their sudo password and cannot access their account recovery phrase they will have lost access to the account permanently.
+If a non-owner user forgets their account sudo password and cannot access their recovery phrase, they can be removed from the organisation and re-added by another user. However, if the Organisation **Owner** forgets their sudo password and cannot access their account recovery phrase they will have lost access to the account permanently. To mitigate this risk, ownership can be [transferred](/console/organisation#transfer-ownership) to another Admin member who has access to their recovery kit.
 
 ## The `sudo` password