agents-inc 0.149.2 → 0.151.0

package/dist/commands/new/marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/new/marketplace.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { BaseCommand } from \"../../base-command.js\";\nimport { writeFile, ensureDir } from \"../../utils/fs.js\";\nimport { getErrorMessage } from \"../../utils/errors.js\";\nimport {\n  CLAUDE_SRC_DIR,\n  CLI_INVOKE_COMMAND,\n  MARKETPLACE_JSON,\n  PLUGIN_MANIFEST_DIR,\n  marketplaceManifestPath,\n  SKILL_CATEGORIES_PATH,\n  SKILL_RULES_PATH,\n  SKILLS_DIR_PATH,\n  STACKS_FILE_PATH,\n  STANDARD_FILES,\n  EJECT_SOURCE,\n  PLUGINS_DIST_PATH,\n} from \"../../consts.js\";\nimport { EXIT_CODES } from \"../../lib/exit-codes.js\";\nimport { validateKebabCaseName } from \"../../lib/validate-kebab-name.js\";\nimport { FEATURE_FLAGS, featureDisabledError } from \"../../lib/feature-flags.js\";\nimport { LOCAL_DEFAULTS } from \"../../lib/metadata-keys.js\";\nimport { compileAllSkillPlugins } from \"../../lib/skills/skill-plugin-compiler.js\";\nimport { loadConfigTypesDataInBackground } from \"../../lib/configuration/config-types-writer.js\";\nimport {\n  writeMarketplaceScaffoldConfig,\n  writeScaffoldedEntityTypes,\n} from \"../../lib/config-gate/index.js\";\nimport { generateMarketplace, writeMarketplace } from \"../../lib/marketplace-generator.js\";\nimport { generateSkillCategoriesTs, generateSkillRulesTs } from \"../../lib/skills/generators.js\";\nimport type { Category, SkillId } from \"../../types/index.js\";\nimport { resolveAuthorOrDefault, scaffoldSkillFiles } from \"./skill.js\";\n\nexport function generateStacksTs(name: string): string {\n  const data = {\n    stacks: [\n      {\n        id: \"dummy-stack\",\n        name: \"Dummy Stack\",\n        description: `Default stack for ${name}`,\n        agents: {\n          \"web-developer\": {\n            \"dummy-category\": \"dummy-skill\",\n          },\n        },\n        philosophy: \"Ship fast, iterate faster\",\n      },\n    ],\n  };\n  const body = JSON.stringify(data, null, 2);\n  return `// Stack definitions for ${name}\\nexport default ${body};\\n`;\n}\n\nexport function generateReadme(name: string): string {\n  return `# ${name}\n\nPrivate marketplace for custom skills and stacks.\n\n## Directory Structure\n\n\\`\\`\\`\n${STACKS_FILE_PATH}         # Stack definitions (agent groupings with skill mappings)\n${SKILLS_DIR_PATH}/                # Custom skill definitions\n\\`\\`\\`\n\n## Creating Skills\n\n\\`\\`\\`bash\n${CLI_INVOKE_COMMAND} new skill <name> --category <category-name>\n\\`\\`\\`\n\nEach skill lives in \\`${SKILLS_DIR_PATH}/<skill-name>/\\` with:\n- \\`${STANDARD_FILES.SKILL_MD}\\` -- Skill content (what the skill teaches)\n- \\`${STANDARD_FILES.METADATA_YAML}\\` -- Skill metadata (category, author, description, custom: true)\n\n## Using This Marketplace\n\nPoint the CLI at this marketplace as a source:\n\n\\`\\`\\`bash\n# Local development\n${CLI_INVOKE_COMMAND} init --source /path/to/${name}\n\n# From a git repository\n${CLI_INVOKE_COMMAND} init --source github:your-org/${name}\n\\`\\`\\`\n\n## How It Works\n\nThe CLI auto-discovers skills from the \\`${SKILLS_DIR_PATH}/\\` directory\nand stacks from \\`${STACKS_FILE_PATH}\\`.\nCustom categories are discovered from skill \\`${STANDARD_FILES.METADATA_YAML}\\` files with \\`custom: true\\`.\nCustom skills appear alongside built-in ones in the wizard. No manual registration needed.\n`;\n}\n\nexport default class NewMarketplace extends BaseCommand {\n  static summary = \"Scaffold a new private marketplace project\";\n  static description =\n    \"Create a new private marketplace directory with the required structure \" +\n    \"for custom skills and stacks.\";\n\n  static examples = [\n    {\n      description: \"Create a new marketplace\",\n      command: \"<%= config.bin %> <%= command.id %> acme-skills\",\n    },\n    {\n      description: \"Initialize the current directory as a marketplace\",\n      command: \"<%= config.bin %> <%= command.id %> .\",\n    },\n    {\n      description: \"Overwrite an existing directory\",\n      command: \"<%= config.bin %> <%= command.id %> acme-skills --force\",\n    },\n  ];\n\n  static args = {\n    name: Args.string({\n      description:\n        'Name of the marketplace directory (kebab-case), or \".\" to use the current directory',\n      required: true,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    force: Flags.boolean({\n      char: \"f\",\n      description: \"Overwrite existing marketplace directory\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    if (!FEATURE_FLAGS.NEW_MARKETPLACE_COMMAND) {\n      this.error(featureDisabledError(\"new marketplace\"), {\n        exit: EXIT_CODES.ERROR,\n      });\n    }\n\n    const { args, flags } = await this.parse(NewMarketplace);\n    const parentDir = process.cwd();\n    const useCurrentDir = args.name === \".\";\n\n    const marketplaceName = useCurrentDir ? path.basename(parentDir) : args.name;\n    const marketplaceDir = useCurrentDir ? parentDir : path.join(parentDir, args.name);\n\n    this.printHeader();\n    this.validateName(marketplaceName, useCurrentDir);\n    await this.checkExistingDir(marketplaceDir, useCurrentDir, flags.force);\n\n    this.log(`Marketplace: ${marketplaceName}`);\n    this.log(`Directory: ${marketplaceDir}`);\n    this.log(\"\");\n\n    try {\n      const author = await resolveAuthorOrDefault(undefined, parentDir);\n      await this.createMarketplaceFiles(marketplaceName, marketplaceDir, author);\n      await this.buildMarketplace(marketplaceDir, marketplaceName);\n      this.printNextSteps(marketplaceName, useCurrentDir);\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  private printHeader(): void {\n    this.log(\"\");\n    this.log(\"Create New Marketplace\");\n    this.log(\"\");\n  }\n\n  private validateName(name: string, useCurrentDir: boolean): void {\n    const validationError = validateKebabCaseName(name, \"Marketplace\");\n    if (validationError) {\n      if (useCurrentDir) {\n        this.error(\n          `Current directory name '${name}' is not valid kebab-case. Rename it or pass an explicit name.`,\n          { exit: EXIT_CODES.INVALID_ARGS },\n        );\n      }\n      this.error(validationError, { exit: EXIT_CODES.INVALID_ARGS });\n    }\n  }\n\n  private async checkExistingDir(\n    dir: string,\n    useCurrentDir: boolean,\n    force: boolean,\n  ): Promise<void> {\n    if (useCurrentDir) return;\n    await this.ensureDirOverwritable(dir, force, {\n      exists: `Directory already exists: ${dir}`,\n      overwriting: `Overwriting existing directory at ${dir}`,\n    });\n  }\n\n  private async createMarketplaceFiles(\n    marketplaceName: string,\n    marketplaceDir: string,\n    author: string,\n  ): Promise<void> {\n    const skillName = \"dummy-skill\";\n\n    this.log(\"Creating marketplace structure...\");\n\n    const stacksContent = generateStacksTs(marketplaceName);\n    const stacksPath = path.join(marketplaceDir, STACKS_FILE_PATH);\n    await ensureDir(path.dirname(stacksPath));\n    await writeFile(stacksPath, stacksContent);\n\n    const categoriesContent = generateSkillCategoriesTs(\n      LOCAL_DEFAULTS.CATEGORY,\n      LOCAL_DEFAULTS.DOMAIN,\n    );\n    const categoriesPath = path.join(marketplaceDir, SKILL_CATEGORIES_PATH);\n    await writeFile(categoriesPath, categoriesContent);\n\n    const rulesContent = generateSkillRulesTs();\n    const rulesPath = path.join(marketplaceDir, SKILL_RULES_PATH);\n    await writeFile(rulesPath, rulesContent);\n\n    const skillsDir = path.join(marketplaceDir, SKILLS_DIR_PATH);\n    await scaffoldSkillFiles({\n      name: skillName,\n      author,\n      category: LOCAL_DEFAULTS.CATEGORY,\n      domain: LOCAL_DEFAULTS.DOMAIN,\n      skillDir: path.join(skillsDir, skillName),\n    });\n\n    const readmeContent = generateReadme(marketplaceName);\n    const readmePath = path.join(marketplaceDir, \"README.md\");\n    await writeFile(readmePath, readmeContent);\n\n    const configDir = path.join(marketplaceDir, CLAUDE_SRC_DIR);\n    await ensureDir(configDir);\n    const marketplaceComment =\n      \"// Marketplaces house skills only — agents are defined by consumer projects.\\n\\n\";\n    await writeMarketplaceScaffoldConfig(\n      marketplaceDir,\n      // Boundary cast: custom marketplace dummy skill/category not in standard unions\n      {\n        name: marketplaceName,\n        skills: [{ id: skillName as SkillId, scope: \"project\", source: EJECT_SOURCE }],\n        agents: [],\n        source: \".\",\n        marketplace: marketplaceName,\n        stack: {\n          \"web-developer\": {\n            // Boundary cast: dummy-category is not in the generated Category union\n            [LOCAL_DEFAULTS.CATEGORY as Category]: [{ id: skillName as SkillId }],\n          },\n        },\n      },\n      marketplaceComment,\n    );\n\n    this.log(\"\");\n    this.logSuccess(`Created ${STACKS_FILE_PATH}`);\n    this.logSuccess(`Created ${SKILL_CATEGORIES_PATH}`);\n    this.logSuccess(`Created ${SKILL_RULES_PATH}`);\n    this.logSuccess(\"Created README.md\");\n    this.logSuccess(`Created ${CLAUDE_SRC_DIR}/${STANDARD_FILES.CONFIG_TS}`);\n    this.log(\"\");\n  }\n\n  private printNextSteps(marketplaceName: string, useCurrentDir: boolean): void {\n    const steps = [\n      ...(useCurrentDir ? [] : [`cd ${marketplaceName}`]),\n      `${CLI_INVOKE_COMMAND} new skill <name> --category <category-name>`,\n      \"Push to a git repository\",\n      `${CLI_INVOKE_COMMAND} init --source github:your-org/${marketplaceName}`,\n    ];\n\n    this.log(\"Marketplace created successfully!\");\n    this.log(\"\");\n    this.log(\"Next steps:\");\n    for (const [index, step] of steps.entries()) {\n      this.log(`  ${index + 1}. ${step}`);\n    }\n    this.log(\"\");\n  }\n\n  private async buildMarketplace(marketplaceDir: string, marketplaceName: string): Promise<void> {\n    const skillsDir = path.resolve(marketplaceDir, SKILLS_DIR_PATH);\n    const pluginsOutputDir = path.resolve(marketplaceDir, PLUGINS_DIST_PATH);\n    const marketplaceOutputPath = marketplaceManifestPath(marketplaceDir);\n\n    try {\n      this.log(\"Building plugins...\");\n      const { compiled, failed } = await compileAllSkillPlugins(skillsDir, pluginsOutputDir);\n      this.logSuccess(`Built ${compiled.length} skill plugins.`);\n      if (failed.length > 0) {\n        this.warn(`${failed.length} skill(s) failed to compile: ${failed.join(\", \")}`);\n      }\n\n      this.log(\"Generating marketplace.json...\");\n      const marketplace = await generateMarketplace(pluginsOutputDir, {\n        name: marketplaceName,\n        ownerName: marketplaceName,\n        pluginRoot: `./${PLUGINS_DIST_PATH}`,\n      });\n      await writeMarketplace(marketplaceOutputPath, marketplace);\n      this.logSuccess(\n        `Generated ${PLUGIN_MANIFEST_DIR}/${MARKETPLACE_JSON} with ${marketplace.plugins.length} plugins.`,\n      );\n\n      this.log(\"Generating config-types.ts...\");\n      const configTypesData = loadConfigTypesDataInBackground(marketplaceDir, marketplaceDir);\n      await writeScaffoldedEntityTypes(marketplaceDir, configTypesData);\n      this.logSuccess(`Generated ${CLAUDE_SRC_DIR}/${STANDARD_FILES.CONFIG_TYPES_TS}`);\n    } catch (error) {\n      this.warn(`Build step failed: ${getErrorMessage(error)}`);\n      this.warn(\n        \"The scaffold is still valid. Run 'build plugins' and 'build marketplace' manually.\",\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/commands/new/skill.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import {
+  NewSkill,
+  generateMetadataYaml,
+  generateSkillMd,
+  resolveAuthorOrDefault,
+  scaffoldSkillFiles
+} from "../../chunk-PV2HNW4I.js";
+import "../../chunk-PG4G4IIK.js";
+import "../../chunk-IHO75PMZ.js";
+import "../../chunk-7QIHKQL5.js";
+import "../../chunk-SYUOXSPU.js";
+import "../../chunk-P3PN5SVI.js";
+import "../../chunk-TVHRMRD3.js";
+import "../../chunk-3LIU2ZEF.js";
+import "../../chunk-DG2NGZ7S.js";
+import "../../chunk-VEP23B5W.js";
+import "../../chunk-O5ASLZ2K.js";
+import "../../chunk-YU2VGX5R.js";
+import "../../chunk-P56WJ5FA.js";
+export {
+  NewSkill as default,
+  generateMetadataYaml,
+  generateSkillMd,
+  resolveAuthorOrDefault,
+  scaffoldSkillFiles
+};
+//# sourceMappingURL=skill.js.map

