@itzptk/ocps 1.0.0 → 1.0.1

package/README.md

@@ -1,7 +1,7 @@
 # ocps
 
-[![npm version](https://img.shields.io/npm/v/ocps.svg?logo=npm&style=flat-square)](https://www.npmjs.com/package/ocps)
-[![npm downloads](https://img.shields.io/npm/dm/ocps.svg?style=flat-square)](https://www.npmjs.com/package/ocps)
+[![npm version](https://img.shields.io/npm/v/@itzptk/ocps.svg?logo=npm&style=flat-square)](https://www.npmjs.com/package/@itzptk/ocps)
+[![npm downloads](https://img.shields.io/npm/dm/@itzptk/ocps.svg?style=flat-square)](https://www.npmjs.com/package/@itzptk/ocps)
 [![license](https://img.shields.io/github/license/itzptk/ocps.svg?style=flat-square)](./LICENSE)
 [![CI](https://img.shields.io/github/actions/workflow/status/itzptk/ocps/ci.yml?branch=main&label=ci&style=flat-square)](https://github.com/itzptk/ocps/actions/workflows/ci.yml)
 [![Bun](https://img.shields.io/badge/powered%20by-bun-f9f1e1?style=flat-square&logo=bun)](https://bun.sh)
@@ -14,7 +14,7 @@ Scaffold a new [opencode](https://opencode.ai) plugin project with a single comm
 ## Quickstart
 
 ```bash
-npx ocps init my-plugin --name opencode-greeter
+npx @itzptk/ocps init my-plugin --name opencode-greeter
 ```
 
 This creates an `opencode-greeter/` directory with a working plugin, installs dependencies, and prints the next steps.

package/dist/cli.js

@@ -0,0 +1,402 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { dirname as dirname2, join as join3 } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+// src/scaffold.ts
+import { existsSync, mkdirSync, readdirSync as readdirSync2, statSync as statSync2, writeFileSync } from "node:fs";
+import { dirname, join as join2, resolve } from "node:path";
+
+// src/name.ts
+var NAME_RE = /^(?:@([a-z0-9][a-z0-9._-]*)\/)?([a-z0-9][a-z0-9._-]*)$/;
+function parseName(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0)
+    return null;
+  if (trimmed.length > 214)
+    return null;
+  const match = NAME_RE.exec(trimmed);
+  if (!match)
+    return null;
+  const scope = match[1] ?? null;
+  const local = match[2];
+  if (scope !== null && scope.length > 214)
+    return null;
+  if (local.length > 214)
+    return null;
+  if (trimmed.toLowerCase() === "node_modules" || trimmed.toLowerCase() === "favicon.ico")
+    return null;
+  return { raw: trimmed, scope, local };
+}
+function isValidName(raw) {
+  return parseName(raw) !== null;
+}
+var RESERVED_WORDS = new Set([
+  "abstract",
+  "await",
+  "boolean",
+  "break",
+  "byte",
+  "case",
+  "catch",
+  "char",
+  "class",
+  "const",
+  "continue",
+  "debugger",
+  "default",
+  "delete",
+  "do",
+  "double",
+  "else",
+  "enum",
+  "export",
+  "extends",
+  "false",
+  "final",
+  "finally",
+  "float",
+  "for",
+  "function",
+  "goto",
+  "if",
+  "implements",
+  "import",
+  "in",
+  "instanceof",
+  "int",
+  "interface",
+  "let",
+  "long",
+  "native",
+  "new",
+  "null",
+  "package",
+  "private",
+  "protected",
+  "public",
+  "return",
+  "short",
+  "static",
+  "super",
+  "switch",
+  "synchronized",
+  "this",
+  "throw",
+  "throws",
+  "transient",
+  "true",
+  "try",
+  "typeof",
+  "var",
+  "void",
+  "volatile",
+  "while",
+  "with",
+  "yield"
+]);
+function toPascalCase(input) {
+  const cleaned = input.replace(/[^a-zA-Z0-9]+/g, " ").trim();
+  if (cleaned.length === 0)
+    return "Plugin";
+  const parts = cleaned.split(/\s+/).filter(Boolean);
+  const pascal = parts.map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
+  if (RESERVED_WORDS.has(pascal.toLowerCase()))
+    return `${pascal}Plugin`;
+  if (/^[0-9]/.test(pascal))
+    return `Plugin${pascal}`;
+  return pascal;
+}
+function deriveExportName(raw, opts = {}) {
+  const parsed = parseName(raw);
+  if (!parsed)
+    return "MyPlugin";
+  const source = opts.stripScope ? parsed.local : parsed.scope ? `${parsed.scope}-${parsed.local}` : parsed.local;
+  return `${toPascalCase(source)}Plugin`;
+}
+function derivePluginExportName(raw) {
+  const parsed = parseName(raw);
+  if (!parsed)
+    return "MyPlugin";
+  return `${toPascalCase(parsed.local)}Plugin`;
+}
+
+// src/template-files.ts
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+var PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g;
+function render(content, vars) {
+  return content.replace(PLACEHOLDER_RE, (match, key) => {
+    if (key === "name")
+      return vars.name;
+    if (key === "exportName")
+      return vars.exportName;
+    if (key === "description")
+      return vars.description;
+    if (key === "year")
+      return vars.year;
+    if (key === "repository")
+      return vars.repository ?? "";
+    if (key === "authorName")
+      return vars.authorName ?? "";
+    return match;
+  });
+}
+function listTemplateFiles(templateDir) {
+  const results = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir)) {
+      const full = join(dir, entry);
+      const st = statSync(full);
+      if (st.isDirectory()) {
+        walk(full);
+        continue;
+      }
+      const rel = relative(templateDir, full).split(sep).join("/");
+      const content = readFileSync(full, "utf-8");
+      const stripped = rel.endsWith(".tpl") ? rel.slice(0, -".tpl".length) : rel;
+      const target = stripped === "gitignore" ? ".gitignore" : stripped;
+      results.push({ relative: target, content });
+    }
+  };
+  walk(templateDir);
+  return results.sort((a, b) => a.relative.localeCompare(b.relative));
+}
+function defaultTemplateDir(rootDir) {
+  return join(rootDir, "templates", "default");
+}
+
+// src/scaffold.ts
+class ScaffoldError extends Error {
+}
+var IGNORED_EXISTING = new Set([".git", ".DS_Store"]);
+function dirIsEmptyOrVcsOnly(dir) {
+  if (!existsSync(dir))
+    return true;
+  const entries = readdirSync2(dir).filter((e) => !IGNORED_EXISTING.has(e));
+  return entries.length === 0;
+}
+function resolveDirectory(opts, parsed) {
+  if (opts.directory && opts.directory.trim().length > 0) {
+    return resolve(opts.directory);
+  }
+  return resolve(parsed.local);
+}
+function scaffold(opts, templateRootDir, now = new Date) {
+  const parsed = parseName(opts.name);
+  if (!parsed) {
+    throw new ScaffoldError(`Invalid package name: "${opts.name}". Use a valid npm name like "opencode-foo" or "@scope/opencode-foo".`);
+  }
+  const directory = resolveDirectory(opts, parsed);
+  if (existsSync(directory) && statSync2(directory).isFile()) {
+    throw new ScaffoldError(`Target path exists and is a file: ${directory}`);
+  }
+  if (existsSync(directory) && !statSync2(directory).isDirectory()) {
+    throw new ScaffoldError(`Target path is not a directory: ${directory}`);
+  }
+  if (!opts.force && existsSync(directory) && !dirIsEmptyOrVcsOnly(directory)) {
+    throw new ScaffoldError(`Target directory is not empty: ${directory}. Pass --force to overwrite, or choose an empty directory.`);
+  }
+  const exportName = derivePluginExportName(opts.name);
+  const description = (opts.description ?? "An opencode plugin").trim();
+  const year = String(now.getFullYear());
+  const vars = {
+    name: parsed.raw,
+    exportName,
+    description,
+    year,
+    authorName: opts.authorName ?? parsed.local
+  };
+  const templateDir = defaultTemplateDir(templateRootDir);
+  if (!existsSync(templateDir)) {
+    throw new ScaffoldError(`Template directory not found: ${templateDir}`);
+  }
+  const files = listTemplateFiles(templateDir);
+  const written = [];
+  for (const file of files) {
+    const target = join2(directory, file.relative);
+    mkdirSync(dirname(target), { recursive: true });
+    const body = render(file.content, vars);
+    writeFileSync(target, body);
+    written.push(file.relative);
+  }
+  return { directory, written, name: parsed.raw, exportName };
+}
+
+// src/cli.ts
+var __dirname = "/home/activadee/dev/opencode-plugin-template/src";
+var SCRIPT_DIR = typeof __dirname !== "undefined" ? __dirname : dirname2(fileURLToPath(import.meta.url));
+var PACKAGE_ROOT = join3(SCRIPT_DIR, "..");
+function parseArgs(argv) {
+  const out = {
+    command: null,
+    force: false,
+    noInstall: false,
+    help: false
+  };
+  const positional = [];
+  for (let i = 0;i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "-h" || arg === "--help") {
+      out.help = true;
+    } else if (arg === "--force") {
+      out.force = true;
+    } else if (arg === "--no-install") {
+      out.noInstall = true;
+    } else if (arg === "--name") {
+      out.name = argv[++i];
+    } else if (arg.startsWith("--name=")) {
+      out.name = arg.slice("--name=".length);
+    } else if (arg === "--description") {
+      out.description = argv[++i];
+    } else if (arg.startsWith("--description=")) {
+      out.description = arg.slice("--description=".length);
+    } else if (arg === "--author") {
+      out.author = argv[++i];
+    } else if (arg.startsWith("--author=")) {
+      out.author = arg.slice("--author=".length);
+    } else if (arg.startsWith("--")) {
+      throw new CliError(`Unknown option: ${arg}`);
+    } else {
+      positional.push(arg);
+    }
+  }
+  if (positional.length > 0)
+    out.command = positional[0];
+  if (positional.length > 1)
+    out.directory = positional[1];
+  return out;
+}
+
+class CliError extends Error {
+}
+function printHelp() {
+  const lines = [
+    "ocps - scaffold a new opencode plugin",
+    "",
+    "Usage:",
+    "  ocps init [directory] --name <package-name> [options]",
+    "",
+    "Options:",
+    "  --name <name>           npm package name for the plugin (required)",
+    "  --description <text>    Short description for package.json and README",
+    "  --author <name>          Copyright author name for LICENSE",
+    "  --force                 Write into a non-empty directory (does not delete existing files)",
+    "  --no-install            Skip running bun install after scaffolding",
+    "  -h, --help              Show this help",
+    "",
+    "Examples:",
+    "  ocps init my-plugin --name opencode-greeter",
+    '  ocps init --name @scope/opencode-greeter --author "Jane Doe"'
+  ];
+  process.stdout.write(lines.join(`
+`) + `
+`);
+}
+function detectBun() {
+  const r = spawnSync("bun", ["--version"], { stdio: "ignore" });
+  return r.status === 0 ? "bun" : null;
+}
+function runInstall(directory, noInstall) {
+  if (noInstall) {
+    printNext(directory, false);
+    return;
+  }
+  const bun = detectBun();
+  if (!bun) {
+    process.stdout.write(`
+Bun was not detected. Next step:
+  cd ` + directory + ` && bun install
+`);
+    return;
+  }
+  process.stdout.write(`
+Running bun install...
+`);
+  const r = spawnSync(bun, ["install"], { cwd: directory, stdio: "inherit" });
+  if (r.status !== 0) {
+    process.stdout.write(`
+bun install exited with code ` + String(r.status) + `. You can retry manually.
+`);
+    return;
+  }
+  printNext(directory, true);
+}
+function printNext(directory, installed) {
+  const cd = directory === process.cwd() ? "" : `cd ${directory}
+`;
+  const installLine = installed ? "" : `bun install
+`;
+  process.stdout.write([
+    "",
+    "Done. Next steps:",
+    cd ? "  " + cd.replace(/\n$/, "") : null,
+    "  " + installLine.replace(/\n$/, ""),
+    "  bun test",
+    "  bun run typecheck",
+    "",
+    "Then register the plugin in your opencode.json:",
+    '  { "$schema": "https://opencode.ai/config.json", "plugin": ["<name>"] }',
+    ""
+  ].filter((l) => l !== null && l !== "" || l === "").join(`
+`) + `
+`);
+}
+function runInit(args) {
+  if (!args.name) {
+    throw new CliError("Missing required option: --name <package-name>");
+  }
+  const opts = {
+    name: args.name,
+    directory: args.directory,
+    description: args.description,
+    authorName: args.author,
+    force: args.force
+  };
+  const result = scaffold(opts, PACKAGE_ROOT);
+  process.stdout.write(`Created ${result.written.length} files in ${result.directory}
+` + `  package:  ${result.name}
+` + `  export:   ${result.exportName}
+`);
+  runInstall(result.directory, args.noInstall);
+}
+function main() {
+  let args;
+  try {
+    args = parseArgs(process.argv.slice(2));
+  } catch (err) {
+    if (err instanceof CliError) {
+      process.stderr.write(`Error: ${err.message}
+`);
+      process.exitCode = 1;
+      return;
+    }
+    throw err;
+  }
+  if (args.help || args.command === null) {
+    printHelp();
+    return;
+  }
+  if (args.command !== "init") {
+    process.stderr.write(`Unknown command: ${args.command}
+`);
+    process.stderr.write(`Run with --help for usage.
+`);
+    process.exitCode = 2;
+    return;
+  }
+  try {
+    runInit(args);
+  } catch (err) {
+    if (err instanceof ScaffoldError || err instanceof CliError) {
+      process.stderr.write(`Error: ${err.message}
+`);
+      process.exitCode = 1;
+      return;
+    }
+    throw err;
+  }
+}
+main();

package/dist/index.js

@@ -0,0 +1,232 @@
+// src/scaffold.ts
+import { existsSync, mkdirSync, readdirSync as readdirSync2, statSync as statSync2, writeFileSync } from "node:fs";
+import { dirname, join as join2, resolve } from "node:path";
+
+// src/name.ts
+var NAME_RE = /^(?:@([a-z0-9][a-z0-9._-]*)\/)?([a-z0-9][a-z0-9._-]*)$/;
+function parseName(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0)
+    return null;
+  if (trimmed.length > 214)
+    return null;
+  const match = NAME_RE.exec(trimmed);
+  if (!match)
+    return null;
+  const scope = match[1] ?? null;
+  const local = match[2];
+  if (scope !== null && scope.length > 214)
+    return null;
+  if (local.length > 214)
+    return null;
+  if (trimmed.toLowerCase() === "node_modules" || trimmed.toLowerCase() === "favicon.ico")
+    return null;
+  return { raw: trimmed, scope, local };
+}
+function isValidName(raw) {
+  return parseName(raw) !== null;
+}
+var RESERVED_WORDS = new Set([
+  "abstract",
+  "await",
+  "boolean",
+  "break",
+  "byte",
+  "case",
+  "catch",
+  "char",
+  "class",
+  "const",
+  "continue",
+  "debugger",
+  "default",
+  "delete",
+  "do",
+  "double",
+  "else",
+  "enum",
+  "export",
+  "extends",
+  "false",
+  "final",
+  "finally",
+  "float",
+  "for",
+  "function",
+  "goto",
+  "if",
+  "implements",
+  "import",
+  "in",
+  "instanceof",
+  "int",
+  "interface",
+  "let",
+  "long",
+  "native",
+  "new",
+  "null",
+  "package",
+  "private",
+  "protected",
+  "public",
+  "return",
+  "short",
+  "static",
+  "super",
+  "switch",
+  "synchronized",
+  "this",
+  "throw",
+  "throws",
+  "transient",
+  "true",
+  "try",
+  "typeof",
+  "var",
+  "void",
+  "volatile",
+  "while",
+  "with",
+  "yield"
+]);
+function toPascalCase(input) {
+  const cleaned = input.replace(/[^a-zA-Z0-9]+/g, " ").trim();
+  if (cleaned.length === 0)
+    return "Plugin";
+  const parts = cleaned.split(/\s+/).filter(Boolean);
+  const pascal = parts.map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
+  if (RESERVED_WORDS.has(pascal.toLowerCase()))
+    return `${pascal}Plugin`;
+  if (/^[0-9]/.test(pascal))
+    return `Plugin${pascal}`;
+  return pascal;
+}
+function deriveExportName(raw, opts = {}) {
+  const parsed = parseName(raw);
+  if (!parsed)
+    return "MyPlugin";
+  const source = opts.stripScope ? parsed.local : parsed.scope ? `${parsed.scope}-${parsed.local}` : parsed.local;
+  return `${toPascalCase(source)}Plugin`;
+}
+function derivePluginExportName(raw) {
+  const parsed = parseName(raw);
+  if (!parsed)
+    return "MyPlugin";
+  return `${toPascalCase(parsed.local)}Plugin`;
+}
+
+// src/template-files.ts
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+var PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g;
+function render(content, vars) {
+  return content.replace(PLACEHOLDER_RE, (match, key) => {
+    if (key === "name")
+      return vars.name;
+    if (key === "exportName")
+      return vars.exportName;
+    if (key === "description")
+      return vars.description;
+    if (key === "year")
+      return vars.year;
+    if (key === "repository")
+      return vars.repository ?? "";
+    if (key === "authorName")
+      return vars.authorName ?? "";
+    return match;
+  });
+}
+function listTemplateFiles(templateDir) {
+  const results = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir)) {
+      const full = join(dir, entry);
+      const st = statSync(full);
+      if (st.isDirectory()) {
+        walk(full);
+        continue;
+      }
+      const rel = relative(templateDir, full).split(sep).join("/");
+      const content = readFileSync(full, "utf-8");
+      const stripped = rel.endsWith(".tpl") ? rel.slice(0, -".tpl".length) : rel;
+      const target = stripped === "gitignore" ? ".gitignore" : stripped;
+      results.push({ relative: target, content });
+    }
+  };
+  walk(templateDir);
+  return results.sort((a, b) => a.relative.localeCompare(b.relative));
+}
+function defaultTemplateDir(rootDir) {
+  return join(rootDir, "templates", "default");
+}
+
+// src/scaffold.ts
+class ScaffoldError extends Error {
+}
+var IGNORED_EXISTING = new Set([".git", ".DS_Store"]);
+function dirIsEmptyOrVcsOnly(dir) {
+  if (!existsSync(dir))
+    return true;
+  const entries = readdirSync2(dir).filter((e) => !IGNORED_EXISTING.has(e));
+  return entries.length === 0;
+}
+function resolveDirectory(opts, parsed) {
+  if (opts.directory && opts.directory.trim().length > 0) {
+    return resolve(opts.directory);
+  }
+  return resolve(parsed.local);
+}
+function scaffold(opts, templateRootDir, now = new Date) {
+  const parsed = parseName(opts.name);
+  if (!parsed) {
+    throw new ScaffoldError(`Invalid package name: "${opts.name}". Use a valid npm name like "opencode-foo" or "@scope/opencode-foo".`);
+  }
+  const directory = resolveDirectory(opts, parsed);
+  if (existsSync(directory) && statSync2(directory).isFile()) {
+    throw new ScaffoldError(`Target path exists and is a file: ${directory}`);
+  }
+  if (existsSync(directory) && !statSync2(directory).isDirectory()) {
+    throw new ScaffoldError(`Target path is not a directory: ${directory}`);
+  }
+  if (!opts.force && existsSync(directory) && !dirIsEmptyOrVcsOnly(directory)) {
+    throw new ScaffoldError(`Target directory is not empty: ${directory}. Pass --force to overwrite, or choose an empty directory.`);
+  }
+  const exportName = derivePluginExportName(opts.name);
+  const description = (opts.description ?? "An opencode plugin").trim();
+  const year = String(now.getFullYear());
+  const vars = {
+    name: parsed.raw,
+    exportName,
+    description,
+    year,
+    authorName: opts.authorName ?? parsed.local
+  };
+  const templateDir = defaultTemplateDir(templateRootDir);
+  if (!existsSync(templateDir)) {
+    throw new ScaffoldError(`Template directory not found: ${templateDir}`);
+  }
+  const files = listTemplateFiles(templateDir);
+  const written = [];
+  for (const file of files) {
+    const target = join2(directory, file.relative);
+    mkdirSync(dirname(target), { recursive: true });
+    const body = render(file.content, vars);
+    writeFileSync(target, body);
+    written.push(file.relative);
+  }
+  return { directory, written, name: parsed.raw, exportName };
+}
+export {
+  toPascalCase,
+  scaffold,
+  resolveDirectory,
+  render,
+  parseName,
+  listTemplateFiles,
+  isValidName,
+  derivePluginExportName,
+  deriveExportName,
+  defaultTemplateDir,
+  ScaffoldError
+};

package/package.json

@@ -1,21 +1,23 @@
 {
   "name": "@itzptk/ocps",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "opencode plugin starter — scaffold a new opencode plugin project via `npx ocps init`",
   "type": "module",
   "bin": {
-    "ocps": "./src/cli.ts"
+    "ocps": "./dist/cli.js"
   },
   "publishConfig": {
     "access": "public"
   },
-  "exports": "./src/index.ts",
+  "exports": "./dist/index.js",
   "files": [
-    "src",
+    "dist",
     "templates",
     "README.md"
   ],
   "scripts": {
+    "build": "bun build ./src/cli.ts ./src/index.ts --outdir ./dist --target node",
+    "prepublishOnly": "bun run build",
     "test": "bun test",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },

package/src/cli.ts

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-
-import { existsSync, readdirSync, statSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawnSync } from "node:child_process";
-import { scaffold, ScaffoldError, type ScaffoldOptions } from "./scaffold";
-
-const SCRIPT_DIR = typeof __dirname !== "undefined"
-  ? __dirname
-  : dirname(fileURLToPath(import.meta.url));
-const PACKAGE_ROOT = join(SCRIPT_DIR, "..");
-
-type ParsedArgs = {
-  command: string | null;
-  directory?: string;
-  name?: string;
-  description?: string;
-  author?: string;
-  force: boolean;
-  noInstall: boolean;
-  help: boolean;
-};
-
-function parseArgs(argv: string[]): ParsedArgs {
-  const out: ParsedArgs = {
-    command: null,
-    force: false,
-    noInstall: false,
-    help: false,
-  };
-  const positional: string[] = [];
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i]!;
-    if (arg === "-h" || arg === "--help") {
-      out.help = true;
-    } else if (arg === "--force") {
-      out.force = true;
-    } else if (arg === "--no-install") {
-      out.noInstall = true;
-    } else if (arg === "--name") {
-      out.name = argv[++i];
-    } else if (arg.startsWith("--name=")) {
-      out.name = arg.slice("--name=".length);
-    } else if (arg === "--description") {
-      out.description = argv[++i];
-    } else if (arg.startsWith("--description=")) {
-      out.description = arg.slice("--description=".length);
-    } else if (arg === "--author") {
-      out.author = argv[++i];
-    } else if (arg.startsWith("--author=")) {
-      out.author = arg.slice("--author=".length);
-    } else if (arg.startsWith("--")) {
-      throw new CliError(`Unknown option: ${arg}`);
-    } else {
-      positional.push(arg);
-    }
-  }
-  if (positional.length > 0) out.command = positional[0]!;
-  if (positional.length > 1) out.directory = positional[1];
-  return out;
-}
-
-class CliError extends Error {}
-
-function printHelp(): void {
-  const lines = [
-    "ocps - scaffold a new opencode plugin",
-    "",
-    "Usage:",
-    "  ocps init [directory] --name <package-name> [options]",
-    "",
-    "Options:",
-    "  --name <name>           npm package name for the plugin (required)",
-    "  --description <text>    Short description for package.json and README",
-    "  --author <name>          Copyright author name for LICENSE",
-    "  --force                 Write into a non-empty directory (does not delete existing files)",
-    "  --no-install            Skip running bun install after scaffolding",
-    "  -h, --help              Show this help",
-    "",
-    "Examples:",
-    "  ocps init my-plugin --name opencode-greeter",
-    "  ocps init --name @scope/opencode-greeter --author \"Jane Doe\"",
-  ];
-  process.stdout.write(lines.join("\n") + "\n");
-}
-
-function detectBun(): string | null {
-  const r = spawnSync("bun", ["--version"], { stdio: "ignore" });
-  return r.status === 0 ? "bun" : null;
-}
-
-function runInstall(directory: string, noInstall: boolean): void {
-  if (noInstall) {
-    printNext(directory, false);
-    return;
-  }
-  const bun = detectBun();
-  if (!bun) {
-    process.stdout.write("\nBun was not detected. Next step:\n  cd " + directory + " && bun install\n");
-    return;
-  }
-  process.stdout.write("\nRunning bun install...\n");
-  const r = spawnSync(bun, ["install"], { cwd: directory, stdio: "inherit" });
-  if (r.status !== 0) {
-    process.stdout.write("\nbun install exited with code " + String(r.status) + ". You can retry manually.\n");
-    return;
-  }
-  printNext(directory, true);
-}
-
-function printNext(directory: string, installed: boolean): void {
-  const cd = directory === process.cwd() ? "" : `cd ${directory}\n`;
-  const installLine = installed ? "" : "bun install\n";
-  process.stdout.write(
-    [
-      "",
-      "Done. Next steps:",
-      cd ? "  " + cd.replace(/\n$/, "") : null,
-      "  " + installLine.replace(/\n$/, ""),
-      "  bun test",
-      "  bun run typecheck",
-      "",
-      "Then register the plugin in your opencode.json:",
-      '  { "$schema": "https://opencode.ai/config.json", "plugin": ["<name>"] }',
-      "",
-    ]
-      .filter((l) => l !== null && l !== "" || l === "")
-      .join("\n") + "\n",
-  );
-}
-
-function runInit(args: ParsedArgs): void {
-  if (!args.name) {
-    throw new CliError("Missing required option: --name <package-name>");
-  }
-  const opts: ScaffoldOptions = {
-    name: args.name,
-    directory: args.directory,
-    description: args.description,
-    authorName: args.author,
-    force: args.force,
-  };
-  const result = scaffold(opts, PACKAGE_ROOT);
-  process.stdout.write(
-    `Created ${result.written.length} files in ${result.directory}\n` +
-    `  package:  ${result.name}\n` +
-    `  export:   ${result.exportName}\n`,
-  );
-  runInstall(result.directory, args.noInstall);
-}
-
-function main(): void {
-  let args: ParsedArgs;
-  try {
-    args = parseArgs(process.argv.slice(2));
-  } catch (err) {
-    if (err instanceof CliError) {
-      process.stderr.write(`Error: ${err.message}\n`);
-      process.exitCode = 1;
-      return;
-    }
-    throw err;
-  }
-
-  if (args.help || args.command === null) {
-    printHelp();
-    return;
-  }
-
-  if (args.command !== "init") {
-    process.stderr.write(`Unknown command: ${args.command}\n`);
-    process.stderr.write("Run with --help for usage.\n");
-    process.exitCode = 2;
-    return;
-  }
-
-  try {
-    runInit(args);
-  } catch (err) {
-    if (err instanceof ScaffoldError || err instanceof CliError) {
-      process.stderr.write(`Error: ${err.message}\n`);
-      process.exitCode = 1;
-      return;
-    }
-    throw err;
-  }
-}
-
-main();

package/src/index.ts

@@ -1,10 +0,0 @@
-export { scaffold, ScaffoldError, resolveDirectory, type ScaffoldOptions, type ScaffoldResult } from "./scaffold";
-export {
-  parseName,
-  isValidName,
-  toPascalCase,
-  deriveExportName,
-  derivePluginExportName,
-  type ParsedName,
-} from "./name";
-export { render, listTemplateFiles, defaultTemplateDir, type TemplateVars, type TemplateFile } from "./template-files";

package/src/name.ts

@@ -1,71 +0,0 @@
-/**
- * npm package name validation and TypeScript export name derivation.
- */
-
-const NAME_RE = /^(?:@([a-z0-9][a-z0-9._-]*)\/)?([a-z0-9][a-z0-9._-]*)$/;
-
-export type ParsedName = {
-  raw: string;
-  scope: string | null;
-  local: string;
-};
-
-export function parseName(raw: string): ParsedName | null {
-  const trimmed = raw.trim();
-  if (trimmed.length === 0) return null;
-  if (trimmed.length > 214) return null;
-  const match = NAME_RE.exec(trimmed);
-  if (!match) return null;
-  const scope = match[1] ?? null;
-  const local = match[2]!;
-  if (scope !== null && scope.length > 214) return null;
-  if (local.length > 214) return null;
-  if (trimmed.toLowerCase() === "node_modules" || trimmed.toLowerCase() === "favicon.ico") return null;
-  return { raw: trimmed, scope, local };
-}
-
-export function isValidName(raw: string): boolean {
-  return parseName(raw) !== null;
-}
-
-const RESERVED_WORDS = new Set([
-  "abstract", "await", "boolean", "break", "byte", "case", "catch", "char",
-  "class", "const", "continue", "debugger", "default", "delete", "do", "double",
-  "else", "enum", "export", "extends", "false", "final", "finally", "float",
-  "for", "function", "goto", "if", "implements", "import", "in", "instanceof",
-  "int", "interface", "let", "long", "native", "new", "null", "package", "private",
-  "protected", "public", "return", "short", "static", "super", "switch",
-  "synchronized", "this", "throw", "throws", "transient", "true", "try",
-  "typeof", "var", "void", "volatile", "while", "with", "yield",
-]);
-
-export function toPascalCase(input: string): string {
-  const cleaned = input.replace(/[^a-zA-Z0-9]+/g, " ").trim();
-  if (cleaned.length === 0) return "Plugin";
-  const parts = cleaned.split(/\s+/).filter(Boolean);
-  const pascal = parts
-    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
-    .join("");
-  if (RESERVED_WORDS.has(pascal.toLowerCase())) return `${pascal}Plugin`;
-  if (/^[0-9]/.test(pascal)) return `Plugin${pascal}`;
-  return pascal;
-}
-
-export function deriveExportName(raw: string, opts: { stripScope?: boolean } = {}): string {
-  const parsed = parseName(raw);
-  if (!parsed) return "MyPlugin";
-  const source = opts.stripScope ? parsed.local : (parsed.scope ? `${parsed.scope}-${parsed.local}` : parsed.local);
-  return `${toPascalCase(source)}Plugin`;
-}
-
-export function derivePluginExportName(raw: string): string {
-  const parsed = parseName(raw);
-  if (!parsed) return "MyPlugin";
-  return `${toPascalCase(parsed.local)}Plugin`;
-}
-
-export function sanitizePathSegment(raw: string): string {
-  const parsed = parseName(raw);
-  if (!parsed) return "opencode-plugin";
-  return parsed.scope ? `${parsed.scope}/${parsed.local}` : parsed.local;
-}

package/src/scaffold.ts

@@ -1,94 +0,0 @@
-import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import {
-  derivePluginExportName,
-  parseName,
-  type ParsedName,
-} from "./name";
-import { defaultTemplateDir, listTemplateFiles, render, type TemplateVars } from "./template-files";
-
-export type ScaffoldOptions = {
-  name: string;
-  directory?: string;
-  description?: string;
-  authorName?: string;
-  force?: boolean;
-};
-
-export type ScaffoldResult = {
-  directory: string;
-  written: string[];
-  name: string;
-  exportName: string;
-};
-
-export class ScaffoldError extends Error {}
-
-const IGNORED_EXISTING = new Set([".git", ".DS_Store"]);
-
-function dirIsEmptyOrVcsOnly(dir: string): boolean {
-  if (!existsSync(dir)) return true;
-  const entries = readdirSync(dir).filter((e) => !IGNORED_EXISTING.has(e));
-  return entries.length === 0;
-}
-
-export function resolveDirectory(opts: ScaffoldOptions, parsed: ParsedName): string {
-  if (opts.directory && opts.directory.trim().length > 0) {
-    return resolve(opts.directory);
-  }
-  return resolve(parsed.local);
-}
-
-export function scaffold(
-  opts: ScaffoldOptions,
-  templateRootDir: string,
-  now: Date = new Date(),
-): ScaffoldResult {
-  const parsed = parseName(opts.name);
-  if (!parsed) {
-    throw new ScaffoldError(`Invalid package name: "${opts.name}". Use a valid npm name like "opencode-foo" or "@scope/opencode-foo".`);
-  }
-
-  const directory = resolveDirectory(opts, parsed);
-  if (existsSync(directory) && statSync(directory).isFile()) {
-    throw new ScaffoldError(`Target path exists and is a file: ${directory}`);
-  }
-  if (existsSync(directory) && !statSync(directory).isDirectory()) {
-    throw new ScaffoldError(`Target path is not a directory: ${directory}`);
-  }
-  if (!opts.force && existsSync(directory) && !dirIsEmptyOrVcsOnly(directory)) {
-    throw new ScaffoldError(
-      `Target directory is not empty: ${directory}. Pass --force to overwrite, or choose an empty directory.`,
-    );
-  }
-
-  const exportName = derivePluginExportName(opts.name);
-  const description = (opts.description ?? "An opencode plugin").trim();
-  const year = String(now.getFullYear());
-
-  const vars: TemplateVars = {
-    name: parsed.raw,
-    exportName,
-    description,
-    year,
-    authorName: opts.authorName ?? parsed.local,
-  };
-
-  const templateDir = defaultTemplateDir(templateRootDir);
-  if (!existsSync(templateDir)) {
-    throw new ScaffoldError(`Template directory not found: ${templateDir}`);
-  }
-
-  const files = listTemplateFiles(templateDir);
-  const written: string[] = [];
-
-  for (const file of files) {
-    const target = join(directory, file.relative);
-    mkdirSync(dirname(target), { recursive: true });
-    const body = render(file.content, vars);
-    writeFileSync(target, body);
-    written.push(file.relative);
-  }
-
-  return { directory, written, name: parsed.raw, exportName };
-}

package/src/template-files.ts

@@ -1,55 +0,0 @@
-import { readdirSync, readFileSync, statSync } from "node:fs";
-import { join, relative, sep } from "node:path";
-
-export type TemplateVars = {
-  name: string;
-  exportName: string;
-  description: string;
-  year: string;
-  repository?: string;
-  authorName?: string;
-};
-
-const PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g;
-
-export function render(content: string, vars: TemplateVars): string {
-  return content.replace(PLACEHOLDER_RE, (match, key: string) => {
-    if (key === "name") return vars.name;
-    if (key === "exportName") return vars.exportName;
-    if (key === "description") return vars.description;
-    if (key === "year") return vars.year;
-    if (key === "repository") return vars.repository ?? "";
-    if (key === "authorName") return vars.authorName ?? "";
-    return match;
-  });
-}
-
-export type TemplateFile = {
-  relative: string;
-  content: string;
-};
-
-export function listTemplateFiles(templateDir: string): TemplateFile[] {
-  const results: TemplateFile[] = [];
-  const walk = (dir: string) => {
-    for (const entry of readdirSync(dir)) {
-      const full = join(dir, entry);
-      const st = statSync(full);
-      if (st.isDirectory()) {
-        walk(full);
-        continue;
-      }
-      const rel = relative(templateDir, full).split(sep).join("/");
-      const content = readFileSync(full, "utf-8");
-      const stripped = rel.endsWith(".tpl") ? rel.slice(0, -".tpl".length) : rel;
-      const target = stripped === "gitignore" ? ".gitignore" : stripped;
-      results.push({ relative: target, content });
-    }
-  };
-  walk(templateDir);
-  return results.sort((a, b) => a.relative.localeCompare(b.relative));
-}
-
-export function defaultTemplateDir(rootDir: string): string {
-  return join(rootDir, "templates", "default");
-}