@uniqbit/mate-core 0.15.3 → 0.15.4-canary.10

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

@@ -0,0 +1,94 @@
+import path from "node:path";
+
+import { FRAMEWORK_NAME } from "../../../framework";
+import { resolveInstallContext } from "../../../lib/install";
+import { ConfigStore } from "../../../lib/orchestrator/config-store";
+import type { PluginDeclaration } from "../../../lib/orchestrator/types";
+import { hydrateDynamicPlugins } from "../../../tools/setup/dynamic-plugins/hydrate";
+import {
+  installDeclaredPlugins,
+  type PluginInstallDeps,
+} from "../../../tools/setup/dynamic-plugins/install";
+import { reportPluginInstallResults } from "../install";
+
+export function parsePackageSpec(spec: string): { package: string; version: string } {
+  const atIndex = spec.startsWith("@") ? spec.indexOf("@", 1) : spec.indexOf("@");
+  if (atIndex === -1) return { package: spec, version: "latest" };
+  return { package: spec.slice(0, atIndex), version: spec.slice(atIndex + 1) };
+}
+
+function withDeclaration(
+  declarations: PluginDeclaration[],
+  packageName: string,
+  version: string,
+): PluginDeclaration[] {
+  const existing = declarations.find((declaration) => declaration.package === packageName);
+  if (existing?.version === version) return declarations;
+  if (!existing) return [...declarations, { package: packageName, version }];
+  return declarations.map((declaration) =>
+    declaration.package === packageName ? { ...declaration, version } : declaration,
+  );
+}
+
+export interface PluginInstallCommandDeps {
+  cwd?: string;
+  installDeps?: PluginInstallDeps;
+}
+
+/**
+ * @command mate plugin install <package>[@version]
+ * @description Declares `<package>` in the companion's (or hub's) `framework.yaml`
+ * `plugins:` list (adding it, or updating its version if already declared)
+ * and installs it immediately into the shared workspace, the same way
+ * `mate install` would on its next run.
+ */
+export async function runPluginInstallCommand(
+  argv: string[],
+  deps: PluginInstallCommandDeps = {},
+): Promise<boolean> {
+  const spec = argv[0];
+  if (!spec) {
+    process.stderr.write(
+      `${FRAMEWORK_NAME}: usage: ${FRAMEWORK_NAME} plugin install <package>[@version]\n`,
+    );
+    process.exitCode = 1;
+    return false;
+  }
+  const { package: packageName, version } = parsePackageSpec(spec);
+
+  const context = await resolveInstallContext(deps.cwd ?? process.cwd());
+  if (context.kind === "ambiguous") {
+    process.stderr.write(`${context.message}\n`);
+    process.exitCode = 1;
+    return false;
+  }
+  if ((context.kind !== "companion" && context.kind !== "hub") || !context.companionPath) {
+    process.stderr.write(
+      `${FRAMEWORK_NAME}: \`plugin install\` requires a companion or hub context; run it from inside a linked working repository or a hub root.\n`,
+    );
+    process.exitCode = 1;
+    return false;
+  }
+
+  const configPath = path.join(
+    context.companionPath,
+    `.${FRAMEWORK_NAME}`,
+    "config",
+    "framework.yaml",
+  );
+  const store = new ConfigStore(configPath);
+  const nextPlugins = withDeclaration(context.config.plugins ?? [], packageName, version);
+  if (nextPlugins !== context.config.plugins) {
+    await store.save({ ...context.config, plugins: nextPlugins });
+  }
+
+  const results = await installDeclaredPlugins(
+    context.companionPath,
+    nextPlugins,
+    deps.installDeps,
+  );
+  reportPluginInstallResults(results);
+  await hydrateDynamicPlugins({ companionPath: context.companionPath });
+
+  return results.find((result) => result.package === packageName)?.status !== "failed";
+}

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

@@ -0,0 +1,17 @@
+import { usage } from "../../usage";
+import { runPluginInstallCommand } from "./install";
+
+export async function runPluginCommand(
+  subcommand: string | undefined,
+  argv: string[],
+): Promise<void> {
+  switch (subcommand) {
+    case "install":
+      await runPluginInstallCommand(argv);
+      return;
+    default:
+      console.error(`Unknown plugin command: ${subcommand ?? ""}`);
+      console.error(usage());
+      process.exitCode = 1;
+  }
+}

package/src/cli/commands/setup.ts

@@ -1,6 +1,6 @@
 import path from "node:path";
 
-import { FRAMEWORK_NAME, frameworkCommandName } from "../../framework";
+import { FRAMEWORK_NAME } from "../../framework";
 import { ConfigStore, defaultConfig } from "../../lib/orchestrator/config-store";
 import { executeSetup } from "../../tools/setup";
 import {
@@ -56,7 +56,7 @@ export async function runSetupCommand(argv: string[]): Promise<void> {
  * Resolves agent/package-manager/capability selections either from CLI flags
  * (non-interactive) or from the interactive `selectSetupCompatibilities` picker,
  * seeded from the existing config when one exists. Writes the resulting config
- * via `setup.execute` and prints a summary table of profiles, package managers,
+ * via `setup.execute` and prints a summary table of allowed agents, package managers,
  * and capabilities.
  * @flags
  * - `--agents <list>` — parsed via `parseAllowedAgents`.
@@ -98,7 +98,7 @@ async function runSetupFlow(
     if (await checkWorkingRepo(cwd)) {
       process.stderr.write(
         `Warning: this directory looks like a working repository (project files detected).\n` +
-          `Initializing it as a ${frameworkCommandName()} companion here may not be what you want.\n`,
+          `Initializing it as a ${FRAMEWORK_NAME} companion here may not be what you want.\n`,
       );
     }
     const ok = await askConfirm("Initialize this directory as a Mate companion repository? [y/N] ");
@@ -192,9 +192,7 @@ async function runSetupFlow(
   const { config } = result;
   const rows: [string, string][] = [];
 
-  for (const [profileName, profile] of Object.entries(config.profiles)) {
-    rows.push([`profile:${profileName}`, (profile.allowedAgents ?? []).join(", ") || "(none)"]);
-  }
+  rows.push(["allowedAgents", (config.allowedAgents ?? []).join(", ") || "(none)"]);
 
   const capabilities = config.capabilities ?? [];
   rows.push(["packageManagers", (config.packageManagers ?? ["bun"]).join(", ") || "(none)"]);

package/src/cli/commands/update.ts

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 
-import { frameworkCommandName } from "../../framework";
+import { FRAMEWORK_NAME } from "../../framework";
 import {
   OPENCODE_PLUGIN_PACKAGE_NAME,
   warmOpenCodePluginCache,
@@ -20,7 +20,7 @@ type InstallResult = ReturnType<typeof installPublicPackageSync>;
 function writeNpmOnlyRecoveryMessage(): void {
   const { packageName, registry } = getUpdateConfig();
   process.stderr.write(
-    `${frameworkCommandName()}: self-update is only supported for npm-installed Mate.\n`,
+    `${FRAMEWORK_NAME}: self-update is only supported for npm-installed Mate.\n`,
   );
   if (packageName.startsWith("@uniqbit/")) {
     process.stderr.write(
@@ -87,16 +87,14 @@ export async function runUpdateCommand(argv: string[]): Promise<void> {
   try {
     latest = await updateCommandDeps.fetchLatestVersion();
   } catch {
-    process.stderr.write(
-      `${frameworkCommandName()}: could not reach registry to check for updates\n`,
-    );
+    process.stderr.write(`${FRAMEWORK_NAME}: could not reach registry to check for updates\n`);
     process.exitCode = 1;
     return;
   }
 
   if (checkOnly) {
     if (updateCommandDeps.isNewer(latest, current)) {
-      console.log(`${frameworkCommandName()}: update available (${current} → ${latest})`);
+      console.log(`${FRAMEWORK_NAME}: update available (${current} → ${latest})`);
       process.exitCode = 1;
     } else {
       console.log("Up to date.");
@@ -127,11 +125,11 @@ export async function runUpdateCommand(argv: string[]): Promise<void> {
   } catch (error) {
     if ((error as NodeJS.ErrnoException).code === "ENOENT") {
       process.stderr.write(
-        `${frameworkCommandName()}: npm is required for self-update but was not found on PATH\n`,
+        `${FRAMEWORK_NAME}: npm is required for self-update but was not found on PATH\n`,
       );
     } else {
       process.stderr.write(
-        `${frameworkCommandName()}: could not verify the npm installation used for self-update\n`,
+        `${FRAMEWORK_NAME}: could not verify the npm installation used for self-update\n`,
       );
     }
     writeNpmOnlyRecoveryMessage();
@@ -148,7 +146,7 @@ export async function runUpdateCommand(argv: string[]): Promise<void> {
   const result = updateCommandDeps.installLatest(latest);
   if (result.status !== 0 || result.error) {
     process.stderr.write(
-      `${frameworkCommandName()}: upgrade command exited with status ${result.status ?? 1}\n`,
+      `${FRAMEWORK_NAME}: upgrade command exited with status ${result.status ?? 1}\n`,
     );
     process.exitCode = 1;
     return;
@@ -163,7 +161,7 @@ export async function runUpdateCommand(argv: string[]): Promise<void> {
   if (!warmed.ok) {
     process.stderr.write(
       [
-        `${frameworkCommandName()}: could not pre-fetch ${OPENCODE_PLUGIN_PACKAGE_NAME}@${latest} for OpenCode.`,
+        `${FRAMEWORK_NAME}: could not pre-fetch ${OPENCODE_PLUGIN_PACKAGE_NAME}@${latest} for OpenCode.`,
         "The next managed OpenCode launch will download it (requires registry access).",
         ...(warmed.detail ? [`Details: ${warmed.detail}`] : []),
       ].join("\n") + "\n",
@@ -173,7 +171,7 @@ export async function runUpdateCommand(argv: string[]): Promise<void> {
   const postInstall = updateCommandDeps.runPostInstall(skipConfirm);
   if (postInstall.status !== 0 || postInstall.error) {
     process.stderr.write(
-      `\nUpgraded to ${latest}, but installation is incomplete. Run \`${frameworkCommandName()} install\`.\n`,
+      `\nUpgraded to ${latest}, but installation is incomplete. Run \`${FRAMEWORK_NAME} install\`.\n`,
     );
     process.exitCode = 1;
     return;

package/src/cli/companion-link-wizard.tsx

@@ -17,7 +17,6 @@ export interface CompanionLinkInputs {
   gitUrl?: string;
   localPath?: string;
   companionPaths?: string[];
-  profile: string;
 }
 
 interface SourceStep {
@@ -45,15 +44,7 @@ interface TextStep {
   error?: string;
 }
 
-interface ProfileStep {
-  kind: "select";
-  field: "profile";
-  label: string;
-  options: string[];
-  activeIndex: number;
-}
-
-type WizardStep = SourceStep | CompanionMultiSelectStep | TextStep | ProfileStep;
+type WizardStep = SourceStep | CompanionMultiSelectStep | TextStep;
 
 interface WizardAppProps {
   step: WizardStep;
@@ -99,10 +90,7 @@ function CompanionLinkWizardApp({ step, stepNumber, totalSteps, onMounted }: Wiz
     );
   }
 
-  const items =
-    step.field === "source"
-      ? step.options.map((option) => ({ key: option.key, label: option.label }))
-      : step.options.map((option) => ({ key: option, label: option }));
+  const items = step.options.map((option) => ({ key: option.key, label: option.label }));
 
   return (
     <Box flexDirection="column" width="100%">
@@ -116,7 +104,6 @@ function CompanionLinkWizardApp({ step, stepNumber, totalSteps, onMounted }: Wiz
 }
 
 export interface CompanionLinkWizardOptions {
-  profiles: string[];
   existingCompanions?: string[];
   stdin?: NodeJS.ReadStream;
   stdout?: NodeJS.WriteStream;
@@ -125,7 +112,6 @@ export interface CompanionLinkWizardOptions {
 
 function buildSteps(
   source: CompanionSource,
-  profiles: string[],
   values: {
     gitUrl: string;
     localPath: string;
@@ -176,21 +162,7 @@ function buildSteps(
             selected: values.companionPaths,
           };
 
-  if (profiles.length === 1) {
-    return [sourceStep, sourceSpecificStep];
-  }
-
-  return [
-    sourceStep,
-    sourceSpecificStep,
-    {
-      kind: "select",
-      field: "profile",
-      label: "Profile",
-      options: profiles,
-      activeIndex: 0,
-    },
-  ];
+  return [sourceStep, sourceSpecificStep];
 }
 
 export async function selectCompanionLinkInputs(
@@ -199,7 +171,6 @@ export async function selectCompanionLinkInputs(
   const stdin = options.stdin ?? process.stdin;
   const stdout = options.stdout ?? process.stdout;
   const stderr = options.stderr ?? process.stderr;
-  const profiles = options.profiles;
   const existingCompanions = options.existingCompanions ?? [];
 
   return new Promise<CompanionLinkInputs | null>((resolve, reject) => {
@@ -214,7 +185,7 @@ export async function selectCompanionLinkInputs(
     let currentStepIndex = 0;
     const keepAlive = setInterval(() => {}, 1 << 30);
     let rendered: ReturnType<typeof inkRender> | undefined;
-    let steps = buildSteps(source, profiles, values, existingCompanions);
+    let steps = buildSteps(source, values, existingCompanions);
 
     const cleanup = () => {
       clearInterval(keepAlive);
@@ -232,24 +203,12 @@ export async function selectCompanionLinkInputs(
       resolve(value);
     };
 
-    const buildResult = (): CompanionLinkInputs => {
-      const singleProfile = profiles.length === 1 ? profiles[0]! : null;
-      const profile =
-        singleProfile ??
-        ((steps.find((step) => step.kind === "select" && step.field === "profile") as ProfileStep)
-          .options[
-          (steps.find((step) => step.kind === "select" && step.field === "profile") as ProfileStep)
-            .activeIndex
-        ] as string);
-
-      return {
-        source,
-        gitUrl: source === "git" ? values.gitUrl : undefined,
-        localPath: source === "local" ? values.localPath : undefined,
-        companionPaths: source === "existing" ? [...values.companionPaths] : undefined,
-        profile,
-      };
-    };
+    const buildResult = (): CompanionLinkInputs => ({
+      source,
+      gitUrl: source === "git" ? values.gitUrl : undefined,
+      localPath: source === "local" ? values.localPath : undefined,
+      companionPaths: source === "existing" ? [...values.companionPaths] : undefined,
+    });
 
     const rerender = () => {
       rendered?.rerender(
@@ -262,16 +221,7 @@ export async function selectCompanionLinkInputs(
     };
 
     const rebuildSteps = () => {
-      const previousProfileStep = steps.find(
-        (step): step is ProfileStep => step.kind === "select" && step.field === "profile",
-      );
-      steps = buildSteps(source, profiles, values, existingCompanions);
-      const nextProfileStep = steps.find(
-        (step): step is ProfileStep => step.kind === "select" && step.field === "profile",
-      );
-      if (previousProfileStep && nextProfileStep) {
-        nextProfileStep.activeIndex = previousProfileStep.activeIndex;
-      }
+      steps = buildSteps(source, values, existingCompanions);
     };
 
     const onData = (chunk: string) => {
@@ -352,7 +302,7 @@ export async function selectCompanionLinkInputs(
         return;
       }
 
-      if (step.kind === "select" && step.field === "source") {
+      if (step.kind === "select") {
         source = step.options[step.activeIndex]!.key;
         rebuildSteps();
         if (currentStepIndex < steps.length - 1) {
@@ -362,23 +312,17 @@ export async function selectCompanionLinkInputs(
         return;
       }
 
-      if (step.kind === "multiselect") {
-        if (step.selected.size === 0) {
-          const option = step.options[step.activeIndex];
-          if (option) step.selected.add(option);
-        }
-        if (currentStepIndex < steps.length - 1) {
-          currentStepIndex++;
-          rerender();
-        } else {
-          doResolve(buildResult());
-          rendered?.unmount();
-        }
-        return;
+      if (step.selected.size === 0) {
+        const option = step.options[step.activeIndex];
+        if (option) step.selected.add(option);
+      }
+      if (currentStepIndex < steps.length - 1) {
+        currentStepIndex++;
+        rerender();
+      } else {
+        doResolve(buildResult());
+        rendered?.unmount();
       }
-
-      doResolve(buildResult());
-      rendered?.unmount();
     };
 
     const onMounted = () => {

package/src/cli/main.ts

@@ -1,5 +1,5 @@
 import { getActiveDistribution } from "../distribution";
-import { frameworkCommandName } from "../framework";
+import { FRAMEWORK_NAME } from "../framework";
 import {
   enforceUpdateIfRequired,
   scheduleBackgroundCheck,
@@ -9,14 +9,17 @@ import {
 import { runArtifactCommand } from "./commands/artifact/artifact";
 import { runCapCommand } from "./commands/cap";
 import { runCompanionCommand } from "./commands/companion/companion";
+import { runHubCommand } from "./commands/companion/hub";
 import { runConfigCommand } from "./commands/config";
 import { runDoctorCommand } from "./commands/doctor";
 import { runLaunchClaudeCommand } from "./commands/launch/claude";
 import { runLaunchOpenCodeCommand } from "./commands/launch/opencode";
+import { runPluginCommand } from "./commands/plugin/plugin";
 import { runReportCommand } from "./commands/report";
 import { runUpdateCommand } from "./commands/update";
 import { runInstallCommand } from "./commands/install";
 import { inspectInstallPreflight } from "../lib/install";
+import { resolveRootContext } from "../lib/orchestrator/root-context";
 import { ensureUnambiguousCompanion } from "./commands/shared/companion-selection";
 import { hydrateDynamicPlugins } from "../tools/setup/dynamic-plugins/hydrate";
 import { findPluginCliCommand } from "./plugin-commands";
@@ -25,6 +28,10 @@ import { usage } from "./usage";
 export interface GateNeeds {
   /** Block the command while an enforced update is pending. */
   updateGuard?: boolean;
+  /** Block the command when the current directory resolves to a hub root. */
+  notHubRoot?: boolean;
+  /** Block the command when the current directory resolves to a companion root. */
+  notCompanionRoot?: boolean;
   /** Require an unambiguous companion (selection wizard on ambiguity) before dispatch. */
   companion?: boolean;
   /** Require a complete installation (install preflight) before dispatch. */
@@ -35,12 +42,14 @@ export interface MainDeps {
   ensureUnambiguousCompanion: typeof ensureUnambiguousCompanion;
   inspectInstallPreflight: typeof inspectInstallPreflight;
   hydrateDynamicPlugins: typeof hydrateDynamicPlugins;
+  resolveRootContext: typeof resolveRootContext;
 }
 
 const mainDeps: MainDeps = {
   ensureUnambiguousCompanion,
   inspectInstallPreflight,
   hydrateDynamicPlugins,
+  resolveRootContext,
 };
 
 export async function main(argv = process.argv, deps: MainDeps = mainDeps): Promise<void> {
@@ -51,10 +60,10 @@ export async function main(argv = process.argv, deps: MainDeps = mainDeps): Prom
     return;
   }
 
-  // Companion-declared plugins register before cap-command detection and
-  // before help text is printed, so their commands route like compiled-in
-  // ones (including MCP servers whose command is their own cap subcommand)
-  // and show up in `mate help`. Diagnostics stay on stderr; a missing or
+  // Dynamic plugins register before cap-command detection and before help
+  // text is printed, so their commands route like compiled-in ones
+  // (including MCP servers whose command is their own cap subcommand) and
+  // show up in `mate help`. Diagnostics stay on stderr; a missing or
   // ambiguous companion makes this a no-op.
   await deps.hydrateDynamicPlugins();
 
@@ -84,6 +93,24 @@ export async function main(argv = process.argv, deps: MainDeps = mainDeps): Prom
       await showUpdateBannerIfAvailable(updateStore);
     }
 
+    if (needs.notHubRoot || needs.notCompanionRoot) {
+      const kind = (await deps.resolveRootContext()).kind;
+      if (needs.notHubRoot && kind === "hub") {
+        console.error(
+          `${FRAMEWORK_NAME}: this directory resolves to a companion hub root; companion commands are not available here. Use \`${FRAMEWORK_NAME} hub ...\` to manage the hub.`,
+        );
+        process.exitCode = 1;
+        return false;
+      }
+      if (needs.notCompanionRoot && kind === "companion") {
+        console.error(
+          `${FRAMEWORK_NAME}: this directory resolves to a companion root; hub commands are not available here. Run them from a hub root.`,
+        );
+        process.exitCode = 1;
+        return false;
+      }
+    }
+
     if (needs.companion && !(await deps.ensureUnambiguousCompanion())) {
       process.exitCode = 1;
       return false;
@@ -92,10 +119,8 @@ export async function main(argv = process.argv, deps: MainDeps = mainDeps): Prom
     if (needs.install) {
       const preflight = await deps.inspectInstallPreflight();
       if (!preflight.ok) {
-        console.error(
-          `${frameworkCommandName()}: ${preflight.reason ?? "installation is incomplete"}`,
-        );
-        console.error(`Run \`${frameworkCommandName()} install\` before continuing.`);
+        console.error(`${FRAMEWORK_NAME}: ${preflight.reason ?? "installation is incomplete"}`);
+        console.error(`Run \`${FRAMEWORK_NAME} install\` before continuing.`);
         process.exitCode = 1;
         return false;
       }
@@ -111,6 +136,14 @@ export async function main(argv = process.argv, deps: MainDeps = mainDeps): Prom
       if (!(await gate({ companion: true }))) return;
       await runInstallCommand(argv.slice(3));
       return;
+    case "plugin":
+      // Declares into framework.yaml and installs on the spot, so it needs
+      // the same gating as `install` — an unambiguous companion (hubs pass
+      // trivially), but must stay runnable when installation is otherwise
+      // incomplete.
+      if (!(await gate({ companion: true }))) return;
+      await runPluginCommand(subcommand, rest);
+      return;
     case "artifact":
       if (!(await gate({ updateGuard: true, companion: true, install: true }))) return;
       await runArtifactCommand(subcommand, rest);
@@ -118,22 +151,33 @@ export async function main(argv = process.argv, deps: MainDeps = mainDeps): Prom
     case "companion":
       switch (subcommand) {
         // setup/link are recovery paths and must never be gated on the
-        // state they exist to repair.
+        // state they exist to repair — but hubs are never companions.
         case "setup":
         case "link":
-          if (!(await gate({}))) return;
+          if (!(await gate({ notHubRoot: true }))) return;
+          break;
+        // Hub commands establish and operate on a local hub root directly;
+        // they must not require a linked working repository or installation —
+        // but companions are never hubs.
+        case "hub":
+          if (!(await gate({ updateGuard: true, notCompanionRoot: true }))) return;
           break;
         // open/tui consume a companion context.
         case "open":
         case "tui":
-          if (!(await gate({ updateGuard: true, companion: true }))) return;
+          if (!(await gate({ updateGuard: true, notHubRoot: true, companion: true }))) return;
           break;
         // list and unknown subcommands (which fail inside the command).
         default:
-          if (!(await gate({ updateGuard: true }))) return;
+          if (!(await gate({ updateGuard: true, notHubRoot: true }))) return;
       }
       await runCompanionCommand(subcommand, rest);
       return;
+    case "hub":
+      // Hubs are never companions: hub commands are blocked in companion roots.
+      if (!(await gate({ updateGuard: true, notCompanionRoot: true }))) return;
+      await runHubCommand(subcommand ? [subcommand, ...rest] : []);
+      return;
     case "claude":
       if (!(await gate({ updateGuard: true, companion: true, install: true }))) return;
       await runLaunchClaudeCommand(argv.slice(3), { directPassthrough: true });

package/src/cli/plugin-commands.ts

@@ -1,5 +1,5 @@
 import { getActiveDistribution } from "../distribution";
-import { frameworkCommandName } from "../framework";
+import { FRAMEWORK_NAME } from "../framework";
 import { resolveInstallContext } from "../lib/install";
 import type { FrameworkConfig } from "../lib/orchestrator/types";
 import type { Plugin, PluginCliCommand } from "../tools/setup/plugin";
@@ -86,7 +86,7 @@ export async function ensureCapabilityEnabled(
   const loadConfig = deps.loadConfig ?? (async () => (await resolveInstallContext()).config);
   if (plugin?.isEnabled(await loadConfig())) return true;
 
-  const name = frameworkCommandName();
+  const name = FRAMEWORK_NAME;
   console.error(
     `${name}: the "${pluginId}" capability is not enabled for this companion. ` +
       `Enable it via \`${name} companion setup\`.`,
@@ -104,7 +104,7 @@ function formatCommand(
 }
 
 function usageFor(plugin: Plugin): string {
-  const distributionName = frameworkCommandName();
+  const distributionName = FRAMEWORK_NAME;
   const namespace = namespaceOf(plugin);
   const lines = (plugin.cliCommands ?? []).map((command) =>
     formatCommand(distributionName, namespace, command),
@@ -119,7 +119,7 @@ function usageFor(plugin: Plugin): string {
  * commands show up in `mate help` alongside framework builtins.
  */
 export function pluginCliCommandLines(): string[] {
-  const distributionName = frameworkCommandName();
+  const distributionName = FRAMEWORK_NAME;
   return getActiveDistribution()
     .registry.getAll()
     .flatMap((plugin) =>

package/src/cli/repo-list-table.tsx

@@ -39,10 +39,6 @@ function RepoListTable({
     "ID",
     repositories.map((repository) => repository.id),
   );
-  const profileWidth = columnWidth(
-    "Profile",
-    repositories.map((repository) => repository.profile),
-  );
   const pathWidth = columnWidth(
     "Path",
     repositories.map((repository) => repository.path),
@@ -53,8 +49,7 @@ function RepoListTable({
       <Text bold>Linked repositories</Text>
       <Box marginTop={1} flexDirection="column">
         <Text dimColor>
-          {pad("Active", markerWidth)} {pad("ID", idWidth)} {pad("Profile", profileWidth)}{" "}
-          {pad("Path", pathWidth)}
+          {pad("Active", markerWidth)} {pad("ID", idWidth)} {pad("Path", pathWidth)}
         </Text>
         {repositories.map((repository) => {
           const isActive = repository.id === activeRepositoryId;
@@ -63,7 +58,7 @@ function RepoListTable({
           return (
             <Text key={repository.id} color={isActive ? "green" : undefined}>
               {pad(marker, markerWidth)} {pad(repository.id, idWidth)}{" "}
-              {pad(repository.profile, profileWidth)} {pad(repository.path, pathWidth)}
+              {pad(repository.path, pathWidth)}
             </Text>
           );
         })}

package/src/cli/usage.ts

@@ -1,13 +1,13 @@
 import { getActiveDistribution } from "../distribution";
-import { FRAMEWORK_NAME, frameworkCommandName } from "../framework";
+import { FRAMEWORK_NAME } from "../framework";
 import { pluginCliCommandLines } from "./plugin-commands";
 
 export function usage(): string {
-  const n = frameworkCommandName();
+  const n = FRAMEWORK_NAME;
   const packageName =
     getActiveDistribution().config.update?.packageName ?? `@uniqbit/${FRAMEWORK_NAME}`;
   return [
-    `${n.charAt(0).toUpperCase() + n.slice(1)} CLI (${packageName})`,
+    `Mate CLI (${packageName})`,
     "",
     "Commands:",
     ` ${n} install [--yes]`,
@@ -16,6 +16,9 @@ export function usage(): string {
     ` ${n} companion list`,
     ` ${n} companion open`,
     ` ${n} companion tui`,
+    ` ${n} hub init [folder]`,
+    ` ${n} hub add [source] [--id ID] [--path PATH]`,
+    ` ${n} hub sync [--json] (companions + hub plugins)`,
     ` ${n} artifact finish <change-name> [--type openspec] [--force] [--no-push] [--json]`,
     ` ${n} doctor`,
     ` ${n} report [--days N] [--input FILE|-] [--json]`,
@@ -25,6 +28,7 @@ export function usage(): string {
     ` ${n} cap openspec <subcommand> [args...]`,
     ` ${n} cap graphify <subcommand> [args...]`,
     ` ${n} cap index [--graphify] [--tokensave]`,
+    ` ${n} plugin install <package>[@version]`,
     ...pluginCliCommandLines(),
     ` ${n} update`,
     ` ${n} update --check`,