agents-inc 0.174.0 → 0.176.0

package/dist/commands/compile.js

@@ -1,32 +1,33 @@
 #!/usr/bin/env node
 import {
   unofferablePlacementsFound
-} from "../chunk-ECPFYHDX.js";
+} from "../chunk-ZBI6GFJD.js";
 import {
   hostCompileNotices
-} from "../chunk-6PGXTLA4.js";
+} from "../chunk-U672FZVC.js";
 import {
   detectBothInstallations,
   reconcileTypesFromDisk
-} from "../chunk-R7GKQBZJ.js";
+} from "../chunk-CKBWEWHZ.js";
 import {
   compileAgents,
   discoverInstalledSkills
-} from "../chunk-REHVGFJE.js";
+} from "../chunk-XMQIWPIR.js";
 import {
   loadAgentDefs
-} from "../chunk-7BHDKEGK.js";
-import "../chunk-IXVGBUWI.js";
-import "../chunk-EFXVYQGT.js";
+} from "../chunk-JNRACLNS.js";
+import "../chunk-EC3JXT23.js";
+import "../chunk-MQZNDK5F.js";
 import {
+  BaseCommand,
+  EXIT_CODES,
   providerFlag,
   providerNamedBy,
   refuseAnAmbiguousInstallation
-} from "../chunk-ORO2T4K2.js";
+} from "../chunk-JTMSFBCA.js";
 import {
-  BaseCommand,
-  EXIT_CODES
-} from "../chunk-IAQFZFWD.js";
+  namedByActiveEntries
+} from "../chunk-FACDJH6O.js";
 import {
   ConfigLoadError,
   ERROR_MESSAGES,
@@ -49,15 +50,15 @@ import {
   skillMetadataUnusableDetail,
   skillMetadataUnusableError,
   verbose
-} from "../chunk-E45IT3HC.js";
+} from "../chunk-ENET4IF6.js";
 import {
   plural
-} from "../chunk-AIBVAYHS.js";
+} from "../chunk-UE4Z3YMB.js";
 import {
   STANDARD_FILES,
   effectivelyExcludedSkillIds,
   isActiveAt
-} from "../chunk-WUSEZFER.js";
+} from "../chunk-U46LYYRA.js";
 import "../chunk-GHHJYNAN.js";
 
 // src/cli/commands/compile.ts
