@penclipai/create-paperclip-plugin 2026.401.0-canary.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Paperclip AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# @penclipai/create-paperclip-plugin
+
+Scaffolding tool for creating new Paperclip plugins.
+
+```bash
+npx @penclipai/create-paperclip-plugin my-plugin
+```
+
+Or with options:
+
+```bash
+npx @penclipai/create-paperclip-plugin @acme/my-plugin \
+  --template connector \
+  --category connector \
+  --display-name "Acme Connector" \
+  --description "Syncs Acme data into Paperclip" \
+  --author "Acme Inc"
+```
+
+Supported templates: `default`, `connector`, `workspace`  
+Supported categories: `connector`, `workspace`, `automation`, `ui`
+
+Generates:
+- typed manifest + worker entrypoint
+- example UI widget using the supported `@paperclipai/plugin-sdk/ui` hooks
+- test file using `@paperclipai/plugin-sdk/testing`
+- `esbuild` and `rollup` config files using SDK bundler presets
+- dev server script for hot-reload (`paperclip-plugin-dev-server`)
+
+The scaffold intentionally uses plain React elements rather than host-provided UI kit components, because the current plugin runtime does not ship a stable shared component library yet.
+
+Inside this repo, the generated package keeps compatibility imports from `@paperclipai/plugin-sdk*` and resolves them to the workspace packages published as `@penclipai/*`.
+
+Outside this repo, the scaffold keeps those same compatibility imports and snapshots local compatibility tarballs into `.paperclip-sdk/` so the generated plugin can install immediately without waiting for npm publish.
+
+If you want the generated package to target already-published npm artifacts instead, pass `--published`:
+
+```bash
+node packages/plugins/create-paperclip-plugin/dist/index.js @acme/my-plugin \
+  --output /absolute/path/to/plugins \
+  --sdk-path /absolute/path/to/paperclip/packages/plugins/sdk \
+  --published
+```
+
+That keeps generated plugins compatible with both upstream Paperclip hosts and Paperclip CN hosts without requiring dual-published packages.
+
+## Workflow after scaffolding
+
+```bash
+cd my-plugin
+pnpm install
+pnpm dev       # watch worker + manifest + ui bundles
+pnpm dev:ui    # local UI preview server with hot-reload events
+pnpm test
+```

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+declare const VALID_TEMPLATES: readonly ["default", "connector", "workspace"];
+type PluginTemplate = (typeof VALID_TEMPLATES)[number];
+export interface ScaffoldPluginOptions {
+    pluginName: string;
+    outputDir: string;
+    template?: PluginTemplate;
+    displayName?: string;
+    description?: string;
+    author?: string;
+    category?: "connector" | "workspace" | "automation" | "ui";
+    sdkPath?: string;
+    publishedPackages?: boolean;
+}
+/** Validate npm-style plugin package names (scoped or unscoped). */
+export declare function isValidPluginName(name: string): boolean;
+/**
+ * Generate a complete Paperclip plugin starter project.
+ *
+ * Output includes manifest/worker/UI entries, SDK harness tests, bundler presets,
+ * and a local dev server script for hot-reload workflow.
+ */
+export declare function scaffoldPluginProject(options: ScaffoldPluginOptions): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,QAAA,MAAM,eAAe,gDAAiD,CAAC;AACvE,KAAK,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAGvD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,IAAI,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIvD;AAsOD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgX5E"}

package/dist/index.js

