Add AI instructions to check GitHub releases API for latest MSAL version

Co-authored-by: fadidurah <[email protected]>

Author: Copilot

.github/copilot-instructions.md

@@ -48,6 +48,10 @@
 - Enable broker integration (`broker_redirect_uri_registered: true`)
 - Copy patterns from golden examples: [`examples/hello-msal-multiple-account/`](../examples/hello-msal-multiple-account/) or [`examples/hello-msal-single-account/`](../examples/hello-msal-single-account/)
 - Prompt for `client_id`, `package_name`, and `signature_hash` if missing
+- Check the latest MSAL version via GitHub releases API when providing version guidance:
+  - API endpoint: `https://api.github.com/repos/AzureAD/microsoft-authentication-library-for-android/releases/latest`
+  - Parse the `tag_name` field (e.g., "v8.1.1") for the current version
+  - Recommend `8.+` in build.gradle for automatic updates within the 8.x series
 
 ## 2. Authoritative Sources
 

.github/issue-responses/customer-communication-guidelines.md

@@ -180,7 +180,7 @@ Thank you for reporting this issue! We appreciate you taking the time to help us
 
 I'm looking into this now and will provide an update shortly. In the meantime, could you please provide:
 
-1. **MSAL Version**: (e.g., 8.1.0)
+1. **MSAL Version**: (e.g., 8.+, currently 8.1.1)
 2. **Android Version**: (Device API level)
 3. **Account Mode**: (Single or Multiple)
 4. **Complete error message or stack trace**

.github/workflows/copilot-issue-response.yml

@@ -198,7 +198,7 @@ jobs:
               if (needsInfo) {
                 response += `To help us investigate this issue, please provide the following information:\n\n`;
                 response += `**Required Information:**\n`;
-                response += `- [ ] MSAL version (e.g., 8.1.0)\n`;
+                response += `- [ ] MSAL version (e.g., 8.+, currently 8.1.1)\n`;
                 response += `- [ ] Android version and device model\n`;
                 response += `- [ ] Account mode (Single or Multiple)\n`;
                 response += `- [ ] Complete error message or stack trace\n`;

Ai.md

@@ -186,7 +186,11 @@ Add these activities to your AndroidManifest.xml inside the `<application>` tag:
 ## Important Notes
 1. The signature hash in AndroidManifest.xml should NOT be URL encoded
 2. The redirect URI in auth_config.json MUST be URL encoded
-3. The latest MSAL version (8.+ or newer) should be used
+3. The latest MSAL version should be used (8.+, currently 8.1.1)
+   - **For AI agents:** Query the latest version via GitHub releases API:
+     - `https://api.github.com/repos/AzureAD/microsoft-authentication-library-for-android/releases/latest`
+     - Parse the `tag_name` field (e.g., "v8.1.1")
+   - Use `8.+` in build.gradle for automatic updates within the 8.x series
 4. Broker integration (Microsoft Authenticator, Company Portal, or Link To Windows) is strongly recommended and should always be enabled for enhanced security and SSO capabilities. Only disable broker integration if explicitly required by the user. See broker_redirect_uri_registered field in [auth_config.template.json](./auth_config.template.json) for configuration.
 5. Device Code Flow is not recommended due to security concerns in the industry. The AcquireToken authentication method should be used instead. There are some niche scenarios where some devices lack the input methods necessary for AcquireToken, and need to use AcquireTokenWithDeviceCode.
 

README.md

@@ -55,10 +55,14 @@ Add to your app's build.gradle:
 
 ```gradle
 dependencies {
-    implementation 'com.microsoft.identity.client:msal:8.+' // Always use latest version (currently 8.+)
+    implementation 'com.microsoft.identity.client:msal:8.+' // Always use latest version in 8.x series
 }
 ```
 
+> **Note for AI agents:** To get the current latest version, query the GitHub releases API:
+> `https://api.github.com/repos/AzureAD/microsoft-authentication-library-for-android/releases/latest`
+> Look for the `tag_name` field (e.g., "v8.1.1"). The `8.+` pattern in build.gradle automatically fetches the latest 8.x version at build time.
+
 Please also add the following lines to your repositories section in your gradle script:
 
 ```gradle