@@ -83,10 +84,12 @@ var Compile = class _Compile extends BaseCommand {
     const { flags } = await this.parse(_Compile);
     setVerbose(flags.verbose);
     const cwd = process.cwd();
+    const namedProvider = providerNamedBy(flags.provider);
+    await this.sayWhenTheGlobalInstallationStandsIn(namedProvider);
     await refuseAnAmbiguousInstallation(
       cwd,
       "compile",
-      providerNamedBy(flags.provider),
+      namedProvider,
       (message) => this.error(message, { exit: EXIT_CODES.INVALID_ARGS })
     );
     await this.ensureConfigReadable(cwd);
@@ -202,8 +205,9 @@ var Compile = class _Compile extends BaseCommand {
   async warnScopeDroppedStackPairs(projectDir) {
     const loaded = await loadProjectConfig(projectDir);
     if (!loaded?.config.stack) return;
+    const namedBy = namedByActiveEntries(loaded.config.skills);
     for (const [skillId, agentNames] of findScopeDroppedStackPairs(loaded.config)) {
-      this.warn(scopeBlockedStackAssignment(agentNames, skillId));
+      this.warn(scopeBlockedStackAssignment(agentNames, skillId, namedBy));
     }
   }
   /** Points at global-scope agents so "No agents to recompile" doesn't read as a silent no-op. */

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  type CompilationResult,\n  discoverInstalledSkills,\n  type DiscoveredSkills,\n} from \"../lib/operations\";\nimport {\n  ConfigLoadError,\n  effectivelyExcludedSkillIds,\n  isActiveAt,\n  loadProjectConfig,\n  loadInstalledConfig,\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 { plural } from \"../utils/string\";\nimport {\n  ERROR_MESSAGES,\n  STATUS_MESSAGES,\n  INFO_MESSAGES,\n  configTypesRefreshFailed,\n  globalScopedAgentsHint,\n  recompileSummary,\n  registeredProjectUpdateFailed,\n  scopeBlockedStackAssignment,\n  skillMetadataUnusableDetail,\n  skillMetadataUnusableError,\n} from \"../utils/messages\";\nimport { reconcileTypesFromDisk, type GateReport } from \"../lib/config-gate/index.js\";\nimport { unofferablePlacementsFound } from \"../lib/hosts/configured-placements.js\";\nimport { providerInUse } from \"../lib/installation/install-layout.js\";\nimport {\n  providerFlag,\n  providerNamedBy,\n  refuseAnAmbiguousInstallation,\n} from \"../lib/installation/provider-flag.js\";\nimport { hostCompileNotices } from \"../lib/hosts/host-compile-notices.js\";\nimport type { Installation } from \"../lib/installation\";\nimport type { SkillScope } from \"../types/config\";\nimport type {\n  AgentDefinition,\n  AgentName,\n  MergedSkillsMatrix,\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    provider: providerFlag(),\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    // First: `providerInUse` below picks by roster order when a scope holds both providers.\n    await refuseAnAmbiguousInstallation(\n      cwd,\n      \"compile\",\n      providerNamedBy(flags.provider),\n      (message) => this.error(message, { exit: EXIT_CODES.INVALID_ARGS }),\n    );\n    await this.ensureConfigReadable(cwd);\n    const installations = await this.detectInstallations(cwd);\n    await this.refuseUnofferablePlacements(cwd);\n    await this.resolveAndLogSource(cwd);\n    const agentDefs = await this.loadAgentDefsOrFail();\n    await this.runCompilePasses(installations, agentDefs, cwd);\n    await this.reportWhatThisHostCannotCarry(installations, cwd);\n  }\n\n  /** Runs after the passes, so the trust notice describes the tree this run wrote. */\n  private async reportWhatThisHostCannotCarry(\n    installations: BothInstallations,\n    cwd: string,\n  ): Promise<void> {\n    const root = rootThisRunCompiled(installations, cwd);\n\n    for (const notice of await hostCompileNotices(providerInUse(root), cwd)) {\n      this.log(notice);\n    }\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      // Compiling config-less would resurrect every deselected agent.\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   * Re-checked here because config.ts names no provider, so a copied installation folder can hold\n   * a configuration its host never vetted at install.\n   */\n  private async refuseUnofferablePlacements(cwd: string): Promise<void> {\n    const [finding] = await unofferablePlacementsFound(cwd);\n    if (finding !== undefined) this.error(finding, { exit: EXIT_CODES.ERROR });\n  }\n\n  /** No `--marketplace`: an installation recompiles against the marketplace config.ts recorded. */\n  private async resolveAndLogSource(projectDir: string): Promise<void> {\n    this.log(STATUS_MESSAGES.RESOLVING_SOURCE);\n    try {\n      // ABORT on an unreadable config (already refused earlier by `detectInstallations`).\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 passesCompiled = 0;\n    for (const pass of passes) {\n      const compiled = await this.runCompilePass(pass, cwd);\n      if (compiled) passesCompiled++;\n    }\n\n    if (passesCompiled === 0) {\n      this.error(ERROR_MESSAGES.NO_SKILLS_TO_COMPILE, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  /** Refuses the run, before anything is written, when an installed skill's metadata is unusable. */\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  /** Detail is logged, not raised: oclif hard-wraps error text, which breaks copyable paths. */\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  /** The resolver drops a missing stack skill silently except at verbose level. */\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   * A hand-edited config.ts can give a global sub-agent a project-scoped skill, which the compile\n   * filter silently drops on every run.\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  /** Points at global-scope agents so \"No agents to recompile\" doesn't read as a silent no-op. */\n  private async hintGlobalScopedAgents(projectDir: string): Promise<void> {\n    const loaded = await loadInstalledConfig(projectDir);\n    if (!loaded) return;\n\n    const globalAgentCount = loaded.config.agents.filter((agent) =>\n      isActiveAt(agent, \"global\"),\n    ).length;\n    if (globalAgentCount === 0) return;\n\n    this.log(globalScopedAgentsHint(globalAgentCount));\n  }\n\n  /**\n   * Seats the matrix singleton the render reads (else local skills lose their stated usage), and\n   * returns it, `null` on failure: the render degrades, the type refresh skips. Extra sources only\n   * annotate skills, so skipping them keeps output identical and the path offline.\n   */\n  private async seatMatrixForPass(projectDir: string): Promise<MergedSkillsMatrix | null> {\n    try {\n      const { matrix: seated } = await loadSkillsMatrixFromSource({\n        projectDir,\n        skipExtraSources: true,\n        matrixOnly: true,\n      });\n      return seated;\n    } catch (error) {\n      this.warn(`Failed to load skills matrix for ${projectDir}: ${getErrorMessage(error)}`);\n      return null;\n    }\n  }\n\n  /**\n   * Regenerates config-types.ts after a hand-edit; failure only warns, as the agents are written.\n   * Skipped without a catalogue, since unions derived from none would be wrong, not just stale.\n   */\n  private async refreshConfigTypes(\n    pass: CompilePass,\n    cwd: string,\n    seatedMatrix: MergedSkillsMatrix | null,\n  ): Promise<void> {\n    if (!seatedMatrix) {\n      this.warn(\n        configTypesRefreshFailed(`no skills catalogue could be loaded for ${pass.projectDir}`),\n      );\n      return;\n    }\n\n    let report: GateReport;\n    try {\n      const loaded = await loadInstalledConfig(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      // A global pass's fan-out must not reach back into the invoking directory.\n      report = await reconcileTypesFromDisk(\n        pass.projectDir,\n        loaded.config,\n        { matrix: seatedMatrix, 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  /** Outside the refresh's catch: an unreachable project is not a failed refresh. */\n  private reportPropagation(report: GateReport): void {\n    this.reportProjectsOutOfReach(report.propagated);\n    for (const projectPath of report.propagated.failed) {\n      this.warn(registeredProjectUpdateFailed(projectPath));\n    }\n    this.reportFanOut(report);\n  }\n\n  private async runCompilePass(pass: CompilePass, cwd: string): Promise<boolean> {\n    const { projectDir } = pass;\n    this.announcePass(pass);\n\n    const seatedMatrix = await this.seatMatrixForPass(projectDir);\n    const { allSkills, totalSkillCount } = await this.discoverAllSkills(projectDir);\n    const compiles = await this.announceWhetherPassCompiles(pass, totalSkillCount);\n    // A skipped pass is a refused run, which writes nothing, config-types.ts included.\n    if (!compiles) return false;\n\n    await this.warnUnresolvedStackSkills(projectDir, allSkills);\n    await this.warnScopeDroppedStackPairs(projectDir);\n    await this.recompilePassAgents(pass, allSkills);\n    await this.refreshConfigTypes(pass, cwd, seatedMatrix);\n\n    this.log(\"\");\n    this.logSuccess(`${pass.label} compile complete!`);\n    this.log(\"\");\n    return true;\n  }\n\n  private announcePass({ label, projectDir, installation }: CompilePass): void {\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\n  /** A pass with no skills still compiles when its config declares base agents only. */\n  private async announceWhetherPassCompiles(\n    pass: CompilePass,\n    totalSkillCount: number,\n  ): Promise<boolean> {\n    if (totalSkillCount > 0) return true;\n\n    const passName = pass.label.toLowerCase();\n    if (await declaresOnlyBaseAgents(pass)) {\n      this.log(`No skills configured for ${passName} pass, compiling base agents`);\n      return true;\n    }\n\n    this.log(`No skills found for ${passName} pass, skipping`);\n    return false;\n  }\n\n  private async recompilePassAgents(pass: CompilePass, skills: SkillDefinitionMap): Promise<void> {\n    const { projectDir, installation, sourcePath, scopeFilter } = pass;\n\n    this.log(STATUS_MESSAGES.RECOMPILING_AGENTS);\n    try {\n      const recompileResult = await compileAgents({\n        projectDir,\n        sourcePath,\n        skills,\n        pluginDir: projectDir,\n        outputDir: installation.agentsDir,\n        ...(scopeFilter !== undefined && { scopeFilter }),\n      });\n      await this.reportRecompile(recompileResult, pass);\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_COMPILE_AGENTS);\n      this.handleError(error);\n    }\n  }\n\n  private async reportRecompile(\n    { compiled, rewritten, failed, warnings }: CompilationResult,\n    { label, projectDir }: CompilePass,\n  ): Promise<void> {\n    const summary = recompileSummary(\n      rewritten.length,\n      compiled.length - rewritten.length,\n      `${label.toLowerCase()} agent`,\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  }\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 * One pass: the project's when there is one (writing nothing outside it), else the global's.\n * `scopeFilter` keeps inlined global agents out of the project's 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/** Mirrors the root {@link buildCompilePasses} picks. */\nfunction rootThisRunCompiled(installations: BothInstallations, cwd: string): string {\n  return installations.project ? cwd : os.homedir();\n}\n\n/**\n * A skill-less pass still compiles a config of base agents only. One that declares skills none of\n * which are on disk lost them, and is skipped rather than recompiled without them.\n */\nasync function declaresOnlyBaseAgents(pass: CompilePass): Promise<boolean> {\n  const loaded = await loadInstalledConfig(pass.projectDir);\n  if (!loaded) return false;\n\n  const { skills, agents } = loaded.config;\n  const declaresASkill = skills.some((skill) => !skill.excluded);\n  const compilesAnAgent = agents.some((agent) =>\n    pass.scopeFilter === undefined ? !agent.excluded : isActiveAt(agent, pass.scopeFilter),\n  );\n  return !declaresASkill && compilesAnAgent;\n}\n\n/** Project-scoped skills a global sub-agent's stack names, grouped by skill. */\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\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 ${plural(totalSkillCount, \"skill\")} (${pluginSkillCount} from plugins, ${localCount} local)`;\n  }\n\n  return pluginSkillCount > 0\n    ? `Discovered ${plural(pluginSkillCount, \"skill\")} from plugins`\n    : `Discovered ${plural(totalSkillCount, \"local skill\")}`;\n}\n"],"mappings":"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","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  type CompilationResult,\n  discoverInstalledSkills,\n  type DiscoveredSkills,\n} from \"../lib/operations\";\nimport {\n  ConfigLoadError,\n  effectivelyExcludedSkillIds,\n  isActiveAt,\n  loadProjectConfig,\n  loadInstalledConfig,\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 { plural } from \"../utils/string\";\nimport {\n  ERROR_MESSAGES,\n  STATUS_MESSAGES,\n  INFO_MESSAGES,\n  configTypesRefreshFailed,\n  globalScopedAgentsHint,\n  recompileSummary,\n  registeredProjectUpdateFailed,\n  scopeBlockedStackAssignment,\n  skillMetadataUnusableDetail,\n  skillMetadataUnusableError,\n} from \"../utils/messages\";\nimport { reconcileTypesFromDisk, type GateReport } from \"../lib/config-gate/index.js\";\nimport { namedByActiveEntries } from \"../lib/configuration/scope-diff.js\";\nimport { unofferablePlacementsFound } from \"../lib/hosts/configured-placements.js\";\nimport { providerInUse } from \"../lib/installation/install-layout.js\";\nimport {\n  providerFlag,\n  providerNamedBy,\n  refuseAnAmbiguousInstallation,\n} from \"../lib/installation/provider-flag.js\";\nimport { hostCompileNotices } from \"../lib/hosts/host-compile-notices.js\";\nimport type { Installation } from \"../lib/installation\";\nimport type { SkillScope } from \"../types/config\";\nimport type {\n  AgentDefinition,\n  AgentName,\n  MergedSkillsMatrix,\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    provider: providerFlag(),\n  };\n\n  async run(): Promise<void> {\n    const { flags } = await this.parse(Compile);\n    setVerbose(flags.verbose);\n    const cwd = process.cwd();\n    const namedProvider = providerNamedBy(flags.provider);\n\n    await this.sayWhenTheGlobalInstallationStandsIn(namedProvider);\n    // First: `providerInUse` below picks by roster order when a scope holds both providers.\n    await refuseAnAmbiguousInstallation(cwd, \"compile\", namedProvider, (message) =>\n      this.error(message, { exit: EXIT_CODES.INVALID_ARGS }),\n    );\n    await this.ensureConfigReadable(cwd);\n    const installations = await this.detectInstallations(cwd);\n    await this.refuseUnofferablePlacements(cwd);\n    await this.resolveAndLogSource(cwd);\n    const agentDefs = await this.loadAgentDefsOrFail();\n    await this.runCompilePasses(installations, agentDefs, cwd);\n    await this.reportWhatThisHostCannotCarry(installations, cwd);\n  }\n\n  /** Runs after the passes, so the trust notice describes the tree this run wrote. */\n  private async reportWhatThisHostCannotCarry(\n    installations: BothInstallations,\n    cwd: string,\n  ): Promise<void> {\n    const root = rootThisRunCompiled(installations, cwd);\n\n    for (const notice of await hostCompileNotices(providerInUse(root), cwd)) {\n      this.log(notice);\n    }\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      // Compiling config-less would resurrect every deselected agent.\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   * Re-checked here because config.ts names no provider, so a copied installation folder can hold\n   * a configuration its host never vetted at install.\n   */\n  private async refuseUnofferablePlacements(cwd: string): Promise<void> {\n    const [finding] = await unofferablePlacementsFound(cwd);\n    if (finding !== undefined) this.error(finding, { exit: EXIT_CODES.ERROR });\n  }\n\n  /** No `--marketplace`: an installation recompiles against the marketplace config.ts recorded. */\n  private async resolveAndLogSource(projectDir: string): Promise<void> {\n    this.log(STATUS_MESSAGES.RESOLVING_SOURCE);\n    try {\n      // ABORT on an unreadable config (already refused earlier by `detectInstallations`).\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 passesCompiled = 0;\n    for (const pass of passes) {\n      const compiled = await this.runCompilePass(pass, cwd);\n      if (compiled) passesCompiled++;\n    }\n\n    if (passesCompiled === 0) {\n      this.error(ERROR_MESSAGES.NO_SKILLS_TO_COMPILE, { exit: EXIT_CODES.ERROR });\n    }\n  }\n\n  /** Refuses the run, before anything is written, when an installed skill's metadata is unusable. */\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  /** Detail is logged, not raised: oclif hard-wraps error text, which breaks copyable paths. */\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  /** The resolver drops a missing stack skill silently except at verbose level. */\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   * A hand-edited config.ts can give a global sub-agent a project-scoped skill, which the compile\n   * filter silently drops on every run.\n   */\n  private async warnScopeDroppedStackPairs(projectDir: string): Promise<void> {\n    const loaded = await loadProjectConfig(projectDir);\n    if (!loaded?.config.stack) return;\n\n    const namedBy = namedByActiveEntries(loaded.config.skills);\n    for (const [skillId, agentNames] of findScopeDroppedStackPairs(loaded.config)) {\n      this.warn(scopeBlockedStackAssignment(agentNames, skillId, namedBy));\n    }\n  }\n\n  /** Points at global-scope agents so \"No agents to recompile\" doesn't read as a silent no-op. */\n  private async hintGlobalScopedAgents(projectDir: string): Promise<void> {\n    const loaded = await loadInstalledConfig(projectDir);\n    if (!loaded) return;\n\n    const globalAgentCount = loaded.config.agents.filter((agent) =>\n      isActiveAt(agent, \"global\"),\n    ).length;\n    if (globalAgentCount === 0) return;\n\n    this.log(globalScopedAgentsHint(globalAgentCount));\n  }\n\n  /**\n   * Seats the matrix singleton the render reads (else local skills lose their stated usage), and\n   * returns it, `null` on failure: the render degrades, the type refresh skips. Extra sources only\n   * annotate skills, so skipping them keeps output identical and the path offline.\n   */\n  private async seatMatrixForPass(projectDir: string): Promise<MergedSkillsMatrix | null> {\n    try {\n      const { matrix: seated } = await loadSkillsMatrixFromSource({\n        projectDir,\n        skipExtraSources: true,\n        matrixOnly: true,\n      });\n      return seated;\n    } catch (error) {\n      this.warn(`Failed to load skills matrix for ${projectDir}: ${getErrorMessage(error)}`);\n      return null;\n    }\n  }\n\n  /**\n   * Regenerates config-types.ts after a hand-edit; failure only warns, as the agents are written.\n   * Skipped without a catalogue, since unions derived from none would be wrong, not just stale.\n   */\n  private async refreshConfigTypes(\n    pass: CompilePass,\n    cwd: string,\n    seatedMatrix: MergedSkillsMatrix | null,\n  ): Promise<void> {\n    if (!seatedMatrix) {\n      this.warn(\n        configTypesRefreshFailed(`no skills catalogue could be loaded for ${pass.projectDir}`),\n      );\n      return;\n    }\n\n    let report: GateReport;\n    try {\n      const loaded = await loadInstalledConfig(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      // A global pass's fan-out must not reach back into the invoking directory.\n      report = await reconcileTypesFromDisk(\n        pass.projectDir,\n        loaded.config,\n        { matrix: seatedMatrix, 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  /** Outside the refresh's catch: an unreachable project is not a failed refresh. */\n  private reportPropagation(report: GateReport): void {\n    this.reportProjectsOutOfReach(report.propagated);\n    for (const projectPath of report.propagated.failed) {\n      this.warn(registeredProjectUpdateFailed(projectPath));\n    }\n    this.reportFanOut(report);\n  }\n\n  private async runCompilePass(pass: CompilePass, cwd: string): Promise<boolean> {\n    const { projectDir } = pass;\n    this.announcePass(pass);\n\n    const seatedMatrix = await this.seatMatrixForPass(projectDir);\n    const { allSkills, totalSkillCount } = await this.discoverAllSkills(projectDir);\n    const compiles = await this.announceWhetherPassCompiles(pass, totalSkillCount);\n    // A skipped pass is a refused run, which writes nothing, config-types.ts included.\n    if (!compiles) return false;\n\n    await this.warnUnresolvedStackSkills(projectDir, allSkills);\n    await this.warnScopeDroppedStackPairs(projectDir);\n    await this.recompilePassAgents(pass, allSkills);\n    await this.refreshConfigTypes(pass, cwd, seatedMatrix);\n\n    this.log(\"\");\n    this.logSuccess(`${pass.label} compile complete!`);\n    this.log(\"\");\n    return true;\n  }\n\n  private announcePass({ label, projectDir, installation }: CompilePass): void {\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\n  /** A pass with no skills still compiles when its config declares base agents only. */\n  private async announceWhetherPassCompiles(\n    pass: CompilePass,\n    totalSkillCount: number,\n  ): Promise<boolean> {\n    if (totalSkillCount > 0) return true;\n\n    const passName = pass.label.toLowerCase();\n    if (await declaresOnlyBaseAgents(pass)) {\n      this.log(`No skills configured for ${passName} pass, compiling base agents`);\n      return true;\n    }\n\n    this.log(`No skills found for ${passName} pass, skipping`);\n    return false;\n  }\n\n  private async recompilePassAgents(pass: CompilePass, skills: SkillDefinitionMap): Promise<void> {\n    const { projectDir, installation, sourcePath, scopeFilter } = pass;\n\n    this.log(STATUS_MESSAGES.RECOMPILING_AGENTS);\n    try {\n      const recompileResult = await compileAgents({\n        projectDir,\n        sourcePath,\n        skills,\n        pluginDir: projectDir,\n        outputDir: installation.agentsDir,\n        ...(scopeFilter !== undefined && { scopeFilter }),\n      });\n      await this.reportRecompile(recompileResult, pass);\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_COMPILE_AGENTS);\n      this.handleError(error);\n    }\n  }\n\n  private async reportRecompile(\n    { compiled, rewritten, failed, warnings }: CompilationResult,\n    { label, projectDir }: CompilePass,\n  ): Promise<void> {\n    const summary = recompileSummary(\n      rewritten.length,\n      compiled.length - rewritten.length,\n      `${label.toLowerCase()} agent`,\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  }\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 * One pass: the project's when there is one (writing nothing outside it), else the global's.\n * `scopeFilter` keeps inlined global agents out of the project's 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/** Mirrors the root {@link buildCompilePasses} picks. */\nfunction rootThisRunCompiled(installations: BothInstallations, cwd: string): string {\n  return installations.project ? cwd : os.homedir();\n}\n\n/**\n * A skill-less pass still compiles a config of base agents only. One that declares skills none of\n * which are on disk lost them, and is skipped rather than recompiled without them.\n */\nasync function declaresOnlyBaseAgents(pass: CompilePass): Promise<boolean> {\n  const loaded = await loadInstalledConfig(pass.projectDir);\n  if (!loaded) return false;\n\n  const { skills, agents } = loaded.config;\n  const declaresASkill = skills.some((skill) => !skill.excluded);\n  const compilesAnAgent = agents.some((agent) =>\n    pass.scopeFilter === undefined ? !agent.excluded : isActiveAt(agent, pass.scopeFilter),\n  );\n  return !declaresASkill && compilesAnAgent;\n}\n\n/** Project-scoped skills a global sub-agent's stack names, grouped by skill. */\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\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 ${plural(totalSkillCount, \"skill\")} (${pluginSkillCount} from plugins, ${localCount} local)`;\n  }\n\n  return pluginSkillCount > 0\n    ? `Discovered ${plural(pluginSkillCount, \"skill\")} from plugins`\n    : `Discovered ${plural(totalSkillCount, \"local skill\")}`;\n}\n"],"mappings":"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","names":[]}

