magus-cli 0.0.0-placeholder → 7.1.0

package/src/ui/state/reducer.ts

@@ -0,0 +1,810 @@
+import type { AppAction, AppState } from "./types.js";
+import { asyncValue } from "./types.js";
+
+export const initialState: AppState = {
+	// Navigation - start on plugins screen
+	currentRoute: { screen: "plugins" },
+
+	// Project context
+	projectPath: process.cwd(),
+
+	// Global UI state
+	modal: null,
+	progress: null,
+	isSearching: false,
+	detailActive: false,
+
+	// Refresh counter for triggering data refetch
+	dataRefreshVersion: 0,
+
+	// Screen-specific state
+	plugins: {
+		scope: "project",
+		collapsedMarketplaces: new Set(),
+		expandedPlugins: new Set(),
+		pluginContents: new Map(),
+		skillDetails: new Map(),
+		selectedIndex: 0,
+		searchQuery: "",
+		marketplaces: { status: "idle" },
+		plugins: { status: "idle" },
+	},
+
+	mcp: {
+		selectedIndex: 0,
+		servers: { status: "idle" },
+		installedServers: {},
+	},
+
+	mcpRegistry: {
+		searchQuery: "",
+		selectedIndex: 0,
+		servers: { status: "idle" },
+	},
+
+	settings: {
+		selectedIndex: 0,
+		values: { status: "idle" },
+	},
+
+	cliTools: {
+		selectedIndex: 0,
+		tools: { status: "idle" },
+	},
+
+	profiles: {
+		selectedIndex: 0,
+		profiles: { status: "idle" },
+	},
+
+	skills: {
+		scope: "user",
+		selectedIndex: 0,
+		searchQuery: "",
+		skills: { status: "idle" },
+		updateStatus: null,
+	},
+
+	styles: {
+		selectedIndex: 0,
+		searchQuery: "",
+		snapshot: { status: "idle" },
+		selected: new Set(),
+		status: null,
+		isFilling: false,
+	},
+
+	models: {
+		// The status header sits at 0 and the cursor cannot land on it. The screen
+		// moves off it on first render; starting at 1 here would be a second place
+		// encoding the list's shape, and it would be wrong the moment the header
+		// gained a row.
+		selectedIndex: 0,
+		searchQuery: "",
+		data: { status: "idle" },
+		status: null,
+		isApplying: false,
+		// False until the plugin lookup answers, and false again if it fails. Both cases
+		// render the screen as it was before mates existed, which is the honest drawing of
+		// "we do not know yet" — see `areMatesAvailable`.
+		matesAvailable: false,
+		// Empty until the catalogue lands, and empty for good if it cannot be read. Both
+		// render identically — no advisory at all — which is exactly the contract
+		// `unknownBindings` holds to: say nothing about a catalogue you could not reach.
+		mateCatalog: [],
+	},
+};
+
+export function appReducer(state: AppState, action: AppAction): AppState {
+	switch (action.type) {
+		// =========================================================================
+		// Navigation
+		// =========================================================================
+		case "NAVIGATE":
+			return {
+				...state,
+				currentRoute: action.route,
+				// Clear transient sub-view state when navigating away
+				isSearching: false,
+				detailActive: false,
+			};
+
+		// =========================================================================
+		// Plugins Screen
+		// =========================================================================
+		case "PLUGINS_SET_SCOPE":
+			return {
+				...state,
+				plugins: {
+					...state.plugins,
+					scope: action.scope,
+					selectedIndex: 0, // Reset selection when scope changes
+					marketplaces: { status: "loading" },
+					plugins: { status: "loading" },
+				},
+			};
+
+		case "PLUGINS_TOGGLE_SCOPE":
+			return appReducer(state, {
+				type: "PLUGINS_SET_SCOPE",
+				scope: state.plugins.scope === "project" ? "global" : "project",
+			});
+
+		case "PLUGINS_TOGGLE_MARKETPLACE": {
+			const collapsed = new Set(state.plugins.collapsedMarketplaces);
+			if (collapsed.has(action.name)) {
+				collapsed.delete(action.name);
+			} else {
+				collapsed.add(action.name);
+			}
+			return {
+				...state,
+				plugins: {
+					...state.plugins,
+					collapsedMarketplaces: collapsed,
+				},
+			};
+		}
+
+		case "PLUGINS_TOGGLE_PLUGIN_CONTENTS": {
+			const expanded = new Set(state.plugins.expandedPlugins);
+			if (expanded.has(action.pluginId)) {
+				expanded.delete(action.pluginId);
+			} else {
+				expanded.add(action.pluginId);
+			}
+			return {
+				...state,
+				plugins: { ...state.plugins, expandedPlugins: expanded },
+			};
+		}
+
+		case "PLUGINS_CONTENTS_LOADING":
+		case "PLUGINS_CONTENTS_SUCCESS":
+		case "PLUGINS_CONTENTS_ERROR": {
+			const pluginContents = new Map(state.plugins.pluginContents);
+			if (action.type === "PLUGINS_CONTENTS_LOADING") {
+				pluginContents.set(action.pluginId, { status: "loading" });
+			} else if (action.type === "PLUGINS_CONTENTS_SUCCESS") {
+				pluginContents.set(action.pluginId, {
+					status: "success",
+					components: action.components,
+				});
+			} else {
+				pluginContents.set(action.pluginId, {
+					status: "error",
+					error: action.error,
+				});
+			}
+			return { ...state, plugins: { ...state.plugins, pluginContents } };
+		}
+
+		case "PLUGINS_SKILL_DETAIL_LOADING":
+		case "PLUGINS_SKILL_DETAIL_SUCCESS":
+		case "PLUGINS_SKILL_DETAIL_ERROR": {
+			const skillDetails = new Map(state.plugins.skillDetails);
+			if (action.type === "PLUGINS_SKILL_DETAIL_LOADING") {
+				skillDetails.set(action.key, { status: "loading" });
+			} else if (action.type === "PLUGINS_SKILL_DETAIL_SUCCESS") {
+				skillDetails.set(action.key, {
+					status: "success",
+					detail: action.detail,
+				});
+			} else {
+				skillDetails.set(action.key, {
+					status: "error",
+					error: action.error,
+				});
+			}
+			return { ...state, plugins: { ...state.plugins, skillDetails } };
+		}
+
+		case "PLUGINS_SELECT":
+			return {
+				...state,
+				plugins: {
+					...state.plugins,
+					selectedIndex: action.index,
+				},
+			};
+
+		case "PLUGINS_SET_SEARCH":
+			return {
+				...state,
+				plugins: {
+					...state.plugins,
+					searchQuery: action.query,
+					selectedIndex: 0, // Reset selection when search changes
+				},
+			};
+
+		case "PLUGINS_DATA_LOADING":
+			return {
+				...state,
+				plugins: {
+					...state.plugins,
+					// Hand the previous list forward so a reload refreshes in place
+					// instead of replacing the screen with "Loading...".
+					marketplaces: {
+						status: "loading",
+						previous: asyncValue(state.plugins.marketplaces),
+					},
+					plugins: {
+						status: "loading",
+						previous: asyncValue(state.plugins.plugins),
+					},
+				},
+			};
+
+		case "PLUGINS_DATA_SUCCESS":
+			return {
+				...state,
+				plugins: {
+					...state.plugins,
+					marketplaces: { status: "success", data: action.marketplaces },
+					plugins: { status: "success", data: action.plugins },
+				},
+			};
+
+		case "PLUGINS_DATA_ERROR":
+			return {
+				...state,
+				plugins: {
+					...state.plugins,
+					marketplaces: { status: "error", error: action.error },
+					plugins: { status: "error", error: action.error },
+				},
+			};
+
+		// =========================================================================
+		// MCP Screen
+		// =========================================================================
+		case "MCP_SELECT":
+			return {
+				...state,
+				mcp: {
+					...state.mcp,
+					selectedIndex: action.index,
+				},
+			};
+
+		case "MCP_DATA_LOADING":
+			return {
+				...state,
+				mcp: {
+					...state.mcp,
+					servers: { status: "loading" },
+				},
+			};
+
+		case "MCP_DATA_SUCCESS":
+			return {
+				...state,
+				mcp: {
+					...state.mcp,
+					servers: { status: "success", data: action.servers },
+					installedServers: action.installedServers,
+				},
+			};
+
+		case "MCP_DATA_ERROR":
+			return {
+				...state,
+				mcp: {
+					...state.mcp,
+					servers: { status: "error", error: action.error },
+				},
+			};
+
+		// =========================================================================
+		// MCP Registry Screen
+		// =========================================================================
+		case "MCP_REGISTRY_SET_QUERY":
+		case "MCPREGISTRY_SEARCH":
+			return {
+				...state,
+				mcpRegistry: {
+					...state.mcpRegistry,
+					searchQuery: action.query,
+					selectedIndex: 0,
+				},
+			};
+
+		case "MCP_REGISTRY_SELECT":
+		case "MCPREGISTRY_SELECT":
+			return {
+				...state,
+				mcpRegistry: {
+					...state.mcpRegistry,
+					selectedIndex: action.index,
+				},
+			};
+
+		case "MCP_REGISTRY_DATA_LOADING":
+			return {
+				...state,
+				mcpRegistry: {
+					...state.mcpRegistry,
+					servers: { status: "loading" },
+				},
+			};
+
+		case "MCP_REGISTRY_DATA_SUCCESS":
+			return {
+				...state,
+				mcpRegistry: {
+					...state.mcpRegistry,
+					servers: { status: "success", data: action.servers },
+				},
+			};
+
+		case "MCP_REGISTRY_DATA_ERROR":
+			return {
+				...state,
+				mcpRegistry: {
+					...state.mcpRegistry,
+					servers: { status: "error", error: action.error },
+				},
+			};
+
+		// =========================================================================
+		// Settings Screen
+		// =========================================================================
+		case "SETTINGS_SELECT":
+			return {
+				...state,
+				settings: {
+					...state.settings,
+					selectedIndex: action.index,
+				},
+			};
+
+		case "SETTINGS_DATA_LOADING":
+			return {
+				...state,
+				settings: {
+					...state.settings,
+					values: { status: "loading" },
+				},
+			};
+
+		case "SETTINGS_DATA_SUCCESS":
+			return {
+				...state,
+				settings: {
+					...state.settings,
+					values: { status: "success", data: action.values },
+				},
+			};
+
+		case "SETTINGS_DATA_ERROR":
+			return {
+				...state,
+				settings: {
+					...state.settings,
+					values: { status: "error", error: action.error },
+				},
+			};
+
+		// =========================================================================
+		// CLI Tools Screen
+		// =========================================================================
+		case "CLITOOLS_SELECT":
+			return {
+				...state,
+				cliTools: {
+					...state.cliTools,
+					selectedIndex: action.index,
+				},
+			};
+
+		case "CLITOOLS_DATA_LOADING":
+			return {
+				...state,
+				cliTools: {
+					...state.cliTools,
+					tools: { status: "loading" },
+				},
+			};
+
+		case "CLITOOLS_DATA_SUCCESS":
+			return {
+				...state,
+				cliTools: {
+					...state.cliTools,
+					tools: { status: "success", data: action.tools },
+				},
+			};
+
+		case "CLITOOLS_DATA_ERROR":
+			return {
+				...state,
+				cliTools: {
+					...state.cliTools,
+					tools: { status: "error", error: action.error },
+				},
+			};
+
+		case "CLITOOLS_UPDATE_TOOL": {
+			if (state.cliTools.tools.status !== "success") return state;
+			return {
+				...state,
+				cliTools: {
+					...state.cliTools,
+					tools: {
+						status: "success",
+						data: state.cliTools.tools.data.map((tool) =>
+							tool.name === action.name ? { ...tool, ...action.updates } : tool,
+						),
+					},
+				},
+			};
+		}
+
+		// =========================================================================
+		// Profiles Screen
+		// =========================================================================
+		case "PROFILES_SELECT":
+			return {
+				...state,
+				profiles: {
+					...state.profiles,
+					selectedIndex: action.index,
+				},
+			};
+
+		case "PROFILES_DATA_LOADING":
+			return {
+				...state,
+				profiles: {
+					...state.profiles,
+					profiles: { status: "loading" },
+				},
+			};
+
+		case "PROFILES_DATA_SUCCESS":
+			return {
+				...state,
+				profiles: {
+					...state.profiles,
+					profiles: { status: "success", data: action.profiles },
+				},
+			};
+
+		case "PROFILES_DATA_ERROR":
+			return {
+				...state,
+				profiles: {
+					...state.profiles,
+					profiles: { status: "error", error: action.error },
+				},
+			};
+
+		// =========================================================================
+		// Skills Screen
+		// =========================================================================
+		case "SKILLS_SET_SCOPE":
+			return {
+				...state,
+				skills: {
+					...state.skills,
+					scope: action.scope,
+					selectedIndex: 0,
+					skills: { status: "loading" },
+				},
+			};
+
+		case "SKILLS_TOGGLE_SCOPE":
+			return appReducer(state, {
+				type: "SKILLS_SET_SCOPE",
+				scope: state.skills.scope === "user" ? "project" : "user",
+			});
+
+		case "SKILLS_SELECT":
+			return {
+				...state,
+				skills: {
+					...state.skills,
+					selectedIndex: action.index,
+				},
+			};
+
+		case "SKILLS_SET_SEARCH":
+			return {
+				...state,
+				skills: {
+					...state.skills,
+					searchQuery: action.query,
+					selectedIndex: 0,
+				},
+			};
+
+		case "SKILLS_DATA_LOADING":
+			return {
+				...state,
+				skills: {
+					...state.skills,
+					skills: { status: "loading" },
+				},
+			};
+
+		case "SKILLS_DATA_SUCCESS":
+			return {
+				...state,
+				skills: {
+					...state.skills,
+					skills: { status: "success", data: action.skills },
+				},
+			};
+
+		case "SKILLS_DATA_ERROR":
+			return {
+				...state,
+				skills: {
+					...state.skills,
+					skills: { status: "error", error: action.error },
+				},
+			};
+
+		case "SKILLS_UPDATE_STATUS":
+			return {
+				...state,
+				skills: {
+					...state.skills,
+					updateStatus: action.updates,
+				},
+			};
+
+		case "SKILLS_UPDATE_ITEM": {
+			if (state.skills.skills.status !== "success") return state;
+			return {
+				...state,
+				skills: {
+					...state.skills,
+					skills: {
+						status: "success",
+						data: state.skills.skills.data.map((s) =>
+							s.name === action.name ? { ...s, ...action.updates } : s,
+						),
+					},
+				},
+			};
+		}
+
+		// =========================================================================
+		// Styles screen
+		// =========================================================================
+		case "STYLES_SELECT":
+			return {
+				...state,
+				styles: { ...state.styles, selectedIndex: action.index },
+			};
+
+		case "STYLES_SET_SEARCH":
+			return {
+				...state,
+				styles: { ...state.styles, searchQuery: action.query },
+			};
+
+		case "STYLES_SEARCH_APPEND":
+			return {
+				...state,
+				styles: {
+					...state.styles,
+					searchQuery: state.styles.searchQuery + action.char,
+					selectedIndex: 0,
+				},
+			};
+
+		case "STYLES_SEARCH_BACKSPACE":
+			return {
+				...state,
+				styles: {
+					...state.styles,
+					searchQuery: state.styles.searchQuery.slice(0, -1),
+					selectedIndex: 0,
+				},
+			};
+
+		case "STYLES_DATA_LOADING":
+			return {
+				...state,
+				styles: { ...state.styles, snapshot: { status: "loading" } },
+			};
+
+		case "STYLES_DATA_SUCCESS":
+			return {
+				...state,
+				styles: {
+					...state.styles,
+					snapshot: { status: "success", data: action.snapshot },
+					// Seed from the project's committed declaration when there is
+					// one, falling back to whatever is live locally.
+					//
+					// The declaration wins deliberately. It is what the project asked
+					// for; the local artifact is only what this machine last did. When
+					// the two differ the screen says "press a to re-apply" — and that
+					// sentence is a lie if `a` would re-apply the stale local set
+					// instead of the pulled one.
+					selected: new Set(
+						action.snapshot.declaration
+							? [
+									...action.snapshot.declaration.presets,
+									...action.snapshot.declaration.imports,
+								]
+							: [
+									...(action.snapshot.applied?.presets ?? []),
+									...(action.snapshot.applied?.imports ?? []),
+								],
+					),
+				},
+			};
+
+		case "STYLES_DATA_ERROR":
+			return {
+				...state,
+				styles: {
+					...state.styles,
+					snapshot: { status: "error", error: action.error },
+				},
+			};
+
+		case "STYLES_STATUS_SET":
+			return { ...state, styles: { ...state.styles, status: action.status } };
+
+		case "STYLES_STATUS_CLEAR":
+			return { ...state, styles: { ...state.styles, status: null } };
+
+		case "STYLES_FILL_START":
+			return { ...state, styles: { ...state.styles, isFilling: true } };
+
+		case "STYLES_FILL_END":
+			return { ...state, styles: { ...state.styles, isFilling: false } };
+
+		case "STYLES_TOGGLE": {
+			const selected = new Set(state.styles.selected);
+			if (selected.has(action.id)) selected.delete(action.id);
+			else selected.add(action.id);
+			return { ...state, styles: { ...state.styles, selected } };
+		}
+
+		case "STYLES_SET_SELECTION":
+			return {
+				...state,
+				styles: { ...state.styles, selected: new Set(action.ids) },
+			};
+
+		// =========================================================================
+		// Models screen
+		// =========================================================================
+		case "MODELS_SELECT":
+			return {
+				...state,
+				models: { ...state.models, selectedIndex: action.index },
+			};
+
+		case "MODELS_SET_SEARCH":
+			return {
+				...state,
+				models: { ...state.models, searchQuery: action.query },
+			};
+
+		case "MODELS_SEARCH_APPEND":
+			return {
+				...state,
+				models: {
+					...state.models,
+					searchQuery: state.models.searchQuery + action.char,
+					selectedIndex: 0,
+				},
+			};
+
+		case "MODELS_SEARCH_BACKSPACE":
+			return {
+				...state,
+				models: {
+					...state.models,
+					searchQuery: state.models.searchQuery.slice(0, -1),
+					selectedIndex: 0,
+				},
+			};
+
+		case "MODELS_DATA_LOADING":
+			return {
+				...state,
+				models: {
+					...state.models,
+					// Carry the last good snapshot through the reload. The router
+					// unmounts this screen on every tab switch, so without it a return
+					// visit blanks the list to "Reading…" and the cursor resets — and
+					// reading the routing is not instant: it scans session transcripts
+					// to resolve the live model id behind each alias.
+					data: {
+						status: "loading",
+						previous: asyncValue(state.models.data),
+					},
+				},
+			};
+
+		case "MODELS_DATA_SUCCESS":
+			return {
+				...state,
+				models: {
+					...state.models,
+					data: { status: "success", data: action.snapshot },
+				},
+			};
+
+		case "MODELS_DATA_ERROR":
+			return {
+				...state,
+				models: {
+					...state.models,
+					data: { status: "error", error: action.error },
+				},
+			};
+
+		case "MODELS_STATUS_SET":
+			return { ...state, models: { ...state.models, status: action.status } };
+
+		case "MODELS_STATUS_CLEAR":
+			return { ...state, models: { ...state.models, status: null } };
+
+		case "MODELS_APPLY_START":
+			return { ...state, models: { ...state.models, isApplying: true } };
+
+		case "MODELS_APPLY_END":
+			return { ...state, models: { ...state.models, isApplying: false } };
+
+		case "MODELS_MATES_AVAILABLE":
+			return {
+				...state,
+				models: { ...state.models, matesAvailable: action.available },
+			};
+
+		case "MODELS_CATALOG_LOADED":
+			return {
+				...state,
+				models: { ...state.models, mateCatalog: action.catalog },
+			};
+
+		// =========================================================================
+		// Modals
+		// =========================================================================
+		case "SHOW_MODAL":
+			return { ...state, modal: action.modal, isSearching: true };
+
+		case "HIDE_MODAL":
+			return { ...state, modal: null, isSearching: false };
+
+		// =========================================================================
+		// Progress
+		// =========================================================================
+		case "SHOW_PROGRESS":
+			return { ...state, progress: action.state };
+
+		case "UPDATE_PROGRESS":
+			return { ...state, progress: action.state };
+
+		case "HIDE_PROGRESS":
+			return { ...state, progress: null };
+
+		// =========================================================================
+		// Search State
+		// =========================================================================
+		case "SET_SEARCHING":
+			return { ...state, isSearching: action.isSearching };
+
+		case "SET_DETAIL_ACTIVE":
+			return { ...state, detailActive: action.detailActive };
+
+		// =========================================================================
+		// Data Refresh
+		// =========================================================================
+		case "DATA_REFRESH_COMPLETE":
+			return { ...state, dataRefreshVersion: state.dataRefreshVersion + 1 };
+
+		default:
+			return state;
+	}
+}