allagents 1.11.4-next.1 → 1.11.5-next.1

package/dist/index.js

@@ -34841,6 +34841,23 @@ async function runOneQuery(q3, page, limit, token, fetchFn) {
     truncated: Boolean(parsed.incomplete_results)
   };
 }
+async function fetchPrimaryPages(q3, page, limit, token, fetchFn) {
+  const needed = page * limit * 3;
+  const numPages = Math.min(Math.max(1, Math.ceil(needed / SEARCH_PAGE_SIZE)), MAX_RESULTS / SEARCH_PAGE_SIZE);
+  const items = [];
+  let total = 0;
+  let truncated = false;
+  for (let currentPage = 1;currentPage <= numPages; currentPage += 1) {
+    const result = await runOneQuery(q3, currentPage, SEARCH_PAGE_SIZE, token, fetchFn);
+    items.push(...result.items);
+    total = result.total;
+    truncated = truncated || result.truncated;
+    if (result.items.length < SEARCH_PAGE_SIZE) {
+      break;
+    }
+  }
+  return { items, total, truncated };
+}
 async function searchSkills(query, options2 = {}, deps = {}) {
   validateSkillSearchArgs(query, options2);
   const fetchFn = deps.fetch ?? fetch;
@@ -34850,7 +34867,7 @@ async function searchSkills(query, options2 = {}, deps = {}) {
   const limit = options2.limit ?? 15;
   const token = await (deps.tokenResolver ?? resolveGhToken)();
   const queries = buildSearchQueries(query, options2.owner);
-  const settled = await Promise.allSettled(queries.map((entry) => runOneQuery(entry.q, page, limit, token, fetchFn)));
+  const settled = await Promise.allSettled(queries.map((entry) => entry.priority === 4 ? fetchPrimaryPages(entry.q, page, limit, token, fetchFn) : runOneQuery(entry.q, 1, SEARCH_PAGE_SIZE, token, fetchFn)));
   const primaryIdx = queries.findIndex((q3) => q3.priority === 4);
   const primarySettled = settled[primaryIdx];
   if (primarySettled?.status === "rejected") {
@@ -34876,17 +34893,21 @@ async function searchSkills(query, options2 = {}, deps = {}) {
     const firstSegment = item.path.split("/")[0] ?? "";
     return !firstSegment.startsWith(".");
   });
+  rankByRelevance(visible, query);
+  const workingSet = truncateForProcessing(visible, page, limit);
   await Promise.all([
-    fetchStarsForItems(visible, token, fetchFn),
-    enrichDescriptionsForItems(visible, token, fetchFn)
+    fetchStarsForItems(workingSet, token, fetchFn),
+    enrichDescriptionsForItems(workingSet, token, fetchFn)
   ]);
-  visible.sort((a, b) => b.stars - a.stars);
-  const finalItems = visible.slice(0, limit);
+  const filtered = filterByRelevance(workingSet, query);
+  rankByRelevance(filtered, query);
+  const dedupedByName = deduplicateByName(filtered);
+  const { items: finalItems, totalPages } = paginate(dedupedByName, page, limit);
   return {
     query,
     items: finalItems,
-    total: finalItems.length,
-    truncated: buckets.some((b) => b.result.truncated) || visible.length > limit
+    total: dedupedByName.length,
+    truncated: buckets.some((b) => b.result.truncated) || totalPages > page
   };
 }
 function dedupeItems(items) {
@@ -34901,6 +34922,73 @@ function dedupeItems(items) {
   }
   return out;
 }
+function splitRepo(item) {
+  const [owner = item.repo, repoName = ""] = item.repo.split("/", 2);
+  return { owner, repoName };
+}
+function relevanceScore(item, query) {
+  const term = query.trim().toLowerCase();
+  const termHyphen = term.replace(/ /g, "-");
+  const name = item.name.toLowerCase();
+  const namespace = item.namespace.toLowerCase();
+  const description = item.description.toLowerCase();
+  let score = 0;
+  if (name === term || name === termHyphen) {
+    score += 3000;
+  } else if (name.includes(term) || name.includes(termHyphen)) {
+    score += 1000;
+  }
+  if (namespace?.includes(term)) {
+    score += 500;
+  }
+  if (description.includes(term)) {
+    score += 100;
+  }
+  if (item.stars > 0) {
+    score += Math.floor(Math.sqrt(item.stars) * 30);
+  }
+  return score;
+}
+function rankByRelevance(items, query) {
+  items.sort((a, b) => relevanceScore(b, query) - relevanceScore(a, query));
+}
+function filterByRelevance(items, query) {
+  const term = query.trim().toLowerCase();
+  const termHyphen = term.replace(/ /g, "-");
+  return items.filter((item) => {
+    const { owner, repoName } = splitRepo(item);
+    return item.name.toLowerCase().includes(term) || item.name.toLowerCase().includes(termHyphen) || item.namespace.toLowerCase().includes(term) || item.description.toLowerCase().includes(term) || owner.toLowerCase().includes(term) || repoName.toLowerCase().includes(term);
+  });
+}
+function truncateForProcessing(items, page, limit) {
+  const maxToProcess = Math.max(page * limit * 3, limit * 3);
+  return items.length > maxToProcess ? items.slice(0, maxToProcess) : items;
+}
+function deduplicateByName(items) {
+  const maxPerName = 3;
+  const counts = new Map;
+  const out = [];
+  for (const item of items) {
+    const key = qualifiedName(item).toLowerCase();
+    const count = counts.get(key) ?? 0;
+    if (count >= maxPerName)
+      continue;
+    counts.set(key, count + 1);
+    out.push(item);
+  }
+  return out;
+}
+function paginate(items, page, limit) {
+  if (items.length === 0) {
+    return { items: [], totalPages: 0 };
+  }
+  const totalPages = Math.ceil(items.length / limit);
+  const start = (page - 1) * limit;
+  return {
+    items: items.slice(start, start + limit),
+    totalPages
+  };
+}
 async function fetchStarsForItems(items, token, fetchFn) {
   const uniqueRepos = [...new Set(items.map((i2) => i2.repo))];
   const headers = buildGitHubApiHeaders(token);
@@ -34982,7 +35070,7 @@ function decodeGitBlob(content, encoding) {
     return;
   return Buffer.from(content.replace(/\s+/g, ""), "base64").toString("utf8");
 }
-var OWNER_REGEX, COULD_BE_OWNER_REGEX, ENRICHMENT_CONCURRENCY = 10, SkillSearchError;
+var OWNER_REGEX, SEARCH_PAGE_SIZE = 100, MAX_RESULTS = 1000, COULD_BE_OWNER_REGEX, ENRICHMENT_CONCURRENCY = 10, SkillSearchError;
 var init_skill_search = __esm(() => {
   init_skill();
   OWNER_REGEX = /^[A-Za-z0-9-]{1,39}$/;
@@ -41967,7 +42055,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "allagents",
-    version: "1.11.4-next.1",
+    version: "1.11.5-next.1",
     packageManager: "bun@1.3.12",
     description: "CLI tool for managing multi-repo AI agent workspaces with plugin synchronization",
     type: "module",
@@ -44814,15 +44902,17 @@ var skillsRemoveMeta = {
 };
 var skillsSearchMeta = {
   command: "skill search",
-  description: "Search GitHub for skills by querying SKILL.md files via the Code Search API. Results are sorted by star count. In TTY mode, shows a filter-as-you-type multi-select picker and offers to install the selected skills.",
+  description: "Search GitHub for skills by querying SKILL.md files via the Code Search API. Results are ranked by relevance, with skill-name matches first. In TTY mode, shows a filter-as-you-type multi-select picker and offers to install the selected skills.",
   whenToUse: 'To discover available skills from public GitHub repositories without leaving the CLI. Bridges "I want a skill that does X" → install.',
   examples: [
     "allagents skill search terraform",
+    "allagents skill pr-search",
+    'allagents skill "pr search"',
     "allagents skill search terraform --owner hashicorp",
     "allagents skill search docs --page 2 --limit 10",
     "allagents --json skill search docs --limit 5"
   ],
-  expectedOutput: "Skills sorted by star count: repo, skill name, stars, description. In TTY mode, followed by a searchable multi-select install prompt.",
+  expectedOutput: "Skills ranked by relevance: repo, skill name, stars, description. In TTY mode, followed by a searchable multi-select install prompt.",
   positionals: [
     { name: "query", type: "string", required: true, description: "Search query (≥2 characters)." }
   ],
@@ -45954,7 +46044,7 @@ var searchCmd = import_cmd_ts3.command({
   name: "search",
   description: buildDescription(skillsSearchMeta),
   args: {
-    query: import_cmd_ts3.positional({ type: import_cmd_ts3.string, displayName: "query" }),
+    query: import_cmd_ts3.restPositionals({ type: import_cmd_ts3.string, displayName: "query" }),
     owner: import_cmd_ts3.option({
       type: import_cmd_ts3.optional(import_cmd_ts3.string),
       long: "owner",
@@ -45973,6 +46063,7 @@ var searchCmd = import_cmd_ts3.command({
   },
   handler: async ({ query, owner, page, limit }) => {
     try {
+      const searchQuery = query.join(" ").trim();
       const opts = {};
       if (owner)
         opts.owner = owner;
@@ -46002,7 +46093,7 @@ var searchCmd = import_cmd_ts3.command({
         }
         opts.limit = n;
       }
-      const result = await searchSkills(query, opts);
+      const result = await searchSkills(searchQuery, opts);
       if (isJsonMode()) {
         jsonOutput({
           success: true,
@@ -46012,16 +46103,16 @@ var searchCmd = import_cmd_ts3.command({
         return;
       }
       if (result.items.length === 0) {
-        console.log(`No skills found for "${query}".`);
+        console.log(`No skills found for "${searchQuery}".`);
         return;
       }
       const isTTY = process.stdout.isTTY && process.stdin.isTTY;
       if (!isTTY) {
-        printSearchResults(result.items, query, result.truncated);
+        printSearchResults(result.items, searchQuery, result.truncated);
         return;
       }
       const { autocompleteMultiselect: autocompleteMultiselect2, isCancel, log } = await Promise.resolve().then(() => (init_dist2(), exports_dist));
-      log.success(formatSkillSearchSummary(result.items.length, query, result.truncated));
+      log.success(formatSkillSearchSummary(result.items.length, searchQuery, result.truncated));
       const options2 = result.items.map((item) => ({
         label: `${qualifiedName(item)}  ${source_default.dim(item.repo)}`,
         value: item.path,
@@ -58135,6 +58226,44 @@ var selfCmd = conciseSubcommands({
   }
 });
 
+// src/cli/skill-arg-normalizer.ts
+var SKILL_SUBCOMMANDS = new Set(["list", "remove", "add", "search"]);
+function normalizeSkillAlias(args) {
+  if (args.length === 0)
+    return args;
+  return args[0] === "skills" ? ["skill", ...args.slice(1)] : args;
+}
+function shouldUseSkillSearchShorthand(rest) {
+  const first2 = rest[0] ?? "";
+  if (rest.length === 0)
+    return false;
+  if (first2.startsWith("-") || SKILL_SUBCOMMANDS.has(first2))
+    return false;
+  return rest.length > 1 || /[-\s]/.test(first2);
+}
+function normalizeSkillHelpArgs(args) {
+  const normalized = normalizeSkillAlias(args);
+  if (normalized.length === 0 || normalized[0] !== "skill") {
+    return normalized;
+  }
+  const [, ...rest] = normalized;
+  return shouldUseSkillSearchShorthand(rest) ? ["skill", "search"] : normalized;
+}
+function normalizeSkillArgs(args) {
+  const normalized = normalizeSkillAlias(args);
+  if (normalized.length === 0 || normalized[0] !== "skill") {
+    return args;
+  }
+  const [, ...rest] = normalized;
+  if (rest.length === 0) {
+    return ["skill"];
+  }
+  if (!shouldUseSkillSearchShorthand(rest)) {
+    return ["skill", ...rest];
+  }
+  return ["skill", "search", ...rest];
+}
+
 // src/cli/agent-help.ts
 var allCommands = [
   initMeta,
@@ -58189,7 +58318,7 @@ function findMetaByCommand(commandPath) {
 }
 function printAgentHelp(args, version2) {
   const positional5 = args.filter((a) => !a.startsWith("-"));
-  const normalized = positional5[0] === "skills" ? ["skill", ...positional5.slice(1)] : positional5;
+  const normalized = normalizeSkillHelpArgs(positional5);
   const commandPath = normalized.join(" ");
   if (!commandPath) {
     const tree = {
@@ -58242,8 +58371,8 @@ var app = conciseSubcommands({
 var rawArgs = process.argv.slice(2);
 var { args: argsNoJson, json: json2, jsonFields: jsonFields2 } = extractJsonFlag(rawArgs);
 var { args: argsNoJq, jqExpr: jqExpr2 } = extractJqFlag(argsNoJson);
-var { args: argsWithSkillAlias, agentHelp } = extractAgentHelpFlag(argsNoJq);
-var finalArgs = argsWithSkillAlias[0] === "skills" ? ["skill", ...argsWithSkillAlias.slice(1)] : argsWithSkillAlias;
+var { args: argsAfterAgentHelp, agentHelp } = extractAgentHelpFlag(argsNoJq);
+var finalArgs = normalizeSkillArgs(argsAfterAgentHelp);
 if (jqExpr2 && !json2) {
   process.stderr.write(`Error: --jq requires --json.
 `);
@@ -58269,7 +58398,7 @@ if (!agentHelp && !json2 && !isWizard) {
 `);
 }
 if (agentHelp) {
-  printAgentHelp(finalArgs, package_default.version);
+  printAgentHelp(normalizeSkillHelpArgs(argsAfterAgentHelp), package_default.version);
 } else if (isWizard) {
   const { runWizard: runWizard2 } = await Promise.resolve().then(() => (init_wizard(), exports_wizard));
   await runWizard2();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "allagents",
-  "version": "1.11.4-next.1",
+  "version": "1.11.5-next.1",
   "packageManager": "bun@1.3.12",
   "description": "CLI tool for managing multi-repo AI agent workspaces with plugin synchronization",
   "type": "module",