@biffo/cli 0.318.4 → 0.319.0

package/dist/index.js

@@ -9835,6 +9835,9 @@ var pluginInstallCommand = new Command15("install").description(
   "--local <path>",
   "Install from a local, unpublished plugin directory instead of the registry"
 ).option("--dry-run", "Resolve the plugin and print planned changes without modifying the repo").option("--cwd <path>", "Project root to install into (defaults to the current directory)").option(
+  "--frontend-cwd <path>",
+  "Dashboard sibling checkout to write the user_frontend dashboard-registry entry into, when the core project and its dashboard are split siblings (biffo-template#2012) \u2014 e.g. biffo-platform / biffo-platform-app. Every other write (backend scaffolding, Terraform, the migration, the manifest) still resolves against --cwd only. Omit it for the common single-repo topology, where the registry entry is written into --cwd as before. Ignored for a plugin manifest with no user_frontend block, since there is nothing to register."
+).option(
   "--config <name=value>",
   "Supply an instance value for one manifest `config:` declaration (biffo-template#1517) \u2014 repeatable. For a 'secret' declaration, value must be an SSM parameter PATH, never the credential itself.",
   (value, previous) => [...previous, value],
@@ -9849,6 +9852,7 @@ var pluginInstallCommand = new Command15("install").description(
           ...options.local ? { local: resolve12(options.local) } : {},
           dryRun: options.dryRun ?? false,
           cwd,
+          ...options.frontendCwd ? { frontendCwd: resolve12(options.frontendCwd) } : {},
           config: parseConfigOptionValues(options.config)
         },
         {
@@ -9947,6 +9951,7 @@ async function runPluginInstall(target, options, deps) {
   const relTargetDir = pluginDir(pluginName, "third-party");
   const targetDir = join34(options.cwd, relTargetDir);
   const modulesDir = join34(options.cwd, "modules", "plugins", pluginName);
+  const registryCwd = options.frontendCwd ?? options.cwd;
   const inTreeSource = options.local !== void 0 && resolve12(options.local) === resolve12(targetDir);
   if (existsSync32(targetDir) && !inTreeSource) {
     throw new Error(
@@ -9954,7 +9959,14 @@ async function runPluginInstall(target, options, deps) {
     );
   }
   if (options.dryRun) {
-    printDryRun4(entry, source, relTargetDir, inTreeSource, options.config ?? {});
+    printDryRun4(
+      entry,
+      source,
+      relTargetDir,
+      inTreeSource,
+      options.config ?? {},
+      options.frontendCwd
+    );
     return;
   }
   const isRepo = await deps.git.isGitRepo(options.cwd);
@@ -9993,7 +10005,15 @@ async function runPluginInstall(target, options, deps) {
       throw new Error(missingRequiredConfigMessage(pluginName, configSupply.missingRequired));
     }
     if (manifest.user_frontend) {
-      assertPluginRegistryReady(options.cwd, pluginName);
+      if (options.frontendCwd) {
+        const frontendIsRepo = await deps.git.isGitRepo(registryCwd);
+        if (!frontendIsRepo) {
+          throw new Error(
+            `${registryCwd} (--frontend-cwd) is not a git repository \u2014 biffo plugin install must write the dashboard registry into a real checkout.`
+          );
+        }
+      }
+      assertPluginRegistryReady(registryCwd, pluginName);
     }
     if (inTreeSource) {
       log.info(`${relTargetDir}/ is already in this checkout \u2014 installing in place.`);
@@ -10079,13 +10099,22 @@ async function runPluginInstall(target, options, deps) {
       );
     }
     if (manifest.user_frontend) {
-      upsertPluginRegistryEntry(options.cwd, {
+      upsertPluginRegistryEntry(registryCwd, {
         slug: pluginName,
         title: titleFromSlug(pluginName),
         frontendUrl: frontendUrlForSlug(pluginName)
       });
-      stagePaths.push(PLUGIN_REGISTRY_RELATIVE_PATH);
-      log.success(`Registered ${pluginName} in ${PLUGIN_REGISTRY_RELATIVE_PATH}`);
+      if (options.frontendCwd) {
+        const dashboardCommitMessage = `feat(plugins): register ${pluginName}@${source.version} in dashboard`;
+        await deps.git.add(registryCwd, [PLUGIN_REGISTRY_RELATIVE_PATH]);
+        await deps.git.commit(registryCwd, dashboardCommitMessage);
+        log.success(
+          `Registered ${pluginName} in ${registryCwd}/${PLUGIN_REGISTRY_RELATIVE_PATH} (committed there: "${dashboardCommitMessage}")`
+        );
+      } else {
+        stagePaths.push(PLUGIN_REGISTRY_RELATIVE_PATH);
+        log.success(`Registered ${pluginName} in ${PLUGIN_REGISTRY_RELATIVE_PATH}`);
+      }
     }
     const commitMessage = `feat(plugins): install ${pluginName}@${source.version}`;
     await deps.git.add(options.cwd, stagePaths);
@@ -10093,8 +10122,16 @@ async function runPluginInstall(target, options, deps) {
     log.success(`Committed: ${commitMessage}`);
     console.log(chalk15.bold("\n  Plugin installed!\n"));
     console.log(`  ${pluginName}@${source.version} is committed at ${relTargetDir}/`);
+    if (manifest.user_frontend && options.frontendCwd) {
+      console.log(
+        `  Its dashboard registration is committed separately at ${registryCwd}/${PLUGIN_REGISTRY_RELATIVE_PATH}.`
+      );
+    }
     console.log("  Push and redeploy to apply its migration and register its routes:");
     console.log(chalk15.dim(`    git push`));
+    if (manifest.user_frontend && options.frontendCwd) {
+      console.log(chalk15.dim(`    (and, in ${registryCwd}) git push`));
+    }
     console.log(chalk15.dim(`    biffo deploy <environment> --app-only
 `));
     printConfigWiringInstructions(pluginName, configSupply.resolved);
@@ -10126,7 +10163,7 @@ function parseManifestFile(path) {
     throw new Error(`Could not parse ${path} as JSON: ${err.message}`);
   }
 }
-function printDryRun4(entry, source, relTargetDir, inTreeSource, suppliedConfig = {}) {
+function printDryRun4(entry, source, relTargetDir, inTreeSource, suppliedConfig = {}, frontendCwd) {
   const name = entry ? entry.name : source.name;
   const version = entry ? entry.version : source.version;
   console.log(chalk15.bold("\n  Dry run \u2014 no changes will be made\n"));
@@ -10158,6 +10195,11 @@ function printDryRun4(entry, source, relTargetDir, inTreeSource, suppliedConfig
       `  Would vendor seed DDL into: ${pluginSeedImportDir(name)}/ (baseline_tables: ${source.manifest.seed.baseline_tables.join(", ") || "none declared"})`
     );
   }
+  if (source && source.manifest.user_frontend) {
+    console.log(
+      frontendCwd ? `  Would register in dashboard at: ${frontendCwd}/${PLUGIN_REGISTRY_RELATIVE_PATH} (separate --frontend-cwd checkout, committed there)` : `  Would register in dashboard at: ${PLUGIN_REGISTRY_RELATIVE_PATH}`
+    );
+  }
   if (source && source.manifest.config.length > 0) {
     const { resolved, missingRequired } = resolvePluginConfigSupply(
       name,

package/package.json

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

package/scripts/verify.sh

@@ -1527,6 +1527,16 @@ fi
 [ -f scripts/rerun-on-runner-loss.test.sh ] &&
   run_check rerun-on-runner-loss sh scripts/rerun-on-runner-loss.test.sh
 
+# Same shape again (#2076): stubs `gh` on PATH and runs the extracted
+# plugin-staleness filing step, discovery loop and tagger against fixtures,
+# so no network and no Actions run. Needs `node`, which every JS-backed check
+# above already needs. Measured here: ~0.4s. It belongs in the local gate for
+# the same reason rerun-on-runner-loss does -- plugin-staleness-report.yml is
+# a scheduled workflow, so the pull request that changes it never runs it, and
+# this self-test is the only thing that sees the change before it is live.
+[ -f scripts/plugin-staleness-target-repo.test.sh ] &&
+  run_check plugin-staleness-target-repo sh scripts/plugin-staleness-target-repo.test.sh
+
 # The DDL module-number allocator's own race-freedom proof (#1886): races real
 # `git` processes against throwaway local bare repos (never a mock of git, and
 # never /tmp -- repo-local scratch dirs cleaned up by its own trap), so it needs