@guanmu/ccprofile 0.1.7 → 0.1.10

package/dist/index.js

@@ -2,7 +2,7 @@
 import fs from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
-import { execSync } from "node:child_process";
+import { execFileSync } from "node:child_process";
 import * as p from "@clack/prompts";
 const PROFILES_DIR = path.join(process.env.HOME, ".ccx", "profiles");
 const MARKETPLACES_DIR = path.join(process.env.HOME, ".claude", "plugins", "marketplaces");
@@ -12,24 +12,77 @@ function ensureProfilesDir() {
 function profilePath(name) {
     return path.join(PROFILES_DIR, `${name}.json`);
 }
+function isValidProfileName(name) {
+    return /^[A-Za-z0-9._-]+$/.test(name) && name !== "." && name !== "..";
+}
+function normalizeProfileName(name) {
+    if (!name)
+        return undefined;
+    const normalized = name.trim();
+    if (!isValidProfileName(normalized)) {
+        console.error("Invalid profile name. Use only letters, numbers, dots, underscores, and hyphens.");
+        process.exitCode = 1;
+        return undefined;
+    }
+    return normalized;
+}
+function normalizePluginName(plugin) {
+    if (!plugin)
+        return undefined;
+    const normalized = plugin.trim();
+    if (!normalized) {
+        console.error("Plugin name is required.");
+        process.exitCode = 1;
+        return undefined;
+    }
+    return normalized;
+}
 function readProfile(name) {
-    const file = profilePath(name);
+    const normalized = normalizeProfileName(name);
+    if (!normalized)
+        process.exit(1);
+    const file = profilePath(normalized);
     if (!fs.existsSync(file)) {
-        p.log.error(`Profile "${name}" not found.`);
+        p.log.error(`Profile "${normalized}" not found.`);
+        process.exit(1);
+    }
+    let data;
+    try {
+        data = JSON.parse(fs.readFileSync(file, "utf-8"));
+    }
+    catch {
+        p.log.error(`Invalid profile file "${normalized}". Expected valid JSON.`);
         process.exit(1);
     }
-    return JSON.parse(fs.readFileSync(file, "utf-8"));
+    if (!data ||
+        typeof data !== "object" ||
+        !Array.isArray(data.plugins)) {
+        p.log.error(`Invalid profile file "${normalized}". Expected a plugins array.`);
+        process.exit(1);
+    }
+    const plugins = data.plugins.map((plugin) => typeof plugin === "string" ? plugin.trim() : undefined);
+    if (plugins.some((plugin) => !plugin)) {
+        p.log.error(`Invalid profile file "${normalized}". Plugin entries must be non-empty strings.`);
+        process.exit(1);
+    }
+    return {
+        name: normalized,
+        plugins: plugins,
+    };
 }
 function writeProfile(name, data) {
+    const normalized = normalizeProfileName(name);
+    if (!normalized)
+        return;
     ensureProfilesDir();
-    fs.writeFileSync(profilePath(name), JSON.stringify(data, null, 2) + "\n");
+    fs.writeFileSync(profilePath(normalized), JSON.stringify({ ...data, name: normalized }, null, 2) + "\n");
 }
 function getProfileNames() {
     ensureProfilesDir();
     return fs
         .readdirSync(PROFILES_DIR)
         .filter((f) => f.endsWith(".json"))
-        .map((f) => f.replace(".json", ""));
+        .map((f) => f.slice(0, -".json".length));
 }
 function getAllPlugins() {
     if (!fs.existsSync(MARKETPLACES_DIR))
@@ -40,27 +93,83 @@ function getAllPlugins() {
         const file = path.join(MARKETPLACES_DIR, dir, ".claude-plugin", "marketplace.json");
         if (!fs.existsSync(file))
             continue;
-        const data = JSON.parse(fs.readFileSync(file, "utf-8"));
-        for (const pl of data.plugins || []) {
+        let data;
+        try {
+            data = JSON.parse(fs.readFileSync(file, "utf-8"));
+        }
+        catch {
+            p.log.warn(`Skipping invalid marketplace "${dir}".`);
+            continue;
+        }
+        if (!data ||
+            typeof data !== "object" ||
+            !Array.isArray(data.plugins)) {
+            p.log.warn(`Skipping invalid marketplace "${dir}".`);
+            continue;
+        }
+        const marketplace = typeof data.name === "string"
+            ? (data.name || dir)
+            : dir;
+        for (const pl of data.plugins) {
+            if (!pl || typeof pl !== "object")
+                continue;
+            const name = pl.name;
+            if (typeof name !== "string" || !name.trim())
+                continue;
+            const description = pl.description;
+            const category = pl.category;
             plugins.push({
-                name: pl.name,
-                description: pl.description || "",
-                category: pl.category,
-                marketplace: data.name,
+                name: name.trim(),
+                description: typeof description === "string" ? description : "",
+                category: typeof category === "string" ? category : undefined,
+                marketplace,
             });
         }
     }
     return plugins;
 }
+function canPrompt() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+function printNonInteractiveHelp() {
+    console.error("Interactive mode requires a TTY. Run `ccx --help` for command usage.");
+    printHelp();
+}
+function missingArg(message, usage) {
+    console.error(message);
+    console.error(`Usage: ${usage}`);
+    process.exitCode = 1;
+}
+async function selectProfile(message) {
+    const names = getProfileNames();
+    if (names.length === 0) {
+        p.log.warn("No profiles found.");
+        return undefined;
+    }
+    const name = await p.select({
+        message,
+        options: names.map((n) => ({ value: n, label: n })),
+    });
+    if (p.isCancel(name))
+        return undefined;
+    return name;
+}
 // ── Commands ──────────────────────────────────────────────
 async function addProfile(name) {
     if (!name) {
+        if (!canPrompt()) {
+            missingArg("Profile name is required.", "ccx create <name>");
+            return;
+        }
         name = (await p.text({
             message: "Profile name:",
         }));
         if (p.isCancel(name))
             return;
     }
+    name = normalizeProfileName(name);
+    if (!name)
+        return;
     const file = profilePath(name);
     if (fs.existsSync(file)) {
         p.log.error(`Profile "${name}" already exists.`);
@@ -70,12 +179,20 @@ async function addProfile(name) {
     p.log.success(`Created profile "${name}".`);
 }
 async function removeProfile(name) {
+    if (!name && !canPrompt()) {
+        missingArg("Profile name is required.", "ccx delete <name>");
+        return;
+    }
     const names = getProfileNames();
     if (names.length === 0) {
         p.log.warn("No profiles found.");
         return;
     }
     if (!name) {
+        if (!canPrompt()) {
+            missingArg("Profile name is required.", "ccx delete <name>");
+            return;
+        }
         name = (await p.select({
             message: "Select profile to remove:",
             options: names.map((n) => ({ value: n, label: n })),
@@ -83,6 +200,9 @@ async function removeProfile(name) {
         if (p.isCancel(name))
             return;
     }
+    name = normalizeProfileName(name);
+    if (!name)
+        return;
     const file = profilePath(name);
     if (!fs.existsSync(file)) {
         p.log.error(`Profile "${name}" not found.`);
@@ -92,22 +212,26 @@ async function removeProfile(name) {
     p.log.success(`Removed profile "${name}".`);
 }
 async function listProfiles() {
-    ensureProfilesDir();
-    const files = fs
-        .readdirSync(PROFILES_DIR)
-        .filter((f) => f.endsWith(".json"));
-    if (files.length === 0) {
+    const names = getProfileNames();
+    if (names.length === 0) {
         p.log.warn("No profiles found.");
         return;
     }
-    for (const f of files) {
-        const data = JSON.parse(fs.readFileSync(path.join(PROFILES_DIR, f), "utf-8"));
+    for (const name of names) {
+        const data = readProfile(name);
         p.log.success(`${data.name}  (${data.plugins.length} plugins)`);
     }
 }
 async function addPlugin(profileName, plugin) {
+    const normalizedProfileName = normalizeProfileName(profileName);
+    if (!normalizedProfileName)
+        return;
     const data = readProfile(profileName);
     if (!plugin) {
+        if (!canPrompt()) {
+            missingArg("Plugin name is required.", "ccx add <profile> <plugin>");
+            return;
+        }
         const allPlugins = getAllPlugins();
         const available = allPlugins.filter((pl) => !data.plugins.includes(pl.name));
         if (available.length === 0) {
@@ -138,21 +262,31 @@ async function addPlugin(profileName, plugin) {
             plugin = selected;
         }
     }
+    plugin = normalizePluginName(plugin);
+    if (!plugin)
+        return;
     if (data.plugins.includes(plugin)) {
         p.log.warn(`Plugin "${plugin}" already in profile.`);
         return;
     }
     data.plugins.push(plugin);
-    writeProfile(profileName, data);
-    p.log.success(`Added "${plugin}" to profile "${profileName}".`);
+    writeProfile(normalizedProfileName, data);
+    p.log.success(`Added "${plugin}" to profile "${normalizedProfileName}".`);
 }
 async function removePlugin(profileName, plugin) {
+    const normalizedProfileName = normalizeProfileName(profileName);
+    if (!normalizedProfileName)
+        return;
     const data = readProfile(profileName);
     if (data.plugins.length === 0) {
         p.log.warn("No plugins in this profile.");
         return;
     }
     if (!plugin) {
+        if (!canPrompt()) {
+            missingArg("Plugin name is required.", "ccx remove <profile> <plugin>");
+            return;
+        }
         plugin = (await p.select({
             message: `Remove plugin from "${profileName}":`,
             options: data.plugins.map((pl) => ({
@@ -163,19 +297,25 @@ async function removePlugin(profileName, plugin) {
         if (p.isCancel(plugin))
             return;
     }
+    plugin = normalizePluginName(plugin);
+    if (!plugin)
+        return;
     const idx = data.plugins.indexOf(plugin);
     if (idx === -1) {
         p.log.error(`Plugin "${plugin}" not found.`);
         return;
     }
     data.plugins.splice(idx, 1);
-    writeProfile(profileName, data);
-    p.log.success(`Removed "${plugin}" from profile "${profileName}".`);
+    writeProfile(normalizedProfileName, data);
+    p.log.success(`Removed "${plugin}" from profile "${normalizedProfileName}".`);
 }
 async function listPlugins(profileName) {
-    const data = readProfile(profileName);
+    const normalizedProfileName = normalizeProfileName(profileName);
+    if (!normalizedProfileName)
+        return;
+    const data = readProfile(normalizedProfileName);
     if (data.plugins.length === 0) {
-        p.log.warn(`No plugins in profile "${profileName}".`);
+        p.log.warn(`No plugins in profile "${normalizedProfileName}".`);
         return;
     }
     for (const pl of data.plugins) {
@@ -184,6 +324,10 @@ async function listPlugins(profileName) {
 }
 async function searchPlugins(keyword) {
     if (!keyword) {
+        if (!canPrompt()) {
+            missingArg("Search keyword is required.", "ccx search <keyword>");
+            return;
+        }
         keyword = (await p.text({
             message: "Search plugins:",
         }));
@@ -218,19 +362,22 @@ async function searchPlugins(keyword) {
     }
 }
 async function executeProfile(profileName) {
-    const data = readProfile(profileName);
+    const normalizedProfileName = normalizeProfileName(profileName);
+    if (!normalizedProfileName)
+        return;
+    const data = readProfile(normalizedProfileName);
     if (data.plugins.length === 0) {
-        p.log.warn(`No plugins to install in profile "${profileName}".`);
+        p.log.warn(`No plugins to install in profile "${normalizedProfileName}".`);
         return;
     }
     const s = p.spinner();
-    s.start(`Installing ${data.plugins.length} plugin(s) from "${profileName}"...`);
+    s.start(`Installing ${data.plugins.length} plugin(s) from "${normalizedProfileName}"...`);
     let installed = 0;
     let failed = 0;
     for (const plugin of data.plugins) {
         s.message(`Installing ${plugin}...`);
         try {
-            execSync(`claude plugin install ${plugin} --scope project`, {
+            execFileSync("claude", ["plugin", "install", plugin, "--scope", "project"], {
                 stdio: "pipe",
             });
             installed++;
@@ -243,164 +390,261 @@ async function executeProfile(profileName) {
     s.stop(`${installed} installed${failed > 0 ? `, ${failed} failed` : ""}`);
     p.log.success("Done.");
 }
+async function installWizard() {
+    while (true) {
+        const action = await p.select({
+            message: "Install",
+            options: [
+                { value: "install", label: "Install profile plugins", hint: "Run a profile" },
+                { value: "back", label: "Back" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(action) || action === "exit")
+            return "exit";
+        if (action === "back")
+            return "back";
+        const name = await selectProfile("Select profile to install:");
+        if (name)
+            await executeProfile(name);
+    }
+}
+async function profilesWizard() {
+    while (true) {
+        const action = await p.select({
+            message: "Profiles",
+            options: [
+                { value: "create", label: "Create profile", hint: "Create a new empty profile" },
+                { value: "list", label: "List profiles", hint: "Show all profiles" },
+                { value: "delete", label: "Delete profile", hint: "Remove a profile" },
+                { value: "back", label: "Back" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(action) || action === "exit")
+            return "exit";
+        if (action === "back")
+            return "back";
+        switch (action) {
+            case "create":
+                await addProfile();
+                break;
+            case "list":
+                await listProfiles();
+                break;
+            case "delete":
+                await removeProfile();
+                break;
+        }
+    }
+}
+async function pluginsWizard() {
+    while (true) {
+        const action = await p.select({
+            message: "Plugins",
+            options: [
+                { value: "add", label: "Add plugin to profile", hint: "Choose a profile, then a plugin" },
+                { value: "remove", label: "Remove plugin from profile", hint: "Choose a profile, then a plugin" },
+                { value: "list", label: "List profile plugins", hint: "Show plugins in a profile" },
+                { value: "back", label: "Back" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(action) || action === "exit")
+            return "exit";
+        if (action === "back")
+            return "back";
+        const name = await selectProfile("Select profile:");
+        if (!name)
+            continue;
+        switch (action) {
+            case "add":
+                await addPlugin(name);
+                break;
+            case "remove":
+                await removePlugin(name);
+                break;
+            case "list":
+                await listPlugins(name);
+                break;
+        }
+    }
+}
+async function marketplaceWizard() {
+    while (true) {
+        const action = await p.select({
+            message: "Marketplace",
+            options: [
+                { value: "search", label: "Search plugins", hint: "Search installed marketplaces" },
+                { value: "back", label: "Back" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(action) || action === "exit")
+            return "exit";
+        if (action === "back")
+            return "back";
+        await searchPlugins();
+    }
+}
 async function interactiveMode() {
-    p.intro("ccx — Agent Profile Manager");
-    const action = await p.select({
-        message: "What do you want to do?",
-        options: [
-            { value: "install", label: "Install profile plugins", hint: "Run a profile to install its plugins" },
-            { value: "plugin-add", label: "Add plugin to profile", hint: "Add a plugin to an existing profile" },
-            { value: "plugin-remove", label: "Remove plugin from profile", hint: "Remove a plugin from a profile" },
-            { value: "plugin-list", label: "List profile plugins", hint: "Show plugins in a profile" },
-            { value: "add", label: "Create new profile", hint: "Create a new empty profile" },
-            { value: "remove", label: "Delete profile", hint: "Remove a profile" },
-            { value: "list", label: "List all profiles", hint: "Show all profiles" },
-            { value: "search", label: "Search plugins", hint: "Search plugins in marketplaces" },
-        ],
-    });
-    if (p.isCancel(action))
+    if (!canPrompt()) {
+        printNonInteractiveHelp();
+        process.exitCode = 1;
         return;
-    switch (action) {
-        case "install": {
-            const names = getProfileNames();
-            if (names.length === 0) {
-                p.log.warn("No profiles found.");
-                return;
-            }
-            const name = await p.select({
-                message: "Select profile to install:",
-                options: names.map((n) => ({ value: n, label: n })),
-            });
-            if (p.isCancel(name))
-                return;
-            await executeProfile(name);
+    }
+    p.intro("ccx — Agent Profile Manager");
+    let shouldExit = false;
+    while (!shouldExit) {
+        const area = await p.select({
+            message: "Choose area:",
+            options: [
+                { value: "install", label: "Install", hint: "Run a profile" },
+                { value: "profiles", label: "Profiles", hint: "Create, list, or delete profiles" },
+                { value: "plugins", label: "Plugins", hint: "Manage plugins inside profiles" },
+                { value: "marketplace", label: "Marketplace", hint: "Search available plugins" },
+                { value: "help", label: "Help", hint: "Show command usage" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(area) || area === "exit")
             break;
+        let result = "back";
+        switch (area) {
+            case "install":
+                result = await installWizard();
+                break;
+            case "profiles":
+                result = await profilesWizard();
+                break;
+            case "plugins":
+                result = await pluginsWizard();
+                break;
+            case "marketplace":
+                result = await marketplaceWizard();
+                break;
+            case "help":
+                printHelp();
+                break;
         }
-        case "plugin-add": {
-            const names = getProfileNames();
-            if (names.length === 0) {
-                p.log.warn("No profiles found. Create one first.");
-                return;
-            }
-            const name = await p.select({
-                message: "Select profile:",
-                options: names.map((n) => ({ value: n, label: n })),
-            });
-            if (p.isCancel(name))
-                return;
-            await addPlugin(name);
+        shouldExit = result === "exit";
+    }
+    p.outro("Done.");
+}
+function printHelp() {
+    console.log(`ccx — Agent Profile Manager for Claude Code
+
+Usage:
+  ccx                            Interactive mode (TTY only)
+  ccx ui                         Interactive mode (TTY only)
+  ccx install <profile>          Install all plugins from profile
+  ccx create <name>              Create a new profile
+  ccx delete <name>              Remove a profile
+  ccx profiles                   List all profiles
+  ccx add <profile> <plugin>     Add plugin to profile
+  ccx remove <profile> <plugin>  Remove plugin from profile
+  ccx list <profile>             List plugins in profile
+  ccx search <keyword>           Search plugins in marketplaces
+  ccx <profile>                  Install all plugins from profile
+  ccx <profile> add [plugin]     Add plugin to profile (legacy)
+  ccx <profile> remove [plugin]  Remove plugin from profile (legacy)
+  ccx <profile> list             List plugins in profile (legacy)
+  ccx add <name>                 Create a new profile (legacy)
+  ccx remove <name>              Remove a profile (legacy)
+  ccx list                       List all profiles (legacy)
+  ccx -v, --version              Show version`);
+}
+// ── Main ──────────────────────────────────────────────────
+async function main(args) {
+    if (args.length === 0) {
+        await interactiveMode();
+        return;
+    }
+    if (args[0] === "--help" || args[0] === "-h") {
+        printHelp();
+        return;
+    }
+    if (args[0] === "--version" || args[0] === "-v" || args[0] === "-V") {
+        const require = createRequire(import.meta.url);
+        const pkg = require("../package.json");
+        console.log(`ccx v${pkg.version}`);
+        return;
+    }
+    const cmd = args[0];
+    switch (cmd) {
+        case "ui":
+        case "tui":
+        case "interactive":
+            await interactiveMode();
             break;
-        }
-        case "plugin-remove": {
-            const names = getProfileNames();
-            if (names.length === 0) {
-                p.log.warn("No profiles found.");
+        case "install":
+            if (!args[1]) {
+                missingArg("Profile name is required.", "ccx install <profile>");
                 return;
             }
-            const name = await p.select({
-                message: "Select profile:",
-                options: names.map((n) => ({ value: n, label: n })),
-            });
-            if (p.isCancel(name))
-                return;
-            await removePlugin(name);
+            await executeProfile(args[1]);
             break;
-        }
-        case "plugin-list": {
-            const names = getProfileNames();
-            if (names.length === 0) {
-                p.log.warn("No profiles found.");
-                return;
-            }
-            const name = await p.select({
-                message: "Select profile:",
-                options: names.map((n) => ({ value: n, label: n })),
-            });
-            if (p.isCancel(name))
-                return;
-            await listPlugins(name);
+        case "create":
+            await addProfile(args[1]);
+            break;
+        case "delete":
+            await removeProfile(args[1]);
+            break;
+        case "profiles":
+            await listProfiles();
             break;
-        }
         case "add":
-            await addProfile();
+            if (args[2]) {
+                await addPlugin(args[1], args[2]);
+            }
+            else {
+                await addProfile(args[1]);
+            }
             break;
         case "remove":
-            await removeProfile();
+            if (args[2]) {
+                await removePlugin(args[1], args[2]);
+            }
+            else {
+                await removeProfile(args[1]);
+            }
             break;
         case "list":
-            await listProfiles();
+            if (args[1]) {
+                await listPlugins(args[1]);
+            }
+            else {
+                await listProfiles();
+            }
             break;
         case "search":
-            await searchPlugins();
+            await searchPlugins(args[1]);
+            break;
+        default: {
+            const profileName = cmd;
+            const sub = args[1];
+            if (!sub) {
+                await executeProfile(profileName);
+            }
+            else if (sub === "add") {
+                await addPlugin(profileName, args[2]);
+            }
+            else if (sub === "remove") {
+                await removePlugin(profileName, args[2]);
+            }
+            else if (sub === "list") {
+                await listPlugins(profileName);
+            }
+            else {
+                console.error(`Unknown command: ccx ${args.join(" ")}`);
+                printHelp();
+                process.exitCode = 1;
+            }
             break;
-    }
-    p.outro("Done.");
-}
-function printHelp() {
-    console.log(`ccx — Agent Profile Manager for Claude Code
-
-Usage:
-  ccx                           Interactive mode
-  ccx <profile>                  Install all plugins from profile
-  ccx add <name>                 Create a new profile
-  ccx remove <name>              Remove a profile
-  ccx list                       List all profiles
-  ccx search <keyword>           Search plugins in marketplaces
-  ccx <profile> add [plugin]     Add plugin to profile
-  ccx <profile> remove [plugin]  Remove plugin from profile
-  ccx <profile> list             List plugins in profile
-  ccx -v, --version              Show version`);
-}
-// ── Main ──────────────────────────────────────────────────
-const args = process.argv.slice(2);
-if (args.length === 0) {
-    interactiveMode();
-    process.exit(0);
-}
-if (args[0] === "--help" || args[0] === "-h") {
-    printHelp();
-    process.exit(0);
-}
-if (args[0] === "--version" || args[0] === "-v" || args[0] === "-V") {
-    const require = createRequire(import.meta.url);
-    const pkg = require("../package.json");
-    console.log(`ccx v${pkg.version}`);
-    process.exit(0);
-}
-const cmd = args[0];
-switch (cmd) {
-    case "add":
-        addProfile(args[1]);
-        break;
-    case "remove":
-        removeProfile(args[1]);
-        break;
-    case "list":
-        listProfiles();
-        break;
-    case "search":
-        searchPlugins(args[1]);
-        break;
-    default: {
-        const profileName = cmd;
-        const sub = args[1];
-        if (!sub) {
-            executeProfile(profileName);
-        }
-        else if (sub === "add") {
-            addPlugin(profileName, args[2]);
-        }
-        else if (sub === "remove") {
-            removePlugin(profileName, args[2]);
-        }
-        else if (sub === "list") {
-            listPlugins(profileName);
-        }
-        else {
-            console.error(`Unknown command: ccx ${args.join(" ")}`);
-            printHelp();
-            process.exit(1);
         }
-        break;
     }
 }
+main(process.argv.slice(2)).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanmu/ccprofile",
-  "version": "0.1.7",
+  "version": "0.1.10",
   "description": "Agent Profile Manager for Claude Code",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "bun run src/index.ts",
+    "test": "pnpm run build && node test/cli.test.mjs",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {