feat(cli): add 'appkit add' and 'appkit registry' commands

apps/scratch/.gitignore

@@ -0,0 +1,6 @@
+# Scratch apps live here — resolved as workspace packages (deps link to the
+# monorepo) and ignored by knip (apps/** is in ignoreWorkspaces), but never
+# committed. Keep this dir tracked via .gitkeep; ignore everything else.
+*
+!.gitignore
+!.gitkeep

packages/shared/package.json

@@ -53,6 +53,7 @@
     "dotenv": "16.6.1",
     "js-yaml": "4.2.0",
     "picocolors": "1.1.1",
+    "yaml": "2.8.2",
     "zod": "4.3.6"
   }
 }

packages/shared/src/cli/commands/doctor/bundle.ts

@@ -14,12 +14,14 @@
 import fs from "node:fs";
 import path from "node:path";
 import yaml from "js-yaml";
+import {
+  APP_YAML_FILE,
+  bindingTypeOf,
+  DATABRICKS_YML_FILE,
+} from "../../deploy-config";
 import type { ResourceOrigin } from "./types";
 import { errorMessage } from "./utils";
 
-export const DEFAULT_BUNDLE_FILE = "databricks.yml";
-export const DEFAULT_APP_YAML_FILE = "app.yaml";
-
 /** A `${resources.<type>.<key>.<field>}` reference — a bundle-created resource. */
 const RESOURCES_REF = /\$\{resources\.([^.]+)\.([^.}]+)\.[^}]+\}/;
 
@@ -62,15 +64,6 @@ interface AppYamlDoc {
   env?: Array<{ name?: string; valueFrom?: string }>;
 }
 
-/** The typed sub-key of a binding is its single non-`name` object property. */
-function bindingType(block: AppResourceBlock): string | undefined {
-  for (const [k, v] of Object.entries(block)) {
-    if (k === "name") continue;
-    if (v && typeof v === "object") return k;
-  }
-  return undefined;
-}
-
 /** Classifies a binding by its typed sub-key and origin: scanning its field
  * values for a `${resources.*}` reference (bundle-managed) vs anything else
  * (external). */
@@ -79,7 +72,7 @@ function classifyBinding(block: AppResourceBlock): {
   origin: ResourceOrigin;
   ref?: { type: string; key: string };
 } {
-  const type = bindingType(block);
+  const type = bindingTypeOf(block);
   const typed = type ? block[type] : undefined;
   if (typed && typeof typed === "object") {
     for (const value of Object.values(typed as Record<string, unknown>)) {
@@ -126,8 +119,8 @@ function readYaml<T>(filePath: string): T | null {
  */
 export function readBundleInfo(
   cwd: string = process.cwd(),
-  bundleFile: string = DEFAULT_BUNDLE_FILE,
-  appYamlFile: string = DEFAULT_APP_YAML_FILE,
+  bundleFile: string = DATABRICKS_YML_FILE,
+  appYamlFile: string = APP_YAML_FILE,
 ): BundleInfo {
   const bindings = new Map<string, BundleBinding>();
   const envToBinding = new Map<string, string>();

packages/shared/src/cli/commands/registry/__fixtures__/analytics/app.yaml

@@ -0,0 +1,4 @@
+command: ['npm', 'run', 'start']
+env:
+  - name: DATABRICKS_WAREHOUSE_ID
+    valueFrom: sql-warehouse