docs: add retrieve app deployments based on last used data docs and product update

[adambenhassen]

Background

Description

Checklist

• Input validation
• Output encoding
• Authentication management
• Session management
• Access control
• Cryptographic practices
• Error handling and logging
• Data protection
• Communication security
• System configuration
• Database security
• File management
• Memory management
• Testing

[gemini-code-assist]

Summary of Changes

Hello @adambenhassen, 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 introduces new documentation that empowers users to effectively manage their app deployments by identifying and retiring stale instances. It outlines how Hive tracks usage data, provides a practical example of querying this data via the GraphQL API to filter deployments, and suggests a workflow for both manual and automated cleanup processes, ensuring efficient resource management.

Highlights

• New Documentation for Stale App Deployments: Added a comprehensive section to the app-deployments.mdx documentation, guiding users on how to identify and manage stale app deployments within Hive using usage data.
• GraphQL API Query for Stale Deployments: Detailed the use of the activeAppDeployments GraphQL query, including new filters like lastUsedBefore and neverUsedAndCreatedBefore, to efficiently find deployments based on their last usage or creation date.
• Automated Cleanup Workflow: Provided guidance and an example script pattern for automating the retirement of stale app deployments by integrating the GraphQL API with the Hive CLI.

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 Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, 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 documentation for finding and retiring stale app deployments. The new section is well-written and provides useful information, including a GraphQL query example and an automation script pattern. I've suggested a couple of minor improvements: a grammatical correction and a more illustrative example for the automated cleanup script to better guide users.

[github-actions]

🚀 Snapshot Release (alpha)

The latest changes of this PR are available as alpha on npm (based on the declared changesets):

Package	Version	Info
@graphql-hive/cli	0.57.2-alpha-20260120155324-c1f5d768429af9b506c2185d9f68e82157e697fe	npm ↗︎ unpkg ↗︎
hive	9.0.0-alpha-20260120155324-c1f5d768429af9b506c2185d9f68e82157e697fe	npm ↗︎ unpkg ↗︎

[github-actions]

📚 Storybook Deployment

The latest changes are available as preview in: https://pr-7398.hive-storybook.pages.dev

[github-actions]

💻 Website Preview

The latest changes are available as preview in: https://pr-7398.hive-landing-page.pages.dev

[github-actions]

🐋 This PR was built and pushed to the following Docker images:

Targets: build

Platforms: linux/amd64

Image Tag: c1f5d768429af9b506c2185d9f68e82157e697fe