@floomhq/floom 1.0.35 → 1.0.37

package/dist/cli.js

@@ -126,6 +126,75 @@ function commandUsage() {
 `;
     process.stdout.write(out);
 }
+function shareUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} share`)} ${c.dim("<slug> [flags]")}
+
+ ${c.bold("Manage email access for one of your skills.")}
+   ${c.cyan(`${CLI_COMMAND} share support-tone --add person@example.com`)}
+   ${c.cyan(`${CLI_COMMAND} share support-tone --remove person@example.com`)}
+   ${c.cyan(`${CLI_COMMAND} share support-tone --list`)}
+
+ ${c.bold("Flags")}
+   ${c.cyan("--add <email>")}       Grant access
+   ${c.cyan("--remove <email>")}    Revoke access
+   ${c.cyan("--list")}              Show who can access the skill
+`);
+}
+function libraryUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} library`)} ${c.dim("<command> [args] [flags]")}
+
+ ${c.bold("Commands")}
+   ${c.cyan("list")}                              Browse public libraries
+   ${c.cyan("create <slug> --name <name>")}       Create a library
+   ${c.cyan("add <library> <skill>")}             Add a skill to a library
+   ${c.cyan("remove <library> <skill>")}          Remove a skill from a library
+   ${c.cyan("subscribe <library>")}               Follow a library
+   ${c.cyan("unsubscribe <library>")}             Stop following a library
+
+ ${c.bold("Examples")}
+   ${c.cyan(`${CLI_COMMAND} library list --json`)}
+   ${c.cyan(`${CLI_COMMAND} library create team-onboarding --name "Team onboarding" --public`)}
+   ${c.cyan(`${CLI_COMMAND} library add team-onboarding support-tone --folder support --tags support,tone`)}
+`);
+}
+function moveUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} move`)} ${c.dim("<slug> --folder <path> [--tag <tag>]")}
+
+ ${c.bold("Place a saved or subscribed skill in a local folder.")}
+   ${c.cyan(`${CLI_COMMAND} move support-tone --folder support/tone`)}
+   ${c.cyan(`${CLI_COMMAND} move support-tone --root`)}
+   ${c.cyan(`${CLI_COMMAND} move support-tone --folder support --tags support,tone`)}
+
+ ${c.bold("Flags")}
+   ${c.cyan("--folder <path>")}     Folder path for synced installs
+   ${c.cyan("--root")}              Put the skill at the root
+   ${c.cyan("--tag <tag>")}         Add one tag, repeatable
+   ${c.cyan("--tags a,b")}          Add comma-separated tags
+`);
+}
+function isHelpArg(value) {
+    return value === "--help" || value === "-h" || value === "help";
+}
+function subcommandUsage(cmd) {
+    switch (cmd) {
+        case "share":
+            shareUsage();
+            return true;
+        case "library":
+        case "lib":
+            libraryUsage();
+            return true;
+        case "move":
+            moveUsage();
+            return true;
+        default:
+            commandUsage();
+            return true;
+    }
+}
 const ASSET_TYPES = new Set(["knowledge", "instruction", "workflow", "skill"]);
 const INSTALL_TARGETS = new Set([
     "claude_skill",
@@ -695,10 +764,8 @@ async function main() {
             // never block on update-notifier
         }
     }
-    // Subcommand --help: any rest arg = --help/-h/help → show top-level usage.
-    // Subcommands are simple enough that one help screen is fine for Version 1.
-    if (rest.includes("--help") || rest.includes("-h") || rest.includes("help")) {
-        usage();
+    if (rest.some(isHelpArg)) {
+        subcommandUsage(cmd);
         return;
     }
     try {

package/dist/errors.js

@@ -12,7 +12,7 @@ export class FloomError extends Error {
             this.hint = hint;
     }
 }
-export function friendlyHttp(status, action) {
+export function friendlyHttp(status, action, detail) {
     if (status === 401) {
         return new FloomError("Your token expired.", "Run `npx -y @floomhq/floom login` to refresh.");
     }
@@ -34,6 +34,9 @@ export function friendlyHttp(status, action) {
     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) {

package/dist/lib/api.js

@@ -39,7 +39,7 @@ export async function floomFetch(url, action, opts = {}) {
             continue;
         }
         if (opts.checkOk !== false && !res.ok) {
-            throw friendlyHttp(res.status, action);
+            throw friendlyHttp(res.status, action, await responseErrorDetail(res));
         }
         return res;
     }
@@ -94,6 +94,29 @@ async function drainResponse(res) {
         // Ignore bodies from rate-limit responses; the retry decision is header-based.
     }
 }
+async function responseErrorDetail(res) {
+    try {
+        const text = await res.text();
+        if (!text.trim())
+            return null;
+        try {
+            const json = JSON.parse(text);
+            const detail = typeof json.error === "string"
+                ? json.error
+                : typeof json.message === "string"
+                    ? json.message
+                    : null;
+            const hint = typeof json.hint === "string" ? json.hint : null;
+            return [detail, hint].filter(Boolean).join("\n") || null;
+        }
+        catch {
+            return text.trim().slice(0, 400);
+        }
+    }
+    catch {
+        return null;
+    }
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/push-watch.js

@@ -156,9 +156,32 @@ export async function pushWatchOnce(opts) {
         const pushed = pushManifest.files[pushKey];
         if (pushed?.hash === hash) {
             if (!isUnchangedSyncedPackage(root, skillPackage, syncManifest)) {
+                if (opts.yolo) {
+                    try {
+                        await publishSkillPath({ file: packagePath, update: true, updateSlug: pushed.slug, quiet: true });
+                        updated += 1;
+                    }
+                    catch (err) {
+                        if (err instanceof Error && /Skill not found/i.test(err.message)) {
+                            const result = await publishSkillPath({ file: packagePath, visibility: "unlisted", quiet: true });
+                            published += 1;
+                            pushManifest.files[pushKey] = { hash, slug: result.data.slug, path: key, pushedAt: new Date().toISOString() };
+                            markPackageSynced(root, skillPackage, syncManifest, result.data.slug);
+                            await writeSyncManifest(syncManifest);
+                            continue;
+                        }
+                        skipped += 1;
+                        if (!opts.quiet) {
+                            process.stderr.write(`[floom] skipped ${packagePath}: ${err instanceof Error ? err.message : String(err)}\n`);
+                        }
+                        continue;
+                    }
+                }
+                else {
+                    adopted += 1;
+                }
                 markPackageSynced(root, skillPackage, syncManifest, pushed.slug);
                 await writeSyncManifest(syncManifest);
-                adopted += 1;
             }
             else {
                 skipped += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floomhq/floom",
-  "version": "1.0.35",
+  "version": "1.0.37",
   "description": "Sync AI skills across agents and machines.",
   "license": "MIT",
   "type": "module",