claudeup 3.7.2 → 3.8.0

package/src/services/plugin-manager.ts

@@ -61,6 +61,7 @@ export interface PluginInfo {
 	skills?: string[];
 	mcpServers?: string[];
 	lspServers?: Record<string, unknown>;
+	isOrphaned?: boolean;
 }
 
 export interface MarketplacePlugin {
@@ -323,6 +324,7 @@ export async function getAvailablePlugins(
 			enabled: isEnabled,
 			installedVersion: installedVersion,
 			hasUpdate,
+			isOrphaned: true,
 			...scopeStatus,
 		});
 	}
@@ -500,6 +502,7 @@ export async function getGlobalAvailablePlugins(): Promise<PluginInfo[]> {
 			...scopeStatus,
 			installedVersion: installedVersion,
 			hasUpdate,
+			isOrphaned: true,
 		});
 	}
 

package/src/services/profiles.js

@@ -0,0 +1,161 @@
+import fs from "fs-extra";
+import path from "node:path";
+import os from "node:os";
+const PROFILES_FILE = "profiles.json";
+// ─── Path helpers ──────────────────────────────────────────────────────────────
+export function getUserProfilesPath() {
+    return path.join(os.homedir(), ".claude", PROFILES_FILE);
+}
+export function getProjectProfilesPath(projectPath) {
+    const base = projectPath ?? process.cwd();
+    return path.join(base, ".claude", PROFILES_FILE);
+}
+// ─── Low-level read/write ──────────────────────────────────────────────────────
+export async function readProfiles(scope, projectPath) {
+    const filePath = scope === "user"
+        ? getUserProfilesPath()
+        : getProjectProfilesPath(projectPath);
+    try {
+        if (await fs.pathExists(filePath)) {
+            const data = await fs.readJson(filePath);
+            if (data.version && data.profiles)
+                return data;
+        }
+    }
+    catch {
+        // fall through to default
+    }
+    return { version: 1, profiles: {} };
+}
+async function writeProfiles(scope, data, projectPath) {
+    const filePath = scope === "user"
+        ? getUserProfilesPath()
+        : getProjectProfilesPath(projectPath);
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeJson(filePath, data, { spaces: 2 });
+}
+// ─── CRUD ──────────────────────────────────────────────────────────────────────
+/** Return all profiles from both scopes, merged into a flat list */
+export async function listProfiles(projectPath) {
+    const [user, project] = await Promise.all([
+        readProfiles("user"),
+        readProfiles("project", projectPath),
+    ]);
+    const entries = [];
+    for (const [id, p] of Object.entries(user.profiles)) {
+        entries.push({ id, scope: "user", ...p });
+    }
+    for (const [id, p] of Object.entries(project.profiles)) {
+        entries.push({ id, scope: "project", ...p });
+    }
+    // Sort: user profiles first, then project, each by updatedAt desc
+    entries.sort((a, b) => {
+        if (a.scope !== b.scope)
+            return a.scope === "user" ? -1 : 1;
+        return b.updatedAt.localeCompare(a.updatedAt);
+    });
+    return entries;
+}
+/**
+ * Save (create or overwrite) a profile.
+ * Returns the generated profile ID.
+ */
+export async function saveProfile(name, plugins, scope, projectPath) {
+    const data = await readProfiles(scope, projectPath);
+    const id = generateUniqueId(name, data.profiles);
+    const now = new Date().toISOString();
+    data.profiles[id] = {
+        name,
+        plugins,
+        createdAt: now,
+        updatedAt: now,
+    };
+    await writeProfiles(scope, data, projectPath);
+    return id;
+}
+/**
+ * Apply a profile: replaces enabledPlugins in the target settings scope.
+ * targetScope is where the settings will be written, independent of where
+ * the profile is stored.
+ */
+export async function applyProfile(profileId, profileScope, targetScope, projectPath) {
+    const data = await readProfiles(profileScope, projectPath);
+    const profile = data.profiles[profileId];
+    if (!profile)
+        throw new Error(`Profile "${profileId}" not found`);
+    // Import settings functions dynamically to avoid circular deps
+    const { readSettings, writeSettings, readGlobalSettings, writeGlobalSettings, } = await import("./claude-settings.js");
+    if (targetScope === "user") {
+        const settings = await readGlobalSettings();
+        settings.enabledPlugins = { ...profile.plugins };
+        await writeGlobalSettings(settings);
+    }
+    else {
+        // project or local both write to project settings.json
+        const settings = await readSettings(projectPath);
+        settings.enabledPlugins = { ...profile.plugins };
+        await writeSettings(settings, projectPath);
+    }
+}
+/** Rename a profile in-place (preserves id, createdAt) */
+export async function renameProfile(profileId, newName, scope, projectPath) {
+    const data = await readProfiles(scope, projectPath);
+    if (!data.profiles[profileId]) {
+        throw new Error(`Profile "${profileId}" not found in ${scope} scope`);
+    }
+    data.profiles[profileId].name = newName;
+    data.profiles[profileId].updatedAt = new Date().toISOString();
+    await writeProfiles(scope, data, projectPath);
+}
+export async function deleteProfile(profileId, scope, projectPath) {
+    const data = await readProfiles(scope, projectPath);
+    if (!data.profiles[profileId]) {
+        throw new Error(`Profile "${profileId}" not found in ${scope} scope`);
+    }
+    delete data.profiles[profileId];
+    await writeProfiles(scope, data, projectPath);
+}
+// ─── Import / Export ───────────────────────────────────────────────────────────
+/** Serialize a profile to a compact JSON string for clipboard sharing */
+export async function exportProfileToJson(profileId, scope, projectPath) {
+    const data = await readProfiles(scope, projectPath);
+    const profile = data.profiles[profileId];
+    if (!profile)
+        throw new Error(`Profile "${profileId}" not found`);
+    const entry = { id: profileId, scope, ...profile };
+    return JSON.stringify(entry, null, 2);
+}
+/**
+ * Parse a clipboard JSON string and save into the specified scope.
+ * Returns the saved profile id.
+ */
+export async function importProfileFromJson(json, targetScope, projectPath) {
+    let entry;
+    try {
+        entry = JSON.parse(json);
+    }
+    catch {
+        throw new Error("Invalid JSON — could not parse clipboard content");
+    }
+    if (!entry.name || typeof entry.plugins !== "object") {
+        throw new Error("Invalid profile format — expected { name, plugins }");
+    }
+    return saveProfile(entry.name, entry.plugins, targetScope, projectPath);
+}
+// ─── Internal helpers ──────────────────────────────────────────────────────────
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+function generateUniqueId(name, existing) {
+    const base = slugify(name) || "profile";
+    if (!existing[base])
+        return base;
+    let n = 2;
+    while (existing[`${base}-${n}`])
+        n++;
+    return `${base}-${n}`;
+}

