@hachej/boring-ui-plugin-cli 0.1.31 → 0.1.32

package/dist/chunk-MNNNQ7Y7.js

@@ -1,565 +0,0 @@
-// src/server/index.ts
-import { join as join3, resolve as resolve3 } from "path";
-
-// src/server/scaffoldPlugin.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join, resolve } from "path";
-import { fileURLToPath } from "url";
-var KEBAB_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
-function scaffoldPlugin(opts) {
-  if (!KEBAB_RE.test(opts.name)) {
-    throw new Error(
-      `invalid plugin name "${opts.name}" \u2014 must be kebab-case (e.g. "my-plugin")`
-    );
-  }
-  const workspaceRoot = resolve(opts.workspaceRoot);
-  const pluginDir = join(workspaceRoot, ".pi", "extensions", opts.name);
-  mkdirSync(join(workspaceRoot, ".pi", "extensions"), { recursive: true });
-  try {
-    mkdirSync(pluginDir, { recursive: false });
-  } catch (error) {
-    const code = error.code;
-    if (code === "EEXIST") {
-      throw new Error(`plugin already exists at ${pluginDir}`);
-    }
-    throw error;
-  }
-  const templatesDir = opts.templatesDir ?? resolveBundledTemplatesDir();
-  if (!templatesDir) {
-    throw new Error(
-      "could not locate bundled plugin templates \u2014 pass `templatesDir` explicitly. (this usually indicates a broken @hachej/boring-ui-plugin-cli install)"
-    );
-  }
-  const tplFront = join(templatesDir, "front-canonical.tsx");
-  const tplPackage = join(templatesDir, "package-canonical.json");
-  for (const tpl of [tplFront, tplPackage]) {
-    if (!existsSync(tpl)) {
-      throw new Error(`canonical template missing: ${tpl}`);
-    }
-  }
-  const label = labelFromName(opts.name);
-  const filesCreated = [];
-  const write = (relPath, contents) => {
-    const target = join(pluginDir, relPath);
-    mkdirSync(join(target, ".."), { recursive: true });
-    writeFileSync(target, contents, "utf8");
-    filesCreated.push(target);
-  };
-  const pkgRaw = JSON.parse(readFileSync(tplPackage, "utf8"));
-  delete pkgRaw._doc_;
-  const pkgJson = substitute(JSON.stringify(pkgRaw, null, 2), opts.name, label);
-  write("package.json", `${pkgJson}
-`);
-  const frontSource = substitute(readFileSync(tplFront, "utf8"), opts.name, label);
-  write("front/index.tsx", frontSource);
-  write(".gitignore", "# Machine-managed sidecars written by the boring-ui plugin runtime.\n.boring-signature.json\n");
-  return { pluginDir, filesCreated };
-}
-function labelFromName(name) {
-  return name.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
-}
-function substitute(source, name, label) {
-  const paneName = `${pascalCase(name)}Pane`;
-  return source.replaceAll("<kebab-name>", name).replaceAll("&lt;kebab-name&gt;", name).replaceAll("<Label>", label).replaceAll(/\bMyPane\b/g, paneName);
-}
-function pascalCase(name) {
-  return name.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
-}
-function resolveBundledTemplatesDir() {
-  const here = dirname(fileURLToPath(import.meta.url));
-  const candidates = [
-    resolve(here, "..", "templates"),
-    resolve(here, "..", "..", "templates")
-  ];
-  return candidates.find((candidate) => existsSync(candidate));
-}
-
-// src/server/verifyPlugin.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2, realpathSync, statSync } from "fs";
-import { isAbsolute, join as join2, relative, resolve as resolve2 } from "path";
-
-// src/manifest.ts
-var SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-var PLUGIN_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
-function isValidBoringPluginId(id) {
-  return typeof id === "string" && id.length > 0 && PLUGIN_ID_RE.test(id);
-}
-function isSafePluginRelativePath(value) {
-  return typeof value === "string" && value.length > 0 && value !== "." && !value.includes("\0") && !value.includes("\\") && !value.startsWith("/") && !value.startsWith("//") && !/^[A-Za-z]:[\\/]/.test(value) && !value.split("/").includes("..");
-}
-function issue(code, field, message) {
-  return { code, field, message };
-}
-function isRecord(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function validateStringArray(issues, value, field, pathLike) {
-  if (value === void 0) return;
-  if (!Array.isArray(value)) {
-    issues.push(issue("INVALID_FIELD", field, `${field} must be an array`));
-    return;
-  }
-  value.forEach((entry, index) => {
-    const itemField = `${field}[${index}]`;
-    if (typeof entry !== "string" || entry.length === 0) {
-      issues.push(issue("INVALID_FIELD", itemField, `${itemField} must be a non-empty string`));
-      return;
-    }
-    if (pathLike && !isSafePluginRelativePath(entry)) {
-      issues.push(issue("INVALID_PATH", itemField, `${itemField} must be a safe relative path`));
-    }
-  });
-}
-var REMOVED_BORING_UI_FIELDS = ["outputs", "panels", "commands", "leftTabs", "surfaceResolvers", "providers", "bindings", "catalogs"];
-function validateBoringField(issues, boring) {
-  if (boring === void 0) return void 0;
-  if (!isRecord(boring)) {
-    issues.push(issue("INVALID_FIELD", "boring", "boring must be an object when provided"));
-    return void 0;
-  }
-  for (const field of REMOVED_BORING_UI_FIELDS) {
-    if (boring[field] !== void 0) {
-      issues.push(issue(
-        "INVALID_FIELD",
-        `boring.${field}`,
-        `boring.${field} is not supported; declare front contributions in boring.front via definePlugin({ ... })`
-      ));
-    }
-  }
-  if (boring.id !== void 0 && (typeof boring.id !== "string" || !isValidBoringPluginId(boring.id))) {
-    issues.push(issue("INVALID_ID", "boring.id", "boring.id must start with a letter or number and use only letters, numbers, dot, underscore, colon, or dash"));
-  }
-  const front = boring.front;
-  if (front !== void 0 && (typeof front !== "string" || !isSafePluginRelativePath(front))) {
-    issues.push(issue("INVALID_PATH", "boring.front", "boring.front must be a safe relative path"));
-  }
-  const server = boring.server;
-  if (server !== void 0 && server !== false && (typeof server !== "string" || !isSafePluginRelativePath(server))) {
-    issues.push(issue("INVALID_PATH", "boring.server", "boring.server must be a safe relative path or false"));
-  }
-  if (boring.label !== void 0 && typeof boring.label !== "string") {
-    issues.push(issue("INVALID_FIELD", "boring.label", "boring.label must be a string when provided"));
-  }
-  return {
-    ...typeof boring.id === "string" ? { id: boring.id } : {},
-    ...typeof boring.front === "string" ? { front: boring.front } : {},
-    ...typeof boring.server === "string" || boring.server === false ? { server: boring.server } : {},
-    ...typeof boring.label === "string" ? { label: boring.label } : {}
-  };
-}
-var REMOTE_PI_PACKAGE_PREFIXES = ["npm:", "git:", "github:", "http:", "https:", "ssh:"];
-function isRemotePiPackageSource(value) {
-  return REMOTE_PI_PACKAGE_PREFIXES.some((prefix) => value.startsWith(prefix));
-}
-function isSafePiPackageSource(value) {
-  if (value.length === 0) return false;
-  if (isRemotePiPackageSource(value)) return true;
-  const path = value.startsWith("file:") ? value.slice("file:".length) : value;
-  if (path === "." || path === "./") return true;
-  const normalized = path.startsWith("./") ? path.slice(2) : path;
-  return isSafePluginRelativePath(normalized);
-}
-function validatePiPackages(issues, value) {
-  if (value === void 0) return;
-  if (!Array.isArray(value)) {
-    issues.push(issue("INVALID_FIELD", "pi.packages", "pi.packages must be an array when provided"));
-    return;
-  }
-  value.forEach((entry, index) => {
-    const field = `pi.packages[${index}]`;
-    if (typeof entry === "string") {
-      if (!isSafePiPackageSource(entry)) {
-        issues.push(issue("INVALID_PATH", field, `${field} must be a safe package source`));
-      }
-      return;
-    }
-    if (!isRecord(entry)) {
-      issues.push(issue("INVALID_FIELD", field, `${field} must be a string or package source object`));
-      return;
-    }
-    if (typeof entry.source !== "string" || entry.source.length === 0) {
-      issues.push(issue("INVALID_FIELD", `${field}.source`, `${field}.source must be a non-empty string`));
-    } else if (!isSafePiPackageSource(entry.source)) {
-      issues.push(issue("INVALID_PATH", `${field}.source`, `${field}.source must be a safe package source`));
-    }
-  });
-}
-function validatePiField(issues, pi) {
-  if (pi === void 0) return void 0;
-  if (!isRecord(pi)) {
-    issues.push(issue("INVALID_FIELD", "pi", "pi must be an object when provided"));
-    return void 0;
-  }
-  validateStringArray(issues, pi.extensions, "pi.extensions", true);
-  validateStringArray(issues, pi.skills, "pi.skills", true);
-  validatePiPackages(issues, pi.packages);
-  if (pi.systemPrompt !== void 0 && typeof pi.systemPrompt !== "string") {
-    issues.push(issue("INVALID_FIELD", "pi.systemPrompt", "pi.systemPrompt must be a string when provided"));
-  }
-  return pi;
-}
-function validateBoringPluginManifest(raw) {
-  const issues = [];
-  if (!isRecord(raw)) {
-    return {
-      valid: false,
-      issues: [issue("INVALID_FIELD", "<root>", "package.json manifest must be an object")]
-    };
-  }
-  if (raw.name !== void 0 && typeof raw.name !== "string") {
-    issues.push(issue("INVALID_FIELD", "name", "name must be a string when provided"));
-  }
-  if (raw.version !== void 0 && typeof raw.version !== "string") {
-    issues.push(issue("INVALID_VERSION", "version", "version must be a string when provided"));
-  } else if (typeof raw.version === "string" && raw.version.length > 0 && !SEMVER_RE.test(raw.version)) {
-    issues.push(issue("INVALID_VERSION", "version", "version must be a valid semver string"));
-  }
-  const boring = validateBoringField(issues, raw.boring);
-  const pi = validatePiField(issues, raw.pi);
-  if (!boring && !pi) {
-    issues.push(issue("MISSING_REQUIRED_FIELD", "boring|pi", "package.json must include boring and/or pi plugin metadata"));
-  }
-  if (issues.length > 0) return { valid: false, issues };
-  return {
-    valid: true,
-    packageJson: {
-      ...typeof raw.name === "string" ? { name: raw.name } : {},
-      ...typeof raw.version === "string" ? { version: raw.version } : {},
-      ...boring ? { boring } : {},
-      ...pi ? { pi } : {}
-    }
-  };
-}
-
-// src/server/verifyPlugin.ts
-function pluginFileSignature(path) {
-  if (!path || !existsSync2(path)) return "missing";
-  const stat = statSync(path);
-  return `${stat.mtimeMs}:${stat.size}`;
-}
-function readPluginSignatureCache(pluginRootDir) {
-  const path = join2(pluginRootDir, ".boring-signature.json");
-  if (!existsSync2(path)) return null;
-  let parsed;
-  try {
-    parsed = JSON.parse(readFileSync2(path, "utf8"));
-  } catch {
-    return null;
-  }
-  if (!parsed || typeof parsed !== "object") return null;
-  const obj = parsed;
-  if (obj.version !== 1) return null;
-  const sig = obj.serverSignature;
-  if (sig !== null && typeof sig !== "string") return null;
-  const loadedAt = typeof obj.loadedAt === "number" ? obj.loadedAt : 0;
-  return { version: 1, serverSignature: sig, loadedAt };
-}
-function verifyPlugin(opts) {
-  const workspaceRoot = resolve2(opts.workspaceRoot);
-  const extensionsDir = join2(workspaceRoot, ".pi", "extensions");
-  if (!existsSync2(extensionsDir)) {
-    return {
-      outcomes: [],
-      ok: true,
-      extensionsDir,
-      extensionsDirMissing: true
-    };
-  }
-  const targets = [];
-  if (opts.name) {
-    const dir = join2(extensionsDir, opts.name);
-    if (!existsSync2(dir)) {
-      return {
-        outcomes: [
-          { id: opts.name, dir, ok: false, errors: [`plugin directory not found: ${dir}`], warnings: [] }
-        ],
-        ok: false,
-        extensionsDir,
-        extensionsDirMissing: false
-      };
-    }
-    targets.push(dir);
-  } else {
-    for (const entry of readdirSync(extensionsDir, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue;
-      if (entry.name.startsWith(".") || entry.name.startsWith("preflight-")) continue;
-      targets.push(join2(extensionsDir, entry.name));
-    }
-  }
-  const outcomes = targets.map((dir) => verifySinglePlugin(dir));
-  return {
-    outcomes,
-    ok: outcomes.every((o) => o.ok),
-    extensionsDir,
-    extensionsDirMissing: false
-  };
-}
-function isInsideRoot(rootReal, targetReal) {
-  const rel = relative(rootReal, targetReal);
-  return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
-}
-function resolveExistingContainedPath(pluginDir, value, field) {
-  if (!isSafePluginRelativePath(value)) {
-    return { path: null, error: `${field} must be a safe relative path inside the plugin root: ${JSON.stringify(value)}` };
-  }
-  const abs = resolve2(pluginDir, value);
-  if (!existsSync2(abs)) return { path: null, error: `${field} points at "${value}" but that file does not exist (looked at ${abs})` };
-  const rootReal = realpathSync(pluginDir);
-  const targetReal = realpathSync(abs);
-  if (!isInsideRoot(rootReal, targetReal)) {
-    return { path: null, error: `${field} points at "${value}" but resolves outside the plugin root (looked at ${abs})` };
-  }
-  return { path: targetReal };
-}
-function verifySinglePlugin(pluginDir) {
-  const id = pluginDir.split(/[\\/]/).pop() ?? "<unknown>";
-  const errors = [];
-  const warnings = [];
-  const pkgPath = join2(pluginDir, "package.json");
-  if (!existsSync2(pkgPath)) {
-    return { id, dir: pluginDir, ok: false, errors: ["package.json missing"], warnings };
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(readFileSync2(pkgPath, "utf8"));
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return { id, dir: pluginDir, ok: false, errors: [`package.json is not valid JSON: ${message}`], warnings };
-  }
-  const result = validateBoringPluginManifest(parsed);
-  if (!result.valid) {
-    for (const issue2 of result.issues) errors.push(formatIssue(issue2));
-    return { id, dir: pluginDir, ok: false, errors, warnings };
-  }
-  const manifest = result.packageJson;
-  const boring = manifest.boring;
-  if (boring?.front) {
-    const resolved = resolveExistingContainedPath(pluginDir, boring.front, "boring.front");
-    if (resolved.error) errors.push(resolved.error);
-  }
-  let serverPathAbs = null;
-  if (typeof boring?.server === "string") {
-    const resolved = resolveExistingContainedPath(pluginDir, boring.server, "boring.server");
-    if (resolved.error) {
-      errors.push(resolved.error);
-    } else {
-      serverPathAbs = resolved.path;
-      warnings.push(
-        "boring.server file is valid, but workspace server entries are boot-time/static composition only. /reload does not import or register .pi/extensions server routes/agentTools; restart the workspace with this package passed via defaultPluginPackages or explicit plugins to activate server code."
-      );
-    }
-  }
-  const cache = readPluginSignatureCache(pluginDir);
-  if (cache) {
-    const currentServerSig = serverPathAbs ? pluginFileSignature(serverPathAbs) : null;
-    const cachedSig = cache.serverSignature;
-    if (cachedSig !== currentServerSig) {
-      warnings.push(
-        "server file changed since the workspace last loaded this plugin \u2014 /reload will hot-swap the front, but routes and agent tools stay on the previously loaded code. Stop and restart the workspace process (Ctrl-C, then re-run your dev command) to pick up the new code."
-      );
-    }
-  }
-  const piExt = manifest.pi?.extensions;
-  if (Array.isArray(piExt)) {
-    for (const ext of piExt) {
-      if (typeof ext !== "string") continue;
-      const resolved = resolveExistingContainedPath(pluginDir, ext, "pi.extensions entry");
-      if (resolved.error) errors.push(resolved.error);
-    }
-  }
-  const piSkills = manifest.pi?.skills;
-  if (Array.isArray(piSkills)) {
-    for (const skill of piSkills) {
-      if (typeof skill !== "string") continue;
-      const resolved = resolveExistingContainedPath(pluginDir, skill, "pi.skills entry");
-      if (resolved.error) errors.push(resolved.error);
-    }
-  }
-  return { id, dir: pluginDir, ok: errors.length === 0, errors, warnings };
-}
-function formatIssue(issue2) {
-  return `${issue2.code}: ${issue2.field}: ${issue2.message}`;
-}
-function formatVerifyResult(result) {
-  if (result.extensionsDirMissing) {
-    return [
-      `WARNING \u2014 no plugins to verify. Scanned: ${result.extensionsDir} (directory does not exist).`,
-      "",
-      "If you just wrote a plugin: check that you put it under THIS workspace's `.pi/extensions/` and not a different cwd. The scanned path above is `<cwd>/.pi/extensions/`."
-    ].join("\n");
-  }
-  if (result.outcomes.length === 0) {
-    return [
-      `WARNING \u2014 scanned ${result.extensionsDir} but found NO plugin directories.`,
-      "",
-      "If you just wrote a plugin: it is NOT in this dir. Either you wrote to a different `.pi/extensions/` (check your cwd), or the dir name starts with `.` / `preflight-` (skipped)."
-    ].join("\n");
-  }
-  const lines = [];
-  const failures = result.outcomes.filter((o) => !o.ok);
-  const withWarnings = result.outcomes.filter((o) => o.warnings.length > 0);
-  if (failures.length === 0) {
-    lines.push(`OK \u2014 ${result.outcomes.length} plugin(s) have valid manifests + present files. (scanned ${result.extensionsDir})`);
-    for (const outcome of result.outcomes) {
-      const tag = outcome.warnings.length > 0 ? "\u26A0" : "\u2713";
-      lines.push(`  ${tag} ${outcome.id}`);
-      for (const w of outcome.warnings) {
-        lines.push(`      WARN: ${w}`);
-      }
-    }
-    lines.push("");
-    if (withWarnings.length > 0) {
-      const n = withWarnings.length;
-      lines.push(`Manifests are valid, but ${n} plugin${n === 1 ? "" : "s"} need a workspace restart (NOT just /reload) to pick up server-side changes \u2014 see WARN lines above.`);
-      lines.push("");
-    }
-    lines.push("Note: this validator does NOT execute plugin code. Front/Pi syntax / type / runtime errors surface on /reload; boring.server files require static composition plus a process restart.");
-  } else {
-    lines.push(`FAILED \u2014 ${failures.length} of ${result.outcomes.length} plugin(s) have errors.  (scanned ${result.extensionsDir})`);
-    lines.push("");
-    for (const outcome of result.outcomes) {
-      if (outcome.ok) {
-        const tag = outcome.warnings.length > 0 ? "\u26A0" : "\u2713";
-        lines.push(`  ${tag} ${outcome.id}`);
-        for (const w of outcome.warnings) {
-          lines.push(`      WARN: ${w}`);
-        }
-      } else {
-        lines.push(`  \u2717 ${outcome.id}  (${outcome.dir})`);
-        for (const err of outcome.errors) {
-          lines.push(`      ${err}`);
-        }
-        for (const w of outcome.warnings) {
-          lines.push(`      WARN: ${w}`);
-        }
-      }
-    }
-    lines.push("");
-    lines.push("Fix the errors above and run `boring-ui-plugin verify` again. Once it reports OK, ask the user to run /reload for front/Pi assets; boring.server changes require static composition plus restart.");
-  }
-  return lines.join("\n");
-}
-var COMMON_MISTAKE_HINTS = [
-  {
-    pattern: /boring\.server must be a safe relative path or false/i,
-    hint: 'Set `boring.server` to a string path like "server/index.ts", or to `false` (or omit the field). It is NOT a boolean true. For hot-reloadable agent behavior in .pi/extensions, prefer pi.extensions instead.'
-  },
-  {
-    pattern: /package\.json manifest must be an object/i,
-    hint: "package.json must parse as a JSON object \u2014 check for trailing commas or unquoted keys."
-  }
-];
-function findHintForError(message) {
-  for (const m of COMMON_MISTAKE_HINTS) {
-    if (m.pattern.test(message)) return m.hint;
-  }
-  return void 0;
-}
-
-// src/server/index.ts
-function defaultWorkspaceRoot() {
-  return process.env.BORING_AGENT_WORKSPACE_ROOT ?? process.cwd();
-}
-function workspaceLocalPluginRootsEnabled() {
-  const raw = process.env.BORING_AGENT_WORKSPACE_LOCAL_PLUGIN_ROOTS;
-  if (raw == null || raw.trim() === "") return true;
-  return !["0", "false", "no", "off"].includes(raw.trim().toLowerCase());
-}
-function buildPluginStatus(workspaceRoot = defaultWorkspaceRoot()) {
-  const resolvedRoot = resolve3(workspaceRoot);
-  const enabled = workspaceLocalPluginRootsEnabled();
-  return {
-    workspaceLocalPluginRoots: enabled,
-    workspaceRoot: resolvedRoot,
-    extensionsDir: join3(resolvedRoot, ".pi", "extensions"),
-    reloadSupported: enabled,
-    ...enabled ? {} : {
-      reason: "This runtime writes to a remote sandbox; host-side plugin discovery cannot load .pi/extensions from there."
-    }
-  };
-}
-function parseVerifyArgs(positionals, workspaceRoot = defaultWorkspaceRoot()) {
-  const maybeName = positionals[0];
-  const maybeWorkspace = positionals[1];
-  const looksLikePath = maybeName && (maybeName.includes("/") || maybeName.startsWith("."));
-  const name = looksLikePath ? void 0 : maybeName;
-  return {
-    ...name ? { name } : {},
-    workspaceRoot: resolve3(maybeWorkspace ?? (looksLikePath ? maybeName : workspaceRoot))
-  };
-}
-function parseScaffoldArgs(positionals, workspaceRoot = defaultWorkspaceRoot()) {
-  const name = positionals[0];
-  if (!name) throw new Error("usage: boring-ui-plugin scaffold <name> [workspace]");
-  return { name, workspaceRoot: resolve3(positionals[1] ?? workspaceRoot) };
-}
-
-// src/index.ts
-function pluginCommandUsage() {
-  return [
-    "usage: boring-ui-plugin <command>",
-    "",
-    "Commands:",
-    "  boring-ui-plugin status [--json]",
-    "  boring-ui-plugin scaffold <name> [workspace]",
-    "  boring-ui-plugin verify [name] [workspace]"
-  ].join("\n");
-}
-function handleStatus(json) {
-  const status = buildPluginStatus();
-  if (json) {
-    console.log(JSON.stringify(status, null, 2));
-    return;
-  }
-  console.log(status.workspaceLocalPluginRoots ? `workspace-local plugin roots enabled: ${status.extensionsDir}` : `workspace-local plugin roots disabled: ${status.reason}`);
-}
-function handleScaffold(positionals) {
-  const args = parseScaffoldArgs(positionals);
-  const status = buildPluginStatus(args.workspaceRoot);
-  if (!workspaceLocalPluginRootsEnabled()) {
-    throw new Error(`${status.reason} Do not scaffold into .pi/extensions in this runtime.`);
-  }
-  const result = scaffoldPlugin(args);
-  console.log(`scaffolded ${args.name}`);
-  console.log(`  dir   ${result.pluginDir}`);
-  for (const file of result.filesCreated) console.log(`  +     ${file}`);
-  console.log("");
-  console.log("Next steps:");
-  console.log("  1. edit front/index.tsx for UI panels/commands/resolvers");
-  console.log("  2. add pi.extensions / skills for hot-reloadable agent behavior");
-  console.log("  3. bash `boring-ui-plugin verify` \u2014 confirms manifests + files are valid");
-  console.log("  4. ask the user: /reload");
-}
-function handleVerify(positionals) {
-  const result = verifyPlugin(parseVerifyArgs(positionals));
-  console.log(formatVerifyResult(result));
-  if (result.ok) return;
-  const hints = [];
-  for (const outcome of result.outcomes) {
-    for (const err of outcome.errors) {
-      const hint = findHintForError(err);
-      if (hint) hints.push(`  hint (${outcome.id}): ${hint}`);
-    }
-  }
-  if (hints.length > 0) {
-    console.log("");
-    console.log("Suggestions:");
-    for (const hint of hints) console.log(hint);
-  }
-  process.exit(1);
-}
-function runBoringUiPluginCli(argv = process.argv.slice(2)) {
-  const positionals = argv.filter((arg) => !arg.startsWith("-"));
-  const json = argv.includes("--json");
-  const command = positionals[0];
-  const rest = positionals.slice(1);
-  if (command === "status") return handleStatus(json);
-  if (command === "scaffold") return handleScaffold(rest);
-  if (command === "verify") return handleVerify(rest);
-  console.log(pluginCommandUsage());
-}
-
-export {
-  pluginCommandUsage,
-  runBoringUiPluginCli
-};