@databricks/appkit 0.23.0 → 0.25.0

package/dist/cli/commands/plugin/create/create.js

@@ -1,16 +1,150 @@
-import { RESOURCE_TYPE_OPTIONS } from "./resource-defaults.js";
+import { DEFAULT_PERMISSION_BY_TYPE, RESOURCE_TYPE_OPTIONS, getDefaultFieldsForType, getValidResourceTypes, humanizeResourceType, resourceKeyFromType } from "./resource-defaults.js";
 import { promptOneResource } from "./prompt-resource.js";
 import { resolveTargetDir, scaffoldPlugin } from "./scaffold.js";
 import fs from "node:fs";
 import path from "node:path";
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import process from "node:process";
 import { cancel, confirm, intro, isCancel, multiselect, outro, select, spinner, text } from "@clack/prompts";
 
 //#region src/cli/commands/plugin/create/create.ts
 const NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
 const DEFAULT_VERSION = "0.1.0";
-async function runPluginCreate() {
+const VALID_PLACEMENTS = ["in-repo", "isolated"];
+const REQUIRED_FLAGS = [
+	"placement",
+	"path",
+	"name",
+	"description"
+];
+function deriveDisplayName(name) {
+	return name.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
+}
+function deriveExportName(name) {
+	return name.split("-").map((s, i) => i === 0 ? s : s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+function buildResourceFromType(type) {
+	return {
+		type,
+		required: true,
+		description: `Required for ${humanizeResourceType(type)} functionality.`,
+		resourceKey: resourceKeyFromType(type),
+		permission: DEFAULT_PERMISSION_BY_TYPE[type] ?? "CAN_VIEW",
+		fields: getDefaultFieldsForType(type)
+	};
+}
+function parseResourcesJson(json) {
+	let parsed;
+	try {
+		parsed = JSON.parse(json);
+	} catch {
+		console.error("Error: --resources-json must be valid JSON.");
+		console.error("  Example: --resources-json '[{\"type\":\"sql_warehouse\"}]'");
+		process.exit(1);
+	}
+	if (!Array.isArray(parsed)) {
+		console.error("Error: --resources-json must be a JSON array.");
+		console.error("  Example: --resources-json '[{\"type\":\"sql_warehouse\"}]'");
+		process.exit(1);
+	}
+	return parsed.map((entry, i) => {
+		if (entry == null || typeof entry !== "object") {
+			console.error(`Error: --resources-json entry ${i} is not an object.`);
+			process.exit(1);
+		}
+		if (!entry.type || typeof entry.type !== "string") {
+			console.error(`Error: --resources-json entry ${i} missing required "type" field.`);
+			process.exit(1);
+		}
+		validateResourceType(entry.type);
+		const defaults = buildResourceFromType(entry.type);
+		return {
+			type: entry.type,
+			required: entry.required ?? defaults.required,
+			description: entry.description ?? defaults.description,
+			resourceKey: entry.resourceKey ?? defaults.resourceKey,
+			permission: entry.permission ?? defaults.permission,
+			fields: entry.fields ?? defaults.fields
+		};
+	});
+}
+function validateResourceType(type) {
+	const validTypes = getValidResourceTypes();
+	if (!validTypes.includes(type)) {
+		console.error(`Error: Unknown resource type "${type}".`);
+		console.error(`  Valid types: ${validTypes.join(", ")}`);
+		process.exit(1);
+	}
+}
+function parseResourcesShorthand(csv) {
+	const types = csv.split(",").map((s) => s.trim()).filter(Boolean);
+	for (const t of types) validateResourceType(t);
+	return types.map(buildResourceFromType);
+}
+function printNextSteps(answers, targetDir) {
+	const relativePath = path.relative(process.cwd(), targetDir);
+	const importPath = relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+	const exportName = deriveExportName(answers.name);
+	console.log("\nNext steps:\n");
+	if (answers.placement === "in-repo") {
+		console.log(`  1. Import and register in your server:`);
+		console.log(`     import { ${exportName} } from "${importPath}";`);
+		console.log(`     createApp({ plugins: [ ..., ${exportName}() ] });`);
+		console.log(`  2. Run \`npx appkit plugin sync --write\` to update appkit.plugins.json.\n`);
+	} else {
+		console.log(`  1. cd into the new package and install dependencies:`);
+		console.log(`     cd ${answers.targetPath} && pnpm install`);
+		console.log(`  2. Build: pnpm build`);
+		console.log(`  3. In your app: pnpm add ./${answers.targetPath} @databricks/appkit`);
+		console.log(`  4. Import and register: import { ${exportName} } from "<package-name>";\n`);
+	}
+}
+function runNonInteractive(opts) {
+	const missing = REQUIRED_FLAGS.filter((f) => !opts[f]);
+	if (missing.length > 0) {
+		console.error(`Error: Non-interactive mode requires: ${REQUIRED_FLAGS.map((f) => `--${f}`).join(", ")}`);
+		console.error(`Missing: ${missing.map((f) => `--${f}`).join(", ")}`);
+		console.error("  appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\"");
+		process.exit(1);
+	}
+	const placement = opts.placement;
+	if (!VALID_PLACEMENTS.includes(placement)) {
+		console.error(`Error: --placement must be one of: ${VALID_PLACEMENTS.join(", ")}`);
+		process.exit(1);
+	}
+	const targetPath = opts.path.trim();
+	if (placement === "in-repo" && (path.isAbsolute(targetPath) || targetPath.startsWith(".."))) {
+		console.error("Error: --path must be a relative path under the current directory for in-repo plugins.");
+		process.exit(1);
+	}
+	const name = opts.name;
+	if (!NAME_PATTERN.test(name)) {
+		console.error("Error: --name must be lowercase, start with a letter, and use only letters, numbers, and hyphens.");
+		process.exit(1);
+	}
+	let resources = [];
+	if (opts.resourcesJson) resources = parseResourcesJson(opts.resourcesJson);
+	else if (opts.resources) resources = parseResourcesShorthand(opts.resources);
+	const answers = {
+		placement,
+		targetPath,
+		name: name.trim(),
+		displayName: opts.displayName?.trim() || deriveDisplayName(name),
+		description: opts.description.trim(),
+		resources,
+		version: DEFAULT_VERSION
+	};
+	const targetDir = resolveTargetDir(process.cwd(), answers);
+	if (fs.existsSync(targetDir) && fs.readdirSync(targetDir).length > 0 && !opts.force) {
+		console.error(`Error: Directory ${answers.targetPath} already exists and is not empty.`);
+		console.error("  Use --force to overwrite.");
+		process.exit(1);
+	}
+	scaffoldPlugin(targetDir, answers, { isolated: placement === "isolated" });
+	console.log(`Plugin "${answers.name}" created at ${path.relative(process.cwd(), targetDir)}`);
+	printNextSteps(answers, targetDir);
+}
+async function runInteractive() {
 	intro("Create a new AppKit plugin");
 	try {
 		const placement = await select({
@@ -133,29 +267,39 @@ async function runPluginCreate() {
 			s.stop("Failed.");
 			throw err;
 		}
-		const relativePath = path.relative(process.cwd(), targetDir);
-		const importPath = relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
-		const exportName = answers.name.split("-").map((s, i) => i === 0 ? s : s.charAt(0).toUpperCase() + s.slice(1)).join("");
 		outro("Plugin created successfully.");
-		console.log("\nNext steps:\n");
-		if (placement === "in-repo") {
-			console.log(`  1. Import and register in your server:`);
-			console.log(`     import { ${exportName} } from "${importPath}";`);
-			console.log(`     createApp({ plugins: [ ..., ${exportName}() ] });`);
-			console.log(`  2. Run \`npx appkit plugin sync --write\` to update appkit.plugins.json.\n`);
-		} else {
-			console.log(`  1. cd into the new package and install dependencies:`);
-			console.log(`     cd ${answers.targetPath} && pnpm install`);
-			console.log(`  2. Build: pnpm build`);
-			console.log(`  3. In your app: pnpm add ./${answers.targetPath} @databricks/appkit`);
-			console.log(`  4. Import and register: import { ${exportName} } from "<package-name>";\n`);
-		}
+		printNextSteps(answers, targetDir);
 	} catch (err) {
 		console.error(err);
 		process.exit(1);
 	}
 }
-const pluginCreateCommand = new Command("create").description("Scaffold a new AppKit plugin (interactive)").action(runPluginCreate);
+const OPTIONAL_FLAGS = [
+	"displayName",
+	"resources",
+	"resourcesJson",
+	"force"
+];
+async function runPluginCreate(opts) {
+	if (REQUIRED_FLAGS.some((f) => opts[f] !== void 0)) runNonInteractive(opts);
+	else {
+		if (OPTIONAL_FLAGS.some((f) => opts[f] !== void 0 && opts[f] !== false)) {
+			console.error(`Error: Non-interactive mode requires: ${REQUIRED_FLAGS.map((f) => `--${f}`).join(", ")}`);
+			console.error("  appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\"");
+			process.exit(1);
+		}
+		await runInteractive();
+	}
+}
+const pluginCreateCommand = new Command("create").description("Scaffold a new AppKit plugin").option("--placement <type>", "Where the plugin lives (in-repo, isolated)").option("--path <dir>", "Target directory for the plugin").option("--name <id>", "Plugin name (lowercase, hyphens allowed)").option("--display-name <name>", "Human-readable display name").option("--description <text>", "Short description of the plugin").addOption(new Option("--resources <types>", "Comma-separated resource types (e.g. sql_warehouse,volume)").conflicts("resourcesJson")).addOption(new Option("--resources-json <json>", "JSON array of resource specs (e.g. '[{\"type\":\"sql_warehouse\"}]')").conflicts("resources")).option("-f, --force", "Overwrite existing directory without confirmation").addHelpText("after", `
+Examples:
+  $ appkit plugin create
+  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description "Does X"
+  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description "Does X" --resources sql_warehouse,volume --force
+  $ appkit plugin create --placement isolated --path appkit-plugin-ml --name ml --description "ML" --resources-json '[{"type":"serving_endpoint"}]'`).action((opts) => runPluginCreate(opts).catch((err) => {
+	console.error(err);
+	process.exit(1);
+}));
 
 //#endregion
 export { pluginCreateCommand };

package/dist/cli/commands/plugin/create/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/create.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport {\n  cancel,\n  confirm,\n  intro,\n  isCancel,\n  multiselect,\n  outro,\n  select,\n  spinner,\n  text,\n} from \"@clack/prompts\";\nimport { Command } from \"commander\";\nimport { promptOneResource } from \"./prompt-resource\";\nimport { RESOURCE_TYPE_OPTIONS } from \"./resource-defaults\";\nimport { resolveTargetDir, scaffoldPlugin } from \"./scaffold\";\nimport type { CreateAnswers, Placement } from \"./types\";\n\nconst NAME_PATTERN = /^[a-z][a-z0-9-]*$/;\nconst DEFAULT_VERSION = \"0.1.0\";\n\nasync function runPluginCreate(): Promise<void> {\n  intro(\"Create a new AppKit plugin\");\n\n  try {\n    const placement = await select<Placement>({\n      message: \"Where should the plugin live?\",\n      options: [\n        {\n          value: \"in-repo\",\n          label: \"In this repository (e.g. plugins/my-plugin)\",\n          hint: \"folder path\",\n        },\n        {\n          value: \"isolated\",\n          label: \"New isolated package\",\n          hint: \"full package with package.json\",\n        },\n      ],\n    });\n    if (isCancel(placement)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const placementPrompt =\n      placement === \"in-repo\"\n        ? \"Folder path for the plugin (e.g. plugins/my-feature)\"\n        : \"Directory name for the new package (e.g. appkit-plugin-my-feature)\";\n    const targetPath = await text({\n      message: placementPrompt,\n      placeholder:\n        placement === \"in-repo\"\n          ? \"plugins/my-plugin\"\n          : \"appkit-plugin-my-feature\",\n      validate(value) {\n        if (!value?.trim()) return \"Path is required.\";\n        if (\n          placement === \"in-repo\" &&\n          (path.isAbsolute(value) || value.trim().startsWith(\"..\"))\n        ) {\n          return \"Use a relative path under the current directory (e.g. plugins/my-plugin).\";\n        }\n        return undefined;\n      },\n    });\n    if (isCancel(targetPath)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const name = await text({\n      message: \"Plugin name (id)\",\n      placeholder: \"my-plugin\",\n      validate(value) {\n        if (!value?.trim()) return \"Name is required.\";\n        if (!NAME_PATTERN.test(value as string)) {\n          return \"Must be lowercase, start with a letter, and use only letters, numbers, and hyphens.\";\n        }\n        return undefined;\n      },\n    });\n    if (isCancel(name)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const displayName = await text({\n      message: \"Display name\",\n      placeholder: \"My Plugin\",\n      initialValue: name\n        .split(\"-\")\n        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n        .join(\" \"),\n      validate(value) {\n        if (!value?.trim()) return \"Display name is required.\";\n        return undefined;\n      },\n    });\n    if (isCancel(displayName)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const description = await text({\n      message: \"Short description\",\n      placeholder: \"What does this plugin do?\",\n      validate(value) {\n        if (!value?.trim()) return \"Description is required.\";\n        return undefined;\n      },\n    });\n    if (isCancel(description)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const resourceTypes = await multiselect({\n      message: \"Which Databricks resources does this plugin need?\",\n      options: RESOURCE_TYPE_OPTIONS.map((o) => ({\n        value: o.value,\n        label: o.label,\n      })),\n      required: false,\n    });\n    if (isCancel(resourceTypes)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const resources: CreateAnswers[\"resources\"] = [];\n    for (const type of resourceTypes as string[]) {\n      const spec = await promptOneResource({ type });\n      if (!spec) {\n        cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n      resources.push({\n        type: spec.type,\n        required: spec.required,\n        description: spec.description,\n        resourceKey: spec.resourceKey,\n        permission: spec.permission,\n        fields: spec.fields,\n      });\n    }\n\n    const answers: CreateAnswers = {\n      placement,\n      targetPath: (targetPath as string).trim(),\n      name: (name as string).trim(),\n      displayName: (displayName as string).trim(),\n      description: (description as string).trim(),\n      resources,\n      version: DEFAULT_VERSION,\n    };\n\n    const targetDir = resolveTargetDir(process.cwd(), answers);\n    const dirExists = fs.existsSync(targetDir);\n    const hasContent = dirExists && fs.readdirSync(targetDir).length > 0;\n    if (hasContent) {\n      const overwrite = await confirm({\n        message: `Directory ${answers.targetPath} already exists and is not empty. Overwrite?`,\n        initialValue: false,\n      });\n      if (isCancel(overwrite) || !overwrite) {\n        cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n    }\n\n    const s = spinner();\n    s.start(\"Writing files…\");\n    try {\n      scaffoldPlugin(targetDir, answers, {\n        isolated: placement === \"isolated\",\n      });\n      s.stop(\"Files written.\");\n    } catch (err) {\n      s.stop(\"Failed.\");\n      throw err;\n    }\n\n    const relativePath = path.relative(process.cwd(), targetDir);\n    const importPath = relativePath.startsWith(\".\")\n      ? relativePath\n      : `./${relativePath}`;\n    const exportName = answers.name\n      .split(\"-\")\n      .map((s, i) => (i === 0 ? s : s.charAt(0).toUpperCase() + s.slice(1)))\n      .join(\"\");\n\n    outro(\"Plugin created successfully.\");\n\n    console.log(\"\\nNext steps:\\n\");\n    if (placement === \"in-repo\") {\n      console.log(`  1. Import and register in your server:`);\n      console.log(`     import { ${exportName} } from \"${importPath}\";`);\n      console.log(`     createApp({ plugins: [ ..., ${exportName}() ] });`);\n      console.log(\n        `  2. Run \\`npx appkit plugin sync --write\\` to update appkit.plugins.json.\\n`,\n      );\n    } else {\n      console.log(`  1. cd into the new package and install dependencies:`);\n      console.log(`     cd ${answers.targetPath} && pnpm install`);\n      console.log(`  2. Build: pnpm build`);\n      console.log(\n        `  3. In your app: pnpm add ./${answers.targetPath} @databricks/appkit`,\n      );\n      console.log(\n        `  4. Import and register: import { ${exportName} } from \"<package-name>\";\\n`,\n      );\n    }\n  } catch (err) {\n    console.error(err);\n    process.exit(1);\n  }\n}\n\nexport const pluginCreateCommand = new Command(\"create\")\n  .description(\"Scaffold a new AppKit plugin (interactive)\")\n  .action(runPluginCreate);\n"],"mappings":"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"}
+{"version":3,"file":"create.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/create.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport {\n  cancel,\n  confirm,\n  intro,\n  isCancel,\n  multiselect,\n  outro,\n  select,\n  spinner,\n  text,\n} from \"@clack/prompts\";\nimport { Command, Option } from \"commander\";\nimport { promptOneResource } from \"./prompt-resource\";\nimport {\n  DEFAULT_PERMISSION_BY_TYPE,\n  getDefaultFieldsForType,\n  getValidResourceTypes,\n  humanizeResourceType,\n  RESOURCE_TYPE_OPTIONS,\n  resourceKeyFromType,\n} from \"./resource-defaults\";\nimport { resolveTargetDir, scaffoldPlugin } from \"./scaffold\";\nimport type { CreateAnswers, Placement, SelectedResource } from \"./types\";\n\nconst NAME_PATTERN = /^[a-z][a-z0-9-]*$/;\nconst DEFAULT_VERSION = \"0.1.0\";\nconst VALID_PLACEMENTS: Placement[] = [\"in-repo\", \"isolated\"];\nconst REQUIRED_FLAGS = [\"placement\", \"path\", \"name\", \"description\"] as const;\n\ninterface CreateOptions {\n  placement?: string;\n  path?: string;\n  name?: string;\n  displayName?: string;\n  description?: string;\n  resources?: string;\n  resourcesJson?: string;\n  force?: boolean;\n}\n\nfunction deriveDisplayName(name: string): string {\n  return name\n    .split(\"-\")\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join(\" \");\n}\n\nfunction deriveExportName(name: string): string {\n  return name\n    .split(\"-\")\n    .map((s, i) => (i === 0 ? s : s.charAt(0).toUpperCase() + s.slice(1)))\n    .join(\"\");\n}\n\nfunction buildResourceFromType(type: string): SelectedResource {\n  return {\n    type,\n    required: true,\n    description: `Required for ${humanizeResourceType(type)} functionality.`,\n    resourceKey: resourceKeyFromType(type),\n    permission: DEFAULT_PERMISSION_BY_TYPE[type] ?? \"CAN_VIEW\",\n    fields: getDefaultFieldsForType(type),\n  };\n}\n\ninterface JsonResourceEntry {\n  type: string;\n  required?: boolean;\n  description?: string;\n  resourceKey?: string;\n  permission?: string;\n  fields?: Record<string, { env: string; description?: string }>;\n}\n\nfunction parseResourcesJson(json: string): SelectedResource[] {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(json);\n  } catch {\n    console.error(\"Error: --resources-json must be valid JSON.\");\n    console.error('  Example: --resources-json \\'[{\"type\":\"sql_warehouse\"}]\\'');\n    process.exit(1);\n  }\n\n  if (!Array.isArray(parsed)) {\n    console.error(\"Error: --resources-json must be a JSON array.\");\n    console.error('  Example: --resources-json \\'[{\"type\":\"sql_warehouse\"}]\\'');\n    process.exit(1);\n  }\n\n  return (parsed as JsonResourceEntry[]).map((entry, i) => {\n    if (entry == null || typeof entry !== \"object\") {\n      console.error(`Error: --resources-json entry ${i} is not an object.`);\n      process.exit(1);\n    }\n    if (!entry.type || typeof entry.type !== \"string\") {\n      console.error(\n        `Error: --resources-json entry ${i} missing required \"type\" field.`,\n      );\n      process.exit(1);\n    }\n    validateResourceType(entry.type);\n    const defaults = buildResourceFromType(entry.type);\n    return {\n      type: entry.type,\n      required: entry.required ?? defaults.required,\n      description: entry.description ?? defaults.description,\n      resourceKey: entry.resourceKey ?? defaults.resourceKey,\n      permission: entry.permission ?? defaults.permission,\n      fields: entry.fields ?? defaults.fields,\n    };\n  });\n}\n\nfunction validateResourceType(type: string): void {\n  const validTypes = getValidResourceTypes();\n  if (!validTypes.includes(type)) {\n    console.error(`Error: Unknown resource type \"${type}\".`);\n    console.error(`  Valid types: ${validTypes.join(\", \")}`);\n    process.exit(1);\n  }\n}\n\nfunction parseResourcesShorthand(csv: string): SelectedResource[] {\n  const types = csv\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  for (const t of types) validateResourceType(t);\n  return types.map(buildResourceFromType);\n}\n\nfunction printNextSteps(answers: CreateAnswers, targetDir: string): void {\n  const relativePath = path.relative(process.cwd(), targetDir);\n  const importPath = relativePath.startsWith(\".\")\n    ? relativePath\n    : `./${relativePath}`;\n  const exportName = deriveExportName(answers.name);\n\n  console.log(\"\\nNext steps:\\n\");\n  if (answers.placement === \"in-repo\") {\n    console.log(`  1. Import and register in your server:`);\n    console.log(`     import { ${exportName} } from \"${importPath}\";`);\n    console.log(`     createApp({ plugins: [ ..., ${exportName}() ] });`);\n    console.log(\n      `  2. Run \\`npx appkit plugin sync --write\\` to update appkit.plugins.json.\\n`,\n    );\n  } else {\n    console.log(`  1. cd into the new package and install dependencies:`);\n    console.log(`     cd ${answers.targetPath} && pnpm install`);\n    console.log(`  2. Build: pnpm build`);\n    console.log(\n      `  3. In your app: pnpm add ./${answers.targetPath} @databricks/appkit`,\n    );\n    console.log(\n      `  4. Import and register: import { ${exportName} } from \"<package-name>\";\\n`,\n    );\n  }\n}\n\nfunction runNonInteractive(opts: CreateOptions): void {\n  const missing = REQUIRED_FLAGS.filter((f) => !opts[f]);\n  if (missing.length > 0) {\n    console.error(\n      `Error: Non-interactive mode requires: ${REQUIRED_FLAGS.map((f) => `--${f}`).join(\", \")}`,\n    );\n    console.error(`Missing: ${missing.map((f) => `--${f}`).join(\", \")}`);\n    console.error(\n      '  appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\"',\n    );\n    process.exit(1);\n  }\n\n  const placement = opts.placement as Placement;\n  if (!VALID_PLACEMENTS.includes(placement)) {\n    console.error(\n      `Error: --placement must be one of: ${VALID_PLACEMENTS.join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  const targetPath = (opts.path as string).trim();\n  if (\n    placement === \"in-repo\" &&\n    (path.isAbsolute(targetPath) || targetPath.startsWith(\"..\"))\n  ) {\n    console.error(\n      \"Error: --path must be a relative path under the current directory for in-repo plugins.\",\n    );\n    process.exit(1);\n  }\n\n  const name = opts.name as string;\n  if (!NAME_PATTERN.test(name)) {\n    console.error(\n      \"Error: --name must be lowercase, start with a letter, and use only letters, numbers, and hyphens.\",\n    );\n    process.exit(1);\n  }\n\n  let resources: SelectedResource[] = [];\n  if (opts.resourcesJson) {\n    resources = parseResourcesJson(opts.resourcesJson);\n  } else if (opts.resources) {\n    resources = parseResourcesShorthand(opts.resources);\n  }\n\n  const answers: CreateAnswers = {\n    placement,\n    targetPath,\n    name: name.trim(),\n    displayName: opts.displayName?.trim() || deriveDisplayName(name),\n    description: (opts.description as string).trim(),\n    resources,\n    version: DEFAULT_VERSION,\n  };\n\n  const targetDir = resolveTargetDir(process.cwd(), answers);\n  const dirExists = fs.existsSync(targetDir);\n  const hasContent = dirExists && fs.readdirSync(targetDir).length > 0;\n  if (hasContent && !opts.force) {\n    console.error(\n      `Error: Directory ${answers.targetPath} already exists and is not empty.`,\n    );\n    console.error(\"  Use --force to overwrite.\");\n    process.exit(1);\n  }\n\n  scaffoldPlugin(targetDir, answers, { isolated: placement === \"isolated\" });\n\n  console.log(\n    `Plugin \"${answers.name}\" created at ${path.relative(process.cwd(), targetDir)}`,\n  );\n  printNextSteps(answers, targetDir);\n}\n\nasync function runInteractive(): Promise<void> {\n  intro(\"Create a new AppKit plugin\");\n\n  try {\n    const placement = await select<Placement>({\n      message: \"Where should the plugin live?\",\n      options: [\n        {\n          value: \"in-repo\",\n          label: \"In this repository (e.g. plugins/my-plugin)\",\n          hint: \"folder path\",\n        },\n        {\n          value: \"isolated\",\n          label: \"New isolated package\",\n          hint: \"full package with package.json\",\n        },\n      ],\n    });\n    if (isCancel(placement)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const placementPrompt =\n      placement === \"in-repo\"\n        ? \"Folder path for the plugin (e.g. plugins/my-feature)\"\n        : \"Directory name for the new package (e.g. appkit-plugin-my-feature)\";\n    const targetPath = await text({\n      message: placementPrompt,\n      placeholder:\n        placement === \"in-repo\"\n          ? \"plugins/my-plugin\"\n          : \"appkit-plugin-my-feature\",\n      validate(value) {\n        if (!value?.trim()) return \"Path is required.\";\n        if (\n          placement === \"in-repo\" &&\n          (path.isAbsolute(value) || value.trim().startsWith(\"..\"))\n        ) {\n          return \"Use a relative path under the current directory (e.g. plugins/my-plugin).\";\n        }\n        return undefined;\n      },\n    });\n    if (isCancel(targetPath)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const name = await text({\n      message: \"Plugin name (id)\",\n      placeholder: \"my-plugin\",\n      validate(value) {\n        if (!value?.trim()) return \"Name is required.\";\n        if (!NAME_PATTERN.test(value as string)) {\n          return \"Must be lowercase, start with a letter, and use only letters, numbers, and hyphens.\";\n        }\n        return undefined;\n      },\n    });\n    if (isCancel(name)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const displayName = await text({\n      message: \"Display name\",\n      placeholder: \"My Plugin\",\n      initialValue: name\n        .split(\"-\")\n        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n        .join(\" \"),\n      validate(value) {\n        if (!value?.trim()) return \"Display name is required.\";\n        return undefined;\n      },\n    });\n    if (isCancel(displayName)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const description = await text({\n      message: \"Short description\",\n      placeholder: \"What does this plugin do?\",\n      validate(value) {\n        if (!value?.trim()) return \"Description is required.\";\n        return undefined;\n      },\n    });\n    if (isCancel(description)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const resourceTypes = await multiselect({\n      message: \"Which Databricks resources does this plugin need?\",\n      options: RESOURCE_TYPE_OPTIONS.map((o) => ({\n        value: o.value,\n        label: o.label,\n      })),\n      required: false,\n    });\n    if (isCancel(resourceTypes)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const resources: CreateAnswers[\"resources\"] = [];\n    for (const type of resourceTypes as string[]) {\n      const spec = await promptOneResource({ type });\n      if (!spec) {\n        cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n      resources.push({\n        type: spec.type,\n        required: spec.required,\n        description: spec.description,\n        resourceKey: spec.resourceKey,\n        permission: spec.permission,\n        fields: spec.fields,\n      });\n    }\n\n    const answers: CreateAnswers = {\n      placement,\n      targetPath: (targetPath as string).trim(),\n      name: (name as string).trim(),\n      displayName: (displayName as string).trim(),\n      description: (description as string).trim(),\n      resources,\n      version: DEFAULT_VERSION,\n    };\n\n    const targetDir = resolveTargetDir(process.cwd(), answers);\n    const dirExists = fs.existsSync(targetDir);\n    const hasContent = dirExists && fs.readdirSync(targetDir).length > 0;\n    if (hasContent) {\n      const overwrite = await confirm({\n        message: `Directory ${answers.targetPath} already exists and is not empty. Overwrite?`,\n        initialValue: false,\n      });\n      if (isCancel(overwrite) || !overwrite) {\n        cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n    }\n\n    const s = spinner();\n    s.start(\"Writing files…\");\n    try {\n      scaffoldPlugin(targetDir, answers, {\n        isolated: placement === \"isolated\",\n      });\n      s.stop(\"Files written.\");\n    } catch (err) {\n      s.stop(\"Failed.\");\n      throw err;\n    }\n\n    outro(\"Plugin created successfully.\");\n    printNextSteps(answers, targetDir);\n  } catch (err) {\n    console.error(err);\n    process.exit(1);\n  }\n}\n\nconst OPTIONAL_FLAGS = [\n  \"displayName\",\n  \"resources\",\n  \"resourcesJson\",\n  \"force\",\n] as const;\n\nasync function runPluginCreate(opts: CreateOptions): Promise<void> {\n  const hasRequiredFlag = REQUIRED_FLAGS.some((f) => opts[f] !== undefined);\n  if (hasRequiredFlag) {\n    runNonInteractive(opts);\n  } else {\n    const hasOptionalOnly = OPTIONAL_FLAGS.some(\n      (f) => opts[f] !== undefined && opts[f] !== false,\n    );\n    if (hasOptionalOnly) {\n      console.error(\n        `Error: Non-interactive mode requires: ${REQUIRED_FLAGS.map((f) => `--${f}`).join(\", \")}`,\n      );\n      console.error(\n        '  appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\"',\n      );\n      process.exit(1);\n    }\n    await runInteractive();\n  }\n}\n\nexport const pluginCreateCommand = new Command(\"create\")\n  .description(\"Scaffold a new AppKit plugin\")\n  .option(\"--placement <type>\", \"Where the plugin lives (in-repo, isolated)\")\n  .option(\"--path <dir>\", \"Target directory for the plugin\")\n  .option(\"--name <id>\", \"Plugin name (lowercase, hyphens allowed)\")\n  .option(\"--display-name <name>\", \"Human-readable display name\")\n  .option(\"--description <text>\", \"Short description of the plugin\")\n  .addOption(\n    new Option(\n      \"--resources <types>\",\n      \"Comma-separated resource types (e.g. sql_warehouse,volume)\",\n    ).conflicts(\"resourcesJson\"),\n  )\n  .addOption(\n    new Option(\n      \"--resources-json <json>\",\n      'JSON array of resource specs (e.g. \\'[{\"type\":\"sql_warehouse\"}]\\')',\n    ).conflicts(\"resources\"),\n  )\n  .option(\"-f, --force\", \"Overwrite existing directory without confirmation\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin create\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\"\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\" --resources sql_warehouse,volume --force\n  $ appkit plugin create --placement isolated --path appkit-plugin-ml --name ml --description \"ML\" --resources-json '[{\"type\":\"serving_endpoint\"}]'`,\n  )\n  .action((opts) =>\n    runPluginCreate(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n\n/** Exported for testing. */\nexport { buildResourceFromType, parseResourcesJson, parseResourcesShorthand };\n"],"mappings":"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"}

package/dist/cli/commands/plugin/create/resource-defaults.js

@@ -81,6 +81,10 @@ const DEFAULT_FIELDS_BY_TYPE = {
 		description: "Databricks App ID"
 	} }
 };
