Struct IFlowAgent 

pub struct IFlowAgent { /* private fields */ }

iFlow CLI installer.

Implementations

impl IFlowAgent

pub const fn new() -> Self

Construct an instance. Stateless.

Trait Implementations

impl Clone for IFlowAgent

fn clone(&self) -> IFlowAgent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IFlowAgent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for IFlowAgent

fn default() -> IFlowAgent

Returns the “default value” for a type.

impl Integration for IFlowAgent

fn id(&self) -> &'static str

Stable, kebab-case identifier (e.g., "claude", "cursor").

fn display_name(&self) -> &'static str

Human-readable name (e.g., "Claude Code").

fn supported_scopes(&self) -> &'static [ScopeKind]

Which scopes this integration accepts.

fn status( &self, scope: &Scope, tag: &str, ) -> Result<StatusReport, AgentConfigError>

Detailed installation state for the hook identified by tag.

fn plan_install( &self, scope: &Scope, spec: &HookSpec, ) -> Result<InstallPlan, AgentConfigError>

Plan a hook install without mutating user files.

fn plan_uninstall( &self, scope: &Scope, tag: &str, ) -> Result<UninstallPlan, AgentConfigError>

Plan a hook uninstall without mutating user files.

fn install( &self, scope: &Scope, spec: &HookSpec, ) -> Result<InstallReport, AgentConfigError>

Install the hook. Repeated calls with the same spec.tag are a no-op after the first (the on-disk state is reached, then preserved).

fn uninstall( &self, scope: &Scope, tag: &str, ) -> Result<UninstallReport, AgentConfigError>

Uninstall the hook identified by tag. Restores .bak files when removing our content leaves the target file empty or pristine.

fn is_installed( &self, scope: &Scope, tag: &str, ) -> Result<bool, AgentConfigError>

Returns true if a hook with this tag is currently installed in this scope. Used by CLI consumers to render install/uninstall state.

fn validate( &self, scope: &Scope, tag: &str, ) -> Result<ValidationReport, AgentConfigError>

Validate hook state without mutating user files.

fn migrate( &self, _scope: &Scope, _tag: &str, ) -> Result<MigrationReport, AgentConfigError>

Migrate any prior layout produced by an earlier version of the consumer (e.g., remove a legacy shell-script wrapper that has since been superseded by a native binary). Default impl is a no-op.

impl McpSurface for IFlowAgent

fn id(&self) -> &'static str

Stable, kebab-case identifier matching Integration::id for the same agent (e.g., "claude").

fn supported_mcp_scopes(&self) -> &'static [ScopeKind]

Which scopes this MCP installer accepts.

fn mcp_status( &self, scope: &Scope, name: &str, expected_owner: &str, ) -> Result<StatusReport, AgentConfigError>

Detailed installation state for the MCP server identified by name, scored against expected_owner.

fn plan_install_mcp( &self, scope: &Scope, spec: &McpSpec, ) -> Result<InstallPlan, AgentConfigError>

Plan an MCP server install without mutating user files.

fn plan_uninstall_mcp( &self, scope: &Scope, name: &str, owner_tag: &str, ) -> Result<UninstallPlan, AgentConfigError>

Plan an MCP server uninstall without mutating user files.

fn install_mcp( &self, scope: &Scope, spec: &McpSpec, ) -> Result<InstallReport, AgentConfigError>

Install (or update) the MCP server. Repeated calls with the same spec.name and same content are a no-op after the first.

fn uninstall_mcp( &self, scope: &Scope, name: &str, owner_tag: &str, ) -> Result<UninstallReport, AgentConfigError>

Uninstall the MCP server identified by name, owned by owner_tag.

fn is_mcp_installed( &self, scope: &Scope, name: &str, ) -> Result<bool, AgentConfigError>

Returns true if a server with name is currently recorded under any owner in this scope’s ownership ledger.

fn validate_mcp( &self, scope: &Scope, name: &str, ) -> Result<ValidationReport, AgentConfigError>

Validate MCP state without mutating user files.

fn validate_mcp_for_owner( &self, scope: &Scope, name: &str, expected_owner: Option<&str>, ) -> Result<ValidationReport, AgentConfigError>

Validate MCP state against a caller-supplied expected owner.

impl Copy for IFlowAgent