@h-rig/plugin-inspector-plugin 0.0.6-alpha.186

package/README.md

@@ -0,0 +1 @@
+# @h-rig/plugin-inspector-plugin

package/dist/src/cli-parsers.d.ts

@@ -0,0 +1,7 @@
+import type { TaskSourceConfig } from "@rig/contracts";
+import type { RigPlugin } from "@rig/core";
+export type CliRigConfig = {
+    plugins?: readonly RigPlugin[];
+    taskSource?: TaskSourceConfig;
+};
+export declare function loadRigConfigOrNull(projectRoot: string): Promise<CliRigConfig | null>;

package/dist/src/cli-parsers.js

@@ -0,0 +1,15 @@
+// @bun
+var __require = import.meta.require;
+
+// packages/plugin-inspector-plugin/src/cli-parsers.ts
+async function loadRigConfigOrNull(projectRoot) {
+  try {
+    const { loadConfig } = await import("@rig/core/load-config");
+    return await loadConfig(projectRoot);
+  } catch {
+    return null;
+  }
+}
+export {
+  loadRigConfigOrNull
+};

package/dist/src/plugin-command.d.ts

@@ -0,0 +1,20 @@
+import type { RuntimeCliContext } from "@rig/core/config";
+import type { CommandOutcome } from "@rig/contracts";
+export declare function executePlugin(context: RuntimeCliContext, args: string[]): Promise<CommandOutcome>;
+/**
+ * Resolve a plugin CLI command by exact id ("my-plugin:deploy") or by the
+ * unambiguous local part after the namespace colon ("deploy").
+ */
+export declare function resolvePluginCliCommand(commands: readonly {
+    id: string;
+    family?: string | undefined;
+    command?: string | undefined;
+    description?: string | undefined;
+    aliases?: readonly string[] | undefined;
+}[], requested: string): {
+    id: string;
+    family?: string | undefined;
+    command?: string | undefined;
+    description?: string | undefined;
+    aliases?: readonly string[] | undefined;
+} | undefined;

package/dist/src/plugin-command.js

