@leynier/ccst 0.2.1 → 0.3.0

package/package.json

@@ -1,58 +1,59 @@
 {
-  "name": "@leynier/ccst",
-  "version": "0.2.1",
-  "description": "Claude Code Switch Tools for managing contexts",
-  "keywords": [
-    "claude",
-    "claude-code",
-    "cli",
-    "contexts",
-    "config",
-    "switcher"
-  ],
-  "homepage": "https://github.com/leynier/ccst",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/leynier/ccst.git"
-  },
-  "bugs": {
-    "url": "https://github.com/leynier/ccst/issues"
-  },
-  "license": "MIT",
-  "readme": "README.md",
-  "module": "index.ts",
-  "type": "module",
-  "bin": {
-    "ccst": "./src/index.ts"
-  },
-  "scripts": {
-    "format": "biome format --write",
-    "lint": "biome check --write",
-    "validate": "bun run format && bun run lint"
-  },
-  "dependencies": {
-    "commander": "^12.1.0",
-    "picocolors": "^1.1.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "2.3.11",
-    "@types/bun": "latest"
-  },
-  "peerDependencies": {
-    "typescript": "^5"
-  },
-  "files": [
-    "src",
-    "index.ts",
-    "README.md",
-    "LICENSE",
-    "AGENTS.md",
-    "CLAUDE.md",
-    "GEMINI.md",
-    "biome.json",
-    "tsconfig.json"
-  ],
-  "publishConfig": {
-    "access": "public"
-  }
+	"name": "@leynier/ccst",
+	"version": "0.3.0",
+	"description": "Claude Code Switch Tools for managing contexts",
+	"keywords": [
+		"claude",
+		"claude-code",
+		"cli",
+		"contexts",
+		"config",
+		"switcher"
+	],
+	"homepage": "https://github.com/leynier/ccst",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/leynier/ccst.git"
+	},
+	"bugs": {
+		"url": "https://github.com/leynier/ccst/issues"
+	},
+	"license": "MIT",
+	"readme": "README.md",
+	"module": "index.ts",
+	"type": "module",
+	"bin": {
+		"ccst": "./src/index.ts"
+	},
+	"scripts": {
+		"format": "biome format --write",
+		"lint": "biome check --write",
+		"validate": "bun run format && bun run lint"
+	},
+	"dependencies": {
+		"commander": "^12.1.0",
+		"jszip": "^3.10.1",
+		"picocolors": "^1.1.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.11",
+		"@types/bun": "latest"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"files": [
+		"src",
+		"index.ts",
+		"README.md",
+		"LICENSE",
+		"AGENTS.md",
+		"CLAUDE.md",
+		"GEMINI.md",
+		"biome.json",
+		"tsconfig.json"
+	],
+	"publishConfig": {
+		"access": "public"
+	}
 }

package/src/commands/completions.ts

@@ -1,49 +1,55 @@
 export const completionsCommand = (shell: string | undefined): void => {
-  if (!shell) {
-    throw new Error("error: shell required for completions");
-  }
-  const available = ["bash", "zsh", "fish", "powershell", "elvish"];
-  if (!available.includes(shell)) {
-    throw new Error(`error: unsupported shell ${shell}`);
-  }
-  const options = [
-    "-d",
-    "--delete",
-    "-c",
-    "--current",
-    "-r",
-    "--rename",
-    "-n",
-    "--new",
-    "-e",
-    "--edit",
-    "-s",
-    "--show",
-    "--export",
-    "--import",
-    "-u",
-    "--unset",
-    "--completions",
-    "-q",
-    "--quiet",
-    "--in-project",
-    "--local",
-    "--merge-from",
-    "--unmerge",
-    "--merge-history",
-    "--merge-full",
-  ].join(" ");
-  if (shell === "bash") {
-    process.stdout.write(`# ccst bash completions\ncomplete -W "${options}" ccst\n`);
-    return;
-  }
-  if (shell === "zsh") {
-    process.stdout.write(`#compdef ccst\n_arguments '*::options:(${options})'\n`);
-    return;
-  }
-  if (shell === "fish") {
-    process.stdout.write(`complete -c ccst -f -a "${options}"\n`);
-    return;
-  }
-  process.stdout.write(`# ${shell} completions not implemented; use bash/zsh/fish output\n`);
+	if (!shell) {
+		throw new Error("error: shell required for completions");
+	}
+	const available = ["bash", "zsh", "fish", "powershell", "elvish"];
+	if (!available.includes(shell)) {
+		throw new Error(`error: unsupported shell ${shell}`);
+	}
+	const options = [
+		"-d",
+		"--delete",
+		"-c",
+		"--current",
+		"-r",
+		"--rename",
+		"-n",
+		"--new",
+		"-e",
+		"--edit",
+		"-s",
+		"--show",
+		"--export",
+		"--import",
+		"-u",
+		"--unset",
+		"--completions",
+		"-q",
+		"--quiet",
+		"--in-project",
+		"--local",
+		"--merge-from",
+		"--unmerge",
+		"--merge-history",
+		"--merge-full",
+	].join(" ");
+	if (shell === "bash") {
+		process.stdout.write(
+			`# ccst bash completions\ncomplete -W "${options}" ccst\n`,
+		);
+		return;
+	}
+	if (shell === "zsh") {
+		process.stdout.write(
+			`#compdef ccst\n_arguments '*::options:(${options})'\n`,
+		);
+		return;
+	}
+	if (shell === "fish") {
+		process.stdout.write(`complete -c ccst -f -a "${options}"\n`);
+		return;
+	}
+	process.stdout.write(
+		`# ${shell} completions not implemented; use bash/zsh/fish output\n`,
+	);
 };

