feat: add plugin create command

chore: fixup

Author: MarioCadenas

CLAUDE.md

@@ -95,6 +95,17 @@ pnpm check:fix        # Auto-fix with Biome
 pnpm typecheck        # TypeScript type checking across all packages
 ```
 
+### AppKit CLI
+When using the published SDK or running from the monorepo (after `pnpm build`), the `appkit` CLI is available:
+
+```bash
+npx appkit plugin sync --write    # Sync plugin manifests into appkit.plugins.json
+npx appkit plugin create         # Scaffold a new plugin (interactive, uses @clack/prompts)
+npx appkit plugin validate      # Validate manifest(s) against the JSON schema
+npx appkit plugin list           # List plugins (from appkit.plugins.json or --dir)
+npx appkit plugin add-resource   # Add a resource requirement to a plugin (interactive)
+```
+
 ### Deployment
 ```bash
 pnpm pack:sdk                      # Package SDK for deployment

packages/shared/package.json

@@ -25,6 +25,7 @@
     "@types/dependency-tree": "^8.1.4",
     "@types/express": "^4.17.21",
     "@types/json-schema": "^7.0.15",
+    "@types/node": "^25.2.3",
     "@types/ws": "^8.18.1",
     "dependency-tree": "^11.2.0"
   },
@@ -42,6 +43,7 @@
     "@ast-grep/napi": "^0.37.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
+    "@clack/prompts": "^1.0.1",
     "commander": "^12.1.0"
   }
 }

packages/shared/src/cli/commands/plugin-add-resource.ts

@@ -0,0 +1,135 @@
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { cancel, intro, isCancel, outro, select, text } from "@clack/prompts";
+import { Command } from "commander";
+import {
+  DEFAULT_PERMISSION_BY_TYPE,
+  getDefaultFieldsForType,
+  humanizeResourceType,
+  RESOURCE_TYPE_OPTIONS,
+  resourceKeyFromType,
+} from "../plugin-create/resource-defaults.js";
+import { validateManifest } from "../plugin-validate/validate-manifest.js";
+
+interface ManifestWithResources {
+  $schema?: string;
+  name: string;
+  displayName: string;
+  description: string;
+  resources: {
+    required: unknown[];
+    optional: unknown[];
+  };
+  [key: string]: unknown;
+}
+
+async function runPluginAddResource(options: { path?: string }): Promise<void> {
+  intro("Add resource to plugin manifest");
+
+  const cwd = process.cwd();
+  const pluginDir = path.resolve(cwd, options.path ?? ".");
+  const manifestPath = path.join(pluginDir, "manifest.json");
+
+  if (!fs.existsSync(manifestPath)) {
+    console.error(`manifest.json not found at ${manifestPath}`);
+    process.exit(1);
+  }
+
+  let raw: string;
+  let manifest: ManifestWithResources;
+  try {
+    raw = fs.readFileSync(manifestPath, "utf-8");
+    const parsed = JSON.parse(raw) as unknown;
+    const result = validateManifest(parsed, manifestPath);
+    if (!result.valid || !result.manifest) {
+      console.error(
+        "Invalid manifest. Run `appkit plugin validate` for details.",
+      );
+      process.exit(1);
+    }
+    manifest = parsed as ManifestWithResources;
+  } catch (err) {
+    console.error(
+      "Failed to read or parse manifest.json:",
+      err instanceof Error ? err.message : err,
+    );
+    process.exit(1);
+  }
+
+  const resourceType = await select({
+    message: "Resource type",
+    options: RESOURCE_TYPE_OPTIONS.map((o) => ({
+      value: o.value,
+      label: o.label,
+    })),
+  });
+  if (isCancel(resourceType)) {
+    cancel("Cancelled.");
+    process.exit(0);
+  }
+
+  const required = await select<boolean>({
+    message: "Required or optional?",
+    options: [
+      { value: true, label: "Required", hint: "plugin needs it to function" },
+      { value: false, label: "Optional", hint: "enhances functionality" },
+    ],
+  });
+  if (isCancel(required)) {
+    cancel("Cancelled.");
+    process.exit(0);
+  }
+
+  const description = await text({
+    message: "Short description for this resource",
+    placeholder: required ? "Required for …" : "Optional for …",
+  });
+  if (isCancel(description)) {
+    cancel("Cancelled.");
+    process.exit(0);
+  }
+
+  const type = resourceType as string;
+  const permission = DEFAULT_PERMISSION_BY_TYPE[type] ?? "CAN_VIEW";
+  const fields = getDefaultFieldsForType(type);
+  const alias = humanizeResourceType(type);
+  const resourceKey = resourceKeyFromType(type);
+  const entry = {
+    type,
+    alias,
+    resourceKey,
+    description:
+      (description as string)?.trim() || `Required for ${alias} functionality.`,
+    permission,
+    fields,
+  };
+
+  if (required) {
+    manifest.resources.required.push(entry);
+  } else {
+    manifest.resources.optional.push(entry);
+  }
+
+  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+
+  outro("Resource added.");
+  console.log(
+    `\nAdded ${alias} as ${required ? "required" : "optional"} to ${path.relative(cwd, manifestPath)}`,
+  );
+}
+
+export const pluginAddResourceCommand = new Command("add-resource")
+  .description(
+    "Add a resource requirement to an existing plugin manifest (interactive)",
+  )
+  .option(
+    "-p, --path <dir>",
+    "Plugin directory containing manifest.json (default: .)",
+  )
+  .action((opts) =>
+    runPluginAddResource(opts).catch((err) => {
+      console.error(err);
+      process.exit(1);
+    }),
+  );