agents-inc 0.156.0 → 0.158.0

package/dist/commands/build/plugins.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/commands/build/plugins.ts"],"sourcesContent":["import { Flags } from \"@oclif/core\";\nimport path from \"path\";\n\nimport { BaseCommand } from \"../../base-command\";\nimport { setVerbose } from \"../../utils/logger\";\nimport { listDirectories, remove } from \"../../utils/fs\";\nimport { DIRS, PLUGINS_DIST_PATH } from \"../../consts\";\nimport {\n  compileAllSkillPlugins,\n  compileSkillPlugin,\n  printCompilationSummary,\n} from \"../../lib/skills\";\nimport { compileAllAgentPlugins, printAgentCompilationSummary } from \"../../lib/agents\";\nimport { readPluginManifest } from \"../../lib/plugins\";\n\nexport default class BuildPlugins extends BaseCommand {\n  static summary = \"Build skills and agents into standalone plugins\";\n\n  static description =\n    \"Build skills and agents into standalone plugins. By default, compiles all skills. Use --skill to compile a specific skill only. Use --agents-dir to also compile agents.\";\n\n  static examples = [\n    {\n      description: \"Compile every skill into plugins\",\n      command: \"<%= config.bin %> <%= command.id %>\",\n    },\n    {\n      description: \"Compile a single skill by name\",\n      command: \"<%= config.bin %> <%= command.id %> --skill cli-commander\",\n    },\n    {\n      description: \"Write plugins to a custom output directory\",\n      command: \"<%= config.bin %> <%= command.id %> --output-dir ./plugins\",\n    },\n    {\n      description: \"Also compile agents from a directory\",\n      command: \"<%= config.bin %> <%= command.id %> --agents-dir ./agents\",\n    },\n    {\n      description: \"Compile with verbose logging\",\n      command: \"<%= config.bin %> <%= command.id %> --verbose\",\n    },\n  ];\n\n  static flags = {\n    \"agents-dir\": Flags.string({\n      char: \"a\",\n      description: \"Agents source directory (builds one plugin per agent)\",\n    }),\n    \"output-dir\": Flags.string({\n      char: \"o\",\n      description: \"Output directory\",\n      default: PLUGINS_DIST_PATH,\n    }),\n    skill: Flags.string({\n      description: \"Compile only a specific skill (path to skill directory)\",\n    }),\n    verbose: Flags.boolean({\n      char: \"v\",\n      description: \"Enable verbose logging\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { flags } = await this.parse(BuildPlugins);\n    setVerbose(flags.verbose);\n\n    const projectRoot = process.cwd();\n    const skillsDir = path.resolve(projectRoot, DIRS.skills);\n    const outputDir = path.resolve(projectRoot, flags[\"output-dir\"]);\n\n    this.printHeader(skillsDir, outputDir);\n\n    try {\n      const expectedSkillPlugins = await this.compileSkills(flags.skill, skillsDir, outputDir);\n\n      if (flags[\"agents-dir\"]) {\n        await this.compileAgents(projectRoot, flags[\"agents-dir\"], outputDir);\n      }\n\n      if (expectedSkillPlugins) {\n        await this.pruneStaleSkillPlugins(outputDir, expectedSkillPlugins);\n      }\n\n      this.log(\"\");\n      this.logSuccess(\"Plugin compilation complete!\");\n    } catch (error) {\n      this.log(\"Compilation failed\");\n      this.handleError(error);\n    }\n  }\n\n  private printHeader(skillsDir: string, outputDir: string): void {\n    this.log(\"\");\n    this.log(\"Compiling skill plugins\");\n    this.log(`  Skills directory: ${skillsDir}`);\n    this.log(`  Output directory: ${outputDir}`);\n    this.log(\"\");\n  }\n\n  /**\n   * Compiles skills and returns the set of plugin directory names that should\n   * exist afterward — used to prune stale plugins. Returns `null` when pruning\n   * must be skipped: single-skill mode (would wipe every other plugin) or a\n   * partial compile failure (a failed skill is indistinguishable from a removed\n   * one, so deleting it would be a worse bug than the stale entry).\n   */\n  private async compileSkills(\n    skillFlag: string | undefined,\n    skillsDir: string,\n    outputDir: string,\n  ): Promise<Set<string> | null> {\n    if (skillFlag) {\n      const skillPath = path.resolve(skillsDir, skillFlag);\n      this.log(`Compiling skill at ${skillPath}...`);\n\n      const result = await compileSkillPlugin({\n        skillPath,\n        outputDir,\n      });\n\n      this.log(`Compiled ${result.skillName}`);\n      this.log(`  Plugin path: ${result.pluginPath}`);\n      return null;\n    }\n\n    this.log(\"Finding and compiling all skills...\");\n\n    const { compiled, failed } = await compileAllSkillPlugins(skillsDir, outputDir);\n\n    this.log(`Compiled ${compiled.length} skill plugins`);\n    printCompilationSummary(compiled);\n\n    if (failed.length > 0) {\n      this.warn(\n        `Skipping stale-plugin pruning: ${failed.length} skill(s) failed to compile ` +\n          `(${failed.join(\", \")}). A failed skill is indistinguishable from a removed one.`,\n      );\n      return null;\n    }\n\n    return new Set(compiled.map((result) => result.skillName));\n  }\n\n  private async compileAgents(\n    projectRoot: string,\n    agentsDir: string,\n    outputDir: string,\n  ): Promise<void> {\n    const resolvedAgentsDir = path.resolve(projectRoot, agentsDir);\n\n    this.log(\"\");\n    this.log(\"Compiling agent plugins\");\n    this.log(`  Agents directory: ${resolvedAgentsDir}`);\n    this.log(\"\");\n\n    this.log(\"Finding and compiling all agents...\");\n\n    const agentResults = await compileAllAgentPlugins(resolvedAgentsDir, outputDir);\n\n    this.log(`Compiled ${agentResults.length} agent plugins`);\n    printAgentCompilationSummary(agentResults);\n  }\n\n  /**\n   * Removes skill-plugin directories in `outputDir` that no longer correspond to\n   * a compiled skill. Only skill plugins are pruned: agent plugins are preserved\n   * (this run has no authority over them) and non-plugin directories are left\n   * untouched. Callers must only invoke this after a clean full-scan compile.\n   */\n  private async pruneStaleSkillPlugins(\n    outputDir: string,\n    expectedSkillPlugins: ReadonlySet<string>,\n  ): Promise<void> {\n    const dirNames = await listDirectories(outputDir);\n\n    for (const dirName of dirNames) {\n      if (expectedSkillPlugins.has(dirName)) continue;\n\n      const pluginDir = path.join(outputDir, dirName);\n      const manifest = await readPluginManifest(pluginDir);\n      if (!manifest) continue;\n      if (manifest.agents !== undefined) continue;\n\n      await remove(pluginDir);\n      this.log(`  Pruned stale plugin: ${dirName}`);\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/cli/commands/build/plugins.ts"],"sourcesContent":["import { Flags } from \"@oclif/core\";\nimport path from \"path\";\n\nimport { BaseCommand } from \"../../base-command\";\nimport { setVerbose } from \"../../utils/logger\";\nimport { listDirectories, remove } from \"../../utils/fs\";\nimport { DIRS, PLUGINS_DIST_PATH } from \"../../consts\";\nimport {\n  compileAllSkillPlugins,\n  compileSkillPlugin,\n  printCompilationSummary,\n} from \"../../lib/skills\";\nimport { compileAllAgentPlugins, printAgentCompilationSummary } from \"../../lib/agents\";\nimport { readPluginManifest } from \"../../lib/plugins\";\n\nexport default class BuildPlugins extends BaseCommand {\n  static summary = \"Build skills and agents into standalone plugins\";\n\n  static description =\n    \"Build skills and agents into standalone plugins. By default, compiles all skills. Use --skill to compile a specific skill only. Use --agents-dir to also compile agents.\";\n\n  static examples = [\n    {\n      description: \"Compile every skill into plugins\",\n      command: \"<%= config.bin %> <%= command.id %>\",\n    },\n    {\n      description: \"Compile a single skill by name\",\n      command: \"<%= config.bin %> <%= command.id %> --skill cli-commander\",\n    },\n    {\n      description: \"Write plugins to a custom output directory\",\n      command: \"<%= config.bin %> <%= command.id %> --output-dir ./plugins\",\n    },\n    {\n      description: \"Also compile agents from a directory\",\n      command: \"<%= config.bin %> <%= command.id %> --agents-dir ./agents\",\n    },\n    {\n      description: \"Compile with verbose logging\",\n      command: \"<%= config.bin %> <%= command.id %> --verbose\",\n    },\n  ];\n\n  static flags = {\n    \"agents-dir\": Flags.string({\n      char: \"a\",\n      description: \"Agents source directory (builds one plugin per agent)\",\n    }),\n    \"output-dir\": Flags.string({\n      char: \"o\",\n      description: \"Output directory\",\n      default: PLUGINS_DIST_PATH,\n    }),\n    skill: Flags.string({\n      description: \"Compile only a specific skill (path to skill directory)\",\n    }),\n    verbose: Flags.boolean({\n      char: \"v\",\n      description: \"Enable verbose logging\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { flags } = await this.parse(BuildPlugins);\n    setVerbose(flags.verbose);\n\n    const projectRoot = process.cwd();\n    const skillsDir = path.resolve(projectRoot, DIRS.skills);\n    const outputDir = path.resolve(projectRoot, flags[\"output-dir\"]);\n\n    this.printHeader(skillsDir, outputDir);\n\n    try {\n      const expectedSkillPlugins = await this.compileSkills(flags.skill, skillsDir, outputDir);\n\n      if (flags[\"agents-dir\"]) {\n        await this.compileAgents(projectRoot, flags[\"agents-dir\"], outputDir);\n      }\n\n      if (expectedSkillPlugins) {\n        await this.pruneStaleSkillPlugins(outputDir, expectedSkillPlugins);\n      }\n\n      this.log(\"\");\n      this.logSuccess(\"Plugin compilation complete!\");\n    } catch (error) {\n      this.log(\"Compilation failed\");\n      this.handleError(error);\n    }\n  }\n\n  private printHeader(skillsDir: string, outputDir: string): void {\n    this.log(\"\");\n    this.log(\"Compiling skill plugins\");\n    this.log(`  Skills directory: ${skillsDir}`);\n    this.log(`  Output directory: ${outputDir}`);\n    this.log(\"\");\n  }\n\n  /**\n   * Compiles skills and returns the set of plugin directory names that should\n   * exist afterward — used to prune stale plugins. Returns `null` when pruning\n   * must be skipped: single-skill mode (would wipe every other plugin) or a\n   * partial compile failure (a failed skill is indistinguishable from a removed\n   * one, so deleting it would be a worse bug than the stale entry).\n   */\n  private async compileSkills(\n    skillFlag: string | undefined,\n    skillsDir: string,\n    outputDir: string,\n  ): Promise<Set<string> | null> {\n    if (skillFlag) {\n      const skillPath = path.resolve(skillsDir, skillFlag);\n      this.log(`Compiling skill at ${skillPath}...`);\n\n      const result = await compileSkillPlugin({\n        skillPath,\n        outputDir,\n      });\n\n      this.log(`Compiled ${result.skillName}`);\n      this.log(`  Plugin path: ${result.pluginPath}`);\n      return null;\n    }\n\n    this.log(\"Finding and compiling all skills...\");\n\n    const { compiled, failed } = await compileAllSkillPlugins(skillsDir, outputDir);\n\n    this.log(`Compiled ${compiled.length} skill plugins`);\n    printCompilationSummary(compiled);\n\n    if (failed.length > 0) {\n      this.warn(\n        `Skipping stale-plugin pruning: ${failed.length} skill(s) failed to compile ` +\n          `(${failed.join(\", \")}). A failed skill is indistinguishable from a removed one.`,\n      );\n      return null;\n    }\n\n    return new Set(compiled.map((result) => result.skillName));\n  }\n\n  private async compileAgents(\n    projectRoot: string,\n    agentsDir: string,\n    outputDir: string,\n  ): Promise<void> {\n    const resolvedAgentsDir = path.resolve(projectRoot, agentsDir);\n\n    this.log(\"\");\n    this.log(\"Compiling agent plugins\");\n    this.log(`  Agents directory: ${resolvedAgentsDir}`);\n    this.log(\"\");\n\n    this.log(\"Finding and compiling all agents...\");\n\n    const agentResults = await compileAllAgentPlugins(resolvedAgentsDir, outputDir);\n\n    this.log(`Compiled ${agentResults.length} agent plugins`);\n    printAgentCompilationSummary(agentResults);\n  }\n\n  /**\n   * Removes skill-plugin directories in `outputDir` that no longer correspond to\n   * a compiled skill. Only skill plugins are pruned: agent plugins are preserved\n   * (this run has no authority over them) and non-plugin directories are left\n   * untouched. Callers must only invoke this after a clean full-scan compile.\n   */\n  private async pruneStaleSkillPlugins(\n    outputDir: string,\n    expectedSkillPlugins: ReadonlySet<string>,\n  ): Promise<void> {\n    const dirNames = await listDirectories(outputDir);\n\n    for (const dirName of dirNames) {\n      if (expectedSkillPlugins.has(dirName)) continue;\n\n      const pluginDir = path.join(outputDir, dirName);\n      const manifest = await readPluginManifest(pluginDir);\n      if (!manifest) continue;\n      if (manifest.agents !== undefined) continue;\n\n      await remove(pluginDir);\n      this.log(`  Pruned stale plugin: ${dirName}`);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/commands/compile.js

@@ -1,22 +1,22 @@
 #!/usr/bin/env node
 import {
-  detectBothInstallations
-} from "../chunk-WUQ3MTPF.js";
+  detectBothInstallations,
+  reconcileTypesFromDisk
+} from "../chunk-H2DHTJKW.js";
 import {
   compileAgents,
   discoverInstalledSkills
-} from "../chunk-5QZAK6J7.js";
+} from "../chunk-H25VRR2T.js";
 import {
   loadAgentDefs
-} from "../chunk-MHRC3KRX.js";
-import "../chunk-F2AMBBIA.js";
-import "../chunk-ZUAZHDKP.js";
+} from "../chunk-H4CL23HG.js";
+import "../chunk-WMVOJY6V.js";
 import {
   BaseCommand,
   EXIT_CODES
-} from "../chunk-YO2LTXB4.js";
-import "../chunk-UMH2YZKG.js";
-import "../chunk-G47TDUK3.js";
+} from "../chunk-X52QUV4U.js";
+import "../chunk-TPQ5M3BW.js";
+import "../chunk-QNAMXQKF.js";
 import {
   ConfigLoadError,
   ERROR_MESSAGES,
@@ -24,6 +24,7 @@ import {
   STATUS_MESSAGES,
   configTypesRefreshFailed,
   effectivelyExcludedSkillIds,
+  getErrorMessage,
   getStackSkillIds,
   globalScopedAgentsHint,
   isActiveAt,
@@ -31,24 +32,19 @@ import {
   loadProjectConfigFromDir,
   loadSkillsMatrixFromSource,
   recompileSummary,
-  reconcileTypesFromDisk,
   registeredProjectUpdateSkipped,
   resolveAgentConfigToSkills,
   resolveSource,
   scopeBlockedStackAssignment,
-  skillMetadataUnusableDetail,
-  skillMetadataUnusableError
-} from "../chunk-WCAUUBHO.js";
-import {
-  getErrorMessage,
   setVerbose,
+  skillMetadataUnusableDetail,
+  skillMetadataUnusableError,
   verbose
-} from "../chunk-XAXJWXI4.js";
-import "../chunk-RWOYPOMR.js";
-import "../chunk-VASLW636.js";
+} from "../chunk-3PJLLBUS.js";
+import "../chunk-7Z4N4JWQ.js";
 import {
   STANDARD_FILES
-} from "../chunk-IO5YBKHV.js";
+} from "../chunk-G6G2FT2G.js";
 import "../chunk-VZRO7RYT.js";
 
 // src/cli/commands/compile.ts