package/dist/commands/doctor.js

@@ -1,32 +1,36 @@
 #!/usr/bin/env node
-import "../chunk-IXVGBUWI.js";
+import "../chunk-EC3JXT23.js";
 import {
   filterExcludedEntries,
   listAgentFilesOf,
   listAgentMdFiles,
   splitAgentsByProvenance
-} from "../chunk-EFXVYQGT.js";
-import {
-  ambiguityFinding
-} from "../chunk-ORO2T4K2.js";
+} from "../chunk-MQZNDK5F.js";
 import {
   BaseCommand,
-  EXIT_CODES
-} from "../chunk-IAQFZFWD.js";
+  EXIT_CODES,
+  ambiguityFinding
+} from "../chunk-JTMSFBCA.js";
+import "../chunk-FACDJH6O.js";
 import {
   ConfigDefaultExportError,
+  ConfigEvaluationError,
   ConfigLoadError,
+  ConfigSchemaError,
   INFO_MESSAGES,
   MarketplaceManifestRequiredError,
   MarketplaceNameRefusedError,
   MarketplaceRefusedError,
   MarketplaceUnreachableError,
+  NoSkillRulesError,
   SOURCE_ENV_VAR,
+  StacksLoadError,
   agentCodec,
   agentYamlGenerationSchema,
   agentsDir,
   askingEachMarketplaceItself,
-  configDirsInPlay,
+  configsDeclaringNothing,
+  configsInPlay,
   declaresNoContent,
   detectInstallations,
   directoryExists,
@@ -34,15 +38,16 @@ import {
   findConfigLoadFailures,
   formatZodErrors,
   getErrorMessage,
-  getInstalledConfigPath,
   getInstalledPluginsRegistryPath,
-  getPluginManifestPath,
+  getProjectConfigPath,
   getProjectPluginsDir,
   getStackSkillIds,
   getUserPluginsDir,
+  getVerifiedPluginInstallPaths,
   glob,
   hostCompilesAgent,
   hostFor,
+  inheritedGlobalProvider,
   installBaseDir,
   invalidResult,
   isHomeDirectory,
@@ -53,7 +58,6 @@ import {
   listPluginDirNames,
   listRegisteredPluginInstalls,
   loadConfig,
-  loadInstalledConfig,
   loadProjectConfigFromDir,
   loadSkillsMatrixFromSource,
   loadSourceRepoConfig,
@@ -89,14 +93,13 @@ import {
   validatePlugin,
   validateProjectConfig,
   validateSkillFrontmatter,
-  validateSkillMetadata,
-  verbose
-} from "../chunk-E45IT3HC.js";
+  validateSkillMetadata
+} from "../chunk-ENET4IF6.js";
 import {
   matrix,
   plural,
   typedValues
-} from "../chunk-AIBVAYHS.js";
+} from "../chunk-UE4Z3YMB.js";
 import {
   CLI_INVOKE_COMMAND,
   DEFAULT_BRANDING,
@@ -111,7 +114,7 @@ import {
   STANDARD_FILES,
   UI_SYMBOLS,
   effectivelyExcludedSkillIds
-} from "../chunk-WUSEZFER.js";
+} from "../chunk-U46LYYRA.js";
 import "../chunk-GHHJYNAN.js";
 
 // src/cli/commands/doctor.ts
@@ -123,18 +126,11 @@ import os from "os";
 async function hostsOnDisk(projectDir) {
   const found = await detectInstallations(projectDir);
   if (inheritsTheGlobalInstallation(found)) return hostsOf(providerInUse(os.homedir()));
-  const project = providerInUse(projectDir);
-  return { project, global: globalBeside(project, found) };
+  return { project: providerInUse(projectDir), global: inheritedGlobalProvider(projectDir) };
 }
 function inheritsTheGlobalInstallation(found) {
   return found.length > 0 && found.every((installation) => installation.scope === "global");
 }
-function globalBeside(project, found) {
-  const inherited = found.some(
-    (installation) => installation.scope === "global" && installation.provider === project
-  );
-  return inherited ? project : providerInUse(os.homedir());
-}
 function hostsOf(provider) {
   return { project: provider, global: provider };
 }
@@ -162,29 +158,23 @@ async function readConfigState(projectDir, hosts) {
   }
   const inherited = isHomeDirectory(projectDir) ? null : await loadProjectConfigFromDir(os.homedir(), hosts.global);
   if (inherited && !declaresNoContent(inherited.config)) {
-    return { kind: "loaded", config: inherited.config, inherited: true };
+    return {
+      kind: "loaded",
+      config: inherited.config,
+      inherited: true,
+      declaringNothingIn: await providerDeclaringNothingIn(projectDir)
+    };
   }
   return own ? { kind: "declares-nothing", config: own.config } : { kind: "absent" };
 }
