Settings Schema: Four different setting types (string, number, boolean, enum)
Lifecycle Hooks: onLoad, onTaskCreated, onTaskCompleted that read settings at runtime
Plugin Tools: Two AI-agent-callable tools that expose settings-driven functionality

Installation via Dashboard Settings

Method 1: Settings → Plugins (Recommended)

Open the Fusion dashboard
Navigate to Settings (gear icon in header)
Click Plugins in the sidebar
Click the Install button

Enter the absolute path to this plugin directory:

/absolute/path/to/plugins/examples/fusion-plugin-settings-demo

Click Install to register the plugin
The plugin will appear in the list with state "installed"
Click the toggle to enable the plugin
Click the Settings (gear) icon to configure the plugin:
- Greeting Message: Custom message shown when plugin loads
- Max Tags: Maximum tags to suggest per task (1-10)
- Enable Logging: Toggle console logging on/off
- Log Level: Minimum log level (debug, info, warn, error)
Click Save Settings to apply configuration
The plugin will reload with the new settings

Method 2: Manual Installation

# Clone the repository
git clone https://github.com/gsxdsm/fusion.git
cd fusion/plugins/examples/fusion-plugin-settings-demo

Then use the dashboard Settings → Plugins UI to install from the local path.

Settings

Setting	Type	Default	Description
`greetingMessage`	string	"Hello from Settings Demo!"	Custom greeting shown on load
`maxTags`	number	3	Maximum tags to suggest per task
`enableLogging`	boolean	true	Enable/disable console logging
`logLevel`	enum	"info"	Minimum log level: debug, info, warn, error

Tools

`settings_demo_suggest_tags`

Analyze a task description and suggest relevant tags based on keyword matching.

Parameters:

taskDescription (string, required): The task description to analyze

Returns: Suggested tags separated by commas

`settings_demo_status`

Get the current plugin configuration status.

Parameters: None

Returns: Current settings values

Hooks

Hook	When	What it does
`onLoad`	Plugin starts	Logs greeting message and configuration
`onTaskCreated`	New task created	Suggests tags for tasks with descriptions
`onTaskCompleted`	Task reaches "done"	Logs completion message

Development

# Install dependencies
pnpm install

# Run tests
pnpm test

# Build (if needed)
pnpm build

Project Structure

fusion-plugin-settings-demo/
├── manifest.json           # Plugin metadata and settings schema
├── package.json            # Package configuration
├── tsconfig.json           # TypeScript configuration
├── vitest.config.ts        # Test configuration
├── README.md               # This file
└── src/
    ├── index.ts            # Plugin implementation
    └── __tests__/
        └── index.test.ts    # Plugin tests

Testing

The plugin includes unit tests that verify:

Manifest correctness and metadata consistency
Plugin export validity
Settings schema definition
Hook behavior with different configuration values
Tool execution with settings-driven output

Run tests:

pnpm test

Example Usage

After installing and configuring the plugin:

Create a new task with description mentioning keywords like "bug", "fix", "performance"
The plugin will suggest relevant tags based on the content
Check the console logs (if enabled) to see plugin activity
Use the /settings_demo_suggest_tags tool to get tag suggestions
Use the /settings_demo_status tool to see current configuration

Notes

The plugin uses src/index.ts as the entrypoint for local installation
Settings changes trigger a plugin reload automatically
Hook errors are isolated and won't crash the host system
Tools use the current settings values at execution time