package/src/services/profiles.ts

@@ -0,0 +1,225 @@
+import fs from "fs-extra";
+import path from "node:path";
+import os from "node:os";
+import type { Profile, ProfilesFile, ProfileEntry } from "../types/index.js";
+
+const PROFILES_FILE = "profiles.json";
+
+// ─── Path helpers ──────────────────────────────────────────────────────────────
+
+export function getUserProfilesPath(): string {
+	return path.join(os.homedir(), ".claude", PROFILES_FILE);
+}
+
+export function getProjectProfilesPath(projectPath?: string): string {
+	const base = projectPath ?? process.cwd();
+	return path.join(base, ".claude", PROFILES_FILE);
+}
+
+// ─── Low-level read/write ──────────────────────────────────────────────────────
+
+export async function readProfiles(
+	scope: "user" | "project",
+	projectPath?: string,
+): Promise<ProfilesFile> {
+	const filePath =
+		scope === "user"
+			? getUserProfilesPath()
+			: getProjectProfilesPath(projectPath);
+	try {
+		if (await fs.pathExists(filePath)) {
+			const data = await fs.readJson(filePath);
+			if (data.version && data.profiles) return data as ProfilesFile;
+		}
+	} catch {
+		// fall through to default
+	}
+	return { version: 1, profiles: {} };
+}
+
+async function writeProfiles(
+	scope: "user" | "project",
+	data: ProfilesFile,
+	projectPath?: string,
+): Promise<void> {
+	const filePath =
+		scope === "user"
+			? getUserProfilesPath()
+			: getProjectProfilesPath(projectPath);
+	await fs.ensureDir(path.dirname(filePath));
+	await fs.writeJson(filePath, data, { spaces: 2 });
+}
+
+// ─── CRUD ──────────────────────────────────────────────────────────────────────
+
+/** Return all profiles from both scopes, merged into a flat list */
+export async function listProfiles(
+	projectPath?: string,
+): Promise<ProfileEntry[]> {
+	const [user, project] = await Promise.all([
+		readProfiles("user"),
+		readProfiles("project", projectPath),
+	]);
+	const entries: ProfileEntry[] = [];
+	for (const [id, p] of Object.entries(user.profiles)) {
+		entries.push({ id, scope: "user", ...p });
+	}
+	for (const [id, p] of Object.entries(project.profiles)) {
+		entries.push({ id, scope: "project", ...p });
+	}
+	// Sort: user profiles first, then project, each by updatedAt desc
+	entries.sort((a, b) => {
+		if (a.scope !== b.scope) return a.scope === "user" ? -1 : 1;
+		return b.updatedAt.localeCompare(a.updatedAt);
+	});
+	return entries;
+}
+
+/**
+ * Save (create or overwrite) a profile.
+ * Returns the generated profile ID.
+ */
+export async function saveProfile(
+	name: string,
+	plugins: Record<string, boolean>,
+	scope: "user" | "project",
+	projectPath?: string,
+): Promise<string> {
+	const data = await readProfiles(scope, projectPath);
+	const id = generateUniqueId(name, data.profiles);
+	const now = new Date().toISOString();
+	data.profiles[id] = {
+		name,
+		plugins,
+		createdAt: now,
+		updatedAt: now,
+	};
+	await writeProfiles(scope, data, projectPath);
+	return id;
+}
+
+/**
+ * Apply a profile: replaces enabledPlugins in the target settings scope.
+ * targetScope is where the settings will be written, independent of where
+ * the profile is stored.
+ */
+export async function applyProfile(
+	profileId: string,
+	profileScope: "user" | "project",
+	targetScope: "user" | "project" | "local",
+	projectPath?: string,
+): Promise<void> {
+	const data = await readProfiles(profileScope, projectPath);
+	const profile = data.profiles[profileId];
+	if (!profile) throw new Error(`Profile "${profileId}" not found`);
+
+	// Import settings functions dynamically to avoid circular deps
+	const {
+		readSettings,
+		writeSettings,
+		readGlobalSettings,
+		writeGlobalSettings,
+	} = await import("./claude-settings.js");
+
+	if (targetScope === "user") {
+		const settings = await readGlobalSettings();
+		settings.enabledPlugins = { ...profile.plugins };
+		await writeGlobalSettings(settings);
+	} else {
+		// project or local both write to project settings.json
+		const settings = await readSettings(projectPath);
+		settings.enabledPlugins = { ...profile.plugins };
+		await writeSettings(settings, projectPath);
+	}
+}
+
+/** Rename a profile in-place (preserves id, createdAt) */
+export async function renameProfile(
+	profileId: string,
+	newName: string,
+	scope: "user" | "project",
+	projectPath?: string,
+): Promise<void> {
+	const data = await readProfiles(scope, projectPath);
+	if (!data.profiles[profileId]) {
+		throw new Error(`Profile "${profileId}" not found in ${scope} scope`);
+	}
+	data.profiles[profileId].name = newName;
+	data.profiles[profileId].updatedAt = new Date().toISOString();
+	await writeProfiles(scope, data, projectPath);
+}
+
+export async function deleteProfile(
+	profileId: string,
+	scope: "user" | "project",
+	projectPath?: string,
+): Promise<void> {
+	const data = await readProfiles(scope, projectPath);
+	if (!data.profiles[profileId]) {
+		throw new Error(`Profile "${profileId}" not found in ${scope} scope`);
+	}
+	delete data.profiles[profileId];
+	await writeProfiles(scope, data, projectPath);
+}
+
+// ─── Import / Export ───────────────────────────────────────────────────────────
+
+/** Serialize a profile to a compact JSON string for clipboard sharing */
+export async function exportProfileToJson(
+	profileId: string,
+	scope: "user" | "project",
+	projectPath?: string,
+): Promise<string> {
+	const data = await readProfiles(scope, projectPath);
+	const profile = data.profiles[profileId];
+	if (!profile) throw new Error(`Profile "${profileId}" not found`);
+	const entry: ProfileEntry = { id: profileId, scope, ...profile };
+	return JSON.stringify(entry, null, 2);
+}
+
+/**
+ * Parse a clipboard JSON string and save into the specified scope.
+ * Returns the saved profile id.
+ */
+export async function importProfileFromJson(
+	json: string,
+	targetScope: "user" | "project",
+	projectPath?: string,
+): Promise<string> {
+	let entry: Partial<ProfileEntry>;
+	try {
+		entry = JSON.parse(json) as Partial<ProfileEntry>;
+	} catch {
+		throw new Error("Invalid JSON — could not parse clipboard content");
+	}
+	if (!entry.name || typeof entry.plugins !== "object") {
+		throw new Error("Invalid profile format — expected { name, plugins }");
+	}
+	return saveProfile(
+		entry.name,
+		entry.plugins as Record<string, boolean>,
+		targetScope,
+		projectPath,
+	);
+}
+
+// ─── Internal helpers ──────────────────────────────────────────────────────────
+
+function slugify(name: string): string {
+	return name
+		.toLowerCase()
+		.trim()
+		.replace(/[^a-z0-9]+/g, "-")
+		.replace(/^-|-$/g, "");
+}
+
+function generateUniqueId(
+	name: string,
+	existing: Record<string, unknown>,
+): string {
+	const base = slugify(name) || "profile";
+	if (!existing[base]) return base;
+	let n = 2;
+	while (existing[`${base}-${n}`]) n++;
+	return `${base}-${n}`;
+}

