@locusai/cli 0.26.0 → 0.26.1

package/bin/locus.js

@@ -4101,6 +4101,80 @@ ${bold2("Skill Information")}
   process.stderr.write(`
 `);
 }
+async function searchSkills(query, flags) {
+  if (!query && !flags.tag) {
+    process.stderr.write(`${red2("✗")} Please provide a search query.
+`);
+    process.stderr.write(`  Usage: ${bold2("locus skills search <query>")} or ${bold2("locus skills search --tag <tag>")}
+`);
+    process.exit(1);
+  }
+  let registry;
+  try {
+    registry = await fetchRegistry();
+  } catch (err) {
+    process.stderr.write(`${red2("✗")} Failed to fetch skills registry. Check your internet connection.
+`);
+    process.stderr.write(`  ${dim2(err.message)}
+`);
+    process.exit(1);
+  }
+  const tagFilter = flags.tag?.toLowerCase();
+  const queryLower = query?.toLowerCase() ?? "";
+  const matches = registry.skills.filter((s) => {
+    if (tagFilter) {
+      return s.tags.some((t) => t.toLowerCase() === tagFilter);
+    }
+    const nameMatch = s.name.toLowerCase().includes(queryLower);
+    const descMatch = s.description.toLowerCase().includes(queryLower);
+    const tagMatch = s.tags.some((t) => t.toLowerCase().includes(queryLower));
+    return nameMatch || descMatch || tagMatch;
+  });
+  if (matches.length === 0) {
+    process.stderr.write(`
+${yellow2("⚠")}  No skills found matching "${bold2(tagFilter || query)}"
+`);
+    process.stderr.write(`  Run ${bold2("locus skills list")} to see all available skills.
+
+`);
+    return;
+  }
+  const cwd = process.cwd();
+  const lockFile = readLockFile(cwd);
+  process.stderr.write(`
+${bold2("Search Results")} for "${cyan2(tagFilter || query)}"
+
+`);
+  const columns = [
+    { key: "name", header: "Name", minWidth: 12, maxWidth: 24 },
+    { key: "description", header: "Description", minWidth: 20, maxWidth: 44 },
+    {
+      key: "tags",
+      header: "Tags",
+      minWidth: 10,
+      maxWidth: 30,
+      format: (val) => dim2(val.join(", "))
+    },
+    {
+      key: "status",
+      header: "Status",
+      minWidth: 8,
+      maxWidth: 12
+    }
+  ];
+  const rows = matches.map((s) => ({
+    name: cyan2(s.name),
+    description: s.description,
+    tags: s.tags,
+    status: s.name in lockFile.skills ? green("installed") : dim2("available")
+  }));
+  process.stderr.write(`${renderTable(columns, rows)}
+
+`);
+  process.stderr.write(`  ${dim2(`${matches.length} skill(s) found.`)} Install with: ${bold2("locus skills install <name>")}
+
+`);
+}
 function printSkillsHelp() {
   process.stderr.write(`
 ${bold2("Usage:")}
@@ -4109,6 +4183,7 @@ ${bold2("Usage:")}
 ${bold2("Subcommands:")}
   ${cyan2("list")}              List available skills from the registry
   ${cyan2("list")} ${dim2("--installed")}   List locally installed skills
+  ${cyan2("search")} ${dim2("<query>")}    Search skills by name, description, or tags
   ${cyan2("install")} ${dim2("<name>")}    Install a skill from the registry
   ${cyan2("remove")} ${dim2("<name>")}     Remove an installed skill (alias: ${cyan2("uninstall")})
   ${cyan2("update")} ${dim2("[name]")}     Update installed skill(s) from registry
@@ -4117,6 +4192,8 @@ ${bold2("Subcommands:")}
 ${bold2("Examples:")}
   locus skills list                   ${dim2("# Browse available skills")}
   locus skills list --installed       ${dim2("# Show installed skills")}
+  locus skills search "code review"   ${dim2("# Search by keyword")}
+  locus skills search --tag testing   ${dim2("# Search by tag")}
   locus skills install code-review    ${dim2("# Install a skill")}
   locus skills remove code-review     ${dim2("# Remove a skill")}
   locus skills update                 ${dim2("# Update all installed skills")}
@@ -4161,10 +4238,15 @@ async function skillsCommand(args, flags) {
       await infoSkill(skillName);
       break;
     }
+    case "search": {
+      const searchQuery = args.slice(1).join(" ");
+      await searchSkills(searchQuery, flags);
+      break;
+    }
     default:
       process.stderr.write(`${red2("✗")} Unknown subcommand: ${bold2(subcommand)}
 `);
-      process.stderr.write(`  Available: ${bold2("list")}, ${bold2("install")}, ${bold2("remove")} (${bold2("uninstall")}), ${bold2("update")}, ${bold2("info")}
+      process.stderr.write(`  Available: ${bold2("list")}, ${bold2("search")}, ${bold2("install")}, ${bold2("remove")} (${bold2("uninstall")}), ${bold2("update")}, ${bold2("info")}
 `);
       process.exit(1);
   }
@@ -8394,6 +8476,105 @@ var init_sprint = __esm(() => {
   init_terminal();
 });
 
+// src/skills/matcher.ts
+function matchRelevantSkills(issue, skills) {
+  if (skills.length <= MAX_SKILLS)
+    return skills;
+  const titleTokens = tokenize(issue.title);
+  const bodyTokens = tokenize(issue.body).slice(0, 200);
+  const labelTokens = issue.labels.flatMap((l) => tokenize(l));
+  const scored = skills.map((skill) => {
+    let score = 0;
+    const tagSet = new Set(skill.tags.map((t) => t.toLowerCase()));
+    const descTokens = new Set(tokenize(skill.description));
+    for (const lt of labelTokens) {
+      if (tagSet.has(lt))
+        score += 5;
+    }
+    for (const tw of titleTokens) {
+      if (tagSet.has(tw))
+        score += 3;
+    }
+    for (const bw of bodyTokens) {
+      if (tagSet.has(bw))
+        score += 2;
+    }
+    for (const tw of titleTokens) {
+      if (descTokens.has(tw))
+        score += 1;
+    }
+    for (const bw of bodyTokens) {
+      if (descTokens.has(bw))
+        score += 0.5;
+    }
+    return { skill, score };
+  });
+  scored.sort((a, b) => b.score - a.score);
+  const relevant = scored.filter((s) => s.score >= RELEVANCE_THRESHOLD);
+  if (relevant.length > 0) {
+    return relevant.slice(0, MAX_SKILLS).map((s) => s.skill);
+  }
+  return scored.slice(0, FALLBACK_COUNT).map((s) => s.skill);
+}
+function tokenize(text) {
+  if (!text)
+    return [];
+  return text.toLowerCase().replace(/[^a-z0-9\-]/g, " ").split(/\s+/).filter((w) => w.length > 2 && !STOP_WORDS.has(w));
+}
+var RELEVANCE_THRESHOLD = 2, MAX_SKILLS = 5, FALLBACK_COUNT = 3, STOP_WORDS;
+var init_matcher = __esm(() => {
+  STOP_WORDS = new Set([
+    "a",
+    "an",
+    "the",
+    "is",
+    "it",
+    "to",
+    "in",
+    "on",
+    "of",
+    "for",
+    "and",
+    "or",
+    "not",
+    "with",
+    "this",
+    "that",
+    "from",
+    "by",
+    "as",
+    "at",
+    "be",
+    "we",
+    "i",
+    "you",
+    "my",
+    "our",
+    "do",
+    "if",
+    "no",
+    "so",
+    "up",
+    "can",
+    "all",
+    "but",
+    "has",
+    "had",
+    "have",
+    "will",
+    "should",
+    "would",
+    "could",
+    "need",
+    "want",
+    "also",
+    "new",
+    "use",
+    "add",
+    "make"
+  ]);
+});
+
 // src/core/prompt-builder.ts
 import { execSync as execSync9 } from "node:child_process";
 import { existsSync as existsSync17, readdirSync as readdirSync4, readFileSync as readFileSync12 } from "node:fs";
@@ -8401,7 +8582,7 @@ import { join as join17 } from "node:path";
 function buildExecutionPrompt(ctx) {
   const sections = [];
   sections.push(buildSystemContext(ctx.projectRoot));
-  const skills = buildSkillsContext(ctx.projectRoot);
+  const skills = buildSkillsContext(ctx.projectRoot, ctx.issue);
   if (skills)
     sections.push(skills);
   sections.push(buildTaskContext(ctx.issue, ctx.issueComments));
@@ -8419,7 +8600,7 @@ function buildExecutionPrompt(ctx) {
 function buildFeedbackPrompt(ctx) {
   const sections = [];
   sections.push(buildSystemContext(ctx.projectRoot));
-  const skills = buildSkillsContext(ctx.projectRoot);
+  const skills = buildSkillsContext(ctx.projectRoot, ctx.issue);
   if (skills)
     sections.push(skills);
   sections.push(buildTaskContext(ctx.issue));
@@ -8652,7 +8833,7 @@ function buildFeedbackInstructions() {
 6. When done, summarize what you changed in response to each comment.
 </instructions>`;
 }
-function buildSkillsContext(projectRoot) {
+function buildSkillsContext(projectRoot, issue) {
   const skillsDir = join17(projectRoot, CLAUDE_SKILLS_DIR);
   if (!existsSync17(skillsDir))
     return null;
@@ -8664,21 +8845,35 @@ function buildSkillsContext(projectRoot) {
   }
   if (dirs.length === 0)
     return null;
-  const entries = [];
+  let allSkills = [];
   for (const dir of dirs) {
     const skillPath = join17(skillsDir, dir, "SKILL.md");
     const content = readFileSafe(skillPath);
     if (!content)
       continue;
     const fm = parseFrontmatter(content);
-    const name = fm.name || dir;
-    const description = fm.description || "";
-    entries.push(`- **${name}**: ${description}`);
+    allSkills.push({
+      dir,
+      name: fm.name || dir,
+      description: fm.description || "",
+      tags: fm.tags ? fm.tags.split(",").map((t) => t.trim()) : []
+    });
   }
-  if (entries.length === 0)
+  if (allSkills.length === 0)
     return null;
+  let selectedSkills = allSkills;
+  if (issue) {
+    const issueCtx = {
+      title: issue.title,
+      body: issue.body || "",
+      labels: issue.labels
+    };
+    const relevant = matchRelevantSkills(issueCtx, allSkills);
+    selectedSkills = allSkills.filter((s) => relevant.some((r) => r.name === s.name));
+  }
+  const entries = selectedSkills.map((s) => `- **${s.name}**: ${s.description}`);
   return `<installed-skills>
-The following skills are installed in this project. If a skill is relevant to the current task, read its full instructions from \`.claude/skills/<name>/SKILL.md\` before starting work.
+The following skills are installed and relevant to this task. Read the full instructions from \`.claude/skills/<name>/SKILL.md\` before using a skill.
 
 ${entries.join(`
 `)}
@@ -8695,9 +8890,13 @@ function parseFrontmatter(content) {
     if (idx === -1)
       continue;
     const key = line.slice(0, idx).trim();
-    const val = line.slice(idx + 1).trim();
-    if (key && val)
-      result[key] = val;
+    let val = line.slice(idx + 1).trim();
+    if (!key || !val)
+      continue;
+    if (val.startsWith("[") && val.endsWith("]")) {
+      val = val.slice(1, -1);
+    }
+    result[key] = val;
   }
   return result;
 }
@@ -8712,6 +8911,7 @@ function readFileSafe(path) {
 }
 var MEMORY_MAX_CHARS = 4000;
 var init_prompt_builder = __esm(() => {
+  init_matcher();
   init_memory();
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/cli",
-  "version": "0.26.0",
+  "version": "0.26.1",
   "description": "GitHub-native AI engineering assistant",
   "type": "module",
   "bin": {
@@ -36,7 +36,7 @@
   "license": "MIT",
   "dependencies": {},
   "devDependencies": {
-    "@locusai/sdk": "^0.26.0",
+    "@locusai/sdk": "^0.26.1",
     "@types/bun": "latest",
     "typescript": "^5.8.3"
   },