package/dist/commands/compile.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/commands/compile.ts"],"sourcesContent":["import { Flags } from \"@oclif/core\";\nimport os from \"os\";\nimport { unique } from \"remeda\";\nimport { BaseCommand } from \"../base-command\";\nimport { setVerbose, verbose } from \"../utils/logger\";\nimport {\n  detectBothInstallations,\n  type BothInstallations,\n  loadAgentDefs,\n  type AgentDefs,\n  compileAgents,\n  discoverInstalledSkills,\n  type DiscoveredSkills,\n} from \"../lib/operations\";\nimport {\n  ConfigLoadError,\n  effectivelyExcludedSkillIds,\n  isActiveAt,\n  loadProjectConfig,\n  loadProjectConfigFromDir,\n  resolveSource,\n} from \"../lib/configuration\";\nimport { getStackSkillIds, resolveAgentConfigToSkills } from \"../lib/stacks\";\nimport { loadSkillsMatrixFromSource, type UnusableSkillMetadata } from \"../lib/loading\";\nimport { STANDARD_FILES } from \"../consts\";\nimport { EXIT_CODES } from \"../lib/exit-codes\";\nimport { getErrorMessage } from \"../utils/errors\";\nimport {\n  ERROR_MESSAGES,\n  STATUS_MESSAGES,\n  INFO_MESSAGES,\n  configTypesRefreshFailed,\n  globalScopedAgentsHint,\n  recompileSummary,\n  registeredProjectUpdateSkipped,\n  scopeBlockedStackAssignment,\n  skillMetadataUnusableDetail,\n  skillMetadataUnusableError,\n} from \"../utils/messages\";\nimport { reconcileTypesFromDisk, type GateReport } from \"../lib/config-gate/index.js\";\nimport type { Installation } from \"../lib/installation\";\nimport type { SkillScope } from \"../types/config\";\nimport type {\n  AgentDefinition,\n  AgentName,\n  ProjectConfig,\n  SkillDefinitionMap,\n  SkillId,\n  StackAgentConfig,\n} from \"../types\";\n\nexport default class Compile extends BaseCommand {\n  static summary = \"Compile agents using local skills and agent definitions\";\n\n  static description =\n    \"Compile agents with resolved skill references. Compiles to the Claude plugin directory.\";\n\n  static examples = [\n    \"<%= config.bin %> <%= command.id %>\",\n    \"<%= config.bin %> <%= command.id %> --verbose\",\n  ];\n\n  static flags = {\n    verbose: Flags.boolean({\n      char: \"v\",\n      description: \"Enable verbose logging\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { flags } = await this.parse(Compile);\n    setVerbose(flags.verbose);\n    const cwd = process.cwd();\n\n    const installations = await this.detectInstallations(cwd);\n    await this.resolveAndLogSource(cwd);\n    const agentDefs = await this.loadAgentDefsOrFail();\n    await this.runCompilePasses(installations, agentDefs, cwd);\n  }\n\n  private async detectInstallations(cwd: string): Promise<BothInstallations> {\n    let installations: BothInstallations;\n    try {\n      installations = await detectBothInstallations(cwd);\n    } catch (error) {\n      // A corrupt config (file present but unparseable) must not let compile run\n      // config-less — that resurrects every deselected agent. Hard-error naming\n      // the offending file before any compilation happens.\n      if (error instanceof ConfigLoadError) {\n        this.error(error.message, { exit: EXIT_CODES.ERROR });\n      }\n      throw error;\n    }\n\n    if (!installations.global && !installations.project) {\n      this.error(ERROR_MESSAGES.NO_INSTALLATION, {\n        exit: EXIT_CODES.ERROR,\n      });\n    }\n\n    return installations;\n  }\n\n  /**\n   * Names where the marketplace came from — the project's own config first, then the global\n   * one, then the default. `compile` takes no `--marketplace`: it recompiles an installation\n   * that already recorded which marketplace its skill references answer to, and reading\n   * a different one would write agents against a catalogue config.ts does not name.\n   */\n  private async resolveAndLogSource(projectDir: string): Promise<void> {\n    this.log(STATUS_MESSAGES.RESOLVING_SOURCE);\n    try {\n      const sourceConfig = await resolveSource({ caller: \"stored\", projectDir });\n      this.log(`Marketplace: ${sourceConfig.sourceOrigin}`);\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_RESOLVE_SOURCE);\n      this.handleError(error);\n    }\n  }\n\n  private async loadAgentDefsOrFail(): Promise<AgentDefs> {\n    this.log(STATUS_MESSAGES.LOADING_AGENT_PARTIALS);\n    try {\n      const defs = await loadAgentDefs();\n      this.log(\"Agent partials loaded\");\n      verbose(`  Agents: ${defs.agentSourcePaths.agentsDir}`);\n      return defs;\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_LOAD_AGENT_PARTIALS);\n      this.handleError(error);\n    }\n  }\n\n  private async runCompilePasses(\n    installations: BothInstallations,\n    agentDefs: AgentDefs,\n    cwd: string,\n  ): Promise<void> {\n    const passes = buildCompilePasses(installations, cwd, agentDefs);\n\n    let totalPassesWithSkills = 0;\n    for (const pass of passes) {\n      const hadSkills = await this.runCompilePass(pass, cwd);\n      if (hadSkills) totalPassesWithSkills++;\n    }\n\n    if (totalPassesWithSkills === 0) {\n      this.error(ERROR_MESSAGES.NO_SKILLS_TO_COMPILE, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  /**\n   * Discovers what this pass compiles from, and refuses the run when any installed\n   * skill's metadata.yaml exists but describes no skill — before a count is printed,\n   * an agent is written or the type unions are regenerated. Skipping such a skill is\n   * what the config-types pass already does; loading it anyway is what this pass\n   * used to do, so a single run both loaded and skipped the same file.\n   */\n  private async discoverAllSkills(projectDir: string): Promise<DiscoveredSkills> {\n    this.log(STATUS_MESSAGES.DISCOVERING_SKILLS);\n    const result = await discoverInstalledSkills(projectDir);\n    if (result.unusableMetadata.length > 0) {\n      this.refuseUnusableSkillMetadata(result.unusableMetadata);\n    }\n    if (result.totalSkillCount === 0) return result;\n    this.log(formatDiscoveryMessage(result));\n    return result;\n  }\n\n  /**\n   * Names each offending file and its reason, then exits. The detail is LOGGED and\n   * only the refusal is raised: oclif hard-wraps error text at the terminal width,\n   * and a path broken across two lines is one nobody can copy.\n   */\n  private refuseUnusableSkillMetadata(entries: UnusableSkillMetadata[]): never {\n    for (const entry of entries) {\n      this.log(skillMetadataUnusableDetail(entry));\n    }\n    this.error(skillMetadataUnusableError(entries), { exit: EXIT_CODES.ERROR });\n  }\n\n  /**\n   * A stack skill that is not among the discovered skills is dropped from every\n   * agent that references it. The resolver only records that at verbose level, so\n   * the default output would claim a successful recompile of an agent that no\n   * longer matches config.ts. Name each dropped skill instead.\n   */\n  private async warnUnresolvedStackSkills(\n    projectDir: string,\n    allSkills: SkillDefinitionMap,\n  ): Promise<void> {\n    const loaded = await loadProjectConfig(projectDir);\n    if (!loaded?.config.stack) return;\n\n    const excludedIds = effectivelyExcludedSkillIds(loaded.config.skills);\n    const unresolved = getStackSkillIds(loaded.config.stack).filter(\n      (id) => !excludedIds.has(id) && !(id in allSkills),\n    );\n\n    for (const id of unresolved) {\n      this.warn(\n        `Skill '${id}' is configured but was not found — agents will be compiled without it.`,\n      );\n    }\n  }\n\n  /**\n   * `config.ts` is the hand-editable half of the pair, so it can declare a pair the scope\n   * rule forbids: a GLOBAL sub-agent whose stack carries a PROJECT-scoped skill. The\n   * compile-time filter in `buildCompileAgents` drops that reference on the way to the\n   * resolver and `compile` rewrites nothing in `config.ts`, so the row survives and is\n   * dropped again on every future run — while the recompile summary reports a clean pass\n   * over an agent that no longer carries what its own config says it does.\n   *\n   * The sibling of {@link warnUnresolvedStackSkills} one layer over: there the skill is\n   * missing from disk, here it is present and unreachable from that sub-agent.\n   */\n  private async warnScopeDroppedStackPairs(projectDir: string): Promise<void> {\n    const loaded = await loadProjectConfig(projectDir);\n    if (!loaded?.config.stack) return;\n\n    for (const [skillId, agentNames] of findScopeDroppedStackPairs(loaded.config)) {\n      this.warn(scopeBlockedStackAssignment(agentNames, skillId));\n    }\n  }\n\n  /**\n   * The project pass compiled no agents, but the project config may still declare\n   * global-scope agents whose stack lives in the global config. Without a pointer\n   * the \"No agents to recompile\" line reads as a silent no-op after a global stack\n   * change, so name the global context and the count.\n   */\n  private async hintGlobalScopedAgents(projectDir: string): Promise<void> {\n    const loaded = await loadProjectConfigFromDir(projectDir);\n    if (!loaded) return;\n\n    const globalAgentCount = loaded.config.agents.filter(\n      (agent) => !agent.excluded && agent.scope === \"global\",\n    ).length;\n    if (globalAgentCount === 0) return;\n\n    this.log(globalScopedAgentsHint(globalAgentCount));\n  }\n\n  /**\n   * The documented hand-edit workflow is \"edit config.ts, then run compile\", and\n   * the type unions in config-types.ts are derived from config.ts — so a compile\n   * pass that leaves them untouched strands stale unions after a hand-edit.\n   * Regenerates them from the scope's persisted config exactly as the wizard\n   * write path would: standalone narrowed unions at global scope, import-and-\n   * extend at project scope. `matrixOnly` keeps the default-source path offline.\n   * A failed refresh downgrades to a warning — the compiled agents are already\n   * written and remain valid; only the type unions may still be stale.\n   *\n   * `skipExtraSources: true` is NOT a divergence from the wizard's full\n   * multi-source load: extra-source loading only annotates each skill's\n   * `availableSources`/`activeSource` for wizard UI tagging — it never adds\n   * skills or categories to the matrix, and the config-types writer never reads\n   * those annotations, so the emitted types are byte-identical either way\n   * (pinned by the skipExtraSources parity test in local-installer.test.ts).\n   * Skipping avoids fetching every registered extra source (network on a cold\n   * cache, plus unreachable-remote warnings) on this offline compile path.\n   */\n  private async refreshConfigTypes(pass: CompilePass, cwd: string): Promise<void> {\n    let report: GateReport;\n    try {\n      const loaded = await loadProjectConfigFromDir(pass.projectDir);\n      if (!loaded) {\n        verbose(\n          `No config found at ${pass.projectDir} — skipping ${STANDARD_FILES.CONFIG_TYPES_TS} refresh`,\n        );\n        return;\n      }\n\n      const { matrix } = await loadSkillsMatrixFromSource({\n        projectDir: pass.projectDir,\n        skipExtraSources: true,\n        matrixOnly: true,\n      });\n      // `cwd` is excluded from the fan-out, which only a global pass can perform:\n      // whatever this invocation was run from is this command's own subject, so a\n      // fan-out must never reach back into it.\n      report = await reconcileTypesFromDisk(\n        pass.projectDir,\n        loaded.config,\n        { matrix, agents: pass.agents },\n        { currentProjectDir: cwd },\n      );\n      this.log(INFO_MESSAGES.CONFIG_TYPES_REFRESHED);\n    } catch (error) {\n      this.warn(configTypesRefreshFailed(getErrorMessage(error)));\n      return;\n    }\n\n    this.reportPropagation(report);\n  }\n\n  /**\n   * Renders the fan-out the refresh above performed. Kept out of the refresh's\n   * catch on purpose: a project the fan-out could not reach is reported as that,\n   * not as a failure to refresh the type unions — which did succeed.\n   */\n  private reportPropagation(report: GateReport): void {\n    for (const skippedPath of report.propagated.skipped) {\n      this.warn(registeredProjectUpdateSkipped(skippedPath));\n    }\n    this.reportPropagatedRecompile(report);\n  }\n\n  private async runCompilePass(params: CompilePass, cwd: string): Promise<boolean> {\n    const { label, projectDir, installation, sourcePath, scopeFilter } = params;\n\n    this.log(\"\");\n    this.log(`Compiling ${label.toLowerCase()} agents...`);\n    this.log(\"\");\n\n    verbose(`  Project: ${projectDir}`);\n    verbose(`  Agents: ${installation.agentsDir}`);\n\n    const { allSkills, totalSkillCount } = await this.discoverAllSkills(projectDir);\n\n    if (totalSkillCount === 0) {\n      this.log(`No skills found for ${label.toLowerCase()} pass, skipping`);\n      // The config loads independently of discovered skills: a hand-edited\n      // config.ts can list skills while nothing is installed for this scope,\n      // and its type unions must follow the config rather than stay stale.\n      await this.refreshConfigTypes(params, cwd);\n      return false;\n    }\n\n    await this.warnUnresolvedStackSkills(projectDir, allSkills);\n    await this.warnScopeDroppedStackPairs(projectDir);\n\n    this.log(STATUS_MESSAGES.RECOMPILING_AGENTS);\n    try {\n      const recompileResult = await compileAgents({\n        projectDir,\n        sourcePath,\n        skills: allSkills,\n        pluginDir: projectDir,\n        outputDir: installation.agentsDir,\n        ...(scopeFilter !== undefined && { scopeFilter }),\n      });\n\n      const { compiled, rewritten, failed, warnings } = recompileResult;\n      const summary = recompileSummary(\n        rewritten.length,\n        compiled.length - rewritten.length,\n        `${label.toLowerCase()} agents`,\n      );\n\n      if (failed.length > 0) {\n        this.log(`${summary} (${failed.length} failed)`);\n        for (const warning of warnings) {\n          this.warn(warning);\n        }\n      } else if (compiled.length > 0) {\n        this.log(summary);\n      } else {\n        this.log(INFO_MESSAGES.NO_AGENTS_TO_RECOMPILE);\n        if (label === \"Project\") {\n          await this.hintGlobalScopedAgents(projectDir);\n        }\n      }\n\n      if (compiled.length > 0) {\n        verbose(`  Compiled: ${compiled.join(\", \")}`);\n      }\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_COMPILE_AGENTS);\n      this.handleError(error);\n    }\n\n    await this.refreshConfigTypes(params, cwd);\n\n    this.log(\"\");\n    this.logSuccess(`${label} compile complete!`);\n    this.log(\"\");\n\n    return true;\n  }\n}\n\ntype CompilePass = {\n  label: \"Global\" | \"Project\";\n  projectDir: string;\n  installation: Installation;\n  sourcePath: string;\n  agents: Partial<Record<AgentName, AgentDefinition>>;\n  scopeFilter?: SkillScope;\n};\n\n/**\n * The single pass this invocation owns.\n *\n * A compile run inside a project is a PROJECT-scope operation and writes nothing\n * outside that project: it compiles the project's own agents and refreshes the\n * project's own type unions, and never the global install's or another\n * registered project's. Propagation is a global operation's consequence — the\n * global config is what every project's config inlines — and a project compile\n * is not one.\n *\n * The global pass is therefore reached only where no project installation is in\n * play: at the home directory (where `detectBothInstallations` returns no\n * project by construction), or in a directory that has no config of its own, so\n * the global install is the only thing there is to compile.\n *\n * `scopeFilter` still narrows the project pass whenever both installations\n * exist: the project's config inlines the global entries, so an unfiltered pass\n * would compile global-scoped agents into the project's own agents directory.\n */\nfunction buildCompilePasses(\n  installations: BothInstallations,\n  cwd: string,\n  agentDefs: AgentDefs,\n): CompilePass[] {\n  const { sourcePath, agents } = agentDefs;\n\n  if (installations.project) {\n    return [\n      {\n        label: \"Project\",\n        projectDir: cwd,\n        installation: installations.project,\n        sourcePath,\n        agents,\n        ...(installations.hasBoth && { scopeFilter: \"project\" as const }),\n      },\n    ];\n  }\n\n  if (installations.global) {\n    return [\n      {\n        label: \"Global\",\n        projectDir: os.homedir(),\n        installation: installations.global,\n        sourcePath,\n        agents,\n      },\n    ];\n  }\n\n  return [];\n}\n\n/**\n * Every project-scoped skill that a GLOBAL sub-agent's stack assigns to itself, with the\n * sub-agents that assign it — exactly the pairs `buildCompileAgents`' scope filter drops on\n * the way to the resolver.\n *\n * Grouped by skill rather than emitted per pair, so one sentence accounts for every\n * sub-agent one skill was kept away from.\n */\nfunction findScopeDroppedStackPairs(config: ProjectConfig): [SkillId, AgentName[]][] {\n  const stack = config.stack ?? {};\n  const globalAgentNames = config.agents\n    .filter((agent) => isActiveAt(agent, \"global\"))\n    .map((agent) => agent.name);\n  const projectScopedIds = unique(\n    config.skills.filter((skill) => isActiveAt(skill, \"project\")).map((skill) => skill.id),\n  );\n\n  return projectScopedIds\n    .map((skillId): [SkillId, AgentName[]] => [\n      skillId,\n      globalAgentNames.filter((agentName) => stackAssignsSkill(stack[agentName], skillId)),\n    ])\n    .filter(([, agentNames]) => agentNames.length > 0);\n}\n\n/** True when this sub-agent's stack names the skill, in any of its categories. */\nfunction stackAssignsSkill(agentStack: StackAgentConfig | undefined, skillId: SkillId): boolean {\n  if (!agentStack) return false;\n  return resolveAgentConfigToSkills(agentStack).some((ref) => ref.id === skillId);\n}\n\nfunction formatDiscoveryMessage(result: DiscoveredSkills): string {\n  const { totalSkillCount, pluginSkillCount } = result;\n  const localCount = totalSkillCount - pluginSkillCount;\n\n  if (pluginSkillCount > 0 && localCount > 0) {\n    return `Discovered ${totalSkillCount} skills (${pluginSkillCount} from plugins, ${localCount} local)`;\n  }\n\n  return pluginSkillCount > 0\n    ? `Discovered ${pluginSkillCount} skills from plugins`\n    : `Discovered ${totalSkillCount} local skills`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,aAAa;AACtB,OAAO,QAAQ;AACf,SAAS,cAAc;AAiDvB,IAAqB,UAArB,MAAqB,iBAAgB,YAAY;AAAA,EAC/C,OAAO,UAAU;AAAA,EAEjB,OAAO,cACL;AAAA,EAEF,OAAO,WAAW;AAAA,IAChB;AAAA,IACA;AAAA,EACF;AAAA,EAEA,OAAO,QAAQ;AAAA,IACb,SAAS,MAAM,QAAQ;AAAA,MACrB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,MAAM,QAAO;AAC1C,eAAW,MAAM,OAAO;AACxB,UAAM,MAAM,QAAQ,IAAI;AAExB,UAAM,gBAAgB,MAAM,KAAK,oBAAoB,GAAG;AACxD,UAAM,KAAK,oBAAoB,GAAG;AAClC,UAAM,YAAY,MAAM,KAAK,oBAAoB;AACjD,UAAM,KAAK,iBAAiB,eAAe,WAAW,GAAG;AAAA,EAC3D;AAAA,EAEA,MAAc,oBAAoB,KAAyC;AACzE,QAAI;AACJ,QAAI;AACF,sBAAgB,MAAM,wBAAwB,GAAG;AAAA,IACnD,SAAS,OAAO;AAId,UAAI,iBAAiB,iBAAiB;AACpC,aAAK,MAAM,MAAM,SAAS,EAAE,MAAM,WAAW,MAAM,CAAC;AAAA,MACtD;AACA,YAAM;AAAA,IACR;AAEA,QAAI,CAAC,cAAc,UAAU,CAAC,cAAc,SAAS;AACnD,WAAK,MAAM,eAAe,iBAAiB;AAAA,QACzC,MAAM,WAAW;AAAA,MACnB,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAc,oBAAoB,YAAmC;AACnE,SAAK,IAAI,gBAAgB,gBAAgB;AACzC,QAAI;AACF,YAAM,eAAe,MAAM,cAAc,EAAE,QAAQ,UAAU,WAAW,CAAC;AACzE,WAAK,IAAI,gBAAgB,aAAa,YAAY,EAAE;AAAA,IACtD,SAAS,OAAO;AACd,WAAK,IAAI,eAAe,qBAAqB;AAC7C,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAc,sBAA0C;AACtD,SAAK,IAAI,gBAAgB,sBAAsB;AAC/C,QAAI;AACF,YAAM,OAAO,MAAM,cAAc;AACjC,WAAK,IAAI,uBAAuB;AAChC,cAAQ,aAAa,KAAK,iBAAiB,SAAS,EAAE;AACtD,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,IAAI,eAAe,0BAA0B;AAClD,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAc,iBACZ,eACA,WACA,KACe;AACf,UAAM,SAAS,mBAAmB,eAAe,KAAK,SAAS;AAE/D,QAAI,wBAAwB;AAC5B,eAAW,QAAQ,QAAQ;AACzB,YAAM,YAAY,MAAM,KAAK,eAAe,MAAM,GAAG;AACrD,UAAI,UAAW;AAAA,IACjB;AAEA,QAAI,0BAA0B,GAAG;AAC/B,WAAK,MAAM,eAAe,sBAAsB,EAAE,MAAM,WAAW,MAAM,CAAC;AAAA,IAC5E;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAc,kBAAkB,YAA+C;AAC7E,SAAK,IAAI,gBAAgB,kBAAkB;AAC3C,UAAM,SAAS,MAAM,wBAAwB,UAAU;AACvD,QAAI,OAAO,iBAAiB,SAAS,GAAG;AACtC,WAAK,4BAA4B,OAAO,gBAAgB;AAAA,IAC1D;AACA,QAAI,OAAO,oBAAoB,EAAG,QAAO;AACzC,SAAK,IAAI,uBAAuB,MAAM,CAAC;AACvC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,4BAA4B,SAAyC;AAC3E,eAAW,SAAS,SAAS;AAC3B,WAAK,IAAI,4BAA4B,KAAK,CAAC;AAAA,IAC7C;AACA,SAAK,MAAM,2BAA2B,OAAO,GAAG,EAAE,MAAM,WAAW,MAAM,CAAC;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAc,0BACZ,YACA,WACe;AACf,UAAM,SAAS,MAAM,kBAAkB,UAAU;AACjD,QAAI,CAAC,QAAQ,OAAO,MAAO;AAE3B,UAAM,cAAc,4BAA4B,OAAO,OAAO,MAAM;AACpE,UAAM,aAAa,iBAAiB,OAAO,OAAO,KAAK,EAAE;AAAA,MACvD,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,KAAK,EAAE,MAAM;AAAA,IAC1C;AAEA,eAAW,MAAM,YAAY;AAC3B,WAAK;AAAA,QACH,UAAU,EAAE;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAc,2BAA2B,YAAmC;AAC1E,UAAM,SAAS,MAAM,kBAAkB,UAAU;AACjD,QAAI,CAAC,QAAQ,OAAO,MAAO;AAE3B,eAAW,CAAC,SAAS,UAAU,KAAK,2BAA2B,OAAO,MAAM,GAAG;AAC7E,WAAK,KAAK,4BAA4B,YAAY,OAAO,CAAC;AAAA,IAC5D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAc,uBAAuB,YAAmC;AACtE,UAAM,SAAS,MAAM,yBAAyB,UAAU;AACxD,QAAI,CAAC,OAAQ;AAEb,UAAM,mBAAmB,OAAO,OAAO,OAAO;AAAA,MAC5C,CAAC,UAAU,CAAC,MAAM,YAAY,MAAM,UAAU;AAAA,IAChD,EAAE;AACF,QAAI,qBAAqB,EAAG;AAE5B,SAAK,IAAI,uBAAuB,gBAAgB,CAAC;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,MAAc,mBAAmB,MAAmB,KAA4B;AAC9E,QAAI;AACJ,QAAI;AACF,YAAM,SAAS,MAAM,yBAAyB,KAAK,UAAU;AAC7D,UAAI,CAAC,QAAQ;AACX;AAAA,UACE,sBAAsB,KAAK,UAAU,oBAAe,eAAe,eAAe;AAAA,QACpF;AACA;AAAA,MACF;AAEA,YAAM,EAAE,OAAO,IAAI,MAAM,2BAA2B;AAAA,QAClD,YAAY,KAAK;AAAA,QACjB,kBAAkB;AAAA,QAClB,YAAY;AAAA,MACd,CAAC;AAID,eAAS,MAAM;AAAA,QACb,KAAK;AAAA,QACL,OAAO;AAAA,QACP,EAAE,QAAQ,QAAQ,KAAK,OAAO;AAAA,QAC9B,EAAE,mBAAmB,IAAI;AAAA,MAC3B;AACA,WAAK,IAAI,cAAc,sBAAsB;AAAA,IAC/C,SAAS,OAAO;AACd,WAAK,KAAK,yBAAyB,gBAAgB,KAAK,CAAC,CAAC;AAC1D;AAAA,IACF;AAEA,SAAK,kBAAkB,MAAM;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,kBAAkB,QAA0B;AAClD,eAAW,eAAe,OAAO,WAAW,SAAS;AACnD,WAAK,KAAK,+BAA+B,WAAW,CAAC;AAAA,IACvD;AACA,SAAK,0BAA0B,MAAM;AAAA,EACvC;AAAA,EAEA,MAAc,eAAe,QAAqB,KAA+B;AAC/E,UAAM,EAAE,OAAO,YAAY,cAAc,YAAY,YAAY,IAAI;AAErE,SAAK,IAAI,EAAE;AACX,SAAK,IAAI,aAAa,MAAM,YAAY,CAAC,YAAY;AACrD,SAAK,IAAI,EAAE;AAEX,YAAQ,cAAc,UAAU,EAAE;AAClC,YAAQ,aAAa,aAAa,SAAS,EAAE;AAE7C,UAAM,EAAE,WAAW,gBAAgB,IAAI,MAAM,KAAK,kBAAkB,UAAU;AAE9E,QAAI,oBAAoB,GAAG;AACzB,WAAK,IAAI,uBAAuB,MAAM,YAAY,CAAC,iBAAiB;AAIpE,YAAM,KAAK,mBAAmB,QAAQ,GAAG;AACzC,aAAO;AAAA,IACT;AAEA,UAAM,KAAK,0BAA0B,YAAY,SAAS;AAC1D,UAAM,KAAK,2BAA2B,UAAU;AAEhD,SAAK,IAAI,gBAAgB,kBAAkB;AAC3C,QAAI;AACF,YAAM,kBAAkB,MAAM,cAAc;AAAA,QAC1C;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR,WAAW;AAAA,QACX,WAAW,aAAa;AAAA,QACxB,GAAI,gBAAgB,UAAa,EAAE,YAAY;AAAA,MACjD,CAAC;AAED,YAAM,EAAE,UAAU,WAAW,QAAQ,SAAS,IAAI;AAClD,YAAM,UAAU;AAAA,QACd,UAAU;AAAA,QACV,SAAS,SAAS,UAAU;AAAA,QAC5B,GAAG,MAAM,YAAY,CAAC;AAAA,MACxB;AAEA,UAAI,OAAO,SAAS,GAAG;AACrB,aAAK,IAAI,GAAG,OAAO,KAAK,OAAO,MAAM,UAAU;AAC/C,mBAAW,WAAW,UAAU;AAC9B,eAAK,KAAK,OAAO;AAAA,QACnB;AAAA,MACF,WAAW,SAAS,SAAS,GAAG;AAC9B,aAAK,IAAI,OAAO;AAAA,MAClB,OAAO;AACL,aAAK,IAAI,cAAc,sBAAsB;AAC7C,YAAI,UAAU,WAAW;AACvB,gBAAM,KAAK,uBAAuB,UAAU;AAAA,QAC9C;AAAA,MACF;AAEA,UAAI,SAAS,SAAS,GAAG;AACvB,gBAAQ,eAAe,SAAS,KAAK,IAAI,CAAC,EAAE;AAAA,MAC9C;AAAA,IACF,SAAS,OAAO;AACd,WAAK,IAAI,eAAe,qBAAqB;AAC7C,WAAK,YAAY,KAAK;AAAA,IACxB;AAEA,UAAM,KAAK,mBAAmB,QAAQ,GAAG;AAEzC,SAAK,IAAI,EAAE;AACX,SAAK,WAAW,GAAG,KAAK,oBAAoB;AAC5C,SAAK,IAAI,EAAE;AAEX,WAAO;AAAA,EACT;AACF;AA8BA,SAAS,mBACP,eACA,KACA,WACe;AACf,QAAM,EAAE,YAAY,OAAO,IAAI;AAE/B,MAAI,cAAc,SAAS;AACzB,WAAO;AAAA,MACL;AAAA,QACE,OAAO;AAAA,QACP,YAAY;AAAA,QACZ,cAAc,cAAc;AAAA,QAC5B;AAAA,QACA;AAAA,QACA,GAAI,cAAc,WAAW,EAAE,aAAa,UAAmB;AAAA,MACjE;AAAA,IACF;AAAA,EACF;AAEA,MAAI,cAAc,QAAQ;AACxB,WAAO;AAAA,MACL;AAAA,QACE,OAAO;AAAA,QACP,YAAY,GAAG,QAAQ;AAAA,QACvB,cAAc,cAAc;AAAA,QAC5B;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,CAAC;AACV;AAUA,SAAS,2BAA2B,QAAiD;AACnF,QAAM,QAAQ,OAAO,SAAS,CAAC;AAC/B,QAAM,mBAAmB,OAAO,OAC7B,OAAO,CAAC,UAAU,WAAW,OAAO,QAAQ,CAAC,EAC7C,IAAI,CAAC,UAAU,MAAM,IAAI;AAC5B,QAAM,mBAAmB;AAAA,IACvB,OAAO,OAAO,OAAO,CAAC,UAAU,WAAW,OAAO,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,MAAM,EAAE;AAAA,EACvF;AAEA,SAAO,iBACJ,IAAI,CAAC,YAAoC;AAAA,IACxC;AAAA,IACA,iBAAiB,OAAO,CAAC,cAAc,kBAAkB,MAAM,SAAS,GAAG,OAAO,CAAC;AAAA,EACrF,CAAC,EACA,OAAO,CAAC,CAAC,EAAE,UAAU,MAAM,WAAW,SAAS,CAAC;AACrD;AAGA,SAAS,kBAAkB,YAA0C,SAA2B;AAC9F,MAAI,CAAC,WAAY,QAAO;AACxB,SAAO,2BAA2B,UAAU,EAAE,KAAK,CAAC,QAAQ,IAAI,OAAO,OAAO;AAChF;AAEA,SAAS,uBAAuB,QAAkC;AAChE,QAAM,EAAE,iBAAiB,iBAAiB,IAAI;AAC9C,QAAM,aAAa,kBAAkB;AAErC,MAAI,mBAAmB,KAAK,aAAa,GAAG;AAC1C,WAAO,cAAc,eAAe,YAAY,gBAAgB,kBAAkB,UAAU;AAAA,EAC9F;AAEA,SAAO,mBAAmB,IACtB,cAAc,gBAAgB,yBAC9B,cAAc,eAAe;AACnC;","names":[]}
+{"version":3,"sources":["../../src/cli/commands/compile.ts"],"sourcesContent":["import { Flags } from \"@oclif/core\";\nimport os from \"os\";\nimport { unique } from \"remeda\";\nimport { BaseCommand } from \"../base-command\";\nimport { setVerbose, verbose } from \"../utils/logger\";\nimport {\n  detectBothInstallations,\n  type BothInstallations,\n  loadAgentDefs,\n  type AgentDefs,\n  compileAgents,\n  discoverInstalledSkills,\n  type DiscoveredSkills,\n} from \"../lib/operations\";\nimport {\n  ConfigLoadError,\n  effectivelyExcludedSkillIds,\n  isActiveAt,\n  loadProjectConfig,\n  loadProjectConfigFromDir,\n  resolveSource,\n} from \"../lib/configuration\";\nimport { getStackSkillIds, resolveAgentConfigToSkills } from \"../lib/stacks\";\nimport { loadSkillsMatrixFromSource, type UnusableSkillMetadata } from \"../lib/loading\";\nimport { STANDARD_FILES } from \"../consts\";\nimport { EXIT_CODES } from \"../lib/exit-codes\";\nimport { getErrorMessage } from \"../utils/errors\";\nimport {\n  ERROR_MESSAGES,\n  STATUS_MESSAGES,\n  INFO_MESSAGES,\n  configTypesRefreshFailed,\n  globalScopedAgentsHint,\n  recompileSummary,\n  registeredProjectUpdateSkipped,\n  scopeBlockedStackAssignment,\n  skillMetadataUnusableDetail,\n  skillMetadataUnusableError,\n} from \"../utils/messages\";\nimport { reconcileTypesFromDisk, type GateReport } from \"../lib/config-gate/index.js\";\nimport type { Installation } from \"../lib/installation\";\nimport type { SkillScope } from \"../types/config\";\nimport type {\n  AgentDefinition,\n  AgentName,\n  ProjectConfig,\n  SkillDefinitionMap,\n  SkillId,\n  StackAgentConfig,\n} from \"../types\";\n\nexport default class Compile extends BaseCommand {\n  static summary = \"Compile agents using local skills and agent definitions\";\n\n  static description =\n    \"Compile agents with resolved skill references. Compiles to the Claude plugin directory.\";\n\n  static examples = [\n    \"<%= config.bin %> <%= command.id %>\",\n    \"<%= config.bin %> <%= command.id %> --verbose\",\n  ];\n\n  static flags = {\n    verbose: Flags.boolean({\n      char: \"v\",\n      description: \"Enable verbose logging\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { flags } = await this.parse(Compile);\n    setVerbose(flags.verbose);\n    const cwd = process.cwd();\n\n    const installations = await this.detectInstallations(cwd);\n    await this.resolveAndLogSource(cwd);\n    const agentDefs = await this.loadAgentDefsOrFail();\n    await this.runCompilePasses(installations, agentDefs, cwd);\n  }\n\n  private async detectInstallations(cwd: string): Promise<BothInstallations> {\n    let installations: BothInstallations;\n    try {\n      installations = await detectBothInstallations(cwd);\n    } catch (error) {\n      // A corrupt config (file present but unparseable) must not let compile run\n      // config-less — that resurrects every deselected agent. Hard-error naming\n      // the offending file before any compilation happens.\n      if (error instanceof ConfigLoadError) {\n        this.error(error.message, { exit: EXIT_CODES.ERROR });\n      }\n      throw error;\n    }\n\n    if (!installations.global && !installations.project) {\n      this.error(ERROR_MESSAGES.NO_INSTALLATION, {\n        exit: EXIT_CODES.ERROR,\n      });\n    }\n\n    return installations;\n  }\n\n  /**\n   * Names where the marketplace came from — the project's own config first, then the global\n   * one, then the default. `compile` takes no `--marketplace`: it recompiles an installation\n   * that already recorded which marketplace its skill references answer to, and reading\n   * a different one would write agents against a catalogue config.ts does not name.\n   */\n  private async resolveAndLogSource(projectDir: string): Promise<void> {\n    this.log(STATUS_MESSAGES.RESOLVING_SOURCE);\n    try {\n      // ABORT on an unreadable config, and unreachable with one: `detectInstallation` reads the\n      // same file first and already hard-errors, at both scopes — verified by hand at both.\n      // The posture is recorded anyway, because what makes it unreachable is a guard in another\n      // command's private helper rather than anything visible from here.\n      const sourceConfig = await resolveSource({ caller: \"stored\", projectDir });\n      this.log(`Marketplace: ${sourceConfig.sourceOrigin}`);\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_RESOLVE_SOURCE);\n      this.handleError(error);\n    }\n  }\n\n  private async loadAgentDefsOrFail(): Promise<AgentDefs> {\n    this.log(STATUS_MESSAGES.LOADING_AGENT_PARTIALS);\n    try {\n      const defs = await loadAgentDefs();\n      this.log(\"Agent partials loaded\");\n      verbose(`  Agents: ${defs.agentSourcePaths.agentsDir}`);\n      return defs;\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_LOAD_AGENT_PARTIALS);\n      this.handleError(error);\n    }\n  }\n\n  private async runCompilePasses(\n    installations: BothInstallations,\n    agentDefs: AgentDefs,\n    cwd: string,\n  ): Promise<void> {\n    const passes = buildCompilePasses(installations, cwd, agentDefs);\n\n    let totalPassesWithSkills = 0;\n    for (const pass of passes) {\n      const hadSkills = await this.runCompilePass(pass, cwd);\n      if (hadSkills) totalPassesWithSkills++;\n    }\n\n    if (totalPassesWithSkills === 0) {\n      this.error(ERROR_MESSAGES.NO_SKILLS_TO_COMPILE, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  /**\n   * Discovers what this pass compiles from, and refuses the run when any installed\n   * skill's metadata.yaml exists but describes no skill — before a count is printed,\n   * an agent is written or the type unions are regenerated. Skipping such a skill is\n   * what the config-types pass already does; loading it anyway is what this pass\n   * used to do, so a single run both loaded and skipped the same file.\n   */\n  private async discoverAllSkills(projectDir: string): Promise<DiscoveredSkills> {\n    this.log(STATUS_MESSAGES.DISCOVERING_SKILLS);\n    const result = await discoverInstalledSkills(projectDir);\n    if (result.unusableMetadata.length > 0) {\n      this.refuseUnusableSkillMetadata(result.unusableMetadata);\n    }\n    if (result.totalSkillCount === 0) return result;\n    this.log(formatDiscoveryMessage(result));\n    return result;\n  }\n\n  /**\n   * Names each offending file and its reason, then exits. The detail is LOGGED and\n   * only the refusal is raised: oclif hard-wraps error text at the terminal width,\n   * and a path broken across two lines is one nobody can copy.\n   */\n  private refuseUnusableSkillMetadata(entries: UnusableSkillMetadata[]): never {\n    for (const entry of entries) {\n      this.log(skillMetadataUnusableDetail(entry));\n    }\n    this.error(skillMetadataUnusableError(entries), { exit: EXIT_CODES.ERROR });\n  }\n\n  /**\n   * A stack skill that is not among the discovered skills is dropped from every\n   * agent that references it. The resolver only records that at verbose level, so\n   * the default output would claim a successful recompile of an agent that no\n   * longer matches config.ts. Name each dropped skill instead.\n   */\n  private async warnUnresolvedStackSkills(\n    projectDir: string,\n    allSkills: SkillDefinitionMap,\n  ): Promise<void> {\n    const loaded = await loadProjectConfig(projectDir);\n    if (!loaded?.config.stack) return;\n\n    const excludedIds = effectivelyExcludedSkillIds(loaded.config.skills);\n    const unresolved = getStackSkillIds(loaded.config.stack).filter(\n      (id) => !excludedIds.has(id) && !(id in allSkills),\n    );\n\n    for (const id of unresolved) {\n      this.warn(\n        `Skill '${id}' is configured but was not found — agents will be compiled without it.`,\n      );\n    }\n  }\n\n  /**\n   * `config.ts` is the hand-editable half of the pair, so it can declare a pair the scope\n   * rule forbids: a GLOBAL sub-agent whose stack carries a PROJECT-scoped skill. The\n   * compile-time filter in `buildCompileAgents` drops that reference on the way to the\n   * resolver and `compile` rewrites nothing in `config.ts`, so the row survives and is\n   * dropped again on every future run — while the recompile summary reports a clean pass\n   * over an agent that no longer carries what its own config says it does.\n   *\n   * The sibling of {@link warnUnresolvedStackSkills} one layer over: there the skill is\n   * missing from disk, here it is present and unreachable from that sub-agent.\n   */\n  private async warnScopeDroppedStackPairs(projectDir: string): Promise<void> {\n    const loaded = await loadProjectConfig(projectDir);\n    if (!loaded?.config.stack) return;\n\n    for (const [skillId, agentNames] of findScopeDroppedStackPairs(loaded.config)) {\n      this.warn(scopeBlockedStackAssignment(agentNames, skillId));\n    }\n  }\n\n  /**\n   * The project pass compiled no agents, but the project config may still declare\n   * global-scope agents whose stack lives in the global config. Without a pointer\n   * the \"No agents to recompile\" line reads as a silent no-op after a global stack\n   * change, so name the global context and the count.\n   */\n  private async hintGlobalScopedAgents(projectDir: string): Promise<void> {\n    const loaded = await loadProjectConfigFromDir(projectDir);\n    if (!loaded) return;\n\n    const globalAgentCount = loaded.config.agents.filter(\n      (agent) => !agent.excluded && agent.scope === \"global\",\n    ).length;\n    if (globalAgentCount === 0) return;\n\n    this.log(globalScopedAgentsHint(globalAgentCount));\n  }\n\n  /**\n   * The documented hand-edit workflow is \"edit config.ts, then run compile\", and\n   * the type unions in config-types.ts are derived from config.ts — so a compile\n   * pass that leaves them untouched strands stale unions after a hand-edit.\n   * Regenerates them from the scope's persisted config exactly as the wizard\n   * write path would: standalone narrowed unions at global scope, import-and-\n   * extend at project scope. `matrixOnly` keeps the default-source path offline.\n   * A failed refresh downgrades to a warning — the compiled agents are already\n   * written and remain valid; only the type unions may still be stale.\n   *\n   * `skipExtraSources: true` is NOT a divergence from the wizard's full\n   * multi-source load: extra-source loading only annotates each skill's\n   * `availableSources`/`activeSource` for wizard UI tagging — it never adds\n   * skills or categories to the matrix, and the config-types writer never reads\n   * those annotations, so the emitted types are byte-identical either way\n   * (pinned by the skipExtraSources parity test in local-installer.test.ts).\n   * Skipping avoids fetching every registered extra source (network on a cold\n   * cache, plus unreachable-remote warnings) on this offline compile path.\n   */\n  private async refreshConfigTypes(pass: CompilePass, cwd: string): Promise<void> {\n    let report: GateReport;\n    try {\n      const loaded = await loadProjectConfigFromDir(pass.projectDir);\n      if (!loaded) {\n        verbose(\n          `No config found at ${pass.projectDir} — skipping ${STANDARD_FILES.CONFIG_TYPES_TS} refresh`,\n        );\n        return;\n      }\n\n      const { matrix } = await loadSkillsMatrixFromSource({\n        projectDir: pass.projectDir,\n        skipExtraSources: true,\n        matrixOnly: true,\n      });\n      // `cwd` is excluded from the fan-out, which only a global pass can perform:\n      // whatever this invocation was run from is this command's own subject, so a\n      // fan-out must never reach back into it.\n      report = await reconcileTypesFromDisk(\n        pass.projectDir,\n        loaded.config,\n        { matrix, agents: pass.agents },\n        { currentProjectDir: cwd },\n      );\n      this.log(INFO_MESSAGES.CONFIG_TYPES_REFRESHED);\n    } catch (error) {\n      this.warn(configTypesRefreshFailed(getErrorMessage(error)));\n      return;\n    }\n\n    this.reportPropagation(report);\n  }\n\n  /**\n   * Renders the fan-out the refresh above performed. Kept out of the refresh's\n   * catch on purpose: a project the fan-out could not reach is reported as that,\n   * not as a failure to refresh the type unions — which did succeed.\n   */\n  private reportPropagation(report: GateReport): void {\n    for (const skippedPath of report.propagated.skipped) {\n      this.warn(registeredProjectUpdateSkipped(skippedPath));\n    }\n    this.reportPropagatedRecompile(report);\n  }\n\n  private async runCompilePass(params: CompilePass, cwd: string): Promise<boolean> {\n    const { label, projectDir, installation, sourcePath, scopeFilter } = params;\n\n    this.log(\"\");\n    this.log(`Compiling ${label.toLowerCase()} agents...`);\n    this.log(\"\");\n\n    verbose(`  Project: ${projectDir}`);\n    verbose(`  Agents: ${installation.agentsDir}`);\n\n    const { allSkills, totalSkillCount } = await this.discoverAllSkills(projectDir);\n\n    if (totalSkillCount === 0) {\n      this.log(`No skills found for ${label.toLowerCase()} pass, skipping`);\n      // The config loads independently of discovered skills: a hand-edited\n      // config.ts can list skills while nothing is installed for this scope,\n      // and its type unions must follow the config rather than stay stale.\n      await this.refreshConfigTypes(params, cwd);\n      return false;\n    }\n\n    await this.warnUnresolvedStackSkills(projectDir, allSkills);\n    await this.warnScopeDroppedStackPairs(projectDir);\n\n    this.log(STATUS_MESSAGES.RECOMPILING_AGENTS);\n    try {\n      const recompileResult = await compileAgents({\n        projectDir,\n        sourcePath,\n        skills: allSkills,\n        pluginDir: projectDir,\n        outputDir: installation.agentsDir,\n        ...(scopeFilter !== undefined && { scopeFilter }),\n      });\n\n      const { compiled, rewritten, failed, warnings } = recompileResult;\n      const summary = recompileSummary(\n        rewritten.length,\n        compiled.length - rewritten.length,\n        `${label.toLowerCase()} agents`,\n      );\n\n      if (failed.length > 0) {\n        this.log(`${summary} (${failed.length} failed)`);\n        for (const warning of warnings) {\n          this.warn(warning);\n        }\n      } else if (compiled.length > 0) {\n        this.log(summary);\n      } else {\n        this.log(INFO_MESSAGES.NO_AGENTS_TO_RECOMPILE);\n        if (label === \"Project\") {\n          await this.hintGlobalScopedAgents(projectDir);\n        }\n      }\n\n      if (compiled.length > 0) {\n        verbose(`  Compiled: ${compiled.join(\", \")}`);\n      }\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_COMPILE_AGENTS);\n      this.handleError(error);\n    }\n\n    await this.refreshConfigTypes(params, cwd);\n\n    this.log(\"\");\n    this.logSuccess(`${label} compile complete!`);\n    this.log(\"\");\n\n    return true;\n  }\n}\n\ntype CompilePass = {\n  label: \"Global\" | \"Project\";\n  projectDir: string;\n  installation: Installation;\n  sourcePath: string;\n  agents: Partial<Record<AgentName, AgentDefinition>>;\n  scopeFilter?: SkillScope;\n};\n\n/**\n * The single pass this invocation owns.\n *\n * A compile run inside a project is a PROJECT-scope operation and writes nothing\n * outside that project: it compiles the project's own agents and refreshes the\n * project's own type unions, and never the global install's or another\n * registered project's. Propagation is a global operation's consequence — the\n * global config is what every project's config inlines — and a project compile\n * is not one.\n *\n * The global pass is therefore reached only where no project installation is in\n * play: at the home directory (where `detectBothInstallations` returns no\n * project by construction), or in a directory that has no config of its own, so\n * the global install is the only thing there is to compile.\n *\n * `scopeFilter` still narrows the project pass whenever both installations\n * exist: the project's config inlines the global entries, so an unfiltered pass\n * would compile global-scoped agents into the project's own agents directory.\n */\nfunction buildCompilePasses(\n  installations: BothInstallations,\n  cwd: string,\n  agentDefs: AgentDefs,\n): CompilePass[] {\n  const { sourcePath, agents } = agentDefs;\n\n  if (installations.project) {\n    return [\n      {\n        label: \"Project\",\n        projectDir: cwd,\n        installation: installations.project,\n        sourcePath,\n        agents,\n        ...(installations.hasBoth && { scopeFilter: \"project\" as const }),\n      },\n    ];\n  }\n\n  if (installations.global) {\n    return [\n      {\n        label: \"Global\",\n        projectDir: os.homedir(),\n        installation: installations.global,\n        sourcePath,\n        agents,\n      },\n    ];\n  }\n\n  return [];\n}\n\n/**\n * Every project-scoped skill that a GLOBAL sub-agent's stack assigns to itself, with the\n * sub-agents that assign it — exactly the pairs `buildCompileAgents`' scope filter drops on\n * the way to the resolver.\n *\n * Grouped by skill rather than emitted per pair, so one sentence accounts for every\n * sub-agent one skill was kept away from.\n */\nfunction findScopeDroppedStackPairs(config: ProjectConfig): [SkillId, AgentName[]][] {\n  const stack = config.stack ?? {};\n  const globalAgentNames = config.agents\n    .filter((agent) => isActiveAt(agent, \"global\"))\n    .map((agent) => agent.name);\n  const projectScopedIds = unique(\n    config.skills.filter((skill) => isActiveAt(skill, \"project\")).map((skill) => skill.id),\n  );\n\n  return projectScopedIds\n    .map((skillId): [SkillId, AgentName[]] => [\n      skillId,\n      globalAgentNames.filter((agentName) => stackAssignsSkill(stack[agentName], skillId)),\n    ])\n    .filter(([, agentNames]) => agentNames.length > 0);\n}\n\n/** True when this sub-agent's stack names the skill, in any of its categories. */\nfunction stackAssignsSkill(agentStack: StackAgentConfig | undefined, skillId: SkillId): boolean {\n  if (!agentStack) return false;\n  return resolveAgentConfigToSkills(agentStack).some((ref) => ref.id === skillId);\n}\n\nfunction formatDiscoveryMessage(result: DiscoveredSkills): string {\n  const { totalSkillCount, pluginSkillCount } = result;\n  const localCount = totalSkillCount - pluginSkillCount;\n\n  if (pluginSkillCount > 0 && localCount > 0) {\n    return `Discovered ${totalSkillCount} skills (${pluginSkillCount} from plugins, ${localCount} local)`;\n  }\n\n  return pluginSkillCount > 0\n    ? `Discovered ${pluginSkillCount} skills from plugins`\n    : `Discovered ${totalSkillCount} local skills`;\n}\n"],"mappings":"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","names":[]}