+/** Valid resource type values from the schema. */
+function getValidResourceTypes() {
+	return RESOURCE_TYPE_OPTIONS.map((o) => o.value);
+}
 /** Humanized alias from resource type (e.g. sql_warehouse -> "SQL Warehouse"). */
 function humanizeResourceType(type) {
 	const option = RESOURCE_TYPE_OPTIONS.find((o) => o.value === type);
@@ -101,5 +105,5 @@ function getDefaultFieldsForType(type) {
 }
 
 //#endregion
-export { MANIFEST_SCHEMA_ID, PERMISSIONS_BY_TYPE, RESOURCE_TYPE_OPTIONS, getDefaultFieldsForType, humanizeResourceType, resourceKeyFromType };
+export { DEFAULT_PERMISSION_BY_TYPE, MANIFEST_SCHEMA_ID, PERMISSIONS_BY_TYPE, RESOURCE_TYPE_OPTIONS, getDefaultFieldsForType, getValidResourceTypes, humanizeResourceType, resourceKeyFromType };
 //# sourceMappingURL=resource-defaults.js.map

package/dist/cli/commands/plugin/create/resource-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-defaults.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/resource-defaults.ts"],"sourcesContent":["/**\n * Resource type and permission defaults for plugin scaffolding.\n * Values are derived from plugin-manifest.schema.json via schema-resources.\n */\n\nimport {\n  getResourceTypeOptions,\n  getResourceTypePermissions,\n  type ResourceTypeOption,\n} from \"../schema-resources\";\n\nexport const MANIFEST_SCHEMA_ID =\n  \"https://databricks.github.io/appkit/schemas/plugin-manifest.schema.json\";\n\nexport type { ResourceTypeOption };\n\n/** Resource types from schema resourceType enum (value, human label). */\nexport const RESOURCE_TYPE_OPTIONS: ResourceTypeOption[] =\n  getResourceTypeOptions();\n\n/** All valid permissions per resource type, from schema allOf/if-then rules. */\nexport const PERMISSIONS_BY_TYPE: Record<string, string[]> =\n  getResourceTypePermissions();\n\n/** Default (first) permission per resource type for scaffolding. */\nexport const DEFAULT_PERMISSION_BY_TYPE: Record<string, string> =\n  Object.fromEntries(\n    Object.entries(PERMISSIONS_BY_TYPE).map(([type, perms]) => [\n      type,\n      perms[0],\n    ]),\n  );\n\n/** Default fields per resource type: field key -> { env, description }. */\nexport const DEFAULT_FIELDS_BY_TYPE: Record<\n  string,\n  Record<string, { env: string; description?: string }>\n> = {\n  sql_warehouse: {\n    id: { env: \"DATABRICKS_WAREHOUSE_ID\", description: \"SQL Warehouse ID\" },\n  },\n  secret: {\n    scope: { env: \"SECRET_SCOPE\", description: \"Secret scope name\" },\n    key: { env: \"SECRET_KEY\", description: \"Secret key\" },\n  },\n  job: {\n    id: { env: \"DATABRICKS_JOB_ID\", description: \"Job ID\" },\n  },\n  serving_endpoint: {\n    id: {\n      env: \"DATABRICKS_SERVING_ENDPOINT_ID\",\n      description: \"Serving endpoint ID\",\n    },\n  },\n  volume: {\n    name: { env: \"VOLUME_NAME\", description: \"Volume name\" },\n  },\n  vector_search_index: {\n    endpoint_name: {\n      env: \"VECTOR_SEARCH_ENDPOINT_NAME\",\n      description: \"Vector search endpoint name\",\n    },\n    index_name: {\n      env: \"VECTOR_SEARCH_INDEX_NAME\",\n      description: \"Vector search index name\",\n    },\n  },\n  uc_function: {\n    name: {\n      env: \"UC_FUNCTION_NAME\",\n      description: \"Unity Catalog function name\",\n    },\n  },\n  uc_connection: {\n    name: {\n      env: \"UC_CONNECTION_NAME\",\n      description: \"Unity Catalog connection name\",\n    },\n  },\n  database: {\n    instance_name: {\n      env: \"DATABRICKS_INSTANCE_NAME\",\n      description: \"Databricks instance name\",\n    },\n    database_name: {\n      env: \"DATABASE_NAME\",\n      description: \"Database name\",\n    },\n  },\n  genie_space: {\n    id: { env: \"GENIE_SPACE_ID\", description: \"Genie Space ID\" },\n  },\n  experiment: {\n    id: { env: \"MLFLOW_EXPERIMENT_ID\", description: \"MLflow experiment ID\" },\n  },\n  app: {\n    id: { env: \"DATABRICKS_APP_ID\", description: \"Databricks App ID\" },\n  },\n};\n\n/** Humanized alias from resource type (e.g. sql_warehouse -> \"SQL Warehouse\"). */\nexport function humanizeResourceType(type: string): string {\n  const option = RESOURCE_TYPE_OPTIONS.find((o) => o.value === type);\n  return option ? option.label : type.replace(/_/g, \" \");\n}\n\n/** Kebab-case resource key from type (e.g. sql_warehouse -> \"sql-warehouse\"). */\nexport function resourceKeyFromType(type: string): string {\n  return type.replace(/_/g, \"-\");\n}\n\n/** Get default fields for a resource type; fallback to single id field. */\nexport function getDefaultFieldsForType(\n  type: string,\n): Record<string, { env: string; description?: string }> {\n  const known = DEFAULT_FIELDS_BY_TYPE[type];\n  if (known) return known;\n  const key = resourceKeyFromType(type);\n  const envName = `DATABRICKS_${key.toUpperCase().replace(/-/g, \"_\")}_ID`;\n  return {\n    id: { env: envName, description: `${humanizeResourceType(type)} ID` },\n  };\n}\n"],"mappings":";;;;;;;AAWA,MAAa,qBACX;;AAKF,MAAa,wBACX,wBAAwB;;AAG1B,MAAa,sBACX,4BAA4B;;AAG9B,MAAa,6BACX,OAAO,YACL,OAAO,QAAQ,oBAAoB,CAAC,KAAK,CAAC,MAAM,WAAW,CACzD,MACA,MAAM,GACP,CAAC,CACH;;AAGH,MAAa,yBAGT;CACF,eAAe,EACb,IAAI;EAAE,KAAK;EAA2B,aAAa;EAAoB,EACxE;CACD,QAAQ;EACN,OAAO;GAAE,KAAK;GAAgB,aAAa;GAAqB;EAChE,KAAK;GAAE,KAAK;GAAc,aAAa;GAAc;EACtD;CACD,KAAK,EACH,IAAI;EAAE,KAAK;EAAqB,aAAa;EAAU,EACxD;CACD,kBAAkB,EAChB,IAAI;EACF,KAAK;EACL,aAAa;EACd,EACF;CACD,QAAQ,EACN,MAAM;EAAE,KAAK;EAAe,aAAa;EAAe,EACzD;CACD,qBAAqB;EACnB,eAAe;GACb,KAAK;GACL,aAAa;GACd;EACD,YAAY;GACV,KAAK;GACL,aAAa;GACd;EACF;CACD,aAAa,EACX,MAAM;EACJ,KAAK;EACL,aAAa;EACd,EACF;CACD,eAAe,EACb,MAAM;EACJ,KAAK;EACL,aAAa;EACd,EACF;CACD,UAAU;EACR,eAAe;GACb,KAAK;GACL,aAAa;GACd;EACD,eAAe;GACb,KAAK;GACL,aAAa;GACd;EACF;CACD,aAAa,EACX,IAAI;EAAE,KAAK;EAAkB,aAAa;EAAkB,EAC7D;CACD,YAAY,EACV,IAAI;EAAE,KAAK;EAAwB,aAAa;EAAwB,EACzE;CACD,KAAK,EACH,IAAI;EAAE,KAAK;EAAqB,aAAa;EAAqB,EACnE;CACF;;AAGD,SAAgB,qBAAqB,MAAsB;CACzD,MAAM,SAAS,sBAAsB,MAAM,MAAM,EAAE,UAAU,KAAK;AAClE,QAAO,SAAS,OAAO,QAAQ,KAAK,QAAQ,MAAM,IAAI;;;AAIxD,SAAgB,oBAAoB,MAAsB;AACxD,QAAO,KAAK,QAAQ,MAAM,IAAI;;;AAIhC,SAAgB,wBACd,MACuD;CACvD,MAAM,QAAQ,uBAAuB;AACrC,KAAI,MAAO,QAAO;AAGlB,QAAO,EACL,IAAI;EAAE,KAFQ,cADJ,oBAAoB,KAAK,CACH,aAAa,CAAC,QAAQ,MAAM,IAAI,CAAC;EAE7C,aAAa,GAAG,qBAAqB,KAAK,CAAC;EAAM,EACtE"}
+{"version":3,"file":"resource-defaults.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/resource-defaults.ts"],"sourcesContent":["/**\n * Resource type and permission defaults for plugin scaffolding.\n * Values are derived from plugin-manifest.schema.json via schema-resources.\n */\n\nimport {\n  getResourceTypeOptions,\n  getResourceTypePermissions,\n  type ResourceTypeOption,\n} from \"../schema-resources\";\n\nexport const MANIFEST_SCHEMA_ID =\n  \"https://databricks.github.io/appkit/schemas/plugin-manifest.schema.json\";\n\nexport type { ResourceTypeOption };\n\n/** Resource types from schema resourceType enum (value, human label). */\nexport const RESOURCE_TYPE_OPTIONS: ResourceTypeOption[] =\n  getResourceTypeOptions();\n\n/** All valid permissions per resource type, from schema allOf/if-then rules. */\nexport const PERMISSIONS_BY_TYPE: Record<string, string[]> =\n  getResourceTypePermissions();\n\n/** Default (first) permission per resource type for scaffolding. */\nexport const DEFAULT_PERMISSION_BY_TYPE: Record<string, string> =\n  Object.fromEntries(\n    Object.entries(PERMISSIONS_BY_TYPE).map(([type, perms]) => [\n      type,\n      perms[0],\n    ]),\n  );\n\n/** Default fields per resource type: field key -> { env, description }. */\nexport const DEFAULT_FIELDS_BY_TYPE: Record<\n  string,\n  Record<string, { env: string; description?: string }>\n> = {\n  sql_warehouse: {\n    id: { env: \"DATABRICKS_WAREHOUSE_ID\", description: \"SQL Warehouse ID\" },\n  },\n  secret: {\n    scope: { env: \"SECRET_SCOPE\", description: \"Secret scope name\" },\n    key: { env: \"SECRET_KEY\", description: \"Secret key\" },\n  },\n  job: {\n    id: { env: \"DATABRICKS_JOB_ID\", description: \"Job ID\" },\n  },\n  serving_endpoint: {\n    id: {\n      env: \"DATABRICKS_SERVING_ENDPOINT_ID\",\n      description: \"Serving endpoint ID\",\n    },\n  },\n  volume: {\n    name: { env: \"VOLUME_NAME\", description: \"Volume name\" },\n  },\n  vector_search_index: {\n    endpoint_name: {\n      env: \"VECTOR_SEARCH_ENDPOINT_NAME\",\n      description: \"Vector search endpoint name\",\n    },\n    index_name: {\n      env: \"VECTOR_SEARCH_INDEX_NAME\",\n      description: \"Vector search index name\",\n    },\n  },\n  uc_function: {\n    name: {\n      env: \"UC_FUNCTION_NAME\",\n      description: \"Unity Catalog function name\",\n    },\n  },\n  uc_connection: {\n    name: {\n      env: \"UC_CONNECTION_NAME\",\n      description: \"Unity Catalog connection name\",\n    },\n  },\n  database: {\n    instance_name: {\n      env: \"DATABRICKS_INSTANCE_NAME\",\n      description: \"Databricks instance name\",\n    },\n    database_name: {\n      env: \"DATABASE_NAME\",\n      description: \"Database name\",\n    },\n  },\n  genie_space: {\n    id: { env: \"GENIE_SPACE_ID\", description: \"Genie Space ID\" },\n  },\n  experiment: {\n    id: { env: \"MLFLOW_EXPERIMENT_ID\", description: \"MLflow experiment ID\" },\n  },\n  app: {\n    id: { env: \"DATABRICKS_APP_ID\", description: \"Databricks App ID\" },\n  },\n};\n\n/** Valid resource type values from the schema. */\nexport function getValidResourceTypes(): string[] {\n  return RESOURCE_TYPE_OPTIONS.map((o) => o.value);\n}\n\n/** Humanized alias from resource type (e.g. sql_warehouse -> \"SQL Warehouse\"). */\nexport function humanizeResourceType(type: string): string {\n  const option = RESOURCE_TYPE_OPTIONS.find((o) => o.value === type);\n  return option ? option.label : type.replace(/_/g, \" \");\n}\n\n/** Kebab-case resource key from type (e.g. sql_warehouse -> \"sql-warehouse\"). */\nexport function resourceKeyFromType(type: string): string {\n  return type.replace(/_/g, \"-\");\n}\n\n/** Get default fields for a resource type; fallback to single id field. */\nexport function getDefaultFieldsForType(\n  type: string,\n): Record<string, { env: string; description?: string }> {\n  const known = DEFAULT_FIELDS_BY_TYPE[type];\n  if (known) return known;\n  const key = resourceKeyFromType(type);\n  const envName = `DATABRICKS_${key.toUpperCase().replace(/-/g, \"_\")}_ID`;\n  return {\n    id: { env: envName, description: `${humanizeResourceType(type)} ID` },\n  };\n}\n"],"mappings":";;;;;;;AAWA,MAAa,qBACX;;AAKF,MAAa,wBACX,wBAAwB;;AAG1B,MAAa,sBACX,4BAA4B;;AAG9B,MAAa,6BACX,OAAO,YACL,OAAO,QAAQ,oBAAoB,CAAC,KAAK,CAAC,MAAM,WAAW,CACzD,MACA,MAAM,GACP,CAAC,CACH;;AAGH,MAAa,yBAGT;CACF,eAAe,EACb,IAAI;EAAE,KAAK;EAA2B,aAAa;EAAoB,EACxE;CACD,QAAQ;EACN,OAAO;GAAE,KAAK;GAAgB,aAAa;GAAqB;EAChE,KAAK;GAAE,KAAK;GAAc,aAAa;GAAc;EACtD;CACD,KAAK,EACH,IAAI;EAAE,KAAK;EAAqB,aAAa;EAAU,EACxD;CACD,kBAAkB,EAChB,IAAI;EACF,KAAK;EACL,aAAa;EACd,EACF;CACD,QAAQ,EACN,MAAM;EAAE,KAAK;EAAe,aAAa;EAAe,EACzD;CACD,qBAAqB;EACnB,eAAe;GACb,KAAK;GACL,aAAa;GACd;EACD,YAAY;GACV,KAAK;GACL,aAAa;GACd;EACF;CACD,aAAa,EACX,MAAM;EACJ,KAAK;EACL,aAAa;EACd,EACF;CACD,eAAe,EACb,MAAM;EACJ,KAAK;EACL,aAAa;EACd,EACF;CACD,UAAU;EACR,eAAe;GACb,KAAK;GACL,aAAa;GACd;EACD,eAAe;GACb,KAAK;GACL,aAAa;GACd;EACF;CACD,aAAa,EACX,IAAI;EAAE,KAAK;EAAkB,aAAa;EAAkB,EAC7D;CACD,YAAY,EACV,IAAI;EAAE,KAAK;EAAwB,aAAa;EAAwB,EACzE;CACD,KAAK,EACH,IAAI;EAAE,KAAK;EAAqB,aAAa;EAAqB,EACnE;CACF;;AAGD,SAAgB,wBAAkC;AAChD,QAAO,sBAAsB,KAAK,MAAM,EAAE,MAAM;;;AAIlD,SAAgB,qBAAqB,MAAsB;CACzD,MAAM,SAAS,sBAAsB,MAAM,MAAM,EAAE,UAAU,KAAK;AAClE,QAAO,SAAS,OAAO,QAAQ,KAAK,QAAQ,MAAM,IAAI;;;AAIxD,SAAgB,oBAAoB,MAAsB;AACxD,QAAO,KAAK,QAAQ,MAAM,IAAI;;;AAIhC,SAAgB,wBACd,MACuD;CACvD,MAAM,QAAQ,uBAAuB;AACrC,KAAI,MAAO,QAAO;AAGlB,QAAO,EACL,IAAI;EAAE,KAFQ,cADJ,oBAAoB,KAAK,CACH,aAAa,CAAC,QAAQ,MAAM,IAAI,CAAC;EAE7C,aAAa,GAAG,qBAAqB,KAAK,CAAC;EAAM,EACtE"}