package/src/services/settings-manager.js

@@ -0,0 +1,108 @@
+import { readSettings, writeSettings, readGlobalSettings, writeGlobalSettings, } from "./claude-settings.js";
+/** Read the current value of a setting from the given scope */
+export async function readSettingValue(setting, scope, projectPath) {
+    const settings = scope === "user"
+        ? await readGlobalSettings()
+        : await readSettings(projectPath);
+    if (setting.storage.type === "env") {
+        const env = settings.env;
+        return env?.[setting.storage.key];
+    }
+    else {
+        // Direct settings key (supports dot notation like "permissions.defaultMode")
+        const keys = setting.storage.key.split(".");
+        let value = settings;
+        for (const k of keys) {
+            value = value?.[k];
+        }
+        return value !== undefined && value !== null ? String(value) : undefined;
+    }
+}
+/** Write a setting value to the given scope */
+export async function writeSettingValue(setting, value, scope, projectPath) {
+    const settings = scope === "user"
+        ? await readGlobalSettings()
+        : await readSettings(projectPath);
+    if (setting.storage.type === "env") {
+        // Write to the "env" block in settings.json
+        settings.env = settings.env || {};
+        if (value === undefined || value === "" || value === setting.defaultValue) {
+            delete settings.env[setting.storage.key];
+            // Clean up empty env block
+            if (Object.keys(settings.env).length === 0) {
+                delete settings.env;
+            }
+        }
+        else {
+            settings.env[setting.storage.key] = value;
+        }
+    }
+    else {
+        // Direct settings key (supports dot notation)
+        const keys = setting.storage.key.split(".");
+        if (keys.length === 1) {
+            if (value === undefined || value === "") {
+                delete settings[keys[0]];
+            }
+            else {
+                // Try to preserve type: boolean, number, or string
+                settings[keys[0]] = parseSettingValue(value, setting.type);
+            }
+        }
+        else {
+            // Nested key like "permissions.defaultMode"
+            let obj = settings;
+            for (let i = 0; i < keys.length - 1; i++) {
+                obj[keys[i]] = obj[keys[i]] || {};
+                obj = obj[keys[i]];
+            }
+            const lastKey = keys[keys.length - 1];
+            if (value === undefined || value === "") {
+                delete obj[lastKey];
+            }
+            else {
+                obj[lastKey] = parseSettingValue(value, setting.type);
+            }
+        }
+    }
+    if (scope === "user") {
+        await writeGlobalSettings(settings);
+    }
+    else {
+        await writeSettings(settings, projectPath);
+    }
+}
+function parseSettingValue(value, type) {
+    if (type === "boolean") {
+        return value === "true" || value === "1";
+    }
+    // Try number
+    const num = Number(value);
+    if (!Number.isNaN(num) && value.trim() !== "") {
+        return value; // Keep as string for env vars
+    }
+    return value;
+}
+/** Read all setting values for the catalog */
+export async function readAllSettings(catalog, scope, projectPath) {
+    const values = new Map();
+    for (const setting of catalog) {
+        values.set(setting.id, await readSettingValue(setting, scope, projectPath));
+    }
+    return values;
+}
+/** Read all setting values from both scopes simultaneously */
+export async function readAllSettingsBothScopes(catalog, projectPath) {
+    const result = new Map();
+    const [userValues, projectValues] = await Promise.all([
+        readAllSettings(catalog, "user", projectPath),
+        readAllSettings(catalog, "project", projectPath),
+    ]);
+    for (const setting of catalog) {
+        result.set(setting.id, {
+            user: userValues.get(setting.id),
+            project: projectValues.get(setting.id),
+        });
+    }
+    return result;
+}