package/dist/commands/doctor.js

@@ -2,78 +2,75 @@
 import {
   detectProject,
   loadSource
-} from "../chunk-WUQ3MTPF.js";
-import "../chunk-5QZAK6J7.js";
-import "../chunk-MHRC3KRX.js";
-import "../chunk-F2AMBBIA.js";
+} from "../chunk-H2DHTJKW.js";
+import "../chunk-H25VRR2T.js";
+import "../chunk-H4CL23HG.js";
 import {
   filterExcludedEntries,
   listAgentMdFiles,
   splitAgentsByProvenance
-} from "../chunk-ZUAZHDKP.js";
+} from "../chunk-WMVOJY6V.js";
 import {
   BaseCommand,
   EXIT_CODES
-} from "../chunk-YO2LTXB4.js";
-import "../chunk-UMH2YZKG.js";
-import "../chunk-G47TDUK3.js";
+} from "../chunk-X52QUV4U.js";
+import "../chunk-TPQ5M3BW.js";
+import "../chunk-QNAMXQKF.js";
 import {
   ConfigDefaultExportError,
+  MarketplaceNameRefusedError,
+  SOURCE_ENV_VAR,
+  agentYamlGenerationSchema,
   checkMatrixHealth,
   configDirsInPlay,
   declaresNoContent,
+  directoryExists,
   discoverLocalSkills,
   effectivelyExcludedSkillIds,
+  fileExists,
   findConfigLoadFailures,
+  formatZodErrors,
+  getErrorMessage,
   getInstalledPluginsRegistryPath,
   getProjectConfigPath,
   getProjectPluginsDir,
   getStackSkillIds,
   getUserPluginsDir,
   getVerifiedPluginInstallPaths,
+  glob,
   installBaseDir,
   isHomeDirectory,
   isLocalSource,
+  isRecord,
+  listDirectories,
   listRegisteredPluginInstalls,
   loadConfig,
   loadProjectConfigFromDir,
   loadProjectSourceConfig,
   loadSkillsMatrixFromSource,
-  parseMarketplacePluginRef,
-  readForkedFromMetadata,
-  resolveInstallPaths,
-  resolvePrimarySourceEntry,
-  validateAgentFrontmatter,
-  validateAllPlugins,
-  validatePlugin,
-  validateProjectConfig,
-  validateSkillFrontmatter
-} from "../chunk-WCAUUBHO.js";
-import {
-  agentYamlGenerationSchema,
-  directoryExists,
-  fileExists,
-  formatZodErrors,
-  getErrorMessage,
-  glob,
-  isRecord,
-  listDirectories,
   metadataValidationSchema,
   parseFrontmatter,
+  parseMarketplacePluginRef,
   readFile,
+  readForkedFromMetadata,
   readSkillMetadata,
-  setVerbose,
+  resolveInstallPaths,
+  resolvePrimarySourceEntry,
   skillCategoriesFileSchema,
   skillRulesFileSchema,
   splitMetadataValidationIssues,
   stackConfigValidationSchema,
   stacksConfigSchema,
+  validateAgentFrontmatter,
+  validateAllPlugins,
+  validatePlugin,
+  validateProjectConfig,
+  validateSkillFrontmatter,
   validateSkillMetadata
-} from "../chunk-XAXJWXI4.js";
+} from "../chunk-3PJLLBUS.js";
 import {
   matrix
-} from "../chunk-RWOYPOMR.js";
-import "../chunk-VASLW636.js";
+} from "../chunk-7Z4N4JWQ.js";
 import {
   CLAUDE_SRC_DIR,
   CLI_INVOKE_COMMAND,
@@ -81,6 +78,7 @@ import {
   DIRS,
   EJECT_SOURCE,
   LOCAL_SKILLS_PATH,
+  MARKETPLACE_JSON,
   PLUGIN_MANIFEST_DIR,
   SKILLS_DIR_PATH,
   SKILL_CATEGORIES_PATH,
@@ -88,7 +86,7 @@ import {
   STACKS_FILE_PATH,
   STANDARD_FILES,
   UI_SYMBOLS
-} from "../chunk-IO5YBKHV.js";
+} from "../chunk-G6G2FT2G.js";
 import "../chunk-VZRO7RYT.js";
 
 // src/cli/commands/doctor.ts
@@ -230,6 +228,7 @@ function checkMetadataSchema(rawMetadata, relPath) {
     ...warnings.map((message) => ({ severity: "warning", file: relPath, message }))
   ];
 }
