kaven-cli 0.4.0 → 0.4.2-alpha.0

package/dist/commands/marketplace/browse.js

@@ -1,186 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.marketplaceBrowse = marketplaceBrowse;
-const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
-const AuthService_1 = require("../../core/AuthService");
-const MarketplaceClient_1 = require("../../infrastructure/MarketplaceClient");
-const install_1 = require("./install");
-const PAGE_SIZE = 10;
-function tierBadge(tier) {
-    switch (tier.toUpperCase()) {
-        case "FREE":
-            return chalk_1.default.gray("[FREE]");
-        case "STARTER":
-            return chalk_1.default.green("[STARTER]");
-        case "COMPLETE":
-            return chalk_1.default.yellow("[COMPLETE]");
-        case "PRO":
-            return chalk_1.default.magenta("[PRO]");
-        case "ENTERPRISE":
-            return chalk_1.default.cyan("[ENTERPRISE]");
-        default:
-            return chalk_1.default.gray(`[${tier}]`);
-    }
-}
-async function marketplaceBrowse() {
-    const authService = new AuthService_1.AuthService();
-    const client = new MarketplaceClient_1.MarketplaceClient(authService);
-    const state = {
-        category: null,
-        page: 1,
-        selectedModule: null,
-        screen: "categories",
-    };
-    const { select } = await import("@inquirer/prompts");
-    while (state.screen !== "exit") {
-        if (state.screen === "categories") {
-            // Step 1: Category selection
-            const spinner = (0, ora_1.default)("Loading categories...").start();
-            let categories = [];
-            try {
-                categories = await client.getCategories();
-                spinner.stop();
-            }
-            catch {
-                spinner.stop();
-                console.log(chalk_1.default.yellow("Could not load categories — showing all modules."));
-            }
-            const categoryChoices = [
-                { name: "All modules", value: "__all__" },
-                ...categories.map((c) => ({ name: c, value: c })),
-                { name: chalk_1.default.red("Exit"), value: "__exit__" },
-            ];
-            const selected = await select({
-                message: "Browse by category:",
-                choices: categoryChoices,
-            });
-            if (selected === "__exit__") {
-                state.screen = "exit";
-                break;
-            }
-            state.category = selected === "__all__" ? null : selected;
-            state.page = 1;
-            state.screen = "list";
-            continue;
-        }
-        if (state.screen === "list") {
-            // Step 2: Module listing with pagination
-            const spinner = (0, ora_1.default)("Loading modules...").start();
-            let modules = [];
-            let totalPages = 1;
-            try {
-                const result = await client.listModules({
-                    category: state.category || undefined,
-                    page: state.page,
-                    pageSize: PAGE_SIZE,
-                });
-                modules = result.data;
-                totalPages = Math.ceil(result.total / PAGE_SIZE) || 1;
-                spinner.stop();
-            }
-            catch (error) {
-                spinner.stop();
-                console.error(chalk_1.default.red(`Error loading modules: ${error instanceof Error ? error.message : String(error)}`));
-                state.screen = "categories";
-                continue;
-            }
-            if (modules.length === 0) {
-                console.log(chalk_1.default.yellow(`No modules found${state.category ? ` in category: ${state.category}` : ""}.`));
-                state.screen = "categories";
-                continue;
-            }
-            const categoryLabel = state.category ? ` [${state.category}]` : "";
-            const pageLabel = totalPages > 1 ? ` (page ${state.page}/${totalPages})` : "";
-            const moduleChoices = [
-                ...modules.map((m) => ({
-                    name: `${m.name} ${tierBadge(m.requiredTier ?? m.tier ?? "")} — ${m.description}`,
-                    value: m.slug,
-                })),
-            ];
-            // Navigation options at bottom
-            if (state.page < totalPages) {
-                moduleChoices.push({ name: chalk_1.default.cyan("→ Next page"), value: "__next__" });
-            }
-            if (state.page > 1) {
-                moduleChoices.push({ name: chalk_1.default.cyan("← Previous page"), value: "__prev__" });
-            }
-            moduleChoices.push({ name: chalk_1.default.dim("↑ Back to categories"), value: "__back__" });
-            moduleChoices.push({ name: chalk_1.default.red("Exit"), value: "__exit__" });
-            const selected = await select({
-                message: `Modules${categoryLabel}${pageLabel}:`,
-                choices: moduleChoices,
-            });
-            if (selected === "__exit__") {
-                state.screen = "exit";
-                break;
-            }
-            if (selected === "__back__") {
-                state.screen = "categories";
-                continue;
-            }
-            if (selected === "__next__") {
-                state.page++;
-                continue;
-            }
-            if (selected === "__prev__") {
-                state.page = Math.max(1, state.page - 1);
-                continue;
-            }
-            // Find selected module
-            const module = modules.find((m) => m.slug === selected);
-            if (module) {
-                state.selectedModule = module;
-                state.screen = "detail";
-            }
-            continue;
-        }
-        if (state.screen === "detail" && state.selectedModule) {
-            const m = state.selectedModule;
-            // Step 3: Module detail view
-            console.log();
-            console.log(chalk_1.default.bold(`${m.name}`), tierBadge(m.requiredTier ?? m.tier ?? ""));
-            console.log(chalk_1.default.gray(`Version: ${m.latestVersion || "latest"}`));
-            if (m.installCount !== undefined) {
-                console.log(chalk_1.default.gray(`Installs: ${m.installCount.toLocaleString()}`));
-            }
-            if (m.description) {
-                console.log();
-                console.log(m.description);
-            }
-            console.log();
-            const action = await select({
-                message: "What would you like to do?",
-                choices: [
-                    { name: `Install ${m.name}`, value: "install" },
-                    { name: "Back to module list", value: "back" },
-                    { name: chalk_1.default.red("Exit"), value: "exit" },
-                ],
-            });
-            if (action === "exit") {
-                state.screen = "exit";
-                break;
-            }
-            if (action === "back") {
-                state.selectedModule = null;
-                state.screen = "list";
-                continue;
-            }
-            if (action === "install") {
-                console.log();
-                await (0, install_1.marketplaceInstall)(m.slug, {
-                    force: false,
-                    skipEnv: false,
-                });
-                state.screen = "exit";
-                break;
-            }
-        }
-    }
-    if (state.screen === "exit") {
-        console.log(chalk_1.default.gray("Browse session ended."));
-    }
-}