package/dist/cli/commands/plugin/index.js

@@ -15,7 +15,13 @@ import { Command } from "commander";
 *   - list: List plugins from appkit.plugins.json or a directory
 *   - add-resource: Add a resource requirement to a plugin manifest (interactive)
 */
-const pluginCommand = new Command("plugin").description("Plugin management commands").addCommand(pluginsSyncCommand).addCommand(pluginCreateCommand).addCommand(pluginValidateCommand).addCommand(pluginListCommand).addCommand(pluginAddResourceCommand);
+const pluginCommand = new Command("plugin").description("Plugin management commands").addCommand(pluginsSyncCommand).addCommand(pluginCreateCommand).addCommand(pluginValidateCommand).addCommand(pluginListCommand).addCommand(pluginAddResourceCommand).addHelpText("after", `
+Examples:
+  $ appkit plugin sync --write
+  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description "Does X"
+  $ appkit plugin validate .
+  $ appkit plugin list --json
+  $ appkit plugin add-resource --path plugins/my-plugin --type sql_warehouse`);
 
 //#endregion
 export { pluginCommand };

package/dist/cli/commands/plugin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/cli/commands/plugin/index.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { pluginAddResourceCommand } from \"./add-resource/add-resource\";\nimport { pluginCreateCommand } from \"./create/create\";\nimport { pluginListCommand } from \"./list/list\";\nimport { pluginsSyncCommand } from \"./sync/sync\";\nimport { pluginValidateCommand } from \"./validate/validate\";\n\n/**\n * Parent command for plugin management operations.\n * Subcommands:\n *   - sync: Aggregate plugin manifests into appkit.plugins.json\n *   - create: Scaffold a new plugin (interactive)\n *   - validate: Validate manifest(s) against the JSON schema\n *   - list: List plugins from appkit.plugins.json or a directory\n *   - add-resource: Add a resource requirement to a plugin manifest (interactive)\n */\nexport const pluginCommand = new Command(\"plugin\")\n  .description(\"Plugin management commands\")\n  .addCommand(pluginsSyncCommand)\n  .addCommand(pluginCreateCommand)\n  .addCommand(pluginValidateCommand)\n  .addCommand(pluginListCommand)\n  .addCommand(pluginAddResourceCommand);\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,MAAa,gBAAgB,IAAI,QAAQ,SAAS,CAC/C,YAAY,6BAA6B,CACzC,WAAW,mBAAmB,CAC9B,WAAW,oBAAoB,CAC/B,WAAW,sBAAsB,CACjC,WAAW,kBAAkB,CAC7B,WAAW,yBAAyB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/cli/commands/plugin/index.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { pluginAddResourceCommand } from \"./add-resource/add-resource\";\nimport { pluginCreateCommand } from \"./create/create\";\nimport { pluginListCommand } from \"./list/list\";\nimport { pluginsSyncCommand } from \"./sync/sync\";\nimport { pluginValidateCommand } from \"./validate/validate\";\n\n/**\n * Parent command for plugin management operations.\n * Subcommands:\n *   - sync: Aggregate plugin manifests into appkit.plugins.json\n *   - create: Scaffold a new plugin (interactive)\n *   - validate: Validate manifest(s) against the JSON schema\n *   - list: List plugins from appkit.plugins.json or a directory\n *   - add-resource: Add a resource requirement to a plugin manifest (interactive)\n */\nexport const pluginCommand = new Command(\"plugin\")\n  .description(\"Plugin management commands\")\n  .addCommand(pluginsSyncCommand)\n  .addCommand(pluginCreateCommand)\n  .addCommand(pluginValidateCommand)\n  .addCommand(pluginListCommand)\n  .addCommand(pluginAddResourceCommand)\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin sync --write\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\"\n  $ appkit plugin validate .\n  $ appkit plugin list --json\n  $ appkit plugin add-resource --path plugins/my-plugin --type sql_warehouse`,\n  );\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,MAAa,gBAAgB,IAAI,QAAQ,SAAS,CAC/C,YAAY,6BAA6B,CACzC,WAAW,mBAAmB,CAC9B,WAAW,oBAAoB,CAC/B,WAAW,sBAAsB,CACjC,WAAW,kBAAkB,CAC7B,WAAW,yBAAyB,CACpC,YACC,SACA;;;;;;8EAOD"}