@@ -0,0 +1,188 @@
+// @bun
+var __require = import.meta.require;
+
+// packages/plugin-inspector-plugin/src/plugin-command.ts
+import { existsSync } from "fs";
+import { resolve } from "path";
+import { CliError, requireNoExtraArgs, requireOption, takeOption } from "@rig/std-shared/cli-args";
+import { buildPluginHostContext } from "@rig/core/plugin-host-context";
+
+// packages/plugin-inspector-plugin/src/cli-parsers.ts
+async function loadRigConfigOrNull(projectRoot) {
+  try {
+    const { loadConfig } = await import("@rig/core/load-config");
+    return await loadConfig(projectRoot);
+  } catch {
+    return null;
+  }
+}
+
+// packages/plugin-inspector-plugin/src/plugin-command.ts
+async function executePlugin(context, args) {
+  const [command = "list", ...rest] = args;
+  switch (command) {
+    case "list": {
+      requireNoExtraArgs(rest, "rig plugin list");
+      const declarative = [];
+      const config = await loadRigConfigOrNull(context.projectRoot);
+      if (config && Array.isArray(config.plugins)) {
+        for (const plugin of config.plugins) {
+          const c = plugin.contributes ?? {};
+          declarative.push({
+            name: plugin.name,
+            version: plugin.version,
+            validators: (c.validators ?? []).map((v) => v.id),
+            hooks: (c.hooks ?? []).map((h) => h.id),
+            agentRoles: (c.agentRoles ?? []).map((r) => r.id),
+            repoSources: (c.repoSources ?? []).map((r) => r.id),
+            taskSources: (c.taskSources ?? []).map((s) => s.id),
+            skills: (c.skills ?? []).map((s) => s.id),
+            taskFieldExtensions: (c.taskFieldSchemas ?? []).map((f) => f.id),
+            cliCommands: (c.cliCommands ?? []).map((entry) => entry.family ?? entry.id)
+          });
+        }
+      }
+      if (context.outputMode === "text") {
+        if (declarative.length === 0) {
+          const configExists = ["rig.config.ts", "rig.config.mts", "rig.config.json"].some((name) => existsSync(resolve(context.projectRoot, name)));
+          console.log(configExists ? "rig.config found but no plugins could be loaded. If the config imports @rig/* packages, run `bun install` in this project first." : "No plugins loaded. Declare plugins in rig.config.ts.");
+        } else {
+          console.log("Plugins (rig.config.ts):");
+          for (const p of declarative) {
+            console.log(`  ${p.name}@${p.version}`);
+            const lines = [];
+            if (p.validators.length)
+              lines.push(`    validators: ${p.validators.join(", ")}`);
+            if (p.hooks.length)
+              lines.push(`    hooks: ${p.hooks.join(", ")}`);
+            if (p.agentRoles.length)
+              lines.push(`    agent-roles: ${p.agentRoles.join(", ")}`);
+            if (p.repoSources.length)
+              lines.push(`    repo-sources: ${p.repoSources.join(", ")}`);
+            if (p.taskSources.length)
+              lines.push(`    task-sources: ${p.taskSources.join(", ")}`);
+            if (p.skills.length)
+              lines.push(`    skills: ${p.skills.join(", ")}`);
+            if (p.taskFieldExtensions.length)
+              lines.push(`    task-fields: ${p.taskFieldExtensions.join(", ")}`);
+            if (p.cliCommands.length)
+              lines.push(`    cli-families: ${p.cliCommands.join(", ")}`);
+            for (const line of lines)
+              console.log(line);
+          }
+        }
+      }
+      return {
+        ok: true,
+        group: "plugin",
+        command,
+        details: { declarative }
+      };
+    }
+    case "validate": {
+      const { value: task, rest: remaining } = takeOption(rest, "--task");
+      requireNoExtraArgs(remaining, "rig plugin validate --task <task-id>");
+      const taskId = requireOption(task, "--task", "rig plugin validate --task <task-id>");
+      const hostCtx = await buildPluginHostContext(context.projectRoot);
+      if (!hostCtx) {
+        throw new CliError(`No rig.config found at ${context.projectRoot}. Run \`rig init\` to set up plugins.`, 2);
+      }
+      const validators = hostCtx.validatorRegistry.list();
+      const results = [];
+      for (const validator of validators) {
+        try {
+          results.push(await validator.run({
+            taskId,
+            workspaceRoot: context.projectRoot,
+            scope: []
+          }));
+        } catch (error) {
+          results.push({
+            id: validator.id,
+            passed: false,
+            summary: `${validator.id} failed unexpectedly`,
+            details: `${error}`
+          });
+        }
+      }
+      const passed = results.filter((result) => result.passed).length;
+      const failed = results.length - passed;
+      if (context.outputMode === "text") {
+        if (results.length === 0) {
+          console.log("No plugin validators registered.");
+        } else {
+          for (const result of results) {
+            const icon = result.passed ? "PASS" : "FAIL";
+            console.log(`[${icon}] ${result.id}: ${result.summary}`);
+            if (result.details && !result.passed) {
+              console.log(result.details);
+            }
+          }
+        }
+      }
+      if (failed > 0) {
+        throw new CliError(`Plugin validation failed for ${failed} validator(s).`, 2, { hint: "Fix the reported validators, then re-run `rig plugin validate --task <id>`." });
+      }
+      return {
+        ok: true,
+        group: "plugin",
+        command,
+        details: {
+          taskId,
+          passed,
+          failed,
+          results
+        }
+      };
+    }
+    case "run": {
+      const [commandId, ...commandArgs] = rest;
+      if (!commandId) {
+        throw new CliError("Usage: rig plugin run <command-id> [args...]", 1, { hint: "Run `rig plugin list` to see plugin-contributed command ids." });
+      }
+      const hostCtx = await buildPluginHostContext(context.projectRoot);
+      if (!hostCtx) {
+        throw new CliError(`No rig.config found at ${context.projectRoot}. Run \`rig init\` to set up plugins.`, 2);
+      }
+      const registration = resolvePluginCliCommand(hostCtx.pluginHost.listCliCommands(), commandId);
+      if (!registration) {
+        const available = hostCtx.pluginHost.listCliCommands().map((entry) => entry.id);
+        throw new CliError(available.length > 0 ? `Unknown plugin command "${commandId}". Available: ${available.join(", ")}` : `No plugin CLI commands are registered. Plugins contribute them via contributes.cliCommands.`, 2);
+      }
+      if (!registration.command) {
+        throw new CliError(`Plugin CLI family "${registration.id}" is an in-process command; invoke it as \`rig ${registration.family ?? registration.id}\`, not through \`rig plugin run\`.`, 1);
+      }
+      if (context.dryRun) {
+        if (context.outputMode === "text") {
+          console.log(`[dry-run] ${registration.command}${commandArgs.length ? ` ${commandArgs.join(" ")}` : ""}`);
+        }
+        return { ok: true, group: "plugin", command, details: { id: registration.id, dryRun: true } };
+      }
+      const proc = Bun.spawn(["bash", "-c", `${registration.command} "$@"`, registration.id, ...commandArgs], {
+        cwd: context.projectRoot,
+        env: process.env,
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit"
+      });
+      const exitCode = await proc.exited;
+      if (exitCode !== 0) {
+        throw new CliError(`Plugin command "${registration.id}" exited with code ${exitCode}.`, exitCode, { hint: "Run `rig plugin list` to inspect the contributing plugin, or re-run with --json for details." });
+      }
+      return { ok: true, group: "plugin", command, details: { id: registration.id, exitCode } };
+    }
+    default:
+      throw new CliError(`Unknown plugin command: ${command}`, 1, { hint: "Run `rig plugin --help` \u2014 commands are list|validate|run." });
+  }
+}
+function resolvePluginCliCommand(commands, requested) {
+  const exact = commands.find((entry) => entry.id === requested || entry.family === requested || (entry.aliases ?? []).includes(requested));
+  if (exact)
+    return exact;
+  const byLocalPart = commands.filter((entry) => entry.id.split(":").slice(1).join(":") === requested);
+  return byLocalPart.length === 1 ? byLocalPart[0] : undefined;
+}
+export {
+  resolvePluginCliCommand,
+  executePlugin
+};

package/dist/src/plugin.d.ts

@@ -0,0 +1,4 @@
+export declare const PLUGIN_INSPECTOR_PLUGIN_NAME = "@rig/plugin-inspector-plugin";
+export declare const pluginInspectorPlugin: import("@rig/core").RigPlugin;
+export declare function createPluginInspectorPlugin(): import("@rig/core").RigPlugin;
+export default pluginInspectorPlugin;

package/dist/src/plugin.js

@@ -0,0 +1,241 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// packages/plugin-inspector-plugin/src/cli-parsers.ts
+async function loadRigConfigOrNull(projectRoot) {
+  try {
+    const { loadConfig } = await import("@rig/core/load-config");
+    return await loadConfig(projectRoot);
+  } catch {
+    return null;
+  }
+}
+
+// packages/plugin-inspector-plugin/src/plugin-command.ts
+var exports_plugin_command = {};
+__export(exports_plugin_command, {
+  resolvePluginCliCommand: () => resolvePluginCliCommand,
+  executePlugin: () => executePlugin
+});
+import { existsSync } from "fs";
+import { resolve } from "path";
+import { CliError, requireNoExtraArgs, requireOption, takeOption } from "@rig/std-shared/cli-args";
+import { buildPluginHostContext } from "@rig/core/plugin-host-context";
+async function executePlugin(context, args) {
+  const [command = "list", ...rest] = args;
+  switch (command) {
+    case "list": {
+      requireNoExtraArgs(rest, "rig plugin list");
+      const declarative = [];
+      const config = await loadRigConfigOrNull(context.projectRoot);
+      if (config && Array.isArray(config.plugins)) {
+        for (const plugin of config.plugins) {
+          const c = plugin.contributes ?? {};
+          declarative.push({
+            name: plugin.name,
+            version: plugin.version,
+            validators: (c.validators ?? []).map((v) => v.id),
+            hooks: (c.hooks ?? []).map((h) => h.id),
+            agentRoles: (c.agentRoles ?? []).map((r) => r.id),
+            repoSources: (c.repoSources ?? []).map((r) => r.id),
+            taskSources: (c.taskSources ?? []).map((s) => s.id),
+            skills: (c.skills ?? []).map((s) => s.id),
+            taskFieldExtensions: (c.taskFieldSchemas ?? []).map((f) => f.id),
+            cliCommands: (c.cliCommands ?? []).map((entry) => entry.family ?? entry.id)
+          });
+        }
+      }
+      if (context.outputMode === "text") {
+        if (declarative.length === 0) {
+          const configExists = ["rig.config.ts", "rig.config.mts", "rig.config.json"].some((name) => existsSync(resolve(context.projectRoot, name)));
+          console.log(configExists ? "rig.config found but no plugins could be loaded. If the config imports @rig/* packages, run `bun install` in this project first." : "No plugins loaded. Declare plugins in rig.config.ts.");
+        } else {
+          console.log("Plugins (rig.config.ts):");
+          for (const p of declarative) {
+            console.log(`  ${p.name}@${p.version}`);
+            const lines = [];
+            if (p.validators.length)
+              lines.push(`    validators: ${p.validators.join(", ")}`);
+            if (p.hooks.length)
+              lines.push(`    hooks: ${p.hooks.join(", ")}`);
+            if (p.agentRoles.length)
+              lines.push(`    agent-roles: ${p.agentRoles.join(", ")}`);
+            if (p.repoSources.length)
+              lines.push(`    repo-sources: ${p.repoSources.join(", ")}`);
+            if (p.taskSources.length)
+              lines.push(`    task-sources: ${p.taskSources.join(", ")}`);
+            if (p.skills.length)
+              lines.push(`    skills: ${p.skills.join(", ")}`);
+            if (p.taskFieldExtensions.length)
+              lines.push(`    task-fields: ${p.taskFieldExtensions.join(", ")}`);
+            if (p.cliCommands.length)
+              lines.push(`    cli-families: ${p.cliCommands.join(", ")}`);
+            for (const line of lines)
+              console.log(line);
+          }
+        }
+      }
+      return {
+        ok: true,
+        group: "plugin",
+        command,
+        details: { declarative }
+      };
+    }
+    case "validate": {
+      const { value: task, rest: remaining } = takeOption(rest, "--task");
+      requireNoExtraArgs(remaining, "rig plugin validate --task <task-id>");
+      const taskId = requireOption(task, "--task", "rig plugin validate --task <task-id>");
+      const hostCtx = await buildPluginHostContext(context.projectRoot);
+      if (!hostCtx) {
+        throw new CliError(`No rig.config found at ${context.projectRoot}. Run \`rig init\` to set up plugins.`, 2);
+      }
+      const validators = hostCtx.validatorRegistry.list();
+      const results = [];
+      for (const validator of validators) {
+        try {
+          results.push(await validator.run({
+            taskId,
+            workspaceRoot: context.projectRoot,
+            scope: []
+          }));
+        } catch (error) {
+          results.push({
+            id: validator.id,
+            passed: false,
+            summary: `${validator.id} failed unexpectedly`,
+            details: `${error}`
+          });
+        }
+      }
+      const passed = results.filter((result) => result.passed).length;
+      const failed = results.length - passed;
+      if (context.outputMode === "text") {
+        if (results.length === 0) {
+          console.log("No plugin validators registered.");
+        } else {
+          for (const result of results) {
+            const icon = result.passed ? "PASS" : "FAIL";
+            console.log(`[${icon}] ${result.id}: ${result.summary}`);
+            if (result.details && !result.passed) {
+              console.log(result.details);
+            }
+          }
+        }
+      }
+      if (failed > 0) {
+        throw new CliError(`Plugin validation failed for ${failed} validator(s).`, 2, { hint: "Fix the reported validators, then re-run `rig plugin validate --task <id>`." });
+      }
+      return {
+        ok: true,
+        group: "plugin",
+        command,
+        details: {
+          taskId,
+          passed,
+          failed,
+          results
+        }
+      };
+    }
+    case "run": {
+      const [commandId, ...commandArgs] = rest;
+      if (!commandId) {
+        throw new CliError("Usage: rig plugin run <command-id> [args...]", 1, { hint: "Run `rig plugin list` to see plugin-contributed command ids." });
+      }
+      const hostCtx = await buildPluginHostContext(context.projectRoot);
+      if (!hostCtx) {
+        throw new CliError(`No rig.config found at ${context.projectRoot}. Run \`rig init\` to set up plugins.`, 2);
+      }
+      const registration = resolvePluginCliCommand(hostCtx.pluginHost.listCliCommands(), commandId);
+      if (!registration) {
+        const available = hostCtx.pluginHost.listCliCommands().map((entry) => entry.id);
+        throw new CliError(available.length > 0 ? `Unknown plugin command "${commandId}". Available: ${available.join(", ")}` : `No plugin CLI commands are registered. Plugins contribute them via contributes.cliCommands.`, 2);
+      }
+      if (!registration.command) {
+        throw new CliError(`Plugin CLI family "${registration.id}" is an in-process command; invoke it as \`rig ${registration.family ?? registration.id}\`, not through \`rig plugin run\`.`, 1);
+      }
+      if (context.dryRun) {
+        if (context.outputMode === "text") {
+          console.log(`[dry-run] ${registration.command}${commandArgs.length ? ` ${commandArgs.join(" ")}` : ""}`);
+        }
+        return { ok: true, group: "plugin", command, details: { id: registration.id, dryRun: true } };
+      }
+      const proc = Bun.spawn(["bash", "-c", `${registration.command} "$@"`, registration.id, ...commandArgs], {
+        cwd: context.projectRoot,
+        env: process.env,
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit"
+      });
+      const exitCode = await proc.exited;
+      if (exitCode !== 0) {
+        throw new CliError(`Plugin command "${registration.id}" exited with code ${exitCode}.`, exitCode, { hint: "Run `rig plugin list` to inspect the contributing plugin, or re-run with --json for details." });
+      }
+      return { ok: true, group: "plugin", command, details: { id: registration.id, exitCode } };
+    }
+    default:
+      throw new CliError(`Unknown plugin command: ${command}`, 1, { hint: "Run `rig plugin --help` \u2014 commands are list|validate|run." });
+  }
+}
+function resolvePluginCliCommand(commands, requested) {
+  const exact = commands.find((entry) => entry.id === requested || entry.family === requested || (entry.aliases ?? []).includes(requested));
+  if (exact)
+    return exact;
+  const byLocalPart = commands.filter((entry) => entry.id.split(":").slice(1).join(":") === requested);
+  return byLocalPart.length === 1 ? byLocalPart[0] : undefined;
+}
+var init_plugin_command = () => {};
+
+// packages/plugin-inspector-plugin/src/plugin.ts
+import { definePlugin } from "@rig/core/config";
+var PLUGIN_INSPECTOR_PLUGIN_NAME = "@rig/plugin-inspector-plugin";
+var pluginCommand = {
+  id: `${PLUGIN_INSPECTOR_PLUGIN_NAME}:plugin`,
+  family: "plugin",
+  description: "Inspect and run plugin compatibility commands.",
+  projectRequired: false,
+  run: async (context, args) => (await Promise.resolve().then(() => (init_plugin_command(), exports_plugin_command))).executePlugin(context, [...args]),
+  helpDoc: {
+    name: "plugin",
+    summary: "Plugin listing, validation, and plugin-contributed commands.",
+    usage: ["rig plugin <list|validate|run> [options]"],
+    commands: [
+      { command: "list", description: "List plugins declared in rig.config.ts and their contributions.", primary: true },
+      { command: "validate --task <id>", description: "Run plugin-contributed validators for a task.", primary: true },
+      { command: "run <command-id> [args...]", description: "Execute a plugin-contributed CLI command (also callable as `rig <command-id>`)." }
+    ],
+    examples: ["rig plugin list", "rig plugin run <command-id>"]
+  }
+};
+var pluginInspectorPlugin = definePlugin({
+  name: PLUGIN_INSPECTOR_PLUGIN_NAME,
+  version: "0.0.0-alpha.1",
+  effects: { readsFiles: true, contributesCliCommands: true },
+  contributes: { cliCommands: [pluginCommand] }
+});
+function createPluginInspectorPlugin() {
+  return pluginInspectorPlugin;
+}
+var plugin_default = pluginInspectorPlugin;
+export {
+  pluginInspectorPlugin,
+  plugin_default as default,
+  createPluginInspectorPlugin,
+  PLUGIN_INSPECTOR_PLUGIN_NAME
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@h-rig/plugin-inspector-plugin",
+  "version": "0.0.6-alpha.186",
+  "type": "module",
+  "description": "First-party Rig plugin-introspection command plugin (rig plugin list/...).",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/plugin.d.ts",
+      "import": "./dist/src/plugin.js"
+    },
+    "./plugin": {
+      "types": "./dist/src/plugin.d.ts",
+      "import": "./dist/src/plugin.js"
+    }
+  },
+  "engines": {
+    "bun": ">=1.3.11"
+  },
+  "dependencies": {
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.186",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.186",
+    "@rig/std-shared": "npm:@h-rig/std-shared@0.0.6-alpha.186"
+  }
+}