package/dist/commands/marketplace/install.js

@@ -1,263 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.marketplaceInstall = marketplaceInstall;
-const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const tar = __importStar(require("tar"));
-const MarketplaceClient_1 = require("../../infrastructure/MarketplaceClient");
-const AuthService_1 = require("../../core/AuthService");
-const ModuleInstaller_1 = require("../../core/ModuleInstaller");
-const MarkerService_1 = require("../../core/MarkerService");
-const TelemetryBuffer_1 = require("../../infrastructure/TelemetryBuffer");
-const errors_1 = require("../../infrastructure/errors");
-const SignatureVerifier_1 = require("../../core/SignatureVerifier");
-/** Create a unique temp directory for this install session. */
-async function makeTempDir() {
-    const base = path_1.default.join(os_1.default.tmpdir(), "kaven-install-");
-    return fs_extra_1.default.mkdtemp(base);
-}
-/** Format bytes into a human-readable string like "245 KB". */
-function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes} B`;
-    if (bytes < 1024 * 1024)
-        return `${Math.round(bytes / 1024)} KB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
-async function marketplaceInstall(slug, options = {}) {
-    const telemetry = TelemetryBuffer_1.TelemetryBuffer.getInstance();
-    const startTime = Date.now();
-    telemetry.capture("cli.marketplace.install.start", { slug });
-    const authService = new AuthService_1.AuthService();
-    const client = new MarketplaceClient_1.MarketplaceClient(authService);
-    const projectRoot = process.cwd();
-    // 1. Verify authentication — required for downloads
-    let accessToken;
-    try {
-        accessToken = await authService.getValidToken();
-    }
-    catch {
-        console.error(chalk_1.default.red("Authentication required. Run: kaven auth login"));
-        telemetry.capture("cli.marketplace.install.error", { slug, error: "not_authenticated" }, Date.now() - startTime);
-        await telemetry.flush();
-        process.exit(1);
-        return; // Unreachable but satisfies TS control flow
-    }
-    void accessToken; // used implicitly via authService in client
-    const spinner = (0, ora_1.default)(`Preparing installation of '${slug}'...`).start();
-    let tempDir = null;
-    try {
-        // 2. Get module metadata
-        spinner.text = `Fetching module '${slug}' from Marketplace...`;
-        let moduleData;
-        try {
-            moduleData = await client.getModule(slug);
-        }
-        catch (error) {
-            if (error instanceof errors_1.NotFoundError) {
-                spinner.fail(chalk_1.default.red(`Module '${slug}' not found in Marketplace.`));
-                process.exit(1);
-                return;
-            }
-            throw error;
-        }
-        const latestVersion = moduleData.latestVersion
-            ?? moduleData.releases?.[0]?.version;
-        const installVersion = options.version ?? latestVersion;
-        if (!installVersion) {
-            spinner.fail(chalk_1.default.red(`No published version found for '${slug}'.`));
-            process.exit(1);
-            return;
-        }
-        // 3. Check for conflict before downloading
-        const markerService = new MarkerService_1.MarkerService();
-        const installer = new ModuleInstaller_1.ModuleInstaller(projectRoot, markerService);
-        // Check if already installed by looking at marker files
-        const isInstalled = await installer.isModuleInstalled(slug);
-        if (isInstalled && !options.force) {
-            spinner.stop();
-            console.log(chalk_1.default.yellow(`Module '${slug}' is already installed. Use --force to overwrite.`));
-            telemetry.capture("cli.marketplace.install.skipped", { slug, reason: "already_installed" }, Date.now() - startTime);
-            await telemetry.flush();
-            return;
-        }
-        // 4. Create download token
-        spinner.text = `Creating download token for '${slug}@${installVersion}'...`;
-        const downloadToken = await client.createDownloadToken(slug, installVersion);
-        // 5. Download the tarball to a temp directory
-        tempDir = await makeTempDir();
-        const tarPath = path_1.default.join(tempDir, "module.tar.gz");
-        const extractDir = path_1.default.join(tempDir, "extracted");
-        await fs_extra_1.default.ensureDir(extractDir);
-        // Fetch with size reporting
-        spinner.text = `Downloading ${slug} v${installVersion}...`;
-        const absoluteUrl = await client.resolveUrl(downloadToken.downloadUrl);
-        const response = await fetch(absoluteUrl);
-        if (!response.ok) {
-            throw new Error(`Download failed: ${response.status} ${response.statusText}`);
-        }
-        const contentLength = response.headers.get("content-length");
-        const sizeStr = contentLength
-            ? ` (${formatBytes(parseInt(contentLength, 10))})`
-            : "";
-        spinner.text = `Downloading ${slug} v${installVersion}${sizeStr}...`;
-        if (!response.body) {
-            throw new Error("No response body received for download");
-        }
-        // Stream download to file
-        const fileStream = fs_extra_1.default.createWriteStream(tarPath);
-        const reader = response.body.getReader();
-        await new Promise((resolve, reject) => {
-            const pump = async () => {
-                try {
-                    let reading = true;
-                    while (reading) {
-                        const { done, value } = await reader.read();
-                        if (done) {
-                            fileStream.end();
-                            reading = false;
-                        }
-                        else {
-                            if (!fileStream.write(value)) {
-                                await new Promise((r) => fileStream.once("drain", r));
-                            }
-                        }
-                    }
-                    fileStream.once("finish", resolve);
-                    fileStream.once("error", reject);
-                }
-                catch (err) {
-                    reject(err);
-                }
-            };
-            pump();
-        });
-        // 6. Verify Ed25519 signature and SHA-256 checksum
-        const stat = await fs_extra_1.default.stat(tarPath);
-        if (stat.size === 0) {
-            throw new Error("Downloaded file is empty");
-        }
-        if (!options.skipVerify) {
-            spinner.text = `Verifying signature for ${slug} v${installVersion}...`;
-            const releaseInfo = await client.getReleaseInfo(slug, installVersion);
-            if (releaseInfo.checksum &&
-                releaseInfo.signature &&
-                releaseInfo.publicKey) {
-                await (0, SignatureVerifier_1.verifyDownload)({
-                    filePath: tarPath,
-                    expectedChecksum: releaseInfo.checksum,
-                    signature: releaseInfo.signature,
-                    publicKeyBase64: releaseInfo.publicKey,
-                });
-                spinner.text = `Signature verified for ${slug} v${installVersion}`;
-            }
-            else {
-                spinner.text = `No signature data for ${slug} v${installVersion} — skipping verification`;
-            }
-        }
-        // 7. Extract tarball
-        spinner.text = `Extracting ${slug} v${installVersion}...`;
-        await tar.x({ file: tarPath, cwd: extractDir });
-        // 8. Read module.json manifest from extracted dir
-        const manifestPath = path_1.default.join(extractDir, "module.json");
-        const manifestExists = await fs_extra_1.default.pathExists(manifestPath);
-        if (!manifestExists) {
-            throw new Error(`module.json not found in extracted archive for '${slug}'`);
-        }
-        const manifest = await fs_extra_1.default.readJson(manifestPath);
-        // 9. Delegate to ModuleInstaller
-        spinner.text = `Installing ${slug} v${installVersion}...`;
-        await installer.install(manifest);
-        spinner.succeed(chalk_1.default.green(`Module '${slug}@${installVersion}' installed successfully.`));
-        console.log(chalk_1.default.gray(`Use 'kaven module doctor' to verify the installation.`));
-        telemetry.capture("cli.marketplace.install.success", { slug, version: installVersion }, Date.now() - startTime);
-        await telemetry.flush();
-    }
-    catch (error) {
-        spinner.stop();
-        if (error instanceof errors_1.SignatureVerificationError) {
-            console.error(chalk_1.default.red(`Signature verification failed for '${slug}': ${error.message}`));
-            console.error(chalk_1.default.yellow("Use --skip-verify to bypass (not recommended)."));
-            telemetry.capture("cli.marketplace.install.error", { slug, error: "signature_verification_failed" }, Date.now() - startTime);
-            await telemetry.flush();
-            process.exit(1);
-            return;
-        }
-        if (error instanceof errors_1.LicenseRequiredError) {
-            console.error(chalk_1.default.red(`License required: '${slug}' requires a '${error.requiredTier}' license.`));
-            console.error(chalk_1.default.yellow(`Run: kaven upgrade ${error.requiredTier}`));
-            telemetry.capture("cli.marketplace.install.error", { slug, error: "license_required", tier: error.requiredTier }, Date.now() - startTime);
-            await telemetry.flush();
-            process.exit(1);
-            return;
-        }
-        if (error instanceof errors_1.AuthenticationError ||
-            (error instanceof Error &&
-                error.message.includes("Not authenticated"))) {
-            console.error(chalk_1.default.red("Authentication required. Run: kaven auth login"));
-            telemetry.capture("cli.marketplace.install.error", { slug, error: "auth_error" }, Date.now() - startTime);
-            await telemetry.flush();
-            process.exit(1);
-            return;
-        }
-        if (error instanceof errors_1.NetworkError) {
-            console.error(chalk_1.default.red("Could not reach marketplace. Check your connection."));
-            telemetry.capture("cli.marketplace.install.error", { slug, error: "network_error" }, Date.now() - startTime);
-            await telemetry.flush();
-            process.exit(1);
-            return;
-        }
-        telemetry.capture("cli.marketplace.install.error", { slug, error: error.message }, Date.now() - startTime);
-        await telemetry.flush();
-        spinner.fail(chalk_1.default.red(`Failed to install module '${slug}'.`));
-        console.error(error);
-        process.exit(1);
-    }
-    finally {
-        // 10. Always cleanup temp dir
-        if (tempDir) {
-            await fs_extra_1.default.remove(tempDir).catch(() => {
-                // Ignore cleanup errors
-            });
-        }
-    }
-}

