chore: plugin manifest definition

chore: make plugin manifest required

All plugins must now declare a static manifest property with their
metadata and resource requirements. This simplifies the manifest loader
and provides better error messages.

Author: MarioCadenas

docs/docs/api/appkit/Class.Plugin.md

@@ -1,6 +1,40 @@
 # Abstract Class: Plugin\<TConfig\>
 
-Base abstract class for creating AppKit plugins
+Base abstract class for creating AppKit plugins.
+
+Plugins can optionally declare their resource requirements through:
+1. A static `manifest` property - recommended for all plugins
+2. A static `getResourceRequirements()` method - for dynamic requirements
+
+## Example
+
+```typescript
+import { Plugin, toPlugin, PluginManifest, ResourceType } from '@databricks/appkit';
+
+// Define manifest
+const myManifest: PluginManifest = {
+  name: 'myPlugin',
+  displayName: 'My Plugin',
+  description: 'Does something awesome',
+  resources: {
+    required: [
+      {
+        type: ResourceType.SQL_WAREHOUSE,
+        alias: 'warehouse',
+        description: 'SQL Warehouse for queries',
+        permission: 'CAN_USE',
+        env: 'DATABRICKS_WAREHOUSE_ID'
+      }
+    ],
+    optional: []
+  }
+};
+
+class MyPlugin extends Plugin<MyConfig> {
+  static manifest = myManifest;
+  // ... implementation
+}
+```
 
 ## Type Parameters
 
@@ -86,6 +120,8 @@ protected isReady: boolean = false;
 name: string;
 ```
 
+Plugin name identifier.
+
 #### Implementation of
 
 ```ts
@@ -116,6 +152,11 @@ protected telemetry: ITelemetry;
 static phase: PluginPhase = "normal";
 ```
 
+Plugin initialization phase.
+- 'core': Initialized first (e.g., config plugins)
+- 'normal': Initialized second (most plugins)
+- 'deferred': Initialized last (e.g., server plugin)
+
 ## Methods
 
 ### abortActiveOperations()

docs/docs/api/appkit/Enumeration.ResourceType.md

@@ -0,0 +1,73 @@
+# Enumeration: ResourceType
+
+Supported Databricks resource types that plugins can depend on.
+
+## Enumeration Members
+
+### JOB
+
+```ts
+JOB: "job";
+```
+
+Databricks Job for scheduled or triggered workflows
+
+***
+
+### LAKEBASE
+
+```ts
+LAKEBASE: "lakebase";
+```
+
+Lakebase instance for persistent caching or data storage
+
+***
+
+### SECRET\_SCOPE
+
+```ts
+SECRET_SCOPE: "secret-scope";
+```
+
+Secret scope for secure credential storage
+
+***
+
+### SERVING\_ENDPOINT
+
+```ts
+SERVING_ENDPOINT: "serving-endpoint";
+```
+
+Model serving endpoint for ML inference
+
+***
+
+### SQL\_WAREHOUSE
+
+```ts
+SQL_WAREHOUSE: "sql-warehouse";
+```
+
+Databricks SQL Warehouse for query execution
+
+***
+
+### UNITY\_CATALOG
+
+```ts
+UNITY_CATALOG: "unity-catalog";
+```
+
+Unity Catalog for data governance and metadata
+
+***
+
+### VECTOR\_SEARCH\_INDEX
+
+```ts
+VECTOR_SEARCH_INDEX: "vector-search-index";
+```
+
+Vector search index for similarity search

docs/docs/api/appkit/Interface.ConfigSchema.md

@@ -0,0 +1,52 @@
+# Interface: ConfigSchema
+
+Configuration schema definition for plugin config.
+Uses JSON Schema format for validation and documentation.
+
+## Indexable
+
+```ts
+[key: string]: unknown
+```
+
+Allow additional JSON Schema properties
+
+## Properties
+
+### additionalProperties?
+
+```ts
+optional additionalProperties: boolean;
+```
+
+***
+
+### items?
+
+```ts
+optional items: ConfigSchema;
+```
+
+***
+
+### properties?
+
+```ts
+optional properties: Record<string, ConfigSchemaProperty>;
+```
+
+***
+
+### required?
+
+```ts
+optional required: string[];
+```
+
+***
+
+### type
+
+```ts
+type: "string" | "number" | "boolean" | "object" | "array";
+```

docs/docs/api/appkit/Interface.ConfigSchemaProperty.md

@@ -0,0 +1,83 @@
+# Interface: ConfigSchemaProperty
+
+Individual property definition in a config schema.
+
+## Properties
+
+### default?
+
+```ts
+optional default: unknown;
+```
+
+***
+
+### description?
+
+```ts
+optional description: string;
+```
+
+***
+
+### enum?
+
+```ts
+optional enum: unknown[];
+```
+
+***
+
+### items?
+
+```ts
+optional items: ConfigSchemaProperty;
+```
+
+***
+
+### maximum?
+
+```ts
+optional maximum: number;
+```
+
+***
+
+### maxLength?
+
+```ts
+optional maxLength: number;
+```
+
+***
+
+### minimum?
+
+```ts
+optional minimum: number;
+```
+
+***
+
+### minLength?
+
+```ts
+optional minLength: number;
+```
+
+***
+
+### properties?
+
+```ts
+optional properties: Record<string, ConfigSchemaProperty>;
+```
+
+***
+
+### type
+
+```ts
+type: "string" | "number" | "boolean" | "object" | "array";
+```

docs/docs/api/appkit/Interface.PluginManifest.md

@@ -0,0 +1,124 @@
+# Interface: PluginManifest
+
+Plugin manifest that declares metadata and resource requirements.
+Attached to plugin classes as a static property.
+
+## Properties
+
+### author?
+
+```ts
+optional author: string;
+```
+
+Optional metadata for community plugins
+
+***
+
+### config?
+
+```ts
+optional config: {
+  schema: ConfigSchema;
+};
+```
+
+Configuration schema for the plugin.
+Defines the shape and validation rules for plugin config.
+
+#### schema
+
+```ts
+schema: ConfigSchema;
+```
+
+***
+
+### description
+
+```ts
+description: string;
+```
+
+Brief description of what the plugin does
+
+***
+
+### displayName
+
+```ts
+displayName: string;
+```
+
+Human-readable display name for UI/CLI
+
+***
+
+### keywords?
+
+```ts
+optional keywords: string[];
+```
+
+***
+
+### license?
+
+```ts
+optional license: string;
+```
+
+***
+
+### name
+
+```ts
+name: string;
+```
+
+Plugin identifier (matches plugin.name)
+
+***
+
+### repository?
+
+```ts
+optional repository: string;
+```
+
+***
+
+### resources
+
+```ts
+resources: {
+  optional: Omit<ResourceRequirement, "required">[];
+  required: Omit<ResourceRequirement, "required">[];
+};
+```
+
+Resource requirements declaration
+
+#### optional
+
+```ts
+optional: Omit<ResourceRequirement, "required">[];
+```
+
+Resources that enhance functionality but are not mandatory
+
+#### required
+
+```ts
+required: Omit<ResourceRequirement, "required">[];
+```
+
+Resources that must be available for the plugin to function
+
+***
+
+### version?
+
+```ts
+optional version: string;
+```