@uniqbit/mate-core 0.17.1 → 0.17.2-canary.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniqbit/mate-core",
-  "version": "0.17.1",
+  "version": "0.17.2-canary.0",
   "description": "Core framework and plugin APIs for Mate.",
   "license": "MIT",
   "files": [

package/src/cli/commands/plugin/plugin.ts

@@ -11,7 +11,7 @@ export async function runPluginCommand(
       await runPluginInstallCommand(argv);
       return;
     case "verify":
-      await runPluginVerifyCommand();
+      await runPluginVerifyCommand(argv);
       return;
     default:
       console.error(`Unknown plugin command: ${subcommand ?? ""}`);

package/src/cli/commands/plugin/verify.ts

@@ -1,19 +1,22 @@
 import { FRAMEWORK_NAME } from "../../../framework";
 import { resolveInstallContext } from "../../../lib/install";
-import { verifyDeclaredPlugins } from "../../../tools/setup/dynamic-plugins/verify";
+import { inspectDeclaredPlugins } from "../../../tools/setup/dynamic-plugins/verify";
 
 /**
  * @command mate plugin verify
- * @description Strict, installation-free check that every plugin declared by the companion is allowed by `MATE_ALLOWED_PLUGINS`, installed, and loadable with the current environment. Exits non-zero naming each failing package.
+ * @description Strict, installation-free check that every plugin declared by the companion is allowed by `MATE_ALLOWED_PLUGINS`, installed, and loadable with the current environment. Exits non-zero naming each failing package. With `--json`, prints `{"capabilities": [...]}` listing the capability IDs the verified plugins provide.
  */
-export async function runPluginVerifyCommand(cwd = process.cwd()): Promise<boolean> {
+export async function runPluginVerifyCommand(
+  argv: string[] = [],
+  cwd = process.cwd(),
+): Promise<boolean> {
   const context = await resolveInstallContext(cwd);
   if ((context.kind !== "companion" && context.kind !== "hub") || !context.companionPath) {
     process.stderr.write(`${FRAMEWORK_NAME}: \`plugin verify\` requires a companion context.\n`);
     process.exitCode = 1;
     return false;
   }
-  const failures = await verifyDeclaredPlugins(context.companionPath);
+  const { failures, capabilities } = await inspectDeclaredPlugins(context.companionPath);
   for (const failure of failures) {
     process.stderr.write(`${FRAMEWORK_NAME}: plugin ${failure.package}: ${failure.reason}\n`);
   }
@@ -21,5 +24,6 @@ export async function runPluginVerifyCommand(cwd = process.cwd()): Promise<boole
     process.exitCode = 1;
     return false;
   }
+  if (argv.includes("--json")) process.stdout.write(`${JSON.stringify({ capabilities })}\n`);
   return true;
 }

package/src/tools/setup/dynamic-plugins/verify.ts

@@ -17,6 +17,12 @@ export interface PluginVerificationFailure {
   reason: string;
 }
 
+export interface PluginInspection {
+  failures: PluginVerificationFailure[];
+  /** IDs of the capabilities the loaded, allowlisted plugins provide. */
+  capabilities: string[];
+}
+
 /**
  * Strict, installation-free check of every declared plugin: allowed, installed
  * and loadable with the effective environment. Unlike hydration it fails
@@ -27,14 +33,22 @@ export async function verifyDeclaredPlugins(
   companionPath: string,
   deps: DynamicPluginLoadDeps = {},
 ): Promise<PluginVerificationFailure[]> {
+  return (await inspectDeclaredPlugins(companionPath, deps)).failures;
+}
+
+export async function inspectDeclaredPlugins(
+  companionPath: string,
+  deps: DynamicPluginLoadDeps = {},
+): Promise<PluginInspection> {
   const env = deps.env ?? process.env;
   const failures: PluginVerificationFailure[] = [];
+  const capabilities: string[] = [];
   let policy: ReturnType<typeof readPluginPolicy>;
   try {
     policy = readPluginPolicy(env);
   } catch (error) {
     if (!(error instanceof PluginPolicyError)) throw error;
-    return [{ package: "(allowlist)", reason: error.message }];
+    return { failures: [{ package: "(allowlist)", reason: error.message }], capabilities };
   }
 
   const declarations: PluginDeclaration[] = [];
@@ -65,6 +79,7 @@ export async function verifyDeclaredPlugins(
     // oxlint-disable-next-line no-await-in-loop -- declared order is part of the contract
     const result = await loadDynamicPlugin(companionPath, declaration, { ...deps, env });
     if (!result.ok) failures.push({ package: name, reason: result.warning });
+    else if (result.plugin.kind === "capability") capabilities.push(result.plugin.id);
   }
-  return failures;
+  return { failures, capabilities };
 }