@floomhq/floom 1.0.37 → 1.0.39

package/dist/cli.js

@@ -175,11 +175,78 @@ function moveUsage() {
    ${c.cyan("--tags a,b")}          Add comma-separated tags
 `);
 }
+function addUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} add`)} ${c.dim("<slug-or-url> [flags]")}
+
+ ${c.bold("Install a shared skill locally.")}
+   ${c.cyan(`${CLI_COMMAND} add https://floom.dev/s/ffas93ud --target claude --setup`)}
+   ${c.cyan(`${CLI_COMMAND} add support-tone --target codex --force`)}
+
+ ${c.bold("Flags")}
+   ${c.cyan(`--target ${TARGET_HINT}`)}   Agent target, default claude
+   ${c.cyan("--setup")}                 Add Floom instructions for the target agent
+   ${c.cyan("--force")}                 Replace an existing tracked install
+`);
+}
+function syncUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} sync`)} ${c.dim("[flags]")}
+
+ ${c.bold("Pull published, saved, and subscribed library skills into one target.")}
+   ${c.cyan(`${CLI_COMMAND} sync --target claude`)}
+   ${c.cyan(`${CLI_COMMAND} sync --target codex`)}
+
+ ${c.bold("Flags")}
+   ${c.cyan(`--target ${TARGET_HINT}`)}   Agent target, default claude
+`);
+}
+function watchUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} watch`)} ${c.dim("[flags]")}
+
+ ${c.bold("Run a polling loop for one target.")}
+   ${c.cyan(`${CLI_COMMAND} watch --target claude`)}
+   ${c.cyan(`${CLI_COMMAND} watch --push --target codex`)}
+
+ ${c.bold("Flags")}
+   ${c.cyan("--push")}                  Publish/update local skill changes
+   ${c.cyan("--no-yolo")}               Adopt local skills without auto-publishing new ones
+   ${c.cyan("--once")}                  Run one cycle and exit
+   ${c.cyan("--interval <seconds>")}     Poll interval, minimum 10
+   ${c.cyan(`--target ${TARGET_HINT}`)}   Agent target, default claude
+`);
+}
+function doctorUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} doctor`)} ${c.dim("[flags]")}
+
+ ${c.bold("Check auth, MCP registration, local folders, and CLI freshness.")}
+   ${c.cyan(`${CLI_COMMAND} doctor --target claude`)}
+   ${c.cyan(`${CLI_COMMAND} doctor --target opencode`)}
+
+ ${c.bold("Flags")}
+   ${c.cyan(`--target ${TARGET_HINT}`)}   Agent target, default claude
+`);
+}
 function isHelpArg(value) {
     return value === "--help" || value === "-h" || value === "help";
 }
 function subcommandUsage(cmd) {
     switch (cmd) {
+        case "add":
+        case "install":
+            addUsage();
+            return true;
+        case "sync":
+            syncUsage();
+            return true;
+        case "watch":
+            watchUsage();
+            return true;
+        case "doctor":
+            doctorUsage();
+            return true;
         case "share":
             shareUsage();
             return true;

package/dist/list.js

@@ -42,8 +42,22 @@ export async function list(opts) {
     const spinner = opts.json ? null : ora({ text: c.dim("Loading skills..."), color: "yellow" }).start();
     let published = [];
     try {
-        const mine = await getJson(`${apiUrl}/api/v1/me/skills`, "load your skills", cfg.accessToken);
-        published = mine.skills ?? [];
+        let cursor;
+        const seenCursors = new Set();
+        for (let page = 0; page < 1000; page += 1) {
+            const url = new URL(`${apiUrl}/api/v1/me/skills`);
+            url.searchParams.set("limit", "100");
+            if (cursor)
+                url.searchParams.set("cursor", cursor);
+            const mine = await getJson(url.toString(), "load your skills", cfg.accessToken);
+            published.push(...(mine.skills ?? []));
+            if (!mine.next_cursor)
+                break;
+            if (seenCursors.has(mine.next_cursor))
+                throw new FloomError("Invalid skills response.");
+            seenCursors.add(mine.next_cursor);
+            cursor = mine.next_cursor;
+        }
     }
     finally {
         spinner?.stop();
@@ -52,7 +66,7 @@ export async function list(opts) {
         process.stdout.write(`${JSON.stringify({ published }, null, 2)}\n`);
         return;
     }
-    process.stdout.write(`\n${symbols.dot}  ${c.bold("Published")} ${c.dim(`(${published.length})`)}\n\n`);
+    process.stdout.write(`\n${symbols.dot}  ${c.bold("Skills")} ${c.dim(`(${published.length})`)}\n\n`);
     if (published.length === 0) {
         process.stdout.write(`   ${c.dim("Nothing published yet. Try `npx -y @floomhq/floom publish my-skill`.")}\n`);
     }

package/dist/package.js

@@ -115,7 +115,7 @@ const GENERATED_PACKAGE_DIRS = new Set([
 ]);
 const GENERATED_PACKAGE_FILES = new Set([".DS_Store"]);
 const GENERATED_PACKAGE_FILE_SUFFIXES = [".icns", ".log", ".mov", ".mp3", ".mp4", ".pyc", ".pyo", ".wav", ".webm"];
-const PACKAGE_FILE_LIMIT = 1000;
+const PACKAGE_FILE_LIMIT = 100;
 const PACKAGE_TOTAL_BYTES_LIMIT = 8_000_000;
 const PACKAGE_FILE_BYTES_LIMIT = 500_000;
 const PACKAGE_SEGMENT_RE = /^[A-Za-z0-9._-]{1,128}$/;

package/dist/setup.js

@@ -21,8 +21,8 @@ function floomAgentInstructions(target) {
 - Before recreating agent behavior from scratch, check Floom for reusable skills.
 - Search or inspect skills with \`${CLI_COMMAND} search <query>\`, \`${CLI_COMMAND} info <slug-or-url>\`, and \`${CLI_COMMAND} list\`.
 - Add shared skills with \`${addCommand}\`; public and unlisted links do not require a Floom account.
-- Use installed Markdown skills from the local skills folder when they match the task.
-- \`${CLI_COMMAND} sync --target ${target}\`, \`${CLI_COMMAND} watch --push --target ${target}\`, and \`@floomhq/floom-mcp-sync\` keep saved, published, and subscribed library skills current; review conflicts before relying on synced output.
+- Use the installed \`floom-find-skills\` router skill, Floom search, or MCP lookup before loading local files. Do not enumerate every cached skill into model context.
+- \`${CLI_COMMAND} sync --target ${target}\`, \`${CLI_COMMAND} watch --push --target ${target}\`, and \`@floomhq/floom-mcp-sync\` keep saved, published, and subscribed library skills current in the Floom cache; review conflicts before relying on synced output.
 ${END_MARKER}`;
 }
 async function fileExists(path) {

package/dist/sync.js

@@ -270,7 +270,7 @@ export async function sync(opts = {}) {
     const spinner = opts.spinner === false ? null : ora({ text: c.dim("Syncing skills..."), color: "yellow" }).start();
     let payload;
     try {
-        payload = await getJson(`${apiUrl}/api/v1/me/skills`, "load your skills", cfg.accessToken);
+        payload = await loadSyncPayload(apiUrl, cfg.accessToken);
     }
     catch (err) {
         spinner?.stop();
@@ -442,3 +442,29 @@ export async function sync(opts = {}) {
         throw err;
     }
 }
+async function loadSyncPayload(apiUrl, token) {
+    const all = [];
+    let fullSync = false;
+    let cursor;
+    const seenCursors = new Set();
+    for (let page = 0; page < 1000; page += 1) {
+        const url = new URL(`${apiUrl}/api/v1/me/skills`);
+        url.searchParams.set("limit", "10");
+        url.searchParams.set("packages", "1");
+        if (cursor)
+            url.searchParams.set("cursor", cursor);
+        const payload = await getJson(url.toString(), "load your skills", token);
+        if (!Array.isArray(payload.skills))
+            throw new FloomError("Invalid sync response.");
+        all.push(...payload.skills);
+        fullSync = payload.full_sync === true;
+        if (!payload.next_cursor) {
+            return { skills: all, full_sync: fullSync };
+        }
+        if (seenCursors.has(payload.next_cursor))
+            throw new FloomError("Invalid sync response.");
+        seenCursors.add(payload.next_cursor);
+        cursor = payload.next_cursor;
+    }
+    throw new FloomError("Invalid sync response.");
+}

package/package.json

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