+var MARKETPLACE_MANIFEST_PATH = path.join(PLUGIN_MANIFEST_DIR, MARKETPLACE_JSON);
 async function checkCrossReferences(resolvedPath, reader) {
   try {
     await loadSkillsMatrixFromSource({ sourceFlag: resolvedPath, skipExtraSources: true });
@@ -237,15 +236,23 @@ async function checkCrossReferences(resolvedPath, reader) {
       (healthIssue) => toSourceIssue(healthIssue, resolvedPath, reader)
     );
   } catch (error) {
-    return [
-      {
-        severity: "warning",
-        file: SKILL_CATEGORIES_PATH,
-        message: `Cross-reference validation skipped: failed to load categories/rules: ${getErrorMessage(error)}`
-      }
-    ];
+    return [matrixLoadFailure(error)];
   }
 }
+function matrixLoadFailure(error) {
+  if (error instanceof MarketplaceNameRefusedError) {
+    return {
+      severity: "error",
+      file: MARKETPLACE_MANIFEST_PATH,
+      message: getErrorMessage(error)
+    };
+  }
+  return {
+    severity: "warning",
+    file: SKILL_CATEGORIES_PATH,
+    message: `Cross-reference validation skipped: failed to load categories/rules: ${getErrorMessage(error)}`
+  };
+}
 var SKILL_AUDIT_PATH = "src/cli/lib/configuration/skill-audit.ts";
 function fileHoldingDefect(finding) {
   switch (finding) {
@@ -931,19 +938,34 @@ async function checkPluginSkillsInstalled(config, projectDir) {
     message: `${pluginSkills.length}/${pluginSkills.length} plugin-mode skills installed`
   };
 }
+var MARKETPLACE_CHOSEN_BY = {
+  flag: "named by this run",
+  env: `named by ${SOURCE_ENV_VAR}`,
+  project: "named by this project's configuration",
+  global: "named by the global configuration",
+  default: "nothing here names one, so this is the default"
+};
+function howItWasReached(source, isLocal) {
+  return isLocal ? `Read ${source} from disk` : `Fetched ${source} over the network`;
+}
+function reachedMarketplace(result) {
+  const { source, sourceOrigin } = result.sourceConfig;
+  const skillCount = Object.keys(matrix.skills).length;
+  const sourceLabel = result.isLocal ? "local" : "remote";
+  return {
+    kind: "source",
+    status: "pass",
+    message: `Connected to ${sourceLabel}: ${result.sourcePath}`,
+    details: [
+      `${plural(skillCount, "skill")} available`,
+      `${howItWasReached(source, result.isLocal)} \u2014 ${MARKETPLACE_CHOSEN_BY[sourceOrigin]}`
+    ]
+  };
+}
 async function checkSourceReachable(projectDir) {
   try {
-    const { sourceResult: result } = await loadSource({
-      projectDir
-    });
-    const skillCount = Object.keys(matrix.skills).length;
-    const sourceLabel = result.isLocal ? "local" : "remote";
-    return {
-      kind: "source",
-      status: "pass",
-      message: `Connected to ${sourceLabel}: ${result.sourcePath}`,
-      details: [`${skillCount} skills available`]
-    };
+    const { sourceResult } = await loadSource({ projectDir });
+    return reachedMarketplace(sourceResult);
   } catch (error) {
     const message = getErrorMessage(error);
     return {
@@ -1175,9 +1197,8 @@ var Doctor = class _Doctor extends BaseCommand {
   static flags = {};
   async run() {
     await this.parse(_Doctor);
-    setVerbose(true);
     const projectDir = process.cwd();
-    this.printHeader();
+    this.printHeader(await this.resolveBrandingName(projectDir));
     const contentResults = await this.runContentChecks(projectDir);
     const operationalResults = await this.runOperationalChecks(projectDir, contentResults);
     const results = [...contentResults, ...operationalResults];
@@ -1186,9 +1207,9 @@ var Doctor = class _Doctor extends BaseCommand {
       this.exit(EXIT_CODES.ERROR);
     }
   }
-  printHeader() {
+  printHeader(brandingName) {
     this.log("");
-    this.log(`${DEFAULT_BRANDING.NAME} Doctor`);
+    this.log(`${brandingName} Doctor`);
     this.log("");
     this.log(`${SECTION_INDENT}Checking configuration health...`);
     this.log("");