feat: Add android-cli resource (#69)

* feat: Add android-cli resource (auto-generated from issue #68)

* fix: macOS install and tests. Moved android studios to it's own folder

* feat: add android studio version completions

* fix: skip tests for linux arm (unsupported)

* feat: made android cli emulator a stateful parameter instead. Improved docs for android

* feat: improved documentation (capitalized folder names)

* fix: added warning message for tart clone if disk is not accessible. Added apply note for android cli. Fixed android cli emulator list

* feat: add beta completions

* feat: add retry to android studio download

* feat: add backup wget as well for linux

* chore: bump version

---------

Co-authored-by: kevinwang5658 <20214115+kevinwang5658@users.noreply.github.com>
Co-authored-by: kevinwang <kevinwang5658@gmail.com>

Author: github-actions[bot]

completions-cron/src/__generated__/completions-index.ts

@@ -6,22 +6,25 @@ const BATCH_SIZE = 1000
 async function getResourceId(
   supabase: SupabaseClient,
   resourceType: string,
+  prerelease: boolean,
   cache: Map<string, string>
 ): Promise<string> {
-  if (cache.has(resourceType)) {
-    return cache.get(resourceType)!
+  const cacheKey = `${resourceType}:${prerelease}`
+  if (cache.has(cacheKey)) {
+    return cache.get(cacheKey)!
   }
 
   const { data, error } = await supabase
     .from('registry_resources')
     .select('id')
     .eq('type', resourceType)
+    .eq('prerelease', prerelease)
 
   if (error || !data?.[0]?.id) {
-    throw new Error(`Resource type '${resourceType}' not found in registry_resources`)
+    throw new Error(`Resource type '${resourceType}' (prerelease=${prerelease}) not found in registry_resources`)
   }
 
-  cache.set(resourceType, data[0].id)
+  cache.set(cacheKey, data[0].id)
   return data[0].id
 }
 
@@ -30,14 +33,15 @@ async function processModule(
   resourceType: string,
   parameterPath: string,
   fetchFn: () => Promise<string[]>,
+  prerelease: boolean,
   resourceIdCache: Map<string, string>
 ): Promise<void> {
   console.log(`Processing ${resourceType}${parameterPath}...`)
 
   const values = await fetchFn()
   console.log(`  [${resourceType}${parameterPath}] Fetched ${values.length} values`)
 
-  const resourceId = await getResourceId(supabase, resourceType, resourceIdCache)
+  const resourceId = await getResourceId(supabase, resourceType, prerelease, resourceIdCache)
 
   await supabase
     .from('resource_parameter_completions')
@@ -66,31 +70,44 @@ async function processModule(
   console.log(`  [${resourceType}${parameterPath}] Done: inserted ${values.length} completions`)
 }
 
+async function runCompletions(env: Env): Promise<void> {
+  const supabase = createClient(env.SUPABASE_URL, env.SUPABASE_SERVICE_ROLE_KEY)
+  const prerelease = env.PRERELEASE === 'true'
+  const resourceIdCache = new Map<string, string>()
+
+  const results = await Promise.allSettled(
+    completionModules.map(({ resourceType, parameterPath, fetch }: CompletionModule) =>
+      processModule(supabase, resourceType, parameterPath, fetch, prerelease, resourceIdCache)
+    )
+  )
+
+  for (const result of results) {
+    if (result.status === 'rejected') {
+      console.error('Completion module failed:', result.reason)
+    }
+  }
+
+  console.log('Successfully processed all resource completion tasks')
+}
+
 export default {
-  async fetch(req: Request) {
+  async fetch(req: Request, env: Env, ctx: ExecutionContext) {
     const url = new URL(req.url)
+
+    if (req.method === 'POST' && url.pathname === '/trigger') {
+      if (req.headers.get('Authorization') !== env.TRIGGER_SECRET) {
+        return new Response('Unauthorized', { status: 401 })
+      }
+      ctx.waitUntil(runCompletions(env))
+      return new Response('Triggered', { status: 202 })
+    }
+
     url.pathname = '/__scheduled'
     url.searchParams.append('cron', '* * * * *')
     return new Response(`To test the scheduled handler, ensure you have used the "--test-scheduled" then try running "curl ${url.href}".`)
   },
 
   async scheduled(_event: ScheduledEvent, env: Env, _ctx: ExecutionContext): Promise<void> {
-    console.log('hihi')
-    const supabase = createClient(env.SUPABASE_URL, env.SUPABASE_SERVICE_ROLE_KEY)
-    const resourceIdCache = new Map<string, string>()
-
-    const results = await Promise.allSettled(
-      completionModules.map(({ resourceType, parameterPath, fetch }: CompletionModule) =>
-        processModule(supabase, resourceType, parameterPath, fetch, resourceIdCache)
-      )
-    )
-
-    for (const result of results) {
-      if (result.status === 'rejected') {
-        console.error('Completion module failed:', result.reason)
-      }
-    }
-
-    console.log('Successfully processed all resource completion tasks')
+    await runCompletions(env)
   },
 } satisfies ExportedHandler<Env>

completions-cron/src/index.ts

@@ -6,6 +6,10 @@ declare namespace Cloudflare {
 		mainModule: typeof import("../src");
 	}
 	interface Env {
+		SUPABASE_URL: string;
+		SUPABASE_SERVICE_ROLE_KEY: string;
+		PRERELEASE: string;
+		TRIGGER_SECRET: string;
 	}
 }
 interface Env extends Cloudflare.Env {}

completions-cron/types/worker-configuration.d.ts

@@ -10,6 +10,18 @@ head_sampling_rate = 1
 
 [vars]
 SUPABASE_URL = "https://kdctbvqvqjfquplxhqrm.supabase.co"
+PRERELEASE = "false"
 
 [triggers]
 crons = ["0 5 * * *"]
+
+# Beta environment — deploys as a separate worker: resource-completions-cron-beta
+[env.beta]
+name = "resource-completions-cron-beta"
+
+[env.beta.vars]
+SUPABASE_URL = "https://kdctbvqvqjfquplxhqrm.supabase.co"
+PRERELEASE = "true"
+
+[env.beta.triggers]
+crons = ["0 5 * * *"]

completions-cron/wrangler.toml

@@ -1,4 +1,9 @@
 {
-  "title": "ai & agents",
-  "pages": ["claude-code", "claude-code-project", "ollama", "openclaw"]
+  "title": "AI & Agents",
+  "pages": [
+    "claude-code",
+    "claude-code-project",
+    "ollama",
+    "openclaw"
+  ]
 }

docs/resources/(resources)/ai-agents/meta.json

@@ -0,0 +1,72 @@
+---
+title: android-cli
+description: Reference pages for the Android CLI resources
+---
+
+The `android-cli` resource installs and configures [Android CLI](https://developer.android.com/tools/agents/android-cli), Google's command-line tool for managing the Android development environment. It manages the CLI itself, SDK packages, and Android Virtual Devices (AVDs) in a single resource.
+
+On macOS, Android CLI is installed via the official curl script (ARM64 and x86_64 supported). On Linux, only AMD64/x86_64 is supported.
+
+## Parameters
+
+- **sdkPath**: *(string)* Path to the Android SDK directory. Written to `~/.androidrc` as `--sdk=<path>`. Defaults to the android CLI's built-in default location if omitted.
+- **sdkPackages**: *(string[])* Android SDK packages to install declaratively. Package paths use forward-slash notation (e.g. `platforms/android-35`, `build-tools/35.0.0`, `cmdline-tools/latest`, `platform-tools`, `system-images/android-35/google_apis_playstore/x86_64`). Run `android sdk list --all` to see all available identifiers.
+- **emulators**: *(string[])* Android emulator profiles to create as AVDs. Each string is a hardware profile name (e.g. `medium_phone`, `pixel_9`). Emulators are always created after `sdkPackages` are installed. Run `android emulator create --list-profiles` to see available profiles.
+
+## Example usage
+
+Install the CLI with essential SDK packages:
+
+```json title="codify.jsonc"
+[
+  {
+    "type": "android-cli",
+    "sdkPackages": [
+      "cmdline-tools/latest",
+      "platform-tools",
+      "platforms/android-35",
+      "build-tools/35.0.0"
+    ]
+  }
+]
+```
+
+Full Android development environment with an emulator:
+
+```json title="codify.jsonc"
+[
+  {
+    "type": "android-cli",
+    "sdkPackages": [
+      "cmdline-tools/latest",
+      "platform-tools",
+      "platforms/android-35",
+      "build-tools/35.0.0",
+      "system-images/android-35/google_apis_playstore/x86_64"
+    ],
+    "emulators": ["pixel_9"]
+  }
+]
+```
+
+## Common emulator profiles
+
+| Profile | Description |
+|---------|-------------|
+| `medium_phone` | Generic medium phone (default) |
+| `small_phone` | Generic small phone |
+| `foldable` | Foldable form factor |
+| `medium_tablet` | Generic medium tablet |
+| `pixel_9` | Google Pixel 9 |
+| `pixel_9_pro` | Google Pixel 9 Pro |
+| `pixel_9_pro_fold` | Google Pixel 9 Pro Fold |
+| `pixel_8` | Google Pixel 8 |
+| `wear_os_large_round` | Wear OS round watch |
+| `tv_1080p` | Android TV 1080p |
+| `automotive_1024p_landscape` | Android Automotive |
+
+## Notes
+
+- Linux ARM64 is **not** supported. Only AMD64/x86_64 is supported on Linux.
+- AVDs are removed using `android emulator remove`.
+- Run `android info` to display the default SDK path in use.

docs/resources/(resources)/android/android-cli.mdx

@@ -0,0 +1,7 @@
+{
+  "title": "Android",
+  "pages": [
+    "android-cli",
+    "android-studio"
+  ]
+}

…sources)/editors-ides/android-studio.mdx …s/(resources)/android/android-studio.mdxdocs/resources/(resources)/editors-ides/android-studio.mdx renamed to docs/resources/(resources)/android/android-studio.mdx docs/resources/(resources)/editors-ides/android-studio.mdx renamed to docs/resources/(resources)/android/android-studio.mdx

@@ -1,4 +1,8 @@
 {
-  "title": "asdf",
-  "pages": ["asdf", "asdf-install", "asdf-plugin"]
+  "title": "Asdf",
+  "pages": [
+    "asdf",
+    "asdf-install",
+    "asdf-plugin"
+  ]
 }

docs/resources/(resources)/android/meta.json

@@ -1,4 +1,7 @@
 {
-  "title": "editors & ides",
-  "pages": ["vscode", "cursor", "intellij-idea", "clion", "goland", "phpstorm", "pycharm", "rider", "rubymine", "rustrover", "webstorm", "android-studio"]
+  "title": "Editors & IDEs",
+  "pages": [
+    "[android-studio](/docs/resources/android/android-studio)",
+    "..."
+  ]
 }