package/dist/cli/commands/plugin/list/list.js

@@ -109,6 +109,7 @@ async function runPluginList(options) {
 		const manifestPath = path.resolve(cwd, options.manifest ?? "appkit.plugins.json");
 		if (!fs.existsSync(manifestPath)) {
 			console.error(`Manifest not found: ${manifestPath}`);
+			console.error("  appkit plugin list --manifest <path-to-manifest> or appkit plugin list --dir <plugins-directory>");
 			process.exit(1);
 		}
 		try {
@@ -121,7 +122,12 @@ async function runPluginList(options) {
 	if (options.json) console.log(JSON.stringify(rows, null, 2));
 	else printTable(rows);
 }
-const pluginListCommand = new Command("list").description("List plugins from appkit.plugins.json or a directory").option("-m, --manifest <path>", "Path to appkit.plugins.json", "appkit.plugins.json").option("-d, --dir <path>", "Scan directory recursively for plugin folders (manifest.json by default)").option("--allow-js-manifest", "Allow reading manifest.js/manifest.cjs (executes code; use only with trusted plugins)").option("--json", "Output as JSON").action((opts) => runPluginList(opts).catch((err) => {
+const pluginListCommand = new Command("list").description("List plugins from appkit.plugins.json or a directory").option("-m, --manifest <path>", "Path to appkit.plugins.json", "appkit.plugins.json").option("-d, --dir <path>", "Scan directory recursively for plugin folders (manifest.json by default)").option("--allow-js-manifest", "Allow reading manifest.js/manifest.cjs (executes code; use only with trusted plugins)").option("--json", "Output as JSON").addHelpText("after", `
+Examples:
+  $ appkit plugin list
+  $ appkit plugin list --json
+  $ appkit plugin list --manifest custom-manifest.json
+  $ appkit plugin list --dir plugins/`).action((opts) => runPluginList(opts).catch((err) => {
 	console.error(err);
 	process.exit(1);
 }));

package/dist/cli/commands/plugin/list/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","names":[],"sources":["../../../../../src/cli/commands/plugin/list/list.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { Command } from \"commander\";\nimport {\n  loadManifestFromFile,\n  resolveManifestInDir,\n} from \"../manifest-resolve\";\nimport { shouldAllowJsManifestForDir } from \"../trusted-js-manifest\";\nimport { validateManifest } from \"../validate/validate-manifest\";\n\n/** Safety limit for recursive directory scanning to prevent runaway traversal. */\nconst MAX_SCAN_DEPTH = 5;\n\nexport interface PluginRow {\n  name: string;\n  displayName: string;\n  package: string;\n  required: number;\n  optional: number;\n}\n\nexport function listFromManifestFile(manifestPath: string): PluginRow[] {\n  let raw: string;\n  try {\n    raw = fs.readFileSync(manifestPath, \"utf-8\");\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to read manifest file ${manifestPath}: ${msg}`);\n  }\n\n  let data: {\n    plugins?: Record<\n      string,\n      {\n        name: string;\n        displayName: string;\n        package: string;\n        resources: { required: unknown[]; optional: unknown[] };\n      }\n    >;\n  };\n  try {\n    data = JSON.parse(raw) as typeof data;\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to parse manifest file ${manifestPath}: ${msg}`);\n  }\n\n  const plugins = data.plugins ?? {};\n  return Object.values(plugins).map((p) => ({\n    name: p.name,\n    displayName: p.displayName ?? p.name,\n    package: p.package ?? \"\",\n    required: Array.isArray(p.resources?.required)\n      ? p.resources.required.length\n      : 0,\n    optional: Array.isArray(p.resources?.optional)\n      ? p.resources.optional.length\n      : 0,\n  }));\n}\n\nasync function collectPluginsRecursive(\n  dir: string,\n  cwd: string,\n  rows: PluginRow[],\n  allowJsManifest: boolean,\n  depth = 0,\n): Promise<void> {\n  if (\n    !fs.existsSync(dir) ||\n    !fs.statSync(dir).isDirectory() ||\n    depth >= MAX_SCAN_DEPTH\n  )\n    return;\n\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n\n    const childPath = path.join(dir, entry.name);\n    const allowJsForChild =\n      allowJsManifest || shouldAllowJsManifestForDir(childPath);\n    const resolvedManifest = resolveManifestInDir(childPath, {\n      allowJsManifest: allowJsForChild,\n    });\n\n    if (resolvedManifest) {\n      try {\n        const obj = await loadManifestFromFile(\n          resolvedManifest.path,\n          resolvedManifest.type,\n          { allowJsManifest: allowJsForChild },\n        );\n        const result = validateManifest(obj);\n        const manifest = result.valid ? result.manifest : null;\n        if (manifest) {\n          const relPath = path.relative(\n            cwd,\n            path.dirname(resolvedManifest.path),\n          );\n          const packagePath = relPath.startsWith(\".\")\n            ? relPath\n            : `./${relPath}`;\n          rows.push({\n            name: manifest.name,\n            displayName: manifest.displayName ?? manifest.name,\n            package: packagePath,\n            required: Array.isArray(manifest.resources?.required)\n              ? manifest.resources.required.length\n              : 0,\n            optional: Array.isArray(manifest.resources?.optional)\n              ? manifest.resources.optional.length\n              : 0,\n          });\n        }\n      } catch {\n        // skip invalid manifests\n      }\n      continue;\n    }\n\n    await collectPluginsRecursive(\n      childPath,\n      cwd,\n      rows,\n      allowJsManifest,\n      depth + 1,\n    );\n  }\n}\n\nexport async function listFromDirectory(\n  dirPath: string,\n  cwd: string,\n  allowJsManifest = false,\n): Promise<PluginRow[]> {\n  const resolved = path.resolve(cwd, dirPath);\n  if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {\n    return [];\n  }\n  const rows: PluginRow[] = [];\n  await collectPluginsRecursive(resolved, cwd, rows, allowJsManifest);\n  return rows;\n}\n\nfunction printTable(rows: PluginRow[]): void {\n  if (rows.length === 0) {\n    console.log(\"No plugins found.\");\n    return;\n  }\n  const maxName = Math.max(4, ...rows.map((r) => r.name.length));\n  const maxDisplay = Math.max(10, ...rows.map((r) => r.displayName.length));\n  const maxPkg = Math.max(7, ...rows.map((r) => r.package.length));\n  const header = [\n    \"NAME\".padEnd(maxName),\n    \"DISPLAY NAME\".padEnd(maxDisplay),\n    \"PACKAGE / PATH\".padEnd(maxPkg),\n    \"REQ\",\n    \"OPT\",\n  ].join(\"  \");\n  console.log(header);\n  console.log(\"-\".repeat(header.length));\n  for (const r of rows) {\n    console.log(\n      [\n        r.name.padEnd(maxName),\n        r.displayName.padEnd(maxDisplay),\n        r.package.padEnd(maxPkg),\n        String(r.required).padStart(3),\n        String(r.optional).padStart(3),\n      ].join(\"  \"),\n    );\n  }\n}\n\nasync function runPluginList(options: {\n  manifest?: string;\n  dir?: string;\n  json?: boolean;\n  allowJsManifest?: boolean;\n}): Promise<void> {\n  const cwd = process.cwd();\n  const allowJsManifest = Boolean(options.allowJsManifest);\n  if (allowJsManifest) {\n    console.warn(\n      \"Warning: --allow-js-manifest executes manifest.js/manifest.cjs files. Only use with trusted code.\",\n    );\n  }\n  let rows: PluginRow[];\n\n  if (options.dir !== undefined) {\n    rows = await listFromDirectory(options.dir, cwd, allowJsManifest);\n    if (rows.length === 0 && options.dir) {\n      console.error(\n        `No plugin directories with ${allowJsManifest ? \"manifest.json or manifest.js\" : \"manifest.json\"} found in ${options.dir}`,\n      );\n      process.exit(1);\n    }\n  } else {\n    const manifestPath = path.resolve(\n      cwd,\n      options.manifest ?? \"appkit.plugins.json\",\n    );\n    if (!fs.existsSync(manifestPath)) {\n      console.error(`Manifest not found: ${manifestPath}`);\n      process.exit(1);\n    }\n    try {\n      rows = listFromManifestFile(manifestPath);\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  }\n\n  if (options.json) {\n    console.log(JSON.stringify(rows, null, 2));\n  } else {\n    printTable(rows);\n  }\n}\n\nexport const pluginListCommand = new Command(\"list\")\n  .description(\"List plugins from appkit.plugins.json or a directory\")\n  .option(\n    \"-m, --manifest <path>\",\n    \"Path to appkit.plugins.json\",\n    \"appkit.plugins.json\",\n  )\n  .option(\n    \"-d, --dir <path>\",\n    \"Scan directory recursively for plugin folders (manifest.json by default)\",\n  )\n  .option(\n    \"--allow-js-manifest\",\n    \"Allow reading manifest.js/manifest.cjs (executes code; use only with trusted plugins)\",\n  )\n  .option(\"--json\", \"Output as JSON\")\n  .action((opts) =>\n    runPluginList(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n"],"mappings":"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"}
+{"version":3,"file":"list.js","names":[],"sources":["../../../../../src/cli/commands/plugin/list/list.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { Command } from \"commander\";\nimport {\n  loadManifestFromFile,\n  resolveManifestInDir,\n} from \"../manifest-resolve\";\nimport { shouldAllowJsManifestForDir } from \"../trusted-js-manifest\";\nimport { validateManifest } from \"../validate/validate-manifest\";\n\n/** Safety limit for recursive directory scanning to prevent runaway traversal. */\nconst MAX_SCAN_DEPTH = 5;\n\nexport interface PluginRow {\n  name: string;\n  displayName: string;\n  package: string;\n  required: number;\n  optional: number;\n}\n\nexport function listFromManifestFile(manifestPath: string): PluginRow[] {\n  let raw: string;\n  try {\n    raw = fs.readFileSync(manifestPath, \"utf-8\");\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to read manifest file ${manifestPath}: ${msg}`);\n  }\n\n  let data: {\n    plugins?: Record<\n      string,\n      {\n        name: string;\n        displayName: string;\n        package: string;\n        resources: { required: unknown[]; optional: unknown[] };\n      }\n    >;\n  };\n  try {\n    data = JSON.parse(raw) as typeof data;\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to parse manifest file ${manifestPath}: ${msg}`);\n  }\n\n  const plugins = data.plugins ?? {};\n  return Object.values(plugins).map((p) => ({\n    name: p.name,\n    displayName: p.displayName ?? p.name,\n    package: p.package ?? \"\",\n    required: Array.isArray(p.resources?.required)\n      ? p.resources.required.length\n      : 0,\n    optional: Array.isArray(p.resources?.optional)\n      ? p.resources.optional.length\n      : 0,\n  }));\n}\n\nasync function collectPluginsRecursive(\n  dir: string,\n  cwd: string,\n  rows: PluginRow[],\n  allowJsManifest: boolean,\n  depth = 0,\n): Promise<void> {\n  if (\n    !fs.existsSync(dir) ||\n    !fs.statSync(dir).isDirectory() ||\n    depth >= MAX_SCAN_DEPTH\n  )\n    return;\n\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n\n    const childPath = path.join(dir, entry.name);\n    const allowJsForChild =\n      allowJsManifest || shouldAllowJsManifestForDir(childPath);\n    const resolvedManifest = resolveManifestInDir(childPath, {\n      allowJsManifest: allowJsForChild,\n    });\n\n    if (resolvedManifest) {\n      try {\n        const obj = await loadManifestFromFile(\n          resolvedManifest.path,\n          resolvedManifest.type,\n          { allowJsManifest: allowJsForChild },\n        );\n        const result = validateManifest(obj);\n        const manifest = result.valid ? result.manifest : null;\n        if (manifest) {\n          const relPath = path.relative(\n            cwd,\n            path.dirname(resolvedManifest.path),\n          );\n          const packagePath = relPath.startsWith(\".\")\n            ? relPath\n            : `./${relPath}`;\n          rows.push({\n            name: manifest.name,\n            displayName: manifest.displayName ?? manifest.name,\n            package: packagePath,\n            required: Array.isArray(manifest.resources?.required)\n              ? manifest.resources.required.length\n              : 0,\n            optional: Array.isArray(manifest.resources?.optional)\n              ? manifest.resources.optional.length\n              : 0,\n          });\n        }\n      } catch {\n        // skip invalid manifests\n      }\n      continue;\n    }\n\n    await collectPluginsRecursive(\n      childPath,\n      cwd,\n      rows,\n      allowJsManifest,\n      depth + 1,\n    );\n  }\n}\n\nexport async function listFromDirectory(\n  dirPath: string,\n  cwd: string,\n  allowJsManifest = false,\n): Promise<PluginRow[]> {\n  const resolved = path.resolve(cwd, dirPath);\n  if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {\n    return [];\n  }\n  const rows: PluginRow[] = [];\n  await collectPluginsRecursive(resolved, cwd, rows, allowJsManifest);\n  return rows;\n}\n\nfunction printTable(rows: PluginRow[]): void {\n  if (rows.length === 0) {\n    console.log(\"No plugins found.\");\n    return;\n  }\n  const maxName = Math.max(4, ...rows.map((r) => r.name.length));\n  const maxDisplay = Math.max(10, ...rows.map((r) => r.displayName.length));\n  const maxPkg = Math.max(7, ...rows.map((r) => r.package.length));\n  const header = [\n    \"NAME\".padEnd(maxName),\n    \"DISPLAY NAME\".padEnd(maxDisplay),\n    \"PACKAGE / PATH\".padEnd(maxPkg),\n    \"REQ\",\n    \"OPT\",\n  ].join(\"  \");\n  console.log(header);\n  console.log(\"-\".repeat(header.length));\n  for (const r of rows) {\n    console.log(\n      [\n        r.name.padEnd(maxName),\n        r.displayName.padEnd(maxDisplay),\n        r.package.padEnd(maxPkg),\n        String(r.required).padStart(3),\n        String(r.optional).padStart(3),\n      ].join(\"  \"),\n    );\n  }\n}\n\nasync function runPluginList(options: {\n  manifest?: string;\n  dir?: string;\n  json?: boolean;\n  allowJsManifest?: boolean;\n}): Promise<void> {\n  const cwd = process.cwd();\n  const allowJsManifest = Boolean(options.allowJsManifest);\n  if (allowJsManifest) {\n    console.warn(\n      \"Warning: --allow-js-manifest executes manifest.js/manifest.cjs files. Only use with trusted code.\",\n    );\n  }\n  let rows: PluginRow[];\n\n  if (options.dir !== undefined) {\n    rows = await listFromDirectory(options.dir, cwd, allowJsManifest);\n    if (rows.length === 0 && options.dir) {\n      console.error(\n        `No plugin directories with ${allowJsManifest ? \"manifest.json or manifest.js\" : \"manifest.json\"} found in ${options.dir}`,\n      );\n      process.exit(1);\n    }\n  } else {\n    const manifestPath = path.resolve(\n      cwd,\n      options.manifest ?? \"appkit.plugins.json\",\n    );\n    if (!fs.existsSync(manifestPath)) {\n      console.error(`Manifest not found: ${manifestPath}`);\n      console.error(\n        \"  appkit plugin list --manifest <path-to-manifest> or appkit plugin list --dir <plugins-directory>\",\n      );\n      process.exit(1);\n    }\n    try {\n      rows = listFromManifestFile(manifestPath);\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  }\n\n  if (options.json) {\n    console.log(JSON.stringify(rows, null, 2));\n  } else {\n    printTable(rows);\n  }\n}\n\nexport const pluginListCommand = new Command(\"list\")\n  .description(\"List plugins from appkit.plugins.json or a directory\")\n  .option(\n    \"-m, --manifest <path>\",\n    \"Path to appkit.plugins.json\",\n    \"appkit.plugins.json\",\n  )\n  .option(\n    \"-d, --dir <path>\",\n    \"Scan directory recursively for plugin folders (manifest.json by default)\",\n  )\n  .option(\n    \"--allow-js-manifest\",\n    \"Allow reading manifest.js/manifest.cjs (executes code; use only with trusted plugins)\",\n  )\n  .option(\"--json\", \"Output as JSON\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin list\n  $ appkit plugin list --json\n  $ appkit plugin list --manifest custom-manifest.json\n  $ appkit plugin list --dir plugins/`,\n  )\n  .action((opts) =>\n    runPluginList(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n"],"mappings":"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"}

package/dist/cli/commands/plugin/sync/sync.js

@@ -326,15 +326,17 @@ function writeManifest(outputPath, { plugins }, options) {
 		version: "1.0",
 		plugins
 	};
+	const serialized = JSON.stringify(templateManifest, null, 2);
+	if (options.json) console.log(serialized);
 	if (options.write) {
-		fs.writeFileSync(outputPath, `${JSON.stringify(templateManifest, null, 2)}\n`);
-		if (!options.silent) console.log(`\n✓ Wrote ${outputPath}`);
-	} else if (!options.silent) {
+		fs.writeFileSync(outputPath, `${serialized}\n`);
+		if (!options.silent && !options.json) console.log(`\n✓ Wrote ${outputPath}`);
+	} else if (!options.silent && !options.json) {
 		console.log("\nTo write the manifest, run:");
 		console.log("  npx appkit plugin sync --write\n");
 		console.log("Preview:");
 		console.log("─".repeat(60));
-		console.log(JSON.stringify(templateManifest, null, 2));
+		console.log(serialized);
 		console.log("─".repeat(60));
 	}
 }
@@ -352,7 +354,7 @@ async function runPluginsSync(options) {
 		console.error(`Error: Output path "${options.output}" resolves outside the project directory.`);
 		process.exit(1);
 	}
-	if (!options.silent) {
+	if (!options.silent && !options.json) {
 		console.log("Scanning for AppKit plugins...\n");
 		if (allowJsManifest) console.warn("Warning: --allow-js-manifest executes manifest.js/manifest.cjs files. Only use with trusted code.");
 	}
@@ -360,7 +362,7 @@ async function runPluginsSync(options) {
 	let serverImports = [];
 	let pluginUsages = /* @__PURE__ */ new Set();
 	if (serverFile) {
-		if (!options.silent) {
+		if (!options.silent && !options.json) {
 			const relativePath = path.relative(cwd, serverFile);
 			console.log(`Server entry file: ${relativePath}`);
 		}
@@ -368,14 +370,14 @@ async function runPluginsSync(options) {
 		const root = parse(serverFile.endsWith(".tsx") ? Lang.Tsx : Lang.TypeScript, content).root();
 		serverImports = parseImports(root);
 		pluginUsages = parsePluginUsages(root);
-	} else if (!options.silent) console.log("No server entry file found. Checked:", SERVER_FILE_CANDIDATES.join(", "));
+	} else if (!options.silent && !options.json) console.log("No server entry file found. Checked:", SERVER_FILE_CANDIDATES.join(", "));
 	const npmImports = serverImports.filter((i) => !i.source.startsWith(".") && !i.source.startsWith("/"));
 	const localImports = serverImports.filter((i) => i.source.startsWith(".") || i.source.startsWith("/"));
 	const plugins = {};
 	if (options.pluginsDir) {
 		const resolvedDir = path.resolve(cwd, options.pluginsDir);
 		const pkgName = options.packageName ?? "@databricks/appkit";
-		if (!options.silent) console.log(`Scanning plugins directory: ${options.pluginsDir}`);
+		if (!options.silent && !options.json) console.log(`Scanning plugins directory: ${options.pluginsDir}`);
 		Object.assign(plugins, await scanPluginsDir(resolvedDir, pkgName, allowJsManifest));
 	} else {
 		const npmPackages = new Set([...KNOWN_PLUGIN_PACKAGES, ...npmImports.map((i) => i.source)]);
@@ -389,19 +391,23 @@ async function runPluginsSync(options) {
 	for (const dir of localDirsToScan) {
 		const resolvedDir = path.resolve(cwd, dir);
 		if (!fs.existsSync(resolvedDir)) continue;
-		if (!options.silent) console.log(`Scanning local plugins directory: ${dir}`);
+		if (!options.silent && !options.json) console.log(`Scanning local plugins directory: ${dir}`);
 		const discovered = await scanPluginsDirRecursive(resolvedDir, cwd, allowJsManifest);
 		for (const [name, entry] of Object.entries(discovered)) if (!plugins[name]) plugins[name] = entry;
 	}
 	const pluginCount = Object.keys(plugins).length;
 	if (pluginCount === 0) {
-		if (options.silent) {
+		if (options.silent || options.json) {
 			writeManifest(outputPath, { plugins: {} }, options);
-			return;
+			if (options.silent) return;
+			process.exit(1);
 		}
 		console.log("No plugins found.");
 		if (options.pluginsDir) console.log(`\nNo manifest (${allowJsManifest ? "manifest.json or manifest.js" : "manifest.json"}) found in: ${options.pluginsDir}`);
-		else console.log("\nMake sure you have plugin packages installed.");
+		else {
+			console.log("\nMake sure you have plugin packages installed, or specify a directory:");
+			console.log("  appkit plugin sync --plugins-dir <path>");
+		}
 		process.exit(1);
 	}
 	const serverFileDir = serverFile ? path.dirname(serverFile) : cwd;
@@ -423,7 +429,7 @@ async function runPluginsSync(options) {
 		for (const name of explicitNames) if (plugins[name]) plugins[name].requiredByTemplate = true;
 		else if (!options.silent) console.warn(`Warning: --require-plugins referenced "${name}" but no such plugin was discovered`);
 	}
-	if (!options.silent) {
+	if (!options.silent && !options.json) {
 		console.log(`\nFound ${pluginCount} plugin(s):`);
 		for (const [name, manifest] of Object.entries(plugins)) {
 			const resourceCount = manifest.resources.required.length + manifest.resources.optional.length;
@@ -434,7 +440,14 @@ async function runPluginsSync(options) {
 	}
 	writeManifest(outputPath, { plugins }, options);
 }
-const pluginsSyncCommand = new Command("sync").description("Sync plugin manifests from installed packages into appkit.plugins.json").option("-w, --write", "Write the manifest file").option("-o, --output <path>", "Output file path (default: ./appkit.plugins.json)").option("-s, --silent", "Suppress output and never exit with error (for use in predev/prebuild hooks)").option("--require-plugins <names>", "Comma-separated plugin names to mark as requiredByTemplate (e.g. server,analytics)").option("--plugins-dir <path>", "Scan this directory for plugin subdirectories with manifest.json (instead of node_modules)").option("--package-name <name>", "Package name to assign to plugins found via --plugins-dir (default: @databricks/appkit)").option("--local-plugins-dir <path>", "Also scan this directory for local plugin manifests (default: plugins, server)").option("--allow-js-manifest", "Allow reading manifest.js/manifest.cjs (executes code; use only with trusted plugins)").action((opts) => runPluginsSync(opts).catch((err) => {
+const pluginsSyncCommand = new Command("sync").description("Sync plugin manifests from installed packages into appkit.plugins.json").option("-w, --write", "Write the manifest file").option("-o, --output <path>", "Output file path (default: ./appkit.plugins.json)").option("-s, --silent", "Suppress output and never exit with error (for use in predev/prebuild hooks)").option("--require-plugins <names>", "Comma-separated plugin names to mark as requiredByTemplate (e.g. server,analytics)").option("--plugins-dir <path>", "Scan this directory for plugin subdirectories with manifest.json (instead of node_modules)").option("--package-name <name>", "Package name to assign to plugins found via --plugins-dir (default: @databricks/appkit)").option("--local-plugins-dir <path>", "Also scan this directory for local plugin manifests (default: plugins, server)").option("--allow-js-manifest", "Allow reading manifest.js/manifest.cjs (executes code; use only with trusted plugins)").option("--json", "Output manifest as JSON to stdout").addHelpText("after", `
+Examples:
+  $ appkit plugin sync
+  $ appkit plugin sync --write
+  $ appkit plugin sync --write --require-plugins server,analytics
+  $ appkit plugin sync --write --plugins-dir src/plugins --package-name @my/pkg
+  $ appkit plugin sync --json
+  $ appkit plugin sync --silent`).action((opts) => runPluginsSync(opts).catch((err) => {
 	console.error(err);
 	process.exit(1);
 }));