claudeup 1.7.0 → 3.3.0

package/src/ui/state/types.ts

@@ -0,0 +1,273 @@
+import type {
+	Marketplace,
+	McpServer,
+	StatusLineConfig,
+} from "../../types/index.js";
+import type { PluginInfo } from "../../services/plugin-manager.js";
+
+// ============================================================================
+// Route Types
+// ============================================================================
+
+export type Screen =
+	| "plugins"
+	| "mcp"
+	| "mcp-registry"
+	| "statusline"
+	| "env-vars"
+	| "cli-tools"
+	| "model-selector";
+
+export type Route =
+	| { screen: "plugins" }
+	| { screen: "mcp" }
+	| { screen: "mcp-registry"; query?: string }
+	| { screen: "statusline" }
+	| { screen: "env-vars" }
+	| { screen: "cli-tools" }
+	| { screen: "model-selector" };
+
+// ============================================================================
+// Async Data Types
+// ============================================================================
+
+export type AsyncData<T> =
+	| { status: "idle" }
+	| { status: "loading" }
+	| { status: "success"; data: T }
+	| { status: "error"; error: Error };
+
+// ============================================================================
+// Modal Types
+// ============================================================================
+
+export interface SelectOption {
+	label: string;
+	value: string;
+	description?: string;
+}
+
+export type ModalState =
+	| {
+			type: "confirm";
+			title: string;
+			message: string;
+			onConfirm: () => void;
+			onCancel: () => void;
+	  }
+	| {
+			type: "input";
+			title: string;
+			label: string;
+			defaultValue?: string;
+			onSubmit: (value: string) => void;
+			onCancel: () => void;
+	  }
+	| {
+			type: "select";
+			title: string;
+			message: string;
+			options: SelectOption[];
+			onSelect: (value: string) => void;
+			onCancel: () => void;
+	  }
+	| {
+			type: "message";
+			title: string;
+			message: string;
+			variant: "info" | "success" | "error";
+			onDismiss: () => void;
+	  }
+	| {
+			type: "loading";
+			message: string;
+	  };
+
+// ============================================================================
+// Progress Types
+// ============================================================================
+
+export interface ProgressState {
+	message: string;
+	current?: number;
+	total?: number;
+}
+
+// ============================================================================
+// Screen State Types
+// ============================================================================
+
+export interface PluginsScreenState {
+	scope: "project" | "global";
+	collapsedMarketplaces: Set<string>;
+	selectedIndex: number;
+	searchQuery: string;
+	marketplaces: AsyncData<Marketplace[]>;
+	plugins: AsyncData<PluginInfo[]>;
+}
+
+export interface McpScreenState {
+	selectedIndex: number;
+	servers: AsyncData<McpServer[]>;
+	installedServers: Record<string, boolean>;
+}
+
+export interface McpRegistryScreenState {
+	searchQuery: string;
+	selectedIndex: number;
+	servers: AsyncData<McpServer[]>;
+}
+
+export interface StatusLineScreenState {
+	scope: "project" | "global";
+	selectedIndex: number;
+	presets: AsyncData<StatusLineConfig[]>;
+	currentPreset: string | null;
+}
+
+export interface EnvVarsScreenState {
+	selectedIndex: number;
+	variables: AsyncData<Record<string, string>>;
+}
+
+export interface CliTool {
+	name: string;
+	displayName: string;
+	description: string;
+	installCommand: string;
+	checkCommand: string;
+	homebrewFormula?: string;
+	npmPackage?: string;
+	installedVersion?: string;
+	latestVersion?: string;
+	hasUpdate?: boolean;
+	isInstalled: boolean;
+	isChecking: boolean;
+}
+
+export interface CliToolsScreenState {
+	selectedIndex: number;
+	tools: AsyncData<CliTool[]>;
+}
+
+export interface ModelSelectorScreenState {
+	selectedIndex: number;
+	searchQuery: string;
+	taskSize: "large" | "small";
+}
+
+// ============================================================================
+// App State
+// ============================================================================
+
+export interface AppState {
+	// Navigation
+	currentRoute: Route;
+
+	// Project context
+	projectPath: string;
+
+	// Global UI state
+	modal: ModalState | null;
+	progress: ProgressState | null;
+	isSearching: boolean;
+
+	// Refresh counter - incremented when marketplace sync completes
+	// Screens can watch this to know when to refetch data
+	dataRefreshVersion: number;
+
+	// Screen-specific state
+	plugins: PluginsScreenState;
+	mcp: McpScreenState;
+	mcpRegistry: McpRegistryScreenState;
+	statusline: StatusLineScreenState;
+	envVars: EnvVarsScreenState;
+	cliTools: CliToolsScreenState;
+	modelSelector: ModelSelectorScreenState;
+}
+
+// ============================================================================
+// Action Types
+// ============================================================================
+
+export type AppAction =
+	// Navigation
+	| { type: "NAVIGATE"; route: Route }
+
+	// Plugins screen
+	| { type: "PLUGINS_SET_SCOPE"; scope: "project" | "global" }
+	| { type: "PLUGINS_TOGGLE_SCOPE" }
+	| { type: "PLUGINS_TOGGLE_MARKETPLACE"; name: string }
+	| { type: "PLUGINS_SELECT"; index: number }
+	| { type: "PLUGINS_SET_SEARCH"; query: string }
+	| { type: "PLUGINS_DATA_LOADING" }
+	| {
+			type: "PLUGINS_DATA_SUCCESS";
+			marketplaces: Marketplace[];
+			plugins: PluginInfo[];
+	  }
+	| { type: "PLUGINS_DATA_ERROR"; error: Error }
+
+	// MCP screen
+	| { type: "MCP_SELECT"; index: number }
+	| { type: "MCP_DATA_LOADING" }
+	| {
+			type: "MCP_DATA_SUCCESS";
+			servers: McpServer[];
+			installedServers: Record<string, boolean>;
+	  }
+	| { type: "MCP_DATA_ERROR"; error: Error }
+
+	// MCP Registry screen
+	| { type: "MCP_REGISTRY_SET_QUERY"; query: string }
+	| { type: "MCPREGISTRY_SEARCH"; query: string } // Alias for MCP_REGISTRY_SET_QUERY
+	| { type: "MCPREGISTRY_SELECT"; index: number } // Alias for MCP_REGISTRY_SELECT
+	| { type: "MCP_REGISTRY_SELECT"; index: number }
+	| { type: "MCP_REGISTRY_DATA_LOADING" }
+	| { type: "MCP_REGISTRY_DATA_SUCCESS"; servers: McpServer[] }
+	| { type: "MCP_REGISTRY_DATA_ERROR"; error: Error }
+
+	// Status line screen
+	| { type: "STATUSLINE_SET_SCOPE"; scope: "project" | "global" }
+	| { type: "STATUSLINE_TOGGLE_SCOPE" }
+	| { type: "STATUSLINE_SELECT"; index: number }
+	| { type: "STATUSLINE_DATA_LOADING" }
+	| {
+			type: "STATUSLINE_DATA_SUCCESS";
+			presets: StatusLineConfig[];
+			currentPreset: string | null;
+	  }
+	| { type: "STATUSLINE_DATA_ERROR"; error: Error }
+
+	// Env vars screen
+	| { type: "ENVVARS_SELECT"; index: number }
+	| { type: "ENVVARS_DATA_LOADING" }
+	| { type: "ENVVARS_DATA_SUCCESS"; variables: Record<string, string> }
+	| { type: "ENVVARS_DATA_ERROR"; error: Error }
+
+	// CLI tools screen
+	| { type: "CLITOOLS_SELECT"; index: number }
+	| { type: "CLITOOLS_DATA_LOADING" }
+	| { type: "CLITOOLS_DATA_SUCCESS"; tools: CliTool[] }
+	| { type: "CLITOOLS_DATA_ERROR"; error: Error }
+	| { type: "CLITOOLS_UPDATE_TOOL"; name: string; updates: Partial<CliTool> }
+
+	// Model Selector Screen
+	| { type: "MODEL_SELECTOR_SELECT"; index: number }
+	| { type: "MODEL_SELECTOR_SET_SEARCH"; query: string }
+	| { type: "MODEL_SELECTOR_SET_TASK_SIZE"; size: "large" | "small" }
+
+	// Modals
+	| { type: "SHOW_MODAL"; modal: ModalState }
+	| { type: "HIDE_MODAL" }
+
+	// Progress
+	| { type: "SHOW_PROGRESS"; state: ProgressState }
+	| { type: "UPDATE_PROGRESS"; state: ProgressState }
+	| { type: "HIDE_PROGRESS" }
+
+	// Search state (blocks global key handlers)
+	| { type: "SET_SEARCHING"; isSearching: boolean }
+
+	// Data refresh - triggers screens to refetch
+	| { type: "DATA_REFRESH_COMPLETE" };

