feat(api): conditional breaking changes based on app deployments

.changeset/flower-ball-gulp.md

@@ -0,0 +1,5 @@
+---
+'hive': minor
+---
+
+Show affected app deployments for breaking schema changes. When a schema check detects breaking changes, it now shows which active app deployments would be affected, including the specific operations within each deployment that use the affected schema coordinates.

.changeset/jdpj-gvmv-utrp.md

@@ -0,0 +1,14 @@
+---
+'hive': minor
+---
+
+Add `activeAppDeployments` GraphQL query to find app deployments based on usage criteria.
+
+New filter options:
+- `lastUsedBefore`: Find stale deployments that were used but not recently (OR with neverUsedAndCreatedBefore)
+- `neverUsedAndCreatedBefore`: Find old deployments that have never been used (OR with lastUsedBefore)
+- `name`: Filter by app deployment name (case-insensitive partial match, AND with date filters)
+
+Also adds `createdAt` field to the `AppDeployment` type.
+
+See [Finding Stale App Deployments](https://the-guild.dev/graphql/hive/docs/schema-registry/app-deployments#finding-stale-app-deployments) for more details.

integration-tests/testkit/cli.ts

@@ -80,6 +80,22 @@ async function dev(args: string[]) {
   );
 }
 
+export async function appCreate(args: string[]) {
+  const registryAddress = await getServiceHost('server', 8082);
+
+  return await exec(
+    ['app:create', `--registry.endpoint`, `http://${registryAddress}/graphql`, ...args].join(' '),
+  );
+}
+
+export async function appPublish(args: string[]) {
+  const registryAddress = await getServiceHost('server', 8082);
+
+  return await exec(
+    ['app:publish', `--registry.endpoint`, `http://${registryAddress}/graphql`, ...args].join(' '),
+  );
+}
+
 export function createCLI(tokens: { readwrite: string; readonly: string }) {
   let publishCount = 0;