@floomhq/floom 1.0.64 → 2.0.0

package/dist/doctor.js

@@ -1,381 +0,0 @@
-import { homedir } from "node:os";
-import { execFile as execFileCb } from "node:child_process";
-import { delimiter } from "node:path";
-import { join } from "node:path";
-import { stat, readFile, access, readdir, constants, realpath } from "node:fs/promises";
-import { promisify } from "node:util";
-import { readConfig, refreshConfigIfNeeded, CONFIG_PATH, resolveApiUrl } from "./config.js";
-import { floomFetch } from "./lib/api.js";
-import { c, symbols } from "./ui.js";
-import { CLI_VERSION, compareSemverish, formatVersionLabel } from "./version.js";
-import { targetSkillsDir } from "./targets.js";
-const execFile = promisify(execFileCb);
-function statusBadge(s) {
-    if (s === "ok")
-        return c.green(symbols.ok);
-    if (s === "warn")
-        return c.yellow("!");
-    return c.red(symbols.fail);
-}
-async function checkAuth() {
-    const cfg = await readConfig();
-    if (!cfg) {
-        return {
-            name: "Auth",
-            status: "ok",
-            detail: "Receiver mode ready. Sign in only when publishing or listing your own skills.",
-        };
-    }
-    const apiUrl = resolveApiUrl(cfg);
-    try {
-        const res = await floomFetch(`${apiUrl}/api/me`, "check authentication", {
-            token: cfg.accessToken,
-            checkOk: false,
-        });
-        if (res.status === 401) {
-            const refreshed = await refreshConfigIfNeeded(cfg, { force: true });
-            if (refreshed.accessToken !== cfg.accessToken) {
-                const retry = await floomFetch(`${apiUrl}/api/me`, "check authentication", {
-                    token: refreshed.accessToken,
-                    checkOk: false,
-                });
-                if (retry.ok) {
-                    const data = (await retry.json());
-                    return {
-                        name: "Auth",
-                        status: "ok",
-                        detail: data.email ? `Signed in as ${data.email} (refreshed)` : "Signed in (refreshed)",
-                    };
-                }
-            }
-            return {
-                name: "Auth",
-                status: "fail",
-                detail: "Token rejected (401).",
-                hint: "Run `npx -y @floomhq/floom logout && npx -y @floomhq/floom login` to refresh.",
-            };
-        }
-        if (!res.ok) {
-            return {
-                name: "Auth",
-                status: "warn",
-                detail: `API returned ${res.status}.`,
-                hint: "Service may be degraded; try again shortly.",
-            };
-        }
-        const data = (await res.json());
-        return {
-            name: "Auth",
-            status: "ok",
-            detail: data.email ? `Signed in as ${data.email}` : "Signed in",
-        };
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        return {
-            name: "Auth",
-            status: "fail",
-            detail: `Cannot reach ${apiUrl}: ${msg}`,
-            hint: "Check your network. Try `curl " + apiUrl + "/api/me`.",
-        };
-    }
-}
-async function checkMcp() {
-    const candidates = [
-        { name: "Claude Code", path: join(homedir(), ".claude.json") },
-        { name: "Claude Code (settings)", path: join(homedir(), ".claude", "settings.json") },
-        { name: "Codex", path: join(homedir(), ".codex", "config.toml") },
-        { name: "Cursor", path: join(homedir(), ".cursor", "mcp.json") },
-        { name: "OpenCode", path: join(homedir(), ".config", "opencode", "opencode.json") },
-        { name: "Kimi", path: join(homedir(), ".kimi", "mcp.json") },
-        { name: "Gemini", path: join(homedir(), ".gemini", "settings.json") },
-    ];
-    const found = [];
-    for (const cand of candidates) {
-        try {
-            const buf = await readFile(cand.path, "utf8");
-            // Cheap match: any reference to a Floom MCP server. The actual MCP
-            // package name is @floomhq/floom-mcp-sync. Detect by package name OR
-            // by "floom" + "mcp_servers"/"mcpServers" co-occurrence.
-            const hasFloom = buf.includes("@floomhq/floom-mcp-sync") ||
-                (buf.includes("\"floom\"") && (buf.includes("mcpServers") || buf.includes("mcp_servers") || buf.includes("\"mcp\""))) ||
-                (buf.includes("[mcp_servers.floom]"));
-            if (hasFloom)
-                found.push({ name: cand.name, configPath: cand.path, hasFloom });
-        }
-        catch {
-            // file missing — fine
-        }
-    }
-    if (found.length === 0) {
-        return {
-            name: "MCP",
-            status: "ok",
-            detail: "Optional MCP not registered. `npx -y @floomhq/floom add` still writes local skill files.",
-        };
-    }
-    return {
-        name: "MCP",
-        status: "ok",
-        detail: `Registered with: ${found.map((f) => f.name).join(", ")}`,
-    };
-}
-async function checkTargetDir(target) {
-    const dir = targetSkillsDir(target);
-    try {
-        const s = await stat(dir);
-        if (!s.isDirectory()) {
-            return {
-                name: "Target dir",
-                status: "fail",
-                detail: `${dir} exists but is not a directory.`,
-            };
-        }
-        try {
-            await access(dir, constants.W_OK);
-            return { name: "Target dir", status: "ok", detail: `${dir} (writable)` };
-        }
-        catch {
-            return {
-                name: "Target dir",
-                status: "fail",
-                detail: `${dir} is not writable.`,
-                hint: `Try: chmod u+w ${dir}`,
-            };
-        }
-    }
-    catch (err) {
-        if (err.code === "ENOENT") {
-            return {
-                name: "Target dir",
-                status: "warn",
-                detail: `${dir} does not exist yet.`,
-                hint: `It will be created on first \`npx -y @floomhq/floom add <link> --target ${target}\`.`,
-            };
-        }
-        throw err;
-    }
-}
-async function checkLastSync(target) {
-    const dir = targetSkillsDir(target);
-    try {
-        const entries = await readdir(dir);
-        const skills = entries.filter((e) => e.endsWith(".md") || !e.startsWith("."));
-        if (skills.length === 0) {
-            return {
-                name: "Last sync",
-                status: "warn",
-                detail: "No synced skills found yet.",
-                hint: `Run \`npx -y @floomhq/floom add <link> --target ${target}\` to install your first skill.`,
-            };
-        }
-        // Find most recently modified entry
-        let newest = { name: "", mtime: 0 };
-        for (const name of skills) {
-            try {
-                const s = await stat(join(dir, name));
-                if (s.mtimeMs > newest.mtime)
-                    newest = { name, mtime: s.mtimeMs };
-            }
-            catch {
-                // skip
-            }
-        }
-        if (newest.mtime === 0) {
-            return {
-                name: "Last sync",
-                status: "warn",
-                detail: `${skills.length} entries, no readable mtime.`,
-            };
-        }
-        const ageSec = Math.round((Date.now() - newest.mtime) / 1000);
-        const human = ageSec < 60
-            ? `${ageSec}s ago`
-            : ageSec < 3600
-                ? `${Math.round(ageSec / 60)}m ago`
-                : ageSec < 86400
-                    ? `${Math.round(ageSec / 3600)}h ago`
-                    : `${Math.round(ageSec / 86400)}d ago`;
-        return {
-            name: "Last sync",
-            status: "ok",
-            detail: `${newest.name} — ${human} (${skills.length} total)`,
-        };
-    }
-    catch (err) {
-        if (err.code === "ENOENT") {
-            return {
-                name: "Last sync",
-                status: "warn",
-                detail: "Skills dir not created yet.",
-            };
-        }
-        return {
-            name: "Last sync",
-            status: "warn",
-            detail: `Cannot read skills dir: ${err.message}`,
-        };
-    }
-}
-async function checkVersion() {
-    const apiUrl = resolveApiUrl(await readConfig());
-    try {
-        const res = await floomFetch(`${apiUrl}/api/v1/cli-version`, "check CLI version", {
-            headers: { accept: "application/json" },
-            checkOk: false,
-        });
-        if (!res.ok) {
-            // Endpoint optional — treat as info-only, not a failure
-            return {
-                name: "Version",
-                status: "ok",
-                detail: `CLI ${formatVersionLabel(CLI_VERSION)} (server check skipped)`,
-            };
-        }
-        const data = (await res.json());
-        if (data.min && compareSemverish(CLI_VERSION, data.min) < 0) {
-            return {
-                name: "Version",
-                status: "fail",
-                detail: `CLI ${formatVersionLabel(CLI_VERSION)} below required ${formatVersionLabel(data.min)}.`,
-                hint: "Run `npm i -g @floomhq/floom` to upgrade, then use `floom`.",
-            };
-        }
-        if (data.latest && compareSemverish(CLI_VERSION, data.latest) < 0) {
-            return {
-                name: "Version",
-                status: "warn",
-                detail: `CLI ${formatVersionLabel(CLI_VERSION)}, latest is ${formatVersionLabel(data.latest)}.`,
-                hint: "Run `npm i -g @floomhq/floom` to upgrade, then use `floom`.",
-            };
-        }
-        return { name: "Version", status: "ok", detail: `CLI ${formatVersionLabel(CLI_VERSION)} (current)` };
-    }
-    catch {
-        return {
-            name: "Version",
-            status: "ok",
-            detail: `CLI ${formatVersionLabel(CLI_VERSION)} (offline)`,
-        };
-    }
-}
-async function findPathExecutables(name) {
-    const seen = new Set();
-    const out = [];
-    const pathDirs = (process.env.PATH ?? "").split(delimiter).filter(Boolean);
-    for (const dir of pathDirs) {
-        const candidate = join(dir, name);
-        if (seen.has(candidate))
-            continue;
-        seen.add(candidate);
-        try {
-            await access(candidate, constants.X_OK);
-            out.push(candidate);
-        }
-        catch {
-            // not present or not executable
-        }
-    }
-    return out;
-}
-async function safeRealpath(path) {
-    if (!path)
-        return null;
-    try {
-        return await realpath(path);
-    }
-    catch {
-        return null;
-    }
-}
-async function checkCliCommand() {
-    const bins = await findPathExecutables("floom");
-    if (bins.length === 0) {
-        return {
-            name: "CLI command",
-            status: "ok",
-            detail: "`floom` is not globally installed. `npx -y @floomhq/floom ...` is ready.",
-        };
-    }
-    const active = bins[0] ?? "";
-    const activeReal = await safeRealpath(active);
-    const currentReal = await safeRealpath(process.argv[1]);
-    if (activeReal && currentReal && activeReal === currentReal) {
-        return {
-            name: "CLI command",
-            status: "ok",
-            detail: `floom resolves to ${active}`,
-        };
-    }
-    const activeText = await readExecutableSample(active);
-    const activeVersion = await readExecutableVersion(active);
-    const looksLikeOldRuntime = active.includes(".floom/repo") ||
-        active.includes("/skills-minimal/") ||
-        activeText.includes("unknown command") ||
-        activeText.includes("Floom runtime") ||
-        (activeVersion !== null && compareSemverish(activeVersion, CLI_VERSION) < 0);
-    return {
-        name: "CLI command",
-        status: looksLikeOldRuntime ? "warn" : "ok",
-        detail: looksLikeOldRuntime
-            ? `Another floom command is first on PATH: ${active}${activeVersion ? ` (${formatVersionLabel(activeVersion)})` : ""}`
-            : `floom resolves to ${active}`,
-        ...(looksLikeOldRuntime
-            ? {
-                hint: `If \`floom doctor\` opens the old runtime CLI, remove that file or move it later in PATH, then run \`npm i -g @floomhq/floom\`. Inspect with: command -v floom`,
-            }
-            : {}),
-    };
-}
-async function readExecutableSample(path) {
-    try {
-        return (await readFile(path, "utf8")).slice(0, 4000);
-    }
-    catch {
-        return "";
-    }
-}
-async function readExecutableVersion(path) {
-    try {
-        const { stdout, stderr } = await execFile(path, ["--version"], { timeout: 1500 });
-        const text = `${stdout}\n${stderr}`;
-        return text.match(/\d+\.\d+\.\d+(?:[-+][A-Za-z0-9._-]+)?/)?.[0] ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-export async function doctor(opts = {}) {
-    const target = opts.target ?? "claude";
-    process.stdout.write(`\n${c.bold("floom doctor")} ${c.dim(`(${formatVersionLabel(CLI_VERSION)}, target: ${target})`)}\n\n`);
-    const checks = await Promise.all([
-        checkCliCommand(),
-        checkAuth(),
-        checkMcp(),
-        checkTargetDir(target),
-        checkLastSync(target),
-        checkVersion(),
-    ]);
-    // Compute column widths for clean table output.
-    const nameW = Math.max(...checks.map((c) => c.name.length), 6);
-    for (const check of checks) {
-        const padded = check.name.padEnd(nameW);
-        process.stdout.write(`  ${statusBadge(check.status)} ${c.bold(padded)}  ${check.detail}\n`);
-        if (check.hint && check.status !== "ok") {
-            process.stdout.write(`     ${c.dim("→ " + check.hint)}\n`);
-        }
-    }
-    const anyFail = checks.some((c) => c.status === "fail");
-    const anyWarn = checks.some((c) => c.status === "warn");
-    process.stdout.write("\n");
-    if (anyFail) {
-        process.stdout.write(`  ${c.red("✗ Some checks failed.")} See hints above.\n\n`);
-        process.exit(1);
-    }
-    if (anyWarn) {
-        process.stdout.write(`  ${c.yellow("! All critical checks passed, with warnings.")}\n\n`);
-        process.exit(0);
-    }
-    process.stdout.write(`  ${c.green("✓ All checks passed.")} Floom is healthy.\n\n`);
-    process.stdout.write(`  ${c.dim("Config: " + CONFIG_PATH)}\n\n`);
-}

package/dist/errors.js

@@ -1,71 +0,0 @@
-import { c, symbols } from "./ui.js";
-/**
- * FloomError is a friendly, user-facing error. Throw this instead of raw Error
- * when you want a clean message (no stack trace, no "Error:" prefix).
- */
-export class FloomError extends Error {
-    hint;
-    constructor(message, hint) {
-        super(message);
-        this.name = "FloomError";
-        if (hint)
-            this.hint = hint;
-    }
-}
-export function friendlyHttp(status, action, detail) {
-    if (status === 401) {
-        return new FloomError("Your token expired.", "Run `npx -y @floomhq/floom login` to refresh.");
-    }
-    if (status === 403) {
-        return new FloomError(`You don't have permission to ${action}.`);
-    }
-    if (status === 404) {
-        if (/fetch|inspect|add|install|show|get|search|list|info/i.test(action)) {
-            return new FloomError("Skill not found.", "Check the link or slug, then try again.");
-        }
-        return new FloomError("Skill not found.", "Run `npx -y @floomhq/floom publish <path>` to create a new one.");
-    }
-    if (status === 413) {
-        return new FloomError("That file is too large to publish.");
-    }
-    if (status === 429) {
-        return new FloomError("Floom is rate limiting requests.", "The CLI retries rate-limited requests automatically. Try again in a moment if this persists.");
-    }
-    if (status >= 500) {
-        return new FloomError("Floom is having trouble right now.", "Try again in a moment.");
-    }
-    if (detail) {
-        return new FloomError(detail);
-    }
-    return new FloomError(`Request failed (HTTP ${status}) while trying to ${action}.`);
-}
-export function friendlyNetwork(err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    if (/ENOTFOUND|EAI_AGAIN|ECONNREFUSED|ECONNRESET|ETIMEDOUT|fetch failed/i.test(msg)) {
-        return new FloomError("Couldn't reach floom (offline?).", "Try again in a moment.");
-    }
-    return new FloomError(msg);
-}
-export function printError(err, opts = {}) {
-    if (opts.json) {
-        const error = err instanceof FloomError
-            ? { error: err.message, hint: err.hint ?? null }
-            : { error: err instanceof Error ? err.message : String(err), hint: null };
-        process.stderr.write(`${JSON.stringify(error)}\n`);
-        return;
-    }
-    if (err instanceof FloomError) {
-        process.stderr.write(`\n${symbols.fail}  ${err.message}\n`);
-        if (err.hint) {
-            for (const line of err.hint.split("\n")) {
-                process.stderr.write(`   ${c.dim(line)}\n`);
-            }
-            process.stderr.write("\n");
-        }
-        else
-            process.stderr.write("\n");
-        return;
-    }
-    const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`\n${symbols.fail}  ${msg}\n\n`);
-}

package/dist/feedback.js

@@ -1,34 +0,0 @@
-import ora from "ora";
-import { readConfig, resolveApiUrl } from "./config.js";
-import { floomFetch } from "./lib/api.js";
-import { c, symbols } from "./ui.js";
-export async function feedback(opts) {
-    const cfg = await readConfig();
-    const apiUrl = resolveApiUrl(cfg);
-    const payload = {
-        event_name: "feedback.submitted",
-        source: "cli",
-        props: {
-            kind: opts.kind,
-            message: opts.message,
-            ...(opts.target ? { target: opts.target } : {}),
-            ...(opts.skill ? { skill: opts.skill } : {}),
-        },
-    };
-    const spinner = opts.json ? null : ora({ text: c.dim("Sending feedback..."), color: "yellow" }).start();
-    try {
-        await floomFetch(`${apiUrl}/api/v1/events`, "send feedback", {
-            method: "POST",
-            ...(cfg?.accessToken ? { token: cfg.accessToken } : {}),
-            body: payload,
-        });
-    }
-    finally {
-        spinner?.stop();
-    }
-    if (opts.json) {
-        process.stdout.write(`${JSON.stringify({ ok: true }, null, 2)}\n`);
-        return;
-    }
-    process.stdout.write(`\n${symbols.ok}  Feedback sent\n\n`);
-}

package/dist/info.js

@@ -1,78 +0,0 @@
-import ora from "ora";
-import { readConfig, resolveApiUrl } from "./config.js";
-import { getJson } from "./lib/api.js";
-import { extractRequires, formatToolList, formatType } from "./lib/skill-labels.js";
-import { c, symbols } from "./ui.js";
-import { FloomError } from "./errors.js";
-const SLUG_RE = /^[A-Za-z0-9_-]{1,128}$/;
-function slugFromInput(input) {
-    const trimmed = input.trim();
-    try {
-        const url = new URL(trimmed);
-        const last = url.pathname.split("/").filter(Boolean).at(-1) ?? "";
-        return last.replace(/\.(md|json)$/i, "");
-    }
-    catch {
-        return trimmed.replace(/\.(md|json)$/i, "");
-    }
-}
-export async function info(opts) {
-    const slug = slugFromInput(opts.slug);
-    if (!slug)
-        throw new FloomError("Missing skill slug.", "Try: `npx -y @floomhq/floom info <slug>`");
-    if (!SLUG_RE.test(slug)) {
-        throw new FloomError(`Invalid skill slug: ${opts.slug}`, "Use a Floom skill slug or URL.");
-    }
-    const cfg = await readConfig();
-    const apiUrl = resolveApiUrl(cfg);
-    const spinner = opts.json ? null : ora({ text: c.dim(`Loading ${slug}...`), color: "yellow" }).start();
-    let detail;
-    try {
-        detail = await getJson(`${apiUrl}/api/v1/skills/${encodeURIComponent(slug)}`, "load skill metadata", cfg?.accessToken);
-    }
-    finally {
-        spinner?.stop();
-    }
-    if (opts.json) {
-        // Strip body_md from JSON output to keep it summary-shaped, but expose
-        // the parsed `requires` list so scripted consumers don't need to parse
-        // YAML themselves.
-        const { body_md: _body, ...summary } = detail;
-        const requires = extractRequires(detail.body_md);
-        process.stdout.write(`${JSON.stringify({ ...summary, requires }, null, 2)}\n`);
-        return;
-    }
-    const title = detail.title ?? c.dim("(untitled)");
-    process.stdout.write(`\n${symbols.dot}  ${c.bold(title)}\n\n`);
-    process.stdout.write(`   ${c.dim("Slug:       ")}${detail.slug}\n`);
-    if (detail.description) {
-        process.stdout.write(`   ${c.dim("About:      ")}${detail.description}\n`);
-    }
-    process.stdout.write(`   ${c.dim("Visibility: ")}${detail.visibility}\n`);
-    process.stdout.write(`   ${c.dim("Type:       ")}${formatType(detail.asset_type)}\n`);
-    const requires = extractRequires(detail.body_md);
-    if (requires.length > 0) {
-        process.stdout.write(`   ${c.dim("Needs:      ")}${formatToolList(requires)}\n`);
-    }
-    if (detail.version) {
-        process.stdout.write(`   ${c.dim("Version:    ")}${detail.version}\n`);
-    }
-    if (detail.installs_as) {
-        process.stdout.write(`   ${c.dim("Installs:   ")}${detail.installs_as}\n`);
-    }
-    if (detail.original_filename) {
-        process.stdout.write(`   ${c.dim("File:       ")}${detail.original_filename}\n`);
-    }
-    if (detail.owner_email) {
-        process.stdout.write(`   ${c.dim("Owner:      ")}${detail.owner_email}\n`);
-    }
-    if (typeof detail.save_count === "number") {
-        process.stdout.write(`   ${c.dim("Saves:      ")}${detail.save_count}\n`);
-    }
-    if (detail.shared_with_emails?.length) {
-        process.stdout.write(`   ${c.dim("Shared:     ")}${detail.shared_with_emails.join(", ")}\n`);
-    }
-    process.stdout.write(`   ${c.dim("Created:    ")}${detail.created_at}\n`);
-    process.stdout.write(`   ${c.dim("Updated:    ")}${detail.updated_at}\n`);
-    process.stdout.write(`   ${c.dim("URL:        ")}${c.cyan(detail.url.replace(/\.md$/, ""))}\n\n`);
-}