+async function providerDeclaringNothingIn(projectDir) {
+  const [leftover] = await configsDeclaringNothing(projectDir);
+  return leftover === void 0 ? null : leftover.provider;
+}
 async function installedPluginSkillIds(baseDir, provider) {
-  const plugins = await verifiedPlugins(baseDir, provider);
+  const plugins = await getVerifiedPluginInstallPaths(baseDir, provider);
   return new Set(plugins.map((plugin) => parseMarketplacePluginRef(plugin.pluginKey)));
 }
-async function verifiedPlugins(baseDir, provider) {
-  const enabled = (await pluginsListedBy(provider, baseDir)).filter((plugin) => plugin.enabled);
-  const onDisk = await Promise.all(
-    enabled.map((plugin) => fileExists(getPluginManifestPath(plugin.installPath)))
-  );
-  return enabled.filter((_, index) => onDisk[index] === true);
-}
-async function pluginsListedBy(provider, baseDir) {
-  try {
-    return await hostFor(provider).listPlugins(baseDir);
-  } catch (error) {
-    verbose(`Failed to list installed plugins: ${getErrorMessage(error)}`);
-    return [];
-  }
-}
 async function unofferablePlacements({
   projectDir,
   hosts
@@ -302,6 +292,7 @@ async function validateSource(sourcePath, reader = "author") {
   }
   const sourceProjectConfig = await loadSourceRepoConfig(resolvedPath);
   const skillsDirRelPath = sourceProjectConfig?.skillsDir ?? SKILLS_DIR_PATH;
+  const stacksRelFile = sourceProjectConfig?.stacksFile ?? STACKS_FILE_PATH;
   const skillsDir2 = path.join(resolvedPath, skillsDirRelPath);
   if (!await directoryExists(skillsDir2)) {
     return buildResult(
@@ -311,11 +302,11 @@ async function validateSource(sourcePath, reader = "author") {
   }
   const { pairIssues, validMetadataFiles } = await pairSkillFiles(skillsDir2);
   const skillIssues = await validateSkillsInTurn(skillsDir2, skillsDirRelPath, validMetadataFiles);
-  const crossReferenceIssues = await checkCrossReferences(resolvedPath, reader);
+  const crossReferenceIssues = await checkCrossReferences(resolvedPath, stacksRelFile, reader);
   const extraIssues = await Promise.all([
     validateStacks(resolvedPath),
     validateAgents(resolvedPath),
-    validateConfigFiles(resolvedPath)
+    validateConfigFiles(resolvedPath, stacksRelFile)
   ]);
   return buildResult(
     [...pairIssues, ...skillIssues, ...crossReferenceIssues, ...extraIssues.flat()],
@@ -371,17 +362,31 @@ var MANIFEST_REQUIRED_SEVERITY = {
   author: "warning",
   consumer: "error"
 };
-async function checkCrossReferences(resolvedPath, reader) {
+async function checkCrossReferences(resolvedPath, stacksRelFile, reader) {
   try {
     await loadSkillsMatrixFromSource({ sourceFlag: resolvedPath, skipExtraSources: true });
     return matrixHealthIssues(matrix).map(
       (healthIssue) => toSourceIssue(healthIssue, resolvedPath, reader)
     );
   } catch (error) {
-    return [matrixLoadFailure(error, reader)];
+    const failedFile = fileThatFailedToLoad(error, resolvedPath, stacksRelFile);
+    return [matrixLoadFailure(error, reader, failedFile)];
+  }
+}
+function fileThatFailedToLoad(error, resolvedPath, stacksRelFile) {
+  if (error instanceof StacksLoadError) return stacksRelFile;
+  if (configThatFailedToLoad(error) === path.join(resolvedPath, SKILL_RULES_PATH)) {
+    return SKILL_RULES_PATH;
+  }
+  return void 0;
+}
+function configThatFailedToLoad(error) {
+  if (error instanceof ConfigEvaluationError || error instanceof ConfigDefaultExportError || error instanceof ConfigSchemaError || error instanceof NoSkillRulesError) {
+    return error.configPath;
   }
+  return void 0;
 }
-function matrixLoadFailure(error, reader) {
+function matrixLoadFailure(error, reader, failedFile) {
   if (error instanceof MarketplaceManifestRequiredError) {
     return {
       severity: MANIFEST_REQUIRED_SEVERITY[reader],
@@ -396,10 +401,14 @@ function matrixLoadFailure(error, reader) {
       message: getErrorMessage(error)
     };
   }
+  if (failedFile !== void 0) return crossReferenceSkipped(failedFile, failedFile, error);
+  return crossReferenceSkipped(SKILL_CATEGORIES_PATH, "categories/rules", error);
+}
+function crossReferenceSkipped(file, whatFailed, error) {
   return {
     severity: "warning",
-    file: SKILL_CATEGORIES_PATH,
-    message: `Cross-reference validation skipped: failed to load categories/rules: ${getErrorMessage(error)}`
+    file,
+    message: `Cross-reference validation skipped: failed to load ${whatFailed}: ${getErrorMessage(error)}`
   };
 }
 var SKILL_AUDIT_PATH = "src/cli/lib/configuration/skill-audit.ts";
@@ -467,11 +476,11 @@ async function validateAgents(resolvedPath) {
     schema: agentYamlGenerationSchema
   });
 }
-async function validateConfigFiles(resolvedPath) {
+async function validateConfigFiles(resolvedPath, stacksRelFile) {
   const results = await Promise.all([
     validateTsConfig(resolvedPath, SKILL_CATEGORIES_PATH, skillCategoriesFileSchema),
     validateTsConfig(resolvedPath, SKILL_RULES_PATH, skillRulesFileSchema),
-    validateTsConfig(resolvedPath, STACKS_FILE_PATH, stacksConfigSchema)
+    validateTsConfig(resolvedPath, stacksRelFile, stacksConfigSchema)
   ]);
   return results.flat();
 }
@@ -572,7 +581,9 @@ function toUnreadableConfigIssue(failure) {
 }
 async function countExistingConfigs(projectDir) {
   const present = await Promise.all(
-    configDirsInPlay(projectDir).map((dir) => fileExists(getInstalledConfigPath(dir)))
+    configsInPlay(projectDir).map(
+      ({ dir, provider }) => fileExists(getProjectConfigPath(dir, provider))
+    )
   );
   return present.filter(Boolean).length;
 }
@@ -676,7 +687,7 @@ async function validateInstalledSkills(projectDir) {
 }
 async function configuredSkillIds(projectDir) {
   const loaded = await Promise.all(
-    configDirsInPlay(projectDir).map((dir) => loadInstalledConfig(dir))
+    configsInPlay(projectDir).map(({ dir, provider }) => loadProjectConfigFromDir(dir, provider))
   );
   return new Set(loaded.flatMap(configuredIdsOf));
 }
@@ -863,39 +874,45 @@ async function unclaimedAgentFiles({ dir, codec, claimed: claimed2 }) {
 import { countBy, unique as unique2 } from "remeda";
 function checkConfigValid(state, installation) {
   const theConfig = (verdict) => configRowMessage(state, installation, verdict);
-  if (state.kind === "absent") {
-    return {
-      result: {
-        kind: "config",
-        status: "fail",
-        message: theConfig("not found"),
-        details: [`Run '${CLI_INVOKE_COMMAND} init' to create a configuration`]
-      },
-      config: null
-    };
-  }
-  if (state.kind === "unreadable") {
-    return {
-      result: {
-        kind: "config",
-        status: "fail",
-        message: theConfig("exists but could not be loaded"),
-        details: [state.failure.reason]
-      },
-      config: null
-    };
-  }
-  if (state.kind === "declares-nothing") {
-    return {
-      result: {
-        kind: "config-empty",
-        status: "warn",
-        message: theConfig("is valid but declares no skills and no agents")
-      },
-      config: state.config
-    };
+  switch (state.kind) {
+    case "absent":
+      return {
+        result: {
+          kind: "config",
+          status: "fail",
+          message: theConfig("not found"),
+          details: [`Run '${CLI_INVOKE_COMMAND} init' to create a configuration`]
+        },
+        config: null
+      };
+    case "unreadable":
+      return {
+        result: {
+          kind: "config",
+          status: "fail",
+          message: theConfig("exists but could not be loaded"),
+          details: [state.failure.reason]
+        },
+        config: null
+      };
+    case "declares-nothing":
+      return {
+        result: {
+          kind: "config-empty",
+          status: "warn",
+          message: theConfig("is valid but declares no skills and no agents")
+        },
+        config: state.config
+      };
+    case "loaded":
+      return checkLoadedConfig(state.config, theConfig);
+    default: {
+      const _exhaustive = state;
+      return _exhaustive;
+    }
   }
-  const { config } = state;
+}
+function checkLoadedConfig(config, theConfig) {
   const validation = validateProjectConfig(config);
   if (!validation.valid) {
     return {
@@ -930,7 +947,7 @@ function checkConfigValid(state, installation) {
 }
 function configRowMessage(state, { projectDir, hosts }, verdict) {
   if (state.kind === "loaded" && state.inherited)
-    return `${theInheritedConfig(hosts.global)}, which ${verdict}`;
+    return `${theInheritedConfig(projectDir, state.declaringNothingIn, hosts.global)}, which ${verdict}`;
   if (state.kind === "unreadable") {
     const { scopeRoot, scope } = state.failure;
     return `${theConfigAt(scopeRoot, hosts[scope])} ${verdict}`;
@@ -940,8 +957,9 @@ function configRowMessage(state, { projectDir, hosts }, verdict) {
 function theConfigAt(root, provider) {
   return `${scopeLabel(scopeOf(root))}: ${configNamedFrom(root, provider)}`;
 }
-function theInheritedConfig(provider) {
-  return `${scopeLabel("project")}: no ${STANDARD_FILES.CONFIG_TS}, using ${scopeNoun("global")}'s (${configNamedFrom(os3.homedir(), provider)})`;
+function theInheritedConfig(projectDir, declaringNothingIn, provider) {
+  const projectHolds = declaringNothingIn === null ? `no ${STANDARD_FILES.CONFIG_TS}` : `${relativeConfigPath(projectDir, declaringNothingIn)} declares nothing`;
+  return `${scopeLabel("project")}: ${projectHolds}, using ${scopeNoun("global")}'s (${configNamedFrom(os3.homedir(), provider)})`;
 }
 function scopeOf(dir) {
   return isHomeDirectory(dir) ? "global" : "project";
@@ -1466,6 +1484,7 @@ var Doctor = class _Doctor extends BaseCommand {
   async run() {
     await this.parse(_Doctor);
     const projectDir = process.cwd();
+    await this.sayWhenTheGlobalInstallationStandsIn(void 0);
     this.printHeader(await this.resolveBrandingName(projectDir));
     const contentResults = await this.runContentChecks(projectDir);
     const operationalResults = await this.runOperationalChecks(projectDir, contentResults);