package/src/services/settings-manager.ts

@@ -0,0 +1,140 @@
+import {
+	readSettings,
+	writeSettings,
+	readGlobalSettings,
+	writeGlobalSettings,
+} from "./claude-settings.js";
+import type { SettingDefinition } from "../data/settings-catalog.js";
+
+export type SettingScope = "user" | "project";
+
+/** Read the current value of a setting from the given scope */
+export async function readSettingValue(
+	setting: SettingDefinition,
+	scope: SettingScope,
+	projectPath?: string,
+): Promise<string | undefined> {
+	const settings =
+		scope === "user"
+			? await readGlobalSettings()
+			: await readSettings(projectPath);
+
+	if (setting.storage.type === "env") {
+		const env = (settings as any).env as Record<string, string> | undefined;
+		return env?.[setting.storage.key];
+	} else {
+		// Direct settings key (supports dot notation like "permissions.defaultMode")
+		const keys = setting.storage.key.split(".");
+		let value: any = settings;
+		for (const k of keys) {
+			value = value?.[k];
+		}
+		return value !== undefined && value !== null ? String(value) : undefined;
+	}
+}
+
+/** Write a setting value to the given scope */
+export async function writeSettingValue(
+	setting: SettingDefinition,
+	value: string | undefined,
+	scope: SettingScope,
+	projectPath?: string,
+): Promise<void> {
+	const settings =
+		scope === "user"
+			? await readGlobalSettings()
+			: await readSettings(projectPath);
+
+	if (setting.storage.type === "env") {
+		// Write to the "env" block in settings.json
+		(settings as any).env = (settings as any).env || {};
+		if (value === undefined || value === "" || value === setting.defaultValue) {
+			delete (settings as any).env[setting.storage.key];
+			// Clean up empty env block
+			if (Object.keys((settings as any).env).length === 0) {
+				delete (settings as any).env;
+			}
+		} else {
+			(settings as any).env[setting.storage.key] = value;
+		}
+	} else {
+		// Direct settings key (supports dot notation)
+		const keys = setting.storage.key.split(".");
+		if (keys.length === 1) {
+			if (value === undefined || value === "") {
+				delete (settings as any)[keys[0]];
+			} else {
+				// Try to preserve type: boolean, number, or string
+				(settings as any)[keys[0]] = parseSettingValue(value, setting.type);
+			}
+		} else {
+			// Nested key like "permissions.defaultMode"
+			let obj: any = settings;
+			for (let i = 0; i < keys.length - 1; i++) {
+				obj[keys[i]] = obj[keys[i]] || {};
+				obj = obj[keys[i]];
+			}
+			const lastKey = keys[keys.length - 1];
+			if (value === undefined || value === "") {
+				delete obj[lastKey];
+			} else {
+				obj[lastKey] = parseSettingValue(value, setting.type);
+			}
+		}
+	}
+
+	if (scope === "user") {
+		await writeGlobalSettings(settings);
+	} else {
+		await writeSettings(settings, projectPath);
+	}
+}
+
+function parseSettingValue(value: string, type: string): any {
+	if (type === "boolean") {
+		return value === "true" || value === "1";
+	}
+	// Try number
+	const num = Number(value);
+	if (!Number.isNaN(num) && value.trim() !== "") {
+		return value; // Keep as string for env vars
+	}
+	return value;
+}
+
+/** Read all setting values for the catalog */
+export async function readAllSettings(
+	catalog: SettingDefinition[],
+	scope: SettingScope,
+	projectPath?: string,
+): Promise<Map<string, string | undefined>> {
+	const values = new Map<string, string | undefined>();
+	for (const setting of catalog) {
+		values.set(setting.id, await readSettingValue(setting, scope, projectPath));
+	}
+	return values;
+}
+
+export interface ScopedSettingValues {
+	user: string | undefined;
+	project: string | undefined;
+}
+
+/** Read all setting values from both scopes simultaneously */
+export async function readAllSettingsBothScopes(
+	catalog: SettingDefinition[],
+	projectPath?: string,
+): Promise<Map<string, ScopedSettingValues>> {
+	const result = new Map<string, ScopedSettingValues>();
+	const [userValues, projectValues] = await Promise.all([
+		readAllSettings(catalog, "user", projectPath),
+		readAllSettings(catalog, "project", projectPath),
+	]);
+	for (const setting of catalog) {
+		result.set(setting.id, {
+			user: userValues.get(setting.id),
+			project: projectValues.get(setting.id),
+		});
+	}
+	return result;
+}