package/{dist → src}/utils/command-utils.js

@@ -1,5 +1,5 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 /**
  * Check if a command exists in PATH
@@ -10,11 +10,10 @@ const execFileAsync = promisify(execFile);
 export async function which(command) {
     try {
         // Use execFile with argument array to prevent command injection
-        const { stdout } = await execFileAsync('which', [command]);
+        const { stdout } = await execFileAsync("which", [command]);
         return stdout.trim() || null;
     }
     catch {
         return null;
     }
 }
-//# sourceMappingURL=command-utils.js.map

package/src/utils/command-utils.ts

@@ -0,0 +1,20 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+
+/**
+ * Check if a command exists in PATH
+ * Uses execFile (not exec) to avoid shell injection vulnerabilities
+ * @param command - Command name to check
+ * @returns Path to command if found, null otherwise
+ */
+export async function which(command: string): Promise<string | null> {
+	try {
+		// Use execFile with argument array to prevent command injection
+		const { stdout } = await execFileAsync("which", [command]);
+		return stdout.trim() || null;
+	} catch {
+		return null;
+	}
+}

package/{dist → src}/utils/fuzzy-search.js

@@ -52,7 +52,7 @@ export function fuzzyMatch(query, target) {
  */
 export function fuzzyFilter(items, query, getText) {
     if (!query.trim()) {
-        return items.map(item => ({ item, score: 1, matches: [] }));
+        return items.map((item) => ({ item, score: 1, matches: [] }));
     }
     const results = [];
     for (const item of items) {
@@ -79,7 +79,7 @@ export function highlightMatches(text, matches) {
     }
     const matchSet = new Set(matches);
     const segments = [];
-    let currentSegment = '';
+    let currentSegment = "";
     let isHighlighted = matchSet.has(0);
     for (let i = 0; i < text.length; i++) {
         const shouldHighlight = matchSet.has(i);
@@ -99,4 +99,3 @@ export function highlightMatches(text, matches) {
     }
     return segments;
 }
-//# sourceMappingURL=fuzzy-search.js.map

package/src/utils/fuzzy-search.ts

@@ -0,0 +1,138 @@
+/**
+ * Simple fuzzy search utility for filtering lists
+ * Uses a scoring algorithm that rewards:
+ * - Consecutive character matches
+ * - Matches at word boundaries
+ * - Matches at start of string
+ */
+
+export interface FuzzyMatch<T> {
+	item: T;
+	score: number;
+	matches: number[]; // indices of matched characters
+}
+
+/**
+ * Calculate fuzzy match score for a query against a target string
+ * Returns null if no match, otherwise returns score and match indices
+ */
+export function fuzzyMatch(
+	query: string,
+	target: string,
+): { score: number; matches: number[] } | null {
+	if (!query) return { score: 1, matches: [] };
+
+	const queryLower = query.toLowerCase();
+	const targetLower = target.toLowerCase();
+
+	let queryIdx = 0;
+	let score = 0;
+	const matches: number[] = [];
+	let prevMatchIdx = -1;
+
+	for (let i = 0; i < targetLower.length && queryIdx < queryLower.length; i++) {
+		if (targetLower[i] === queryLower[queryIdx]) {
+			matches.push(i);
+
+			// Bonus for consecutive matches
+			if (prevMatchIdx === i - 1) {
+				score += 5;
+			}
+
+			// Bonus for matching at word boundary
+			if (i === 0 || /[\s\-_.]/.test(target[i - 1])) {
+				score += 10;
+			}
+
+			// Bonus for matching at start
+			if (i === 0) {
+				score += 15;
+			}
+
+			// Base score for each match
+			score += 1;
+
+			prevMatchIdx = i;
+			queryIdx++;
+		}
+	}
+
+	// All query characters must be found
+	if (queryIdx !== queryLower.length) {
+		return null;
+	}
+
+	// Penalty for longer strings (prefer shorter, more precise matches)
+	score -= Math.floor(target.length / 10);
+
+	return { score, matches };
+}
+
+/**
+ * Filter and sort items by fuzzy match score
+ */
+export function fuzzyFilter<T>(
+	items: T[],
+	query: string,
+	getText: (item: T) => string,
+): FuzzyMatch<T>[] {
+	if (!query.trim()) {
+		return items.map((item) => ({ item, score: 1, matches: [] }));
+	}
+
+	const results: FuzzyMatch<T>[] = [];
+
+	for (const item of items) {
+		const text = getText(item);
+		const match = fuzzyMatch(query, text);
+
+		if (match) {
+			results.push({
+				item,
+				score: match.score,
+				matches: match.matches,
+			});
+		}
+	}
+
+	// Sort by score descending
+	return results.sort((a, b) => b.score - a.score);
+}
+
+/**
+ * Highlight matched characters in a string
+ * Returns array of { text, highlighted } segments
+ */
+export function highlightMatches(
+	text: string,
+	matches: number[],
+): Array<{ text: string; highlighted: boolean }> {
+	if (matches.length === 0) {
+		return [{ text, highlighted: false }];
+	}
+
+	const matchSet = new Set(matches);
+	const segments: Array<{ text: string; highlighted: boolean }> = [];
+	let currentSegment = "";
+	let isHighlighted = matchSet.has(0);
+
+	for (let i = 0; i < text.length; i++) {
+		const shouldHighlight = matchSet.has(i);
+
+		if (shouldHighlight !== isHighlighted) {
+			if (currentSegment) {
+				segments.push({ text: currentSegment, highlighted: isHighlighted });
+			}
+			currentSegment = text[i];
+			isHighlighted = shouldHighlight;
+		} else {
+			currentSegment += text[i];
+		}
+	}
+
+	if (currentSegment) {
+		segments.push({ text: currentSegment, highlighted: isHighlighted });
+	}
+
+	return segments;
+}

package/{dist → src}/utils/string-utils.js

@@ -9,14 +9,14 @@ export function formatMarketplaceName(name) {
     return name
         .split(/[-_]/)
         .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-        .join(' ');
+        .join(" ");
 }
 /**
  * Validate GitHub repository format (org/repo)
  * Prevents SSRF via malicious repo strings
  */
 export function isValidGitHubRepo(repo) {
-    if (!repo || typeof repo !== 'string') {
+    if (!repo || typeof repo !== "string") {
         return false;
     }
     // Must match GitHub username/repo format
@@ -25,7 +25,8 @@ export function isValidGitHubRepo(repo) {
     const GITHUB_REPO_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]\/[a-zA-Z0-9_.-]+$/;
     // Allow single-char usernames too
     const GITHUB_REPO_PATTERN_SHORT = /^[a-zA-Z0-9]\/[a-zA-Z0-9_.-]+$/;
-    if (!GITHUB_REPO_PATTERN.test(repo) && !GITHUB_REPO_PATTERN_SHORT.test(repo)) {
+    if (!GITHUB_REPO_PATTERN.test(repo) &&
+        !GITHUB_REPO_PATTERN_SHORT.test(repo)) {
         return false;
     }
     // Blocklist suspicious patterns
@@ -40,11 +41,11 @@ export function isValidGitHubRepo(repo) {
     return !BLOCKLIST.some((pattern) => pattern.test(repo));
 }
 export function parsePluginId(pluginId) {
-    if (!pluginId || typeof pluginId !== 'string') {
+    if (!pluginId || typeof pluginId !== "string") {
         return null;
     }
     const trimmed = pluginId.trim();
-    const atIndex = trimmed.lastIndexOf('@');
+    const atIndex = trimmed.lastIndexOf("@");
     if (atIndex <= 0) {
         return null;
     }
@@ -59,4 +60,3 @@ export function parsePluginId(pluginId) {
         raw: trimmed,
     };
 }
-//# sourceMappingURL=string-utils.js.map

package/src/utils/string-utils.ts

@@ -0,0 +1,88 @@
+/**
+ * Shared string utilities for claudeup
+ */
+
+/**
+ * Format marketplace name for display
+ * e.g., "mag-claude-plugins" -> "Mag Claude Plugins"
+ */
+export function formatMarketplaceName(name: string): string {
+	return name
+		.split(/[-_]/)
+		.map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+		.join(" ");
+}
+
+/**
+ * Validate GitHub repository format (org/repo)
+ * Prevents SSRF via malicious repo strings
+ */
+export function isValidGitHubRepo(repo: string): boolean {
+	if (!repo || typeof repo !== "string") {
+		return false;
+	}
+
+	// Must match GitHub username/repo format
+	// Username: alphanumeric, hyphens (no consecutive, not start/end)
+	// Repo: alphanumeric, hyphens, underscores, dots
+	const GITHUB_REPO_PATTERN =
+		/^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]\/[a-zA-Z0-9_.-]+$/;
+
+	// Allow single-char usernames too
+	const GITHUB_REPO_PATTERN_SHORT = /^[a-zA-Z0-9]\/[a-zA-Z0-9_.-]+$/;
+
+	if (
+		!GITHUB_REPO_PATTERN.test(repo) &&
+		!GITHUB_REPO_PATTERN_SHORT.test(repo)
+	) {
+		return false;
+	}
+
+	// Blocklist suspicious patterns
+	const BLOCKLIST = [
+		/\.\./, // Path traversal
+		/@/, // URL authority injection
+		/:/, // Port specification
+		/\s/, // Whitespace
+		/%/, // URL encoding
+		/\\/, // Backslash
+	];
+
+	return !BLOCKLIST.some((pattern) => pattern.test(repo));
+}
+
+/**
+ * Parse plugin ID into components
+ * Format: pluginName@marketplaceName
+ */
+export interface ParsedPluginId {
+	pluginName: string;
+	marketplace: string;
+	raw: string;
+}
+
+export function parsePluginId(pluginId: string): ParsedPluginId | null {
+	if (!pluginId || typeof pluginId !== "string") {
+		return null;
+	}
+
+	const trimmed = pluginId.trim();
+	const atIndex = trimmed.lastIndexOf("@");
+
+	if (atIndex <= 0) {
+		return null;
+	}
+
+	const pluginName = trimmed.slice(0, atIndex).trim();
+	const marketplace = trimmed.slice(atIndex + 1).trim();
+
+	if (!pluginName || !marketplace) {
+		return null;
+	}
+
+	return {
+		pluginName,
+		marketplace,
+		raw: trimmed,
+	};
+}

package/dist/data/cli-tools.d.ts

@@ -1,13 +0,0 @@
-export interface CliTool {
-    name: string;
-    displayName: string;
-    description: string;
-    installCommand: string;
-    checkCommand: string;
-    website: string;
-    category: 'ai-coding' | 'utility';
-    packageManager: 'npm' | 'pip';
-    packageName: string;
-}
-export declare const cliTools: CliTool[];
-//# sourceMappingURL=cli-tools.d.ts.map

package/dist/data/cli-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-tools.d.ts","sourceRoot":"","sources":["../../src/data/cli-tools.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,cAAc,EAAE,KAAK,GAAG,KAAK,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,QAAQ,EAAE,OAAO,EA0H7B,CAAC"}