package/dist/commands/marketplace/list.js

@@ -1,122 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.marketplaceList = marketplaceList;
-const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
-const cli_table3_1 = __importDefault(require("cli-table3"));
-const MarketplaceClient_1 = require("../../infrastructure/MarketplaceClient");
-const AuthService_1 = require("../../core/AuthService");
-const errors_1 = require("../../infrastructure/errors");
-const TelemetryBuffer_1 = require("../../infrastructure/TelemetryBuffer");
-function colorTier(tier) {
-    switch (tier.toLowerCase()) {
-        case "starter":
-            return chalk_1.default.green(tier.toLowerCase());
-        case "complete":
-            return chalk_1.default.yellow(tier.toLowerCase());
-        case "pro":
-            return chalk_1.default.magenta(tier.toLowerCase());
-        case "enterprise":
-            return chalk_1.default.blue(tier.toLowerCase());
-        default:
-            return tier;
-    }
-}
-async function marketplaceList(options = {}) {
-    const telemetry = TelemetryBuffer_1.TelemetryBuffer.getInstance();
-    const startTime = Date.now();
-    telemetry.capture("cli.marketplace.list.start");
-    const authService = new AuthService_1.AuthService();
-    const client = new MarketplaceClient_1.MarketplaceClient(authService);
-    const page = options.page ?? 1;
-    const pageSize = Math.min(options.limit ?? 20, 100);
-    const sort = options.sort ?? "newest";
-    // Check auth — warn but don't block
-    const isAuth = await authService.isAuthenticated();
-    if (!isAuth) {
-        console.log(chalk_1.default.yellow("Warning: Not authenticated. Only public modules will be shown. Run: kaven auth login"));
-    }
-    const spinner = (0, ora_1.default)("Fetching modules from Marketplace...").start();
-    try {
-        const result = await client.listModules({
-            category: options.category,
-            page,
-            pageSize,
-            q: sort === "newest" ? undefined : undefined,
-        });
-        spinner.stop();
-        const modules = result.data;
-        const meta = result.meta;
-        const total = result.total ?? meta?.total ?? modules.length;
-        if (options.json) {
-            console.log(JSON.stringify(result, null, 2));
-            telemetry.capture("cli.marketplace.list.success", { count: modules.length, json: true }, Date.now() - startTime);
-            await telemetry.flush();
-            return;
-        }
-        if (modules.length === 0) {
-            console.log(chalk_1.default.yellow("No modules found matching your criteria."));
-            telemetry.capture("cli.marketplace.list.success", { count: 0 }, Date.now() - startTime);
-            await telemetry.flush();
-            return;
-        }
-        const table = new cli_table3_1.default({
-            head: [
-                chalk_1.default.white.bold("Slug"),
-                chalk_1.default.white.bold("Name"),
-                chalk_1.default.white.bold("Version"),
-                chalk_1.default.white.bold("Tier"),
-                chalk_1.default.white.bold("Installs"),
-            ],
-            style: {
-                head: [],
-                border: ["gray"],
-            },
-        });
-        // Sort modules client-side based on sort option
-        const sorted = [...modules];
-        if (sort === "popular") {
-            sorted.sort((a, b) => b.installCount - a.installCount);
-        }
-        else if (sort === "name") {
-            sorted.sort((a, b) => a.name.localeCompare(b.name));
-        }
-        // newest = default server-side order
-        for (const mod of sorted) {
-            table.push([
-                chalk_1.default.cyan(mod.slug),
-                chalk_1.default.white(mod.name),
-                chalk_1.default.green(mod.latestVersion ?? "—"),
-                colorTier(mod.requiredTier ?? mod.tier ?? ""),
-                chalk_1.default.gray(String(mod.installCount)),
-            ]);
-        }
-        console.log(chalk_1.default.blue.bold("\nAvailable Marketplace Modules:\n"));
-        console.log(table.toString());
-        // Pagination footer
-        const totalPages = Math.ceil(total / pageSize);
-        const startItem = (page - 1) * pageSize + 1;
-        const endItem = Math.min(page * pageSize, total);
-        console.log(chalk_1.default.gray(`\nShowing ${startItem}-${endItem} of ${total} modules (page ${page}/${totalPages})`));
-        console.log(chalk_1.default.gray("Use 'kaven marketplace install <slug>' to install a module."));
-        telemetry.capture("cli.marketplace.list.success", { count: modules.length, total }, Date.now() - startTime);
-        await telemetry.flush();
-    }
-    catch (error) {
-        spinner.stop();
-        if (error instanceof errors_1.NetworkError) {
-            console.error(chalk_1.default.red("Could not reach marketplace. Check your connection."));
-            telemetry.capture("cli.marketplace.list.error", { error: "network_error" }, Date.now() - startTime);
-            await telemetry.flush();
-            process.exit(1);
-        }
-        telemetry.capture("cli.marketplace.list.error", { error: error.message }, Date.now() - startTime);
-        await telemetry.flush();
-        console.error(chalk_1.default.red("Error fetching modules from Marketplace."));
-        console.error(error);
-        process.exit(1);
-    }
-}