package/dist/commands/new/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/commands/search.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import {
+  STATUS_MESSAGES
+} from "../chunk-GYG5SE2D.js";
+import {
+  loadSource
+} from "../chunk-Y4CXDA3I.js";
+import "../chunk-4R6PGHQQ.js";
+import "../chunk-3XFUQ6OL.js";
+import "../chunk-YBVA7GPW.js";
+import "../chunk-NGLQ5W7U.js";
+import {
+  BaseCommand
+} from "../chunk-7QIHKQL5.js";
+import "../chunk-SYUOXSPU.js";
+import "../chunk-P3PN5SVI.js";
+import {
+  IMPORT_DEFAULTS,
+  fetchFromSource,
+  resolveAllSources,
+  truncateText
+} from "../chunk-TVHRMRD3.js";
+import {
+  fileExists,
+  listDirectories,
+  parseFrontmatter,
+  readFile
+} from "../chunk-3LIU2ZEF.js";
+import "../chunk-DG2NGZ7S.js";
+import {
+  typedValues
+} from "../chunk-VEP23B5W.js";
+import {
+  DEFAULT_SKILLS_SUBDIR,
+  STANDARD_FILES
+} from "../chunk-O5ASLZ2K.js";
+import "../chunk-YU2VGX5R.js";
+import {
+  init_esm_shims
+} from "../chunk-P56WJ5FA.js";
+
+// src/cli/commands/search.ts
+init_esm_shims();
+import { Args } from "@oclif/core";
+import { printTable } from "@oclif/table";
+import path from "path";
+import { sortBy } from "remeda";
+var MAX_DESCRIPTION_WIDTH = 50;
+var PRIMARY_SOURCE_NAME = "marketplace";
+var Search = class _Search extends BaseCommand {
+  static summary = "Search the catalog of available skills across all registered sources";
+  static description = "Read-only catalog browse. Searches every registered source (primary + extras) by id, displayName, slug, description, or category. Use `import skill` to install.";
+  static examples = [
+    {
+      description: "Search for React skills",
+      command: "<%= config.bin %> search react"
+    },
+    {
+      description: "Search by any keyword (matches id, name, description, category)",
+      command: "<%= config.bin %> search state"
+    }
+  ];
+  static args = {
+    query: Args.string({
+      description: "Search query (matches id, displayName, slug, description, category)",
+      required: true
+    })
+  };
+  // Override parent baseFlags to drop --source (search is a zero-flag command)
+  static baseFlags = {};
+  static flags = {};
+  async run() {
+    const { args } = await this.parse(_Search);
+    await this.runSearch(args.query);
+  }
+  async runSearch(query) {
+    try {
+      this.log(STATUS_MESSAGES.LOADING_SKILLS);
+      const projectDir = process.cwd();
+      const allSkills = await loadSkillsFromAllSources(projectDir);
+      const results = sortBy(
+        allSkills.filter((skill) => matchesQuery(skill, query)),
+        (r) => r.displayName.toLowerCase()
+      );
+      this.log("");
+      if (results.length === 0) {
+        this.warn(`No skills found matching "${query}"`);
+        return;
+      }
+      this.logInfo(
+        `Found ${results.length} skill${results.length === 1 ? "" : "s"} matching "${query}"`
+      );
+      this.log("");
+      printTable({
+        data: results.map((skill) => ({
+          id: skill.displayName,
+          source: skill.sourceName,
+          category: skill.category,
+          description: truncateText(skill.description, MAX_DESCRIPTION_WIDTH)
+        })),
+        columns: [
+          { key: "id", name: "ID" },
+          { key: "source", name: "Source" },
+          { key: "category", name: "Category" },
+          { key: "description", name: "Description" }
+        ],
+        headerOptions: { bold: true }
+      });
+      this.log("");
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+};
+async function loadSkillsFromAllSources(projectDir) {
+  const { sourceResult } = await loadSource({ projectDir });
+  const { matrix } = sourceResult;
+  const primarySkills = typedValues(matrix.skills).map((skill) => ({
+    ...skill,
+    sourceName: PRIMARY_SOURCE_NAME
+  }));
+  const { extras } = await resolveAllSources(projectDir);
+  const extraSkillArrays = await Promise.all(extras.map(fetchSkillsFromExternalSource));
+  return [...primarySkills, ...extraSkillArrays.flat()];
+}
+async function fetchSkillsFromExternalSource(source) {
+  try {
+    const result = await fetchFromSource(source.url, {});
+    const skillsDir = path.join(result.path, DEFAULT_SKILLS_SUBDIR);
+    if (!await fileExists(skillsDir)) {
+      return [];
+    }
+    const skillDirs = await listDirectories(skillsDir);
+    const loaded = await Promise.all(
+      skillDirs.map((skillDir) => loadExternalSkill(skillsDir, skillDir, source.name))
+    );
+    return loaded.filter((skill) => skill !== null);
+  } catch {
+    return [];
+  }
+}
+async function loadExternalSkill(skillsDir, skillDir, sourceName) {
+  const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);
+  if (!await fileExists(skillMdPath)) return null;
+  const content = await readFile(skillMdPath);
+  const frontmatter = parseFrontmatter(content, skillMdPath);
+  if (!frontmatter) return null;
+  return {
+    id: frontmatter.name,
+    description: frontmatter.description,
+    // Boundary cast: directory name used as slug for third-party source skill
+    slug: skillDir,
+    displayName: skillDir,
+    // Boundary cast: external source skills have no real category; "imported" is a display-only placeholder
+    category: IMPORT_DEFAULTS.CATEGORY,
+    author: `@${sourceName}`,
+    conflictsWith: [],
+    isRecommended: false,
+    requires: [],
+    alternatives: [],
+    discourages: [],
+    compatibleWith: [],
+    path: path.join(skillsDir, skillDir),
+    sourceName
+  };
+}
+function matchesQuery(skill, query) {
+  const lowerQuery = query.toLowerCase();
+  return [skill.id, skill.displayName, skill.slug, skill.description, skill.category].some(
+    (field) => field.toLowerCase().includes(lowerQuery)
+  );
+}
+export {
+  Search as default
+};
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/commands/search.ts"],"sourcesContent":["import { Args } from \"@oclif/core\";\nimport { printTable } from \"@oclif/table\";\nimport path from \"path\";\nimport { sortBy } from \"remeda\";\n\nimport { BaseCommand } from \"../base-command.js\";\nimport { DEFAULT_SKILLS_SUBDIR, STANDARD_FILES } from \"../consts.js\";\nimport { resolveAllSources } from \"../lib/configuration/index.js\";\nimport { fetchFromSource, parseFrontmatter } from \"../lib/loading/index.js\";\nimport { IMPORT_DEFAULTS } from \"../lib/metadata-keys.js\";\nimport { loadSource } from \"../lib/operations/index.js\";\nimport type { SourceEntry } from \"../types/config.js\";\nimport type { ResolvedSkill, SkillSlug } from \"../types/index.js\";\nimport { fileExists, listDirectories, readFile } from \"../utils/fs.js\";\nimport { STATUS_MESSAGES } from \"../utils/messages.js\";\nimport { truncateText } from \"../utils/string.js\";\nimport { typedValues } from \"../utils/typed-object.js\";\n\nconst MAX_DESCRIPTION_WIDTH = 50;\nconst PRIMARY_SOURCE_NAME = \"marketplace\";\n\ntype SearchableSkill = ResolvedSkill & { sourceName: string };\n\nexport default class Search extends BaseCommand {\n  static summary = \"Search the catalog of available skills across all registered sources\";\n  static description =\n    \"Read-only catalog browse. Searches every registered source (primary + extras) \" +\n    \"by id, displayName, slug, description, or category. Use `import skill` to install.\";\n\n  static examples = [\n    {\n      description: \"Search for React skills\",\n      command: \"<%= config.bin %> search react\",\n    },\n    {\n      description: \"Search by any keyword (matches id, name, description, category)\",\n      command: \"<%= config.bin %> search state\",\n    },\n  ];\n\n  static args = {\n    query: Args.string({\n      description: \"Search query (matches id, displayName, slug, description, category)\",\n      required: true,\n    }),\n  };\n\n  // Override parent baseFlags to drop --source (search is a zero-flag command)\n  static baseFlags = {} as (typeof BaseCommand)[\"baseFlags\"];\n\n  static flags = {};\n\n  async run(): Promise<void> {\n    const { args } = await this.parse(Search);\n    await this.runSearch(args.query);\n  }\n\n  private async runSearch(query: string): Promise<void> {\n    try {\n      this.log(STATUS_MESSAGES.LOADING_SKILLS);\n\n      const projectDir = process.cwd();\n      const allSkills = await loadSkillsFromAllSources(projectDir);\n\n      const results = sortBy(\n        allSkills.filter((skill) => matchesQuery(skill, query)),\n        (r) => r.displayName.toLowerCase(),\n      );\n\n      this.log(\"\");\n      if (results.length === 0) {\n        this.warn(`No skills found matching \"${query}\"`);\n        return;\n      }\n\n      this.logInfo(\n        `Found ${results.length} skill${results.length === 1 ? \"\" : \"s\"} matching \"${query}\"`,\n      );\n      this.log(\"\");\n\n      printTable({\n        data: results.map((skill) => ({\n          id: skill.displayName,\n          source: skill.sourceName,\n          category: skill.category,\n          description: truncateText(skill.description, MAX_DESCRIPTION_WIDTH),\n        })),\n        columns: [\n          { key: \"id\", name: \"ID\" },\n          { key: \"source\", name: \"Source\" },\n          { key: \"category\", name: \"Category\" },\n          { key: \"description\", name: \"Description\" },\n        ],\n        headerOptions: { bold: true },\n      });\n      this.log(\"\");\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n}\n\nasync function loadSkillsFromAllSources(projectDir: string): Promise<SearchableSkill[]> {\n  const { sourceResult } = await loadSource({ projectDir });\n  const { matrix } = sourceResult;\n\n  const primarySkills: SearchableSkill[] = typedValues(matrix.skills).map((skill) => ({\n    ...skill,\n    sourceName: PRIMARY_SOURCE_NAME,\n  }));\n\n  const { extras } = await resolveAllSources(projectDir);\n\n  const extraSkillArrays = await Promise.all(extras.map(fetchSkillsFromExternalSource));\n\n  return [...primarySkills, ...extraSkillArrays.flat()];\n}\n\nasync function fetchSkillsFromExternalSource(source: SourceEntry): Promise<SearchableSkill[]> {\n  try {\n    const result = await fetchFromSource(source.url, {});\n    const skillsDir = path.join(result.path, DEFAULT_SKILLS_SUBDIR);\n\n    if (!(await fileExists(skillsDir))) {\n      return [];\n    }\n\n    const skillDirs = await listDirectories(skillsDir);\n    const loaded = await Promise.all(\n      skillDirs.map((skillDir) => loadExternalSkill(skillsDir, skillDir, source.name)),\n    );\n    return loaded.filter((skill) => skill !== null);\n  } catch {\n    // Source unavailable, return empty\n    return [];\n  }\n}\n\n/** Loads one external skill dir as a SearchableSkill, or null when it has no valid SKILL.md. */\nasync function loadExternalSkill(\n  skillsDir: string,\n  skillDir: string,\n  sourceName: string,\n): Promise<SearchableSkill | null> {\n  const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);\n  if (!(await fileExists(skillMdPath))) return null;\n\n  const content = await readFile(skillMdPath);\n  const frontmatter = parseFrontmatter(content, skillMdPath);\n  if (!frontmatter) return null;\n\n  return {\n    id: frontmatter.name,\n    description: frontmatter.description,\n    // Boundary cast: directory name used as slug for third-party source skill\n    slug: skillDir as SkillSlug,\n    displayName: skillDir,\n    // Boundary cast: external source skills have no real category; \"imported\" is a display-only placeholder\n    category: IMPORT_DEFAULTS.CATEGORY,\n    author: `@${sourceName}`,\n    conflictsWith: [],\n    isRecommended: false,\n    requires: [],\n    alternatives: [],\n    discourages: [],\n    compatibleWith: [],\n    path: path.join(skillsDir, skillDir),\n    sourceName,\n  };\n}\n\nfunction matchesQuery(skill: ResolvedSkill, query: string): boolean {\n  const lowerQuery = query.toLowerCase();\n  return [skill.id, skill.displayName, skill.slug, skill.description, skill.category].some(\n    (field) => field.toLowerCase().includes(lowerQuery),\n  );\n}\n"],"mappings":"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","names":[]}