@@ -0,0 +1,551 @@
+#!/usr/bin/env node
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const VALID_TEMPLATES = ["default", "connector", "workspace"];
+const VALID_CATEGORIES = new Set(["connector", "workspace", "automation", "ui"]);
+/** Validate npm-style plugin package names (scoped or unscoped). */
+export function isValidPluginName(name) {
+    const scopedPattern = /^@[a-z0-9_-]+\/[a-z0-9._-]+$/;
+    const unscopedPattern = /^[a-z0-9._-]+$/;
+    return scopedPattern.test(name) || unscopedPattern.test(name);
+}
+/** Convert `@scope/name` to an output directory basename (`name`). */
+function packageToDirName(pluginName) {
+    return pluginName.replace(/^@[^/]+\//, "");
+}
+/** Convert an npm package name into a manifest-safe plugin id. */
+function packageToManifestId(pluginName) {
+    if (!pluginName.startsWith("@")) {
+        return pluginName;
+    }
+    return pluginName.slice(1).replace("/", ".");
+}
+/** Build a human-readable display name from package name tokens. */
+function makeDisplayName(pluginName) {
+    const raw = packageToDirName(pluginName).replace(/[._-]+/g, " ").trim();
+    return raw
+        .split(/\s+/)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ");
+}
+function writeFile(target, content) {
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, content);
+}
+function quote(value) {
+    return JSON.stringify(value);
+}
+function toPosixPath(value) {
+    return value.split(path.sep).join("/");
+}
+function formatFileDependency(absPath) {
+    return `file:${toPosixPath(path.resolve(absPath))}`;
+}
+function formatRelativeFileDependency(baseDir, targetPath) {
+    return `file:${toPosixPath(path.relative(baseDir, targetPath))}`;
+}
+function copyDir(sourceDir, targetDir) {
+    fs.mkdirSync(targetDir, { recursive: true });
+    fs.cpSync(sourceDir, targetDir, { recursive: true });
+}
+function runPnpm(args, cwd) {
+    execFileSync("pnpm", args, {
+        cwd,
+        stdio: "pipe",
+        shell: process.platform === "win32",
+    });
+}
+function getLocalSdkPackagePath() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "sdk");
+}
+function getRepoRootFromSdkPath(sdkPath) {
+    return path.resolve(sdkPath, "..", "..", "..");
+}
+function getLocalSharedPackagePath(sdkPath) {
+    return path.resolve(getRepoRootFromSdkPath(sdkPath), "packages", "shared");
+}
+function isInsideDir(targetPath, parentPath) {
+    const relative = path.relative(parentPath, targetPath);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+function packLocalPackage(packagePath, outputDir) {
+    const packageJsonPath = path.join(packagePath, "package.json");
+    if (!fs.existsSync(packageJsonPath)) {
+        throw new Error(`Package package.json not found at ${packageJsonPath}`);
+    }
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+    const packageName = packageJson.name ?? path.basename(packagePath);
+    const packageVersion = packageJson.version ?? "0.0.0";
+    const tarballFileName = `${packageName.replace(/^@/, "").replace("/", "-")}-${packageVersion}.tgz`;
+    const sdkBundleDir = path.join(outputDir, ".paperclip-sdk");
+    fs.mkdirSync(sdkBundleDir, { recursive: true });
+    runPnpm(["build"], packagePath);
+    runPnpm(["pack", "--pack-destination", sdkBundleDir], packagePath);
+    const tarballPath = path.join(sdkBundleDir, tarballFileName);
+    if (!fs.existsSync(tarballPath)) {
+        throw new Error(`Packed tarball was not created at ${tarballPath}`);
+    }
+    return tarballPath;
+}
+function rewriteWorkspaceDependencyVersions(deps, rewrites) {
+    if (!deps)
+        return deps;
+    const next = {};
+    for (const [name, value] of Object.entries(deps)) {
+        const rewrite = rewrites[name];
+        const nextName = rewrite?.name ?? name;
+        const nextValue = rewrite?.version ?? (value.startsWith("workspace:") ? value.slice("workspace:".length) || "*" : value);
+        next[nextName] = nextValue;
+    }
+    return next;
+}
+function rewritePackageFileContents(rootDir, replacements) {
+    const textExtensions = new Set([".js", ".mjs", ".cjs", ".d.ts", ".map"]);
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+            const fullPath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(fullPath);
+                continue;
+            }
+            if (!textExtensions.has(path.extname(entry.name)))
+                continue;
+            let content = fs.readFileSync(fullPath, "utf8");
+            let changed = false;
+            for (const [from, to] of replacements) {
+                if (!content.includes(from))
+                    continue;
+                content = content.split(from).join(to);
+                changed = true;
+            }
+            if (changed) {
+                fs.writeFileSync(fullPath, content);
+            }
+        }
+    }
+}
+function packCompatibilityPackage(packagePath, outputDir, options) {
+    const packageJsonPath = path.join(packagePath, "package.json");
+    if (!fs.existsSync(packageJsonPath)) {
+        throw new Error(`Package package.json not found at ${packageJsonPath}`);
+    }
+    runPnpm(["build"], packagePath);
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+    const publishConfig = typeof packageJson.publishConfig === "object" && packageJson.publishConfig !== null
+        ? packageJson.publishConfig
+        : {};
+    const packageVersion = typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
+    const bundleDir = path.join(outputDir, ".paperclip-sdk");
+    const compatDir = path.join(bundleDir, options.aliasName.replace(/^@/, "").replace("/", "__"));
+    fs.rmSync(compatDir, { recursive: true, force: true });
+    fs.mkdirSync(compatDir, { recursive: true });
+    const distSource = path.join(packagePath, "dist");
+    if (fs.existsSync(distSource)) {
+        copyDir(distSource, path.join(compatDir, "dist"));
+    }
+    const readmeSource = path.join(packagePath, "README.md");
+    if (fs.existsSync(readmeSource)) {
+        fs.copyFileSync(readmeSource, path.join(compatDir, "README.md"));
+    }
+    if (options.contentReplacements?.length) {
+        rewritePackageFileContents(path.join(compatDir, "dist"), options.contentReplacements);
+    }
+    const compatPackageJson = {
+        name: options.aliasName,
+        version: packageVersion,
+        description: packageJson.description,
+        type: packageJson.type ?? "module",
+        keywords: packageJson.keywords,
+        license: packageJson.license,
+        repository: packageJson.repository,
+        homepage: packageJson.homepage,
+        bugs: packageJson.bugs,
+        bin: publishConfig.bin ?? packageJson.bin,
+        exports: publishConfig.exports ?? packageJson.exports,
+        main: publishConfig.main ?? packageJson.main,
+        types: publishConfig.types ?? packageJson.types,
+        files: ["dist", "README.md"],
+        dependencies: rewriteWorkspaceDependencyVersions(packageJson.dependencies, options.dependencyRewrites ?? {}),
+        optionalDependencies: rewriteWorkspaceDependencyVersions(packageJson.optionalDependencies, options.dependencyRewrites ?? {}),
+        peerDependencies: packageJson.peerDependencies,
+        peerDependenciesMeta: packageJson.peerDependenciesMeta,
+    };
+    writeFile(path.join(compatDir, "package.json"), `${JSON.stringify(compatPackageJson, null, 2)}\n`);
+    runPnpm(["pack", "--pack-destination", bundleDir], compatDir);
+    const tarballFileName = `${options.aliasName.replace(/^@/, "").replace("/", "-")}-${packageVersion}.tgz`;
+    const tarballPath = path.join(bundleDir, tarballFileName);
+    if (!fs.existsSync(tarballPath)) {
+        throw new Error(`Packed compatibility tarball was not created at ${tarballPath}`);
+    }
+    return tarballPath;
+}
+/**
+ * Generate a complete Paperclip plugin starter project.
+ *
+ * Output includes manifest/worker/UI entries, SDK harness tests, bundler presets,
+ * and a local dev server script for hot-reload workflow.
+ */
+export function scaffoldPluginProject(options) {
+    const template = options.template ?? "default";
+    if (!VALID_TEMPLATES.includes(template)) {
+        throw new Error(`Invalid template '${template}'. Expected one of: ${VALID_TEMPLATES.join(", ")}`);
+    }
+    if (!isValidPluginName(options.pluginName)) {
+        throw new Error("Invalid plugin name. Must be lowercase and may include scope, dots, underscores, or hyphens.");
+    }
+    if (options.category && !VALID_CATEGORIES.has(options.category)) {
+        throw new Error(`Invalid category '${options.category}'. Expected one of: ${[...VALID_CATEGORIES].join(", ")}`);
+    }
+    const outputDir = path.resolve(options.outputDir);
+    if (fs.existsSync(outputDir)) {
+        throw new Error(`Directory already exists: ${outputDir}`);
+    }
+    const displayName = options.displayName ?? makeDisplayName(options.pluginName);
+    const description = options.description ?? "A Paperclip plugin";
+    const author = options.author ?? "Plugin Author";
+    const category = options.category ?? (template === "workspace" ? "workspace" : "connector");
+    const manifestId = packageToManifestId(options.pluginName);
+    const localSdkPath = path.resolve(options.sdkPath ?? getLocalSdkPackagePath());
+    const localSharedPath = getLocalSharedPackagePath(localSdkPath);
+    const repoRoot = getRepoRootFromSdkPath(localSdkPath);
+    const useWorkspaceSdk = isInsideDir(outputDir, repoRoot);
+    const usePublishedPackages = options.publishedPackages === true && !useWorkspaceSdk;
+    const sdkVersion = JSON.parse(fs.readFileSync(path.join(localSdkPath, "package.json"), "utf8")).version ?? "latest";
+    const sharedVersion = JSON.parse(fs.readFileSync(path.join(localSharedPath, "package.json"), "utf8")).version ?? "latest";
+    fs.mkdirSync(outputDir, { recursive: true });
+    const packedCompatSdkTarball = useWorkspaceSdk || usePublishedPackages
+        ? null
+        : packCompatibilityPackage(localSdkPath, outputDir, {
+            aliasName: "@paperclipai/plugin-sdk",
+            dependencyRewrites: {
+                "@penclipai/shared": {
+                    name: "@paperclipai/shared",
+                    version: sharedVersion,
+                },
+            },
+            contentReplacements: [
+                ["@penclipai/shared", "@paperclipai/shared"],
+            ],
+        });
+    const packedCompatSharedTarball = useWorkspaceSdk || usePublishedPackages
+        ? null
+        : packCompatibilityPackage(localSharedPath, outputDir, {
+            aliasName: "@paperclipai/shared",
+        });
+    const sdkDependency = useWorkspaceSdk
+        ? "workspace:@penclipai/plugin-sdk@*"
+        : usePublishedPackages
+            ? `npm:@penclipai/plugin-sdk@${sdkVersion}`
+            : formatRelativeFileDependency(outputDir, packedCompatSdkTarball);
+    const sharedDependency = useWorkspaceSdk
+        ? "workspace:@penclipai/shared@*"
+        : usePublishedPackages
+            ? `npm:@penclipai/shared@${sharedVersion}`
+            : formatRelativeFileDependency(outputDir, packedCompatSharedTarball);
+    const packageJson = {
+        name: options.pluginName,
+        version: "0.1.0",
+        type: "module",
+        private: true,
+        description,
+        scripts: {
+            build: "node ./esbuild.config.mjs",
+            "build:rollup": "rollup -c",
+            dev: "node ./esbuild.config.mjs --watch",
+            "dev:ui": "paperclip-plugin-dev-server --root . --ui-dir dist/ui --port 4177",
+            test: "vitest run --config ./vitest.config.ts",
+            typecheck: "tsc --noEmit"
+        },
+        paperclipPlugin: {
+            manifest: "./dist/manifest.js",
+            worker: "./dist/worker.js",
+            ui: "./dist/ui/"
+        },
+        keywords: ["paperclip", "plugin", category],
+        author,
+        license: "MIT",
+        ...(packedCompatSharedTarball
+            ? {
+                pnpm: {
+                    overrides: {
+                        "@paperclipai/shared": formatRelativeFileDependency(outputDir, packedCompatSharedTarball),
+                    },
+                },
+            }
+            : {}),
+        devDependencies: {
+            "@paperclipai/plugin-sdk": sdkDependency,
+            "@paperclipai/shared": sharedDependency,
+            "@rollup/plugin-node-resolve": "^16.0.1",
+            "@rollup/plugin-typescript": "^12.1.2",
+            "@types/node": "^24.6.0",
+            "@types/react": "^19.0.8",
+            esbuild: "^0.27.3",
+            rollup: "^4.38.0",
+            tslib: "^2.8.1",
+            typescript: "^5.7.3",
+            vitest: "^3.0.5"
+        },
+        peerDependencies: {
+            react: ">=18"
+        }
+    };
+    writeFile(path.join(outputDir, "package.json"), `${JSON.stringify(packageJson, null, 2)}\n`);
+    const tsconfig = {
+        compilerOptions: {
+            target: "ES2022",
+            module: "NodeNext",
+            moduleResolution: "NodeNext",
+            lib: ["ES2022", "DOM"],
+            jsx: "react-jsx",
+            strict: true,
+            skipLibCheck: true,
+            declaration: true,
+            declarationMap: true,
+            sourceMap: true,
+            outDir: "dist",
+            rootDir: "."
+        },
+        include: ["src", "tests"],
+        exclude: ["dist", "node_modules"]
+    };
+    writeFile(path.join(outputDir, "tsconfig.json"), `${JSON.stringify(tsconfig, null, 2)}\n`);
+    writeFile(path.join(outputDir, "esbuild.config.mjs"), `import esbuild from "esbuild";
+import { createPluginBundlerPresets } from "@paperclipai/plugin-sdk/bundlers";
+
+const presets = createPluginBundlerPresets({ uiEntry: "src/ui/index.tsx" });
+const watch = process.argv.includes("--watch");
+
+const workerCtx = await esbuild.context(presets.esbuild.worker);
+const manifestCtx = await esbuild.context(presets.esbuild.manifest);
+const uiCtx = await esbuild.context(presets.esbuild.ui);
+
+if (watch) {
+  await Promise.all([workerCtx.watch(), manifestCtx.watch(), uiCtx.watch()]);
+  console.log("esbuild watch mode enabled for worker, manifest, and ui");
+} else {
+  await Promise.all([workerCtx.rebuild(), manifestCtx.rebuild(), uiCtx.rebuild()]);
+  await Promise.all([workerCtx.dispose(), manifestCtx.dispose(), uiCtx.dispose()]);
+}
+`);
+    writeFile(path.join(outputDir, "rollup.config.mjs"), `import { nodeResolve } from "@rollup/plugin-node-resolve";
+import typescript from "@rollup/plugin-typescript";
+import { createPluginBundlerPresets } from "@paperclipai/plugin-sdk/bundlers";
+
+const presets = createPluginBundlerPresets({ uiEntry: "src/ui/index.tsx" });
+
+function withPlugins(config) {
+  if (!config) return null;
+  return {
+    ...config,
+    plugins: [
+      nodeResolve({
+        extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs"],
+      }),
+      typescript({
+        tsconfig: "./tsconfig.json",
+        declaration: false,
+        declarationMap: false,
+      }),
+    ],
+  };
+}
+
+export default [
+  withPlugins(presets.rollup.manifest),
+  withPlugins(presets.rollup.worker),
+  withPlugins(presets.rollup.ui),
+].filter(Boolean);
+`);
+    writeFile(path.join(outputDir, "vitest.config.ts"), `import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    include: ["tests/**/*.spec.ts"],
+    environment: "node",
+  },
+});
+`);
+    writeFile(path.join(outputDir, "src", "manifest.ts"), `import type { PaperclipPluginManifestV1 } from "@paperclipai/plugin-sdk";
+
+const manifest: PaperclipPluginManifestV1 = {
+  id: ${quote(manifestId)},
+  apiVersion: 1,
+  version: "0.1.0",
+  displayName: ${quote(displayName)},
+  description: ${quote(description)},
+  author: ${quote(author)},
+  categories: [${quote(category)}],
+  capabilities: [
+    "events.subscribe",
+    "plugin.state.read",
+    "plugin.state.write"
+  ],
+  entrypoints: {
+    worker: "./dist/worker.js",
+    ui: "./dist/ui"
+  },
+  ui: {
+    slots: [
+      {
+        type: "dashboardWidget",
+        id: "health-widget",
+        displayName: ${quote(`${displayName} Health`)},
+        exportName: "DashboardWidget"
+      }
+    ]
+  }
+};
+
+export default manifest;
+`);
+    writeFile(path.join(outputDir, "src", "worker.ts"), `import { definePlugin, runWorker } from "@paperclipai/plugin-sdk";
+
+const plugin = definePlugin({
+  async setup(ctx) {
+    ctx.events.on("issue.created", async (event) => {
+      const issueId = event.entityId ?? "unknown";
+      await ctx.state.set({ scopeKind: "issue", scopeId: issueId, stateKey: "seen" }, true);
+      ctx.logger.info("Observed issue.created", { issueId });
+    });
+
+    ctx.data.register("health", async () => {
+      return { status: "ok", checkedAt: new Date().toISOString() };
+    });
+
+    ctx.actions.register("ping", async () => {
+      ctx.logger.info("Ping action invoked");
+      return { pong: true, at: new Date().toISOString() };
+    });
+  },
+
+  async onHealth() {
+    return { status: "ok", message: "Plugin worker is running" };
+  }
+});
+
+export default plugin;
+runWorker(plugin, import.meta.url);
+`);
+    writeFile(path.join(outputDir, "src", "ui", "index.tsx"), `import { usePluginAction, usePluginData, type PluginWidgetProps } from "@paperclipai/plugin-sdk/ui";
+
+type HealthData = {
+  status: "ok" | "degraded" | "error";
+  checkedAt: string;
+};
+
+export function DashboardWidget(_props: PluginWidgetProps) {
+  const { data, loading, error } = usePluginData<HealthData>("health");
+  const ping = usePluginAction("ping");
+
+  if (loading) return <div>Loading plugin health...</div>;
+  if (error) return <div>Plugin error: {error.message}</div>;
+
+  return (
+    <div style={{ display: "grid", gap: "0.5rem" }}>
+      <strong>${displayName}</strong>
+      <div>Health: {data?.status ?? "unknown"}</div>
+      <div>Checked: {data?.checkedAt ?? "never"}</div>
+      <button onClick={() => void ping()}>Ping Worker</button>
+    </div>
+  );
+}
+`);
+    writeFile(path.join(outputDir, "tests", "plugin.spec.ts"), `import { describe, expect, it } from "vitest";
+import { createTestHarness } from "@paperclipai/plugin-sdk/testing";
+import manifest from "../src/manifest.js";
+import plugin from "../src/worker.js";
+
+describe("plugin scaffold", () => {
+  it("registers data + actions and handles events", async () => {
+    const harness = createTestHarness({ manifest, capabilities: [...manifest.capabilities, "events.emit"] });
+    await plugin.definition.setup(harness.ctx);
+
+    await harness.emit("issue.created", { issueId: "iss_1" }, { entityId: "iss_1", entityType: "issue" });
+    expect(harness.getState({ scopeKind: "issue", scopeId: "iss_1", stateKey: "seen" })).toBe(true);
+
+    const data = await harness.getData<{ status: string }>("health");
+    expect(data.status).toBe("ok");
+
+    const action = await harness.performAction<{ pong: boolean }>("ping");
+    expect(action.pong).toBe(true);
+  });
+});
+`);
+    writeFile(path.join(outputDir, "README.md"), `# ${displayName}
+
+${description}
+
+## Development
+
+\`\`\`bash
+pnpm install
+pnpm dev            # watch builds
+pnpm dev:ui         # local dev server with hot-reload events
+pnpm test
+\`\`\`
+
+${useWorkspaceSdk
+        ? `This scaffold keeps compatibility imports from \`@paperclipai/plugin-sdk*\` while resolving them to the workspace packages published as \`@penclipai/*\`.\n\n`
+        : usePublishedPackages
+            ? `This scaffold keeps compatibility imports from \`@paperclipai/plugin-sdk*\` while installing the published packages from \`@penclipai/*\` via npm alias dependencies pinned from your local Paperclip checkout at:\n\n\`${toPosixPath(localSdkPath)}\`\n\n`
+            : `This scaffold snapshots compatibility packages for \`@paperclipai/plugin-sdk\` and \`@paperclipai/shared\` from your local Paperclip checkout at:\n\n\`${toPosixPath(localSdkPath)}\`\n\nThe packed tarballs live in \`.paperclip-sdk/\` so the generated plugin can install immediately without waiting for npm publish.\n\n`}
+
+## Install Into Paperclip
+
+\`\`\`bash
+curl -X POST http://127.0.0.1:3100/api/plugins/install \\
+  -H "Content-Type: application/json" \\
+  -d '{"packageName":"${toPosixPath(outputDir)}","isLocalPath":true}'
+\`\`\`
+
+## Build Options
+
+- \`pnpm build\` uses esbuild presets from \`@paperclipai/plugin-sdk/bundlers\`.
+- \`pnpm build:rollup\` uses rollup presets from the same SDK.
+`);
+    writeFile(path.join(outputDir, ".gitignore"), "dist\nnode_modules\n.paperclip-sdk\n");
+    return outputDir;
+}
+function parseArg(name) {
+    const index = process.argv.indexOf(name);
+    if (index === -1)
+        return undefined;
+    return process.argv[index + 1];
+}
+function hasFlag(name) {
+    return process.argv.includes(name);
+}
+/** CLI wrapper for `scaffoldPluginProject`. */
+function runCli() {
+    const pluginName = process.argv[2];
+    if (!pluginName) {
+        // eslint-disable-next-line no-console
+        console.error("Usage: create-paperclip-plugin <name> [--template default|connector|workspace] [--output <dir>] [--sdk-path <paperclip-sdk-path>] [--published]");
+        process.exit(1);
+    }
+    const template = (parseArg("--template") ?? "default");
+    const outputRoot = parseArg("--output") ?? process.cwd();
+    const targetDir = path.resolve(outputRoot, packageToDirName(pluginName));
+    const out = scaffoldPluginProject({
+        pluginName,
+        outputDir: targetDir,
+        template,
+        displayName: parseArg("--display-name"),
+        description: parseArg("--description"),
+        author: parseArg("--author"),
+        category: parseArg("--category"),
+        sdkPath: parseArg("--sdk-path"),
+        publishedPackages: hasFlag("--published"),
+    });
+    // eslint-disable-next-line no-console
+    console.log(`Created plugin scaffold at ${out}`);
+}
+if (process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1])) {
+    runCli();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@penclipai/create-paperclip-plugin",
+  "version": "2026.401.0-canary.0",
+  "license": "MIT",
+  "homepage": "https://github.com/penclipai/paperclip-cn",
+  "bugs": {
+    "url": "https://github.com/penclipai/paperclip-cn/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/penclipai/paperclip-cn",
+    "directory": "packages/plugins/create-paperclip-plugin"
+  },
+  "type": "module",
+  "bin": {
+    "create-paperclip-plugin": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@penclipai/plugin-sdk": "2026.401.0-canary.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}