Add Convert-MeetingMembersToMarkdown cmdlet

[Copilot]

Parses comma-separated email strings with display names into markdown grouped by company domain.

Changes

• private/parseMemberEmail.ps1: Helper functions to parse "Name <email@domain.com>" format and group by company
• public/convertMeetingMembersToMarkdown.ps1: Public cmdlet with pipeline support
• Test/public/convertMeetingMembersToMarkdown.test.ps1: Tests for single/multiple companies, special characters, edge cases

Example

$members = 'Gisela Torres <0gis0@github.com>, "Martin Fernandez, Borja" <mfborj5@mapfre.com>'
Convert-MeetingMembersToMarkdown -MeetingMembers $members

Output:

- Github
    - Gisela Torres <0gis0@github.com>
- Mapfre
    - "Martin Fernandez, Borja" <mfborj5@mapfre.com>

Handles quoted names with commas/parentheses, sorts companies alphabetically, and preserves original email formatting.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• www.powershellgallery.com
  • Triggering command: /usr/bin/pwsh pwsh -NoProfile -Command ./test.ps1 (dns block)
  • Triggering command: /usr/bin/pwsh pwsh -NoProfile -Command Get-PSRepository (dns block)
  • Triggering command: /usr/bin/pwsh pwsh -NoProfile -Command Register-PSRepository -Default; Get-PSRepository (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Create Convert-MeetingMembersToMarkdown cmdlet

Create Convert-MeetingMembersToMarkdown cmdlet

Parse comma-separated emails with display names into a markdown list grouped by company domain. Each company becomes a section header with member entries below, preserving original email formatting while grouping by domain.

Steps

1. Create private helper function parseMemberEmail in new private/parseMemberEmail.ps1 to parse individual email strings in "Name <email@domain.com>" format, returning objects with DisplayName, Email, Company, and OriginalFormat properties.

2. Create private helper function groupMembersByCompany in private/parseMemberEmail.ps1 to accept parsed member objects, sort by company, and format as markdown with company headers and indented member entries.

3. Create public cmdlet Convert-MeetingMembersToMarkdown in public/convertMeetingMembersToMarkdown.ps1 with:

   • Parameter: $MeetingMembers (string, comma-separated email list)
   • Optional: $SortByCompany (switch, default behavior)
   • Pipe input through helpers and return formatted markdown string

4. Create test file Test/public/convertMeetingMembersToMarkdown.test.ps1 covering:

   • Single company with multiple members
   • Multiple companies with mixed members
   • Duplicate members across companies (same person, different emails)
   • Names with special characters (quotes, commas, parentheses)
   • Edge cases (empty input, malformed entries)

5. Update NotesHelper.psm1 to ensure new function loads from private folder before public.

Sample Input and Output

Input

"Gisela Torres <0gis0@github.com>, "David (GitHub) Losert" <davelosert@github.com>, Gisela Torres <giselat@microsoft.com>, "Martin Fernandez, Borja" <mfborj5@mapfre.com>, "Jovanovic Obradovic, Mat" <mjovanovic@mapfre.com>, "Molina Merchan, Jesus" <mmjesu6@mapfre.com>"

Expected Output

- Github
    - Gisela Torres <0gis0@github.com>
    - "David (GitHub) Losert" <davelosert@github.com>
- Microsoft
    - Gisela Torres <giselat@microsoft.com>
- Mapfre
    - "Martin Fernandez, Borja" <mfborj5@mapfre.com>
    - "Jovanovic Obradovic, Mat" <mjovanovic@mapfre.com>
    - "Molina Merchan, Jesus" <mmjesu6@mapfre.com>

Key Observations from Sample

• Same person (Gisela Torres) appears in multiple companies with different emails
• Display names with quotes and special characters (commas, parentheses) are preserved as-is
• Companies are grouped with headers (no indentation)
• Members are listed under company with 4-space indentation
• Each member line preserves original display name and email format
• Output is sorted by company name (alphabetically: Github, Mapfre, Microsoft)

Further Considerations

1. Company name capitalization: Should we use a hardcoded lookup table (GitHub, Microsoft, Mapfre) or auto-capitalize the domain name extracted from email?
2. Duplicate handling: If same person appears twice (different email domains), should they appear in both company groups or deduplicate by display name?
3. Sorting within company: Alphabetically by display name, or preserve order of first appearance in input?

Follow the PowerShell module patterns from the NotesHelper module:

• All public functions must have [CmdletBinding()] attribute
• Public functions must end with Export-ModuleMember -Function 'FunctionName'
• Private helper functions should not be exported
• Tests must follow the Arrange-Act-Assert pattern with proper test naming convention Test_FunctionName_Scenario

Created from VS Code via the GitHub Pull Request extension.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.