@biffo/cli 0.164.0 → 0.165.0

package/dist/index.js

@@ -6661,7 +6661,8 @@ function applySubstitutions(text, names) {
   return out;
 }
 var BINARY_EXTENSIONS = /\.(png|jpe?g|gif|ico|woff2?|ttf|zip|gz)$/i;
-function scaffoldPlugin(skeletonRoot, destDir, names) {
+function scaffoldPlugin(skeletonRoot, destDir, names, options = {}) {
+  const layout = options.layout ?? "in-tree";
   if (!existsSync22(skeletonRoot)) {
     throw new Error(`Plugin skeleton not found at ${skeletonRoot}`);
   }
@@ -6678,7 +6679,7 @@ function scaffoldPlugin(skeletonRoot, destDir, names) {
       (a, b) => a.name.localeCompare(b.name)
     )) {
       if (NEVER_COPY.has(entry.name)) continue;
-      if (relDir === "" && entry.name in STANDALONE_ONLY_ENTRIES) {
+      if (layout === "in-tree" && relDir === "" && entry.name in STANDALONE_ONLY_ENTRIES) {
         skipped.push({ entry: entry.name, reason: STANDALONE_ONLY_ENTRIES[entry.name] });
         continue;
       }
@@ -6724,6 +6725,9 @@ function findSkeletonRoot(startDir, skeleton) {
 var pluginCreateCommand = new Command13("create").description("Scaffold a new plugin from the Biffo plugin skeleton: biffo plugin create <name>").argument("<name>", "Plugin name \u2014 lowercase kebab-case, e.g. acme-crm").option(
   "--first-party",
   "Scaffold into the template-owned services/_plugins/ carve-out. Only valid in the biffo-template repo itself \u2014 see notes."
+).option(
+  "--standalone",
+  "Scaffold a standalone plugin repo (ADR-0003 section 2) into ./biffo-plugin-<name>/ instead of into this checkout, keeping its own CI/CD workflows"
 ).option(
   "--skeleton <path>",
   "Path to the plugin skeleton (defaults to _skeletons/plugin-template)"
@@ -6735,6 +6739,7 @@ var pluginCreateCommand = new Command13("create").description("Scaffold a new pl
         name,
         {
           firstParty: options.firstParty ?? false,
+          standalone: options.standalone ?? false,
           ...options.skeleton ? { skeletonRoot: resolve11(options.skeleton) } : {},
           dryRun: options.dryRun ?? false,
           commit: options.commit !== false,
@@ -6750,6 +6755,15 @@ var pluginCreateCommand = new Command13("create").description("Scaffold a new pl
 );
 async function runPluginCreate(name, options, deps) {
   const names = deriveNames(name);
+  if (options.standalone) {
+    if (options.firstParty) {
+      throw new Error(
+        "--standalone and --first-party are opposites: --first-party authors a plugin *inside* the template at services/_plugins/, while --standalone authors one in its own repository (ADR-0003 section 2). Pick one."
+      );
+    }
+    await runStandaloneCreate(names, options, deps);
+    return;
+  }
   const isInstance = existsSync23(join23(options.cwd, INSTANCE_CORE_FILE));
   if (options.firstParty && isInstance) {
     throw new Error(
@@ -6808,6 +6822,78 @@ async function runPluginCreate(name, options, deps) {
   }
   printNextSteps(names, relDir, channel);
 }
+async function runStandaloneCreate(names, options, deps) {
+  const destDir = join23(options.cwd, names.dist);
+  if (existsSync23(destDir)) {
+    throw new Error(`${names.dist}/ already exists. Choose a different name, or remove it first.`);
+  }
+  const skeletonRoot = resolveSkeletonRoot(options);
+  if (options.dryRun) {
+    console.log(chalk13.bold("\n  Dry run \u2014 no changes will be made\n"));
+    console.log(`  Plugin:          ${names.slug}`);
+    console.log("  Channel:         standalone repo");
+    console.log(`  Would scaffold:  ${names.dist}/`);
+    console.log(`  From skeleton:   ${skeletonRoot}`);
+    console.log(`  Python package:  ${names.pkg}   (dist: ${names.dist})`);
+    console.log("  Would git init:  yes, on branch dev, with an initial commit\n");
+    return;
+  }
+  const { files } = scaffoldPlugin(skeletonRoot, destDir, names, { layout: "standalone" });
+  restorePackagedDotfiles(destDir);
+  log.success(`Scaffolded ${String(files.length)} file(s) into ${names.dist}/`);
+  const manifest = validateManifest(
+    JSON.parse(readFileSync17(join23(destDir, "biffo.plugin.json"), "utf8"))
+  );
+  if (manifest.name !== names.slug) {
+    throw new Error(
+      `Scaffolded manifest declares name '${manifest.name}', expected '${names.slug}'. The skeleton's manifest name may have diverged from 'example-plugin'.`
+    );
+  }
+  log.success(
+    `Manifest valid \u2014 ${String(manifest.tables.length)} table(s), ${String(manifest.api_routes.length)} route(s)`
+  );
+  if (options.commit) {
+    await deps.git.init(destDir);
+    await deps.git.add(destDir, ["."]);
+    await deps.git.commit(destDir, `feat: scaffold ${names.slug} plugin`);
+    log.success(`Initialised a git repo on dev with an initial commit`);
+  }
+  printStandaloneNextSteps(names, minorOf(manifest.version));
+}
+function minorOf(version) {
+  const match = /^(\d+)\.(\d+)/.exec(version);
+  return match ? `${match[1]}.${match[2]}` : version;
+}
+function printStandaloneNextSteps(names, minor) {
+  console.log(chalk13.bold("\n  Standalone plugin repo scaffolded!\n"));
+  console.log(`  ${names.dist}/ is a complete plugin repository: manifest, example table and`);
+  console.log("  routes, terraform/ module, and its own CI, release and registry workflows.\n");
+  console.log("  Next:");
+  console.log(chalk13.dim(`    1. cd ${names.dist} && edit biffo.plugin.json`));
+  console.log(
+    chalk13.dim("    2. Create the repo \u2014 plugin repos are dev-only (AGENTS.md section 2):")
+  );
+  console.log(chalk13.dim(`         gh repo create <org>/${names.dist} --private --source=. --push`));
+  console.log(
+    chalk13.dim("         gh api -X PATCH repos/<org>/" + names.dist + " -f default_branch=dev")
+  );
+  console.log(chalk13.dim("    3. Publish it to the registry so it appears in the plugin store:"));
+  console.log(chalk13.dim("         see .github/workflows/publish-registry.yml in the new repo"));
+  console.log(
+    chalk13.dim(`    4. Consumers install it with: biffo plugin install ${names.slug}@${minor}
+`)
+  );
+}
+function resolveSkeletonRoot(options) {
+  const here = dirname8(fileURLToPath5(import.meta.url));
+  const skeletonRoot = options.skeletonRoot ?? findSkeletonRoot(here, "plugin-template") ?? join23(options.cwd, "_skeletons", "plugin-template");
+  if (!existsSync23(skeletonRoot)) {
+    throw new Error(
+      `Could not find the plugin skeleton (_skeletons/plugin-template/). Pass --skeleton <path> to point at it explicitly.`
+    );
+  }
+  return skeletonRoot;
+}
 function printDryRun3(names, relDir, skeletonRoot, channel) {
   console.log(chalk13.bold("\n  Dry run \u2014 no changes will be made\n"));
   console.log(`  Plugin:          ${names.slug}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@biffo/cli",
-  "version": "0.164.0",
+  "version": "0.165.0",
   "description": "Biffo project scaffolding CLI",
   "license": "MIT",
   "type": "module",