feat: add admin-directory service alias (#473)

[dumko2001]

Description

Add support for the Google Admin SDK Directory API via the admin-directory service alias. This allows users to manage organizational resources like users, groups, and organizational units directly from the gws CLI.

This PR completes the service registration and adds the following standard project artifacts:

• Skills: Generated the gws-admin-directory skill and updated the skills index.
• Personas: Updated the it-admin persona to include both admin-directory and admin-reports services and relevant instructions.
• Changeset: Added a minor version changeset to document the new feature.

Dry Run Output:

{
  "body": null,
  "dry_run": true,
  "is_multipart_upload": false,
  "method": "GET",
  "query_params": [
    [
      "customer",
      "my_customer"
    ]
  ],
  "url": "https://admin.googleapis.com/admin/directory/v1/users"
}

Checklist:

• My code follows the AGENTS.md guidelines (no generated google-* crates).
• I have run cargo fmt --all to format the code perfectly.
• I have run cargo clippy -- -D warnings and resolved all warnings.
• I have added tests that prove my fix is effective or that my feature works.
• I have provided a Changeset file (e.g. via pnpx changeset) to document my changes.

[changeset-bot]

🦋 Changeset detected

Latest commit: 5847ea1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@googleworkspace/cli	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request integrates the Google Admin SDK Directory API into the gws CLI, allowing administrators to manage Google Workspace organizational resources like users, groups, and organizational units directly from the command line. This enhancement expands the CLI's administrative capabilities and updates relevant documentation and persona definitions to reflect the new functionality.

Highlights

• New Service Alias: Introduced the admin-directory service alias to provide command-line access to the Google Admin SDK Directory API.
• Skill Generation: Generated the gws-admin-directory skill, enabling management of users, groups, and organizational units.
• Persona Update: Updated the it-admin persona to include the new admin-directory service and the existing admin-reports service, along with relevant instructions.
• Versioning: Added a minor version changeset to formally document the new feature.

Changelog

• .changeset/feat-admin-directory.md
  • Documented the addition of the Google Admin SDK Directory API support as a minor version update.
• docs/skills.md
  • Added the gws-admin-directory skill to the list of available skills.
• registry/personas.yaml
  • Updated the it-admin persona to include admin-directory and admin-reports services and refined its instructions.
• skills/gws-admin-directory/SKILL.md
  • Created a new skill definition file for gws-admin-directory, detailing its API resources and commands.
• skills/persona-it-admin/SKILL.md
  • Updated the it-admin persona's skill prerequisites and instructions to incorporate the new gws-admin-directory skill.
• src/services.rs
  • Registered the new admin-directory service alias and added a corresponding test case for service resolution.

Activity

• No human activity (comments, reviews, etc.) has occurred on this pull request yet.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Generative AI Prohibited Use Policy, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request adds support for the Google Admin SDK Directory API via the admin-directory service alias. The changes are well-structured, including updates to service registration, documentation, and relevant personas. A test case for the new service is also included. All specific suggestions have been addressed or deemed outside the scope of this pull request.