A plugin isa platform unit

import { defineCommand, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';
import { requireApiKey, createTask } from '@kb-labs/clickup-core';

export default defineCommand({
  id: 'clickup:task.create',

  handler: {
    // intent() — declare what the plugin will do before it does it
    async intent(_ctx, input: CLIInput<TaskCreateFlags>) {
      const { list, name } = input.flags;
      return {
        summary: `Create task "${name}" in list ${list}`,
        operations: [{ type: 'create', resource: 'task' }],
      };
    },

    async execute(ctx: PluginContextV3, input: CLIInput<TaskCreateFlags>) {
      const { list, name, desc, status, json } = input.flags;

      // business logic — the only thing the plugin author writes
      const task = await createTask(requireApiKey(), list, {
        name,
        markdown_content: desc,
        status,
      });

      // ctx.ui — same code, different surface: CLI, REST, Studio
      if (json) {
        ctx.ui.json({ id: task.id, name: task.name, url: task.url });
      } else {
        ctx.ui.success('Task created', {
          sections: [{ items: [`id: ${task.id}`, `url: ${task.url}`] }],
        });
      }

      return { exitCode: 0, result: task };
    },
  },
});