root/fusion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(FN-2493): add plugin add alias and normalize install guidance

Browse Source 
- Route "fn plugin add" to the plugin install handler and update CLI help/usage text to document the alias
- Add bin routing tests that cover plugin add/install parity and updated error/help messaging
- Update getting-started, settings reference, and runtime plugin READMEs to standardize plugin installation examples
- Add a patch changeset for @runfusion/fusion and apply DirectoryPicker/PluginManager design-token styling refinements
This commit is contained in:
Fusion
2026-04-25 11:28:33 -07:00
committed by gsxdsm
parent 79b73c343c
commit adbad8afca
12 changed files with 109 additions and 71 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
packages/cli/src/__tests__/bin.test.ts
View File

@@ -83,6 +83,13 @@ const commandMocks = vi.hoisted(() => ({
runMessageRead: vi.fn(),
runMessageDelete: vi.fn(),
runAgentMailbox: vi.fn(),
runPluginList: vi.fn(),
runPluginInstall: vi.fn(),
runPluginUninstall: vi.fn(),
runPluginEnable: vi.fn(),
runPluginDisable: vi.fn(),
runPluginCreate: vi.fn(),
}));
vi.mock("../commands/dashboard.js", () => ({ runDashboard: commandMocks.runDashboard }));
@@ -187,6 +194,18 @@ vi.mock("../commands/message.js", () => ({
runAgentMailbox: commandMocks.runAgentMailbox,
}));
vi.mock("../commands/plugin.js", () => ({
runPluginList: commandMocks.runPluginList,
runPluginInstall: commandMocks.runPluginInstall,
runPluginUninstall: commandMocks.runPluginUninstall,
runPluginEnable: commandMocks.runPluginEnable,
runPluginDisable: commandMocks.runPluginDisable,
}));
vi.mock("../commands/plugin-scaffold.js", () => ({
runPluginCreate: commandMocks.runPluginCreate,
}));
const originalArgv = process.argv;
const originalExit = process.exit;
const originalPiPackageDir = process.env.PI_PACKAGE_DIR;
@@ -370,6 +389,33 @@ describe("bin command routing and fallbacks", () => {
expect(commandMocks.runMessageOutbox).toHaveBeenCalledWith("demo");
});
it("routes plugin install and add alias to the same install handler", async () => {
await runBin(["plugin", "install", "fusion-plugin-hermes-runtime", "-P", "demo"]);
await runBin(["plugin", "add", "fusion-plugin-hermes-runtime", "-P", "demo"]);
expect(commandMocks.runPluginInstall).toHaveBeenNthCalledWith(1, "fusion-plugin-hermes-runtime", {
projectName: "demo",
});
expect(commandMocks.runPluginInstall).toHaveBeenNthCalledWith(2, "fusion-plugin-hermes-runtime", {
projectName: "demo",
});
});
it("errors when plugin install source is missing", async () => {
await expect(runBin(["plugin", "add"])).rejects.toThrow("process.exit:1");
expect(errorSpy).toHaveBeenCalledWith(
"Usage: fn plugin install <path-or-package> (alias: fn plugin add <path-or-package>)",
);
});
it("shows plugin help guidance with install/add alias on unknown plugin subcommand", async () => {
await expect(runBin(["plugin", "oops"])).rejects.toThrow("process.exit:1");
expect(errorSpy).toHaveBeenCalledWith("Unknown subcommand: plugin oops");
expect(logSpy).toHaveBeenCalledWith(
"Try: fn plugin list | install | add (alias for install) | uninstall | enable | disable | create",
);
});
it("routes node add with typed option parsing", async () => {
await runBin([
"node",

13
packages/cli/src/bin.ts
View File

@@ -306,7 +306,8 @@ Usage:
fn backup --restore <file> Restore database from a backup file
fn backup --cleanup Remove old backups exceeding retention limit
fn plugin list | ls List installed plugins
fn plugin install <path> Install a plugin from path
fn plugin install <path-or-package> Install a plugin from path or package
fn plugin add <path-or-package> Alias for plugin install
fn plugin uninstall <id> [--force] Uninstall a plugin
fn plugin enable <id> Enable a plugin
fn plugin disable <id> Disable a plugin
@@ -1222,9 +1223,13 @@ async function main() {
case "ls":
await runPluginList(projectName);
break;
case "install": {
case "install":
case "add": {
const source = args[2];
if (!source) { console.error("Usage: fn plugin install <path-or-package>"); process.exit(1); }
if (!source) {
console.error("Usage: fn plugin install <path-or-package> (alias: fn plugin add <path-or-package>)");
process.exit(1);
}
await runPluginInstall(source, { projectName });
break;
}
@@ -1255,7 +1260,7 @@ async function main() {
}
default:
console.error(`Unknown subcommand: plugin ${sub || ""}`);
console.log("Try: fn plugin list | install | uninstall | enable | disable | create");
console.log("Try: fn plugin list | install | add (alias for install) | uninstall | enable | disable | create");
process.exit(1);
}
break;