package/src/commands/config/dump.ts

@@ -0,0 +1,40 @@
+import { resolve } from "node:path";
+import JSZip from "jszip";
+import pc from "picocolors";
+import {
+	getAllBackupFilePaths,
+	getRelativePath,
+} from "../../utils/ccs-paths.js";
+
+const DEFAULT_OUTPUT = "ccs-config.zip";
+
+export const configDumpCommand = async (outputPath?: string): Promise<void> => {
+	const output = resolve(outputPath ?? DEFAULT_OUTPUT);
+	const files = getAllBackupFilePaths();
+	if (files.length === 0) {
+		console.log(pc.yellow("No CCS configuration files found to backup"));
+		return;
+	}
+	const zip = new JSZip();
+	for (const filePath of files) {
+		try {
+			const relativePath = getRelativePath(filePath);
+			const content = await Bun.file(filePath).arrayBuffer();
+			zip.file(relativePath, content);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw new Error(`Failed to read ${filePath}: ${message}`);
+		}
+	}
+	try {
+		const zipContent = await zip.generateAsync({ type: "uint8array" });
+		await Bun.write(output, zipContent);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Failed to write ${output}: ${message}`);
+	}
+	console.log(pc.green(`Exported ${files.length} files to ${output}`));
+	for (const filePath of files) {
+		console.log(pc.dim(`  - ${getRelativePath(filePath)}`));
+	}
+};

package/src/commands/config/load.ts

@@ -0,0 +1,122 @@
+import { existsSync, unlinkSync } from "node:fs";
+import { join, resolve } from "node:path";
+import JSZip from "jszip";
+import pc from "picocolors";
+import {
+	ensureDirectoryExists,
+	getCcsHome,
+	getFilesToDelete,
+} from "../../utils/ccs-paths.js";
+
+const DEFAULT_INPUT = "ccs-config.zip";
+
+type LoadOptions = {
+	replace?: boolean;
+	yes?: boolean;
+};
+
+const confirmReplace = async (
+	profiles: string[],
+	authFiles: string[],
+): Promise<boolean> => {
+	const totalFiles = profiles.length + authFiles.length;
+	if (totalFiles === 0) {
+		return true;
+	}
+	console.log(pc.yellow("\nThe following files will be deleted:"));
+	if (profiles.length > 0) {
+		console.log(pc.dim("\nProfiles:"));
+		for (const file of profiles) {
+			console.log(pc.red(`  - ${file}`));
+		}
+	}
+	if (authFiles.length > 0) {
+		console.log(pc.dim("\nAuth files:"));
+		for (const file of authFiles) {
+			console.log(pc.red(`  - ${file}`));
+		}
+	}
+	console.log();
+	// Dynamic import for interactive prompt
+	const readline = await import("node:readline");
+	const rl = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout,
+	});
+	return new Promise((resolvePromise) => {
+		rl.question(
+			pc.yellow(`Delete ${totalFiles} files and replace? [y/N] `),
+			(answer) => {
+				rl.close();
+				resolvePromise(answer.toLowerCase() === "y");
+			},
+		);
+	});
+};
+
+export const configLoadCommand = async (
+	inputPath?: string,
+	options?: LoadOptions,
+): Promise<void> => {
+	const input = resolve(inputPath ?? DEFAULT_INPUT);
+	if (!existsSync(input)) {
+		throw new Error(`File not found: ${input}`);
+	}
+	const zipData = await Bun.file(input).arrayBuffer();
+	const zip = await JSZip.loadAsync(zipData);
+	const fileEntries = Object.keys(zip.files).filter((name) => {
+		const file = zip.files[name];
+		return file && !file.dir;
+	});
+	if (fileEntries.length === 0) {
+		console.log(pc.yellow("No files found in zip archive"));
+		return;
+	}
+	const ccsHome = getCcsHome();
+	// Handle replace mode
+	if (options?.replace) {
+		const { profiles, authFiles } = getFilesToDelete();
+		if (!options.yes) {
+			const confirmed = await confirmReplace(profiles, authFiles);
+			if (!confirmed) {
+				console.log(pc.dim("Operation cancelled"));
+				return;
+			}
+		}
+		// Delete existing files
+		for (const file of [...profiles, ...authFiles]) {
+			if (existsSync(file)) {
+				unlinkSync(file);
+			}
+		}
+		if (profiles.length + authFiles.length > 0) {
+			console.log(
+				pc.dim(`Deleted ${profiles.length + authFiles.length} existing files`),
+			);
+		}
+	}
+	// Extract files
+	let extractedCount = 0;
+	for (const relativePath of fileEntries) {
+		// Handle both forward and back slashes for cross-platform compatibility
+		const pathParts = relativePath.split(/[/\\]/);
+		const absolutePath = join(ccsHome, ...pathParts);
+		// Validate path is within ccsHome (prevent path traversal attacks)
+		if (!absolutePath.startsWith(ccsHome)) {
+			console.warn(pc.yellow(`Skipping suspicious path: ${relativePath}`));
+			continue;
+		}
+		const zipFile = zip.files[relativePath];
+		if (!zipFile) {
+			continue;
+		}
+		const fileData = await zipFile.async("uint8array");
+		ensureDirectoryExists(absolutePath);
+		await Bun.write(absolutePath, fileData);
+		extractedCount++;
+	}
+	console.log(pc.green(`Imported ${extractedCount} files from ${input}`));
+	for (const relativePath of fileEntries) {
+		console.log(pc.dim(`  - ${relativePath}`));
+	}
+};

package/src/commands/create.ts

@@ -1,5 +1,8 @@
 import type { ContextManager } from "../core/context-manager.js";
 
-export const createCommand = async (manager: ContextManager, name: string): Promise<void> => {
-  await manager.createContext(name);
+export const createCommand = async (
+	manager: ContextManager,
+	name: string,
+): Promise<void> => {
+	await manager.createContext(name);
 };

package/src/commands/delete.ts

@@ -1,9 +1,12 @@
 import type { ContextManager } from "../core/context-manager.js";
 
-export const deleteCommand = async (manager: ContextManager, name?: string): Promise<void> => {
-  if (name) {
-    await manager.deleteContext(name);
-    return;
-  }
-  await manager.interactiveDelete();
+export const deleteCommand = async (
+	manager: ContextManager,
+	name?: string,
+): Promise<void> => {
+	if (name) {
+		await manager.deleteContext(name);
+		return;
+	}
+	await manager.interactiveDelete();
 };

package/src/commands/edit.ts

@@ -1,13 +1,16 @@
 import type { ContextManager } from "../core/context-manager.js";
 
-export const editCommand = async (manager: ContextManager, name?: string): Promise<void> => {
-  if (name) {
-    await manager.editContext(name);
-    return;
-  }
-  const current = await manager.getCurrentContext();
-  if (!current) {
-    throw new Error("error: no current context set");
-  }
-  await manager.editContext(current);
+export const editCommand = async (
+	manager: ContextManager,
+	name?: string,
+): Promise<void> => {
+	if (name) {
+		await manager.editContext(name);
+		return;
+	}
+	const current = await manager.getCurrentContext();
+	if (!current) {
+		throw new Error("error: no current context set");
+	}
+	await manager.editContext(current);
 };

package/src/commands/export.ts

@@ -1,13 +1,16 @@
 import type { ContextManager } from "../core/context-manager.js";
 
-export const exportCommand = async (manager: ContextManager, name?: string): Promise<void> => {
-  if (name) {
-    await manager.exportContext(name);
-    return;
-  }
-  const current = await manager.getCurrentContext();
-  if (!current) {
-    throw new Error("error: no current context set");
-  }
-  await manager.exportContext(current);
+export const exportCommand = async (
+	manager: ContextManager,
+	name?: string,
+): Promise<void> => {
+	if (name) {
+		await manager.exportContext(name);
+		return;
+	}
+	const current = await manager.getCurrentContext();
+	if (!current) {
+		throw new Error("error: no current context set");
+	}
+	await manager.exportContext(current);
 };

package/src/commands/import-profiles/ccs.ts

@@ -1,88 +1,113 @@
-import path from "node:path";
-import { homedir } from "node:os";
 import { existsSync, mkdirSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
 import type { ContextManager } from "../../core/context-manager.js";
+import { colors } from "../../utils/colors.js";
 import { deepMerge } from "../../utils/deep-merge.js";
 import { readJson, readJsonIfExists } from "../../utils/json.js";
-import { colors } from "../../utils/colors.js";
 
 const defaultConfigsDir = (): string => path.join(homedir(), ".ccst");
 const ccsDir = (): string => path.join(homedir(), ".ccs");
 
-const ensureDefaultConfig = async (manager: ContextManager, configsDir: string): Promise<{ created: boolean; defaultPath: string }> => {
-  const defaultPath = path.join(configsDir, "default.json");
-  if (existsSync(defaultPath)) {
-    return { created: false, defaultPath };
-  }
-  const currentContext = await getCurrentContext(manager);
-  if (currentContext) {
-    return { created: false, defaultPath };
-  }
-  const claudeSettings = path.join(homedir(), ".claude", "settings.json");
-  if (!existsSync(claudeSettings)) {
-    return { created: false, defaultPath };
-  }
-  mkdirSync(configsDir, { recursive: true });
-  const content = await Bun.file(claudeSettings).text();
-  await Bun.write(defaultPath, content);
-  return { created: true, defaultPath };
+const ensureDefaultConfig = async (
+	manager: ContextManager,
+	configsDir: string,
+): Promise<{ created: boolean; defaultPath: string }> => {
+	const defaultPath = path.join(configsDir, "default.json");
+	if (existsSync(defaultPath)) {
+		return { created: false, defaultPath };
+	}
+	const currentContext = await getCurrentContext(manager);
+	if (currentContext) {
+		return { created: false, defaultPath };
+	}
+	const claudeSettings = path.join(homedir(), ".claude", "settings.json");
+	if (!existsSync(claudeSettings)) {
+		return { created: false, defaultPath };
+	}
+	mkdirSync(configsDir, { recursive: true });
+	const content = await Bun.file(claudeSettings).text();
+	await Bun.write(defaultPath, content);
+	return { created: true, defaultPath };
 };
 
-const getCurrentContext = async (manager: ContextManager): Promise<string | undefined> => {
-  return manager.getCurrentContext();
+const getCurrentContext = async (
+	manager: ContextManager,
+): Promise<string | undefined> => {
+	return manager.getCurrentContext();
 };
 
-const loadDefaultConfig = async (configsDir: string): Promise<Record<string, unknown>> => {
-  const defaultPath = path.join(configsDir, "default.json");
-  return readJsonIfExists<Record<string, unknown>>(defaultPath, {});
+const loadDefaultConfig = async (
+	configsDir: string,
+): Promise<Record<string, unknown>> => {
+	const defaultPath = path.join(configsDir, "default.json");
+	return readJsonIfExists<Record<string, unknown>>(defaultPath, {});
 };
 
-const importProfile = async (manager: ContextManager, profileName: string, merged: Record<string, unknown>): Promise<void> => {
-  await manager.deleteContext(profileName).catch(() => undefined);
-  const input = `${JSON.stringify(merged, null, 2)}\n`;
-  await manager.importContextFromString(profileName, input);
+const importProfile = async (
+	manager: ContextManager,
+	profileName: string,
+	merged: Record<string, unknown>,
+): Promise<void> => {
+	await manager.deleteContext(profileName).catch(() => undefined);
+	const input = `${JSON.stringify(merged, null, 2)}\n`;
+	await manager.importContextFromString(profileName, input);
 };
 
-const createDefaultProfileIfNeeded = async (manager: ContextManager, created: boolean, defaultProfile: Record<string, unknown>): Promise<void> => {
-  if (!created) {
-    return;
-  }
-  await importProfile(manager, "default", defaultProfile);
+const createDefaultProfileIfNeeded = async (
+	manager: ContextManager,
+	created: boolean,
+	defaultProfile: Record<string, unknown>,
+): Promise<void> => {
+	if (!created) {
+		return;
+	}
+	await importProfile(manager, "default", defaultProfile);
 };
 
-export const importFromCcs = async (manager: ContextManager, configsDir?: string): Promise<void> => {
-  const ccsPath = ccsDir();
-  if (!existsSync(ccsPath)) {
-    throw new Error(`CCS directory not found: ${ccsPath}`);
-  }
-  console.log(`📥 Importing profiles from CCS settings...`);
-  const dir = configsDir ?? defaultConfigsDir();
-  const { created } = await ensureDefaultConfig(manager, dir);
-  const defaultConfig = await loadDefaultConfig(dir);
-  const defaultProfile = await readJsonIfExists<Record<string, unknown>>(path.join(dir, "default.json"), defaultConfig);
-  await createDefaultProfileIfNeeded(manager, created, defaultProfile);
-  const currentContext = await manager.getCurrentContext();
-  let entries: string[] = [];
-  try {
-    entries = readdirSync(ccsPath).filter((name) => name.endsWith(".settings.json"));
-  } catch {
-    entries = [];
-  }
-  let importedCount = 0;
-  for (const fileName of entries) {
-    const settingsPath = path.join(ccsPath, fileName);
-    const profileName = fileName.replace(/\.settings\.json$/u, "");
-    console.log(`  📦 Importing '${colors.cyan(profileName)}'...`);
-    const settings = await readJson<Record<string, unknown>>(settingsPath);
-    const merged = deepMerge(defaultConfig, settings);
-    if (currentContext && currentContext === profileName) {
-      await manager.unsetContext();
-    }
-    await importProfile(manager, profileName, merged);
-    importedCount++;
-  }
-  if (currentContext) {
-    await manager.switchContext(currentContext);
-  }
-  console.log(`✅ Imported ${colors.bold(colors.green(String(importedCount)))} profiles from CCS`);
+export const importFromCcs = async (
+	manager: ContextManager,
+	configsDir?: string,
+): Promise<void> => {
+	const ccsPath = ccsDir();
+	if (!existsSync(ccsPath)) {
+		throw new Error(`CCS directory not found: ${ccsPath}`);
+	}
+	console.log(`📥 Importing profiles from CCS settings...`);
+	const dir = configsDir ?? defaultConfigsDir();
+	const { created } = await ensureDefaultConfig(manager, dir);
+	const defaultConfig = await loadDefaultConfig(dir);
+	const defaultProfile = await readJsonIfExists<Record<string, unknown>>(
+		path.join(dir, "default.json"),
+		defaultConfig,
+	);
+	await createDefaultProfileIfNeeded(manager, created, defaultProfile);
+	const currentContext = await manager.getCurrentContext();
+	let entries: string[] = [];
+	try {
+		entries = readdirSync(ccsPath).filter((name) =>
+			name.endsWith(".settings.json"),
+		);
+	} catch {
+		entries = [];
+	}
+	let importedCount = 0;
+	for (const fileName of entries) {
+		const settingsPath = path.join(ccsPath, fileName);
+		const profileName = fileName.replace(/\.settings\.json$/u, "");
+		console.log(`  📦 Importing '${colors.cyan(profileName)}'...`);
+		const settings = await readJson<Record<string, unknown>>(settingsPath);
+		const merged = deepMerge(defaultConfig, settings);
+		if (currentContext && currentContext === profileName) {
+			await manager.unsetContext();
+		}
+		await importProfile(manager, profileName, merged);
+		importedCount++;
+	}
+	if (currentContext) {
+		await manager.switchContext(currentContext);
+	}
+	console.log(
+		`✅ Imported ${colors.bold(colors.green(String(importedCount)))} profiles from CCS`,
+	);
 };