Module plugins 

Plugin and marketplace actions over the command bus.

The work is reachable through crate::Command so that any view can act, rather than one view reaching for the forge-agent CLI functions this module calls from inside its own layer (rule 24’s case). The CLI calls, the batch runner and the disk scan are forge-agent’s; what lives here is the orchestration: resolving each action’s working directory from forge.toml rather than the launch directory (hard rule 14), serializing actions one at a time, and reporting through the Plugins* updates a view already listens to.

One run at a time: an update-all, a check and an action all serialize through Workspace::plugin_action_running, and the latest run stays readable mid-flight so a view attaching during one draws it.

Re-exports

use std::path::PathBuf; 🔒

use std::sync::Arc; 🔒

use std::sync::atomic::Ordering; 🔒

use std::time::Duration; 🔒

use forge_agent::userdata::plugins::cli; 🔒

use forge_agent::userdata::plugins::cli::UpdateRunner; 🔒

use forge_primitives::plugins::InstalledPluginEntry; 🔒

use forge_primitives::plugins::MarketplaceEntry; 🔒

use forge_primitives::plugins::MarketplaceSourceEntry; 🔒

use forge_primitives::plugins::PluginRunRowStatus; 🔒

use forge_primitives::plugins::PluginUpdateRun; 🔒

use forge_primitives::plugins::PluginUpdateRunRow; 🔒

use forge_primitives::plugins::PluginUpdateTrigger; 🔒

use forge_primitives::plugins::PluginsCliActionSuccess; 🔒

use forge_primitives::plugins::PluginsInventorySnapshot; 🔒

use forge_primitives::plugins::update_availability; 🔒

use crate::protocol::DispatchError; 🔒

use crate::protocol::SessionUpdate; 🔒

use crate::workspace::Workspace; 🔒

Structs

PluginActionGuard 🔒

Clears the single-action gate however its task ends, panic included: a crashed task that left the gate shut would refuse every later press with no way back.

PluginCli 🔒

How the plugin actions reach claude and the disk. Real in every production build.

Constants

PLUGIN_CALL_TIMEOUT 🔒

Upper bound on one CLI call inside a batch; a hung call fails its row instead of pinning the run forever.

Functions

fail_action 🔒

Report a failed action, or a refusal found before one could run, on the frame the page already listens for.

plugin_call_cwd 🔒

The working directory one plugin CLI call runs in.

run_action 🔒

Run one CLI action and report its outcome on the Plugins frames.

run_update_batch 🔒

Run one update batch, reporting progress per row, persisting the rollback records it earns, and finishing with the refreshed inventory.

scan_inventory 🔒

The disk scan, off the runtime.

stale_rows 🔒

The run rows one update-all/check queues: exactly the stale installed entries, one per registry entry, each with the cwd its own scope runs in.

Type Aliases

PluginCliFut 🔒

One future handed back by the plugin CLI seams.

RefreshFn 🔒

RunAndRefresh 🔒

ScanFn 🔒