agents-inc 0.149.2 → 0.151.0

package/dist/commands/compile.js

@@ -0,0 +1,331 @@
+#!/usr/bin/env node
+import {
+  ERROR_MESSAGES,
+  INFO_MESSAGES,
+  STATUS_MESSAGES,
+  configTypesRefreshFailed,
+  globalScopedAgentsHint,
+  registeredProjectUpdateSkipped
+} from "../chunk-GYG5SE2D.js";
+import {
+  detectBothInstallations
+} from "../chunk-Y4CXDA3I.js";
+import {
+  compileAgents,
+  discoverInstalledSkills
+} from "../chunk-4R6PGHQQ.js";
+import "../chunk-3XFUQ6OL.js";
+import {
+  loadAgentDefs
+} from "../chunk-YBVA7GPW.js";
+import "../chunk-NGLQ5W7U.js";
+import {
+  BaseCommand,
+  EXIT_CODES
+} from "../chunk-7QIHKQL5.js";
+import "../chunk-SYUOXSPU.js";
+import "../chunk-P3PN5SVI.js";
+import {
+  ConfigLoadError,
+  effectivelyExcludedSkillIds,
+  getStackSkillIds,
+  loadProjectConfig,
+  loadProjectConfigFromDir,
+  loadSkillsMatrixFromSource,
+  reconcileTypesFromDisk,
+  resolveSource
+} from "../chunk-TVHRMRD3.js";
+import {
+  getErrorMessage,
+  setVerbose,
+  verbose
+} from "../chunk-3LIU2ZEF.js";
+import "../chunk-DG2NGZ7S.js";
+import "../chunk-VEP23B5W.js";
+import {
+  CLI_INVOKE_COMMAND,
+  STANDARD_FILES
+} from "../chunk-O5ASLZ2K.js";
+import "../chunk-YU2VGX5R.js";
+import {
+  init_esm_shims
+} from "../chunk-P56WJ5FA.js";
+
+// src/cli/commands/compile.ts
+init_esm_shims();
+import { Flags } from "@oclif/core";
+import os from "os";
+var Compile = class _Compile extends BaseCommand {
+  static summary = "Compile agents using local skills and agent definitions";
+  static description = "Compile agents with resolved skill references. Compiles to the Claude plugin directory.";
+  static examples = [
+    "<%= config.bin %> <%= command.id %>",
+    "<%= config.bin %> <%= command.id %> --verbose"
+  ];
+  static flags = {
+    ...BaseCommand.baseFlags,
+    verbose: Flags.boolean({
+      char: "v",
+      description: "Enable verbose logging",
+      default: false
+    })
+  };
+  async run() {
+    const { flags } = await this.parse(_Compile);
+    setVerbose(flags.verbose);
+    const cwd = process.cwd();
+    const installations = await this.detectInstallations(cwd);
+    await this.resolveAndLogSource(flags.source);
+    const agentDefs = await this.loadAgentDefsOrFail(cwd);
+    await this.compileAllScopes(installations, agentDefs, cwd, flags.source);
+  }
+  async detectInstallations(cwd) {
+    let installations;
+    try {
+      installations = await detectBothInstallations(cwd);
+    } catch (error) {
+      if (error instanceof ConfigLoadError) {
+        this.error(error.message, { exit: EXIT_CODES.ERROR });
+      }
+      throw error;
+    }
+    if (!installations.global && !installations.project) {
+      this.error(ERROR_MESSAGES.NO_INSTALLATION, {
+        exit: EXIT_CODES.ERROR
+      });
+    }
+    return installations;
+  }
+  async resolveAndLogSource(sourceFlag) {
+    this.log(STATUS_MESSAGES.RESOLVING_SOURCE);
+    try {
+      const sourceConfig = await resolveSource(sourceFlag);
+      this.log(`Source: ${sourceConfig.sourceOrigin}`);
+    } catch (error) {
+      this.log(ERROR_MESSAGES.FAILED_RESOLVE_SOURCE);
+      this.handleError(error);
+    }
+  }
+  async loadAgentDefsOrFail(cwd) {
+    this.log(STATUS_MESSAGES.LOADING_AGENT_PARTIALS);
+    try {
+      const defs = await loadAgentDefs({ projectDir: cwd });
+      this.log("Agent partials loaded");
+      verbose(`  Agents: ${defs.agentSourcePaths.agentsDir}`);
+      verbose(`  Templates: ${defs.agentSourcePaths.templatesDir}`);
+      return defs;
+    } catch (error) {
+      this.log(ERROR_MESSAGES.FAILED_LOAD_AGENT_PARTIALS);
+      this.handleError(error);
+    }
+  }
+  async compileAllScopes(installations, agentDefs, cwd, sourceFlag) {
+    const passes = buildCompilePasses(installations, cwd, agentDefs);
+    let totalPassesWithSkills = 0;
+    for (const pass of passes) {
+      const hadSkills = await this.runCompilePass(pass, cwd, sourceFlag);
+      if (hadSkills) totalPassesWithSkills++;
+    }
+    if (totalPassesWithSkills === 0) {
+      this.error(
+        `No skills found. Add skills with '${CLI_INVOKE_COMMAND} add <skill>' or create in .claude/skills/.`,
+        { exit: EXIT_CODES.ERROR }
+      );
+    }
+  }
+  async discoverAllSkills(projectDir) {
+    this.log(STATUS_MESSAGES.DISCOVERING_SKILLS);
+    const result = await discoverInstalledSkills(projectDir);
+    if (result.totalSkillCount === 0) return result;
+    this.log(formatDiscoveryMessage(result));
+    return result;
+  }
+  /**
+   * A stack skill that is not among the discovered skills is dropped from every
+   * agent that references it. The resolver only records that at verbose level, so
+   * the default output would claim a successful recompile of an agent that no
+   * longer matches config.ts. Name each dropped skill instead.
+   */
+  async warnUnresolvedStackSkills(projectDir, allSkills) {
+    const loaded = await loadProjectConfig(projectDir);
+    if (!loaded?.config.stack) return;
+    const excludedIds = effectivelyExcludedSkillIds(loaded.config.skills);
+    const unresolved = getStackSkillIds(loaded.config.stack).filter(
+      (id) => !excludedIds.has(id) && !(id in allSkills)
+    );
+    for (const id of unresolved) {
+      this.warn(
+        `Skill '${id}' is configured but was not found \u2014 agents will be compiled without it.`
+      );
+    }
+  }
+  /**
+   * The project pass compiled no agents, but the project config may still declare
+   * global-scope agents whose stack lives in the global config. Without a pointer
+   * the "No agents to recompile" line reads as a silent no-op after a global stack
+   * change, so name the global context and the count.
+   */
+  async hintGlobalScopedAgents(projectDir) {
+    const loaded = await loadProjectConfigFromDir(projectDir);
+    if (!loaded) return;
+    const globalAgentCount = loaded.config.agents.filter(
+      (agent) => !agent.excluded && agent.scope === "global"
+    ).length;
+    if (globalAgentCount === 0) return;
+    this.log(globalScopedAgentsHint(globalAgentCount));
+  }
+  /**
+   * The documented hand-edit workflow is "edit config.ts, then run compile", and
+   * the type unions in config-types.ts are derived from config.ts — so a compile
+   * pass that leaves them untouched strands stale unions after a hand-edit.
+   * Regenerates them from the scope's persisted config exactly as the wizard
+   * write path would: standalone narrowed unions at global scope, import-and-
+   * extend at project scope. `matrixOnly` keeps the default-source path offline.
+   * A failed refresh downgrades to a warning — the compiled agents are already
+   * written and remain valid; only the type unions may still be stale.
+   *
+   * `skipExtraSources: true` is NOT a divergence from the wizard's full
+   * multi-source load: extra-source loading only annotates each skill's
+   * `availableSources`/`activeSource` for wizard UI tagging — it never adds
+   * skills or categories to the matrix, and the config-types writer never reads
+   * those annotations, so the emitted types are byte-identical either way
+   * (pinned by the skipExtraSources parity test in local-installer.test.ts).
+   * Skipping avoids fetching every registered extra source (network on a cold
+   * cache, plus unreachable-remote warnings) on this offline compile path.
+   */
+  async refreshConfigTypes(pass, cwd, sourceFlag) {
+    let report;
+    try {
+      const loaded = await loadProjectConfigFromDir(pass.projectDir);
+      if (!loaded) {
+        verbose(
+          `No config found at ${pass.projectDir} \u2014 skipping ${STANDARD_FILES.CONFIG_TYPES_TS} refresh`
+        );
+        return;
+      }
+      const { matrix } = await loadSkillsMatrixFromSource({
+        sourceFlag,
+        projectDir: pass.projectDir,
+        skipExtraSources: true,
+        matrixOnly: true
+      });
+      report = await reconcileTypesFromDisk(
+        pass.projectDir,
+        loaded.config,
+        { matrix, agents: pass.agents },
+        { currentProjectDir: cwd }
+      );
+      this.log(INFO_MESSAGES.CONFIG_TYPES_REFRESHED);
+    } catch (error) {
+      this.warn(configTypesRefreshFailed(getErrorMessage(error)));
+      return;
+    }
+    this.reportPropagation(report);
+  }
+  /**
+   * Renders the fan-out the refresh above performed. Kept out of the refresh's
+   * catch on purpose: a project the fan-out could not reach is reported as that,
+   * not as a failure to refresh the type unions — which did succeed.
+   */
+  reportPropagation(report) {
+    for (const skippedPath of report.propagated.skipped) {
+      this.warn(registeredProjectUpdateSkipped(skippedPath));
+    }
+    for (const warning of report.recompile.warnings) {
+      this.warn(warning);
+    }
+    if (report.propagated.updated.length === 0) return;
+    const { recompiledCount, failedCount } = report.recompile;
+    const failureSuffix = failedCount > 0 ? ` (${failedCount} failed)` : "";
+    this.log(`Recompiled agents in ${recompiledCount} registered projects${failureSuffix}`);
+  }
+  async runCompilePass(params, cwd, sourceFlag) {
+    const { label, projectDir, installation, sourcePath, scopeFilter } = params;
+    this.log("");
+    this.log(`Compiling ${label.toLowerCase()} agents...`);
+    this.log("");
+    verbose(`  Project: ${projectDir}`);
+    verbose(`  Agents: ${installation.agentsDir}`);
+    const { allSkills, totalSkillCount } = await this.discoverAllSkills(projectDir);
+    if (totalSkillCount === 0) {
+      this.log(`No skills found for ${label.toLowerCase()} pass, skipping`);
+      await this.refreshConfigTypes(params, cwd, sourceFlag);
+      return false;
+    }
+    await this.warnUnresolvedStackSkills(projectDir, allSkills);
+    this.log(STATUS_MESSAGES.RECOMPILING_AGENTS);
+    try {
+      const recompileResult = await compileAgents({
+        projectDir,
+        sourcePath,
+        skills: allSkills,
+        pluginDir: projectDir,
+        outputDir: installation.agentsDir,
+        scopeFilter
+      });
+      if (recompileResult.failed.length > 0) {
+        this.log(
+          `Recompiled ${recompileResult.compiled.length} ${label.toLowerCase()} agents (${recompileResult.failed.length} failed)`
+        );
+        for (const warning of recompileResult.warnings) {
+          this.warn(warning);
+        }
+      } else if (recompileResult.compiled.length > 0) {
+        this.log(`Recompiled ${recompileResult.compiled.length} ${label.toLowerCase()} agents`);
+      } else {
+        this.log(INFO_MESSAGES.NO_AGENTS_TO_RECOMPILE);
+        if (label === "Project") {
+          await this.hintGlobalScopedAgents(projectDir);
+        }
+      }
+      if (recompileResult.compiled.length > 0) {
+        verbose(`  Compiled: ${recompileResult.compiled.join(", ")}`);
+      }
+    } catch (error) {
+      this.log(ERROR_MESSAGES.FAILED_COMPILE_AGENTS);
+      this.handleError(error);
+    }
+    await this.refreshConfigTypes(params, cwd, sourceFlag);
+    this.log("");
+    this.logSuccess(`${label} compile complete!`);
+    this.log("");
+    return true;
+  }
+};
+function buildCompilePasses(installations, cwd, agentDefs) {
+  const { sourcePath, agents } = agentDefs;
+  const passes = [];
+  if (installations.global) {
+    passes.push({
+      label: "Global",
+      projectDir: os.homedir(),
+      installation: installations.global,
+      sourcePath,
+      agents,
+      scopeFilter: installations.hasBoth ? "global" : void 0
+    });
+  }
+  if (installations.project) {
+    passes.push({
+      label: "Project",
+      projectDir: cwd,
+      installation: installations.project,
+      sourcePath,
+      agents,
+      scopeFilter: installations.hasBoth ? "project" : void 0
+    });
+  }
+  return passes;
+}
+function formatDiscoveryMessage(result) {
+  const { totalSkillCount, pluginSkillCount } = result;
+  const localCount = totalSkillCount - pluginSkillCount;
+  if (pluginSkillCount > 0 && localCount > 0) {
+    return `Discovered ${totalSkillCount} skills (${pluginSkillCount} from plugins, ${localCount} local)`;
+  }
+  return pluginSkillCount > 0 ? `Discovered ${pluginSkillCount} skills from plugins` : `Discovered ${totalSkillCount} local skills`;
+}
+export {
+  Compile as default
+};
+//# sourceMappingURL=compile.js.map

package/dist/commands/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/commands/compile.ts"],"sourcesContent":["import { Flags } from \"@oclif/core\";\nimport os from \"os\";\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  loadProjectConfig,\n  loadProjectConfigFromDir,\n  resolveSource,\n} from \"../lib/configuration\";\nimport { getStackSkillIds } from \"../lib/stacks\";\nimport { loadSkillsMatrixFromSource } from \"../lib/loading\";\nimport { CLI_INVOKE_COMMAND, 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  registeredProjectUpdateSkipped,\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 { AgentDefinition, AgentName, SkillDefinitionMap } 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    ...BaseCommand.baseFlags,\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(flags.source);\n    const agentDefs = await this.loadAgentDefsOrFail(cwd);\n    await this.compileAllScopes(installations, agentDefs, cwd, flags.source);\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  private async resolveAndLogSource(sourceFlag?: string): Promise<void> {\n    this.log(STATUS_MESSAGES.RESOLVING_SOURCE);\n    try {\n      const sourceConfig = await resolveSource(sourceFlag);\n      this.log(`Source: ${sourceConfig.sourceOrigin}`);\n    } catch (error) {\n      this.log(ERROR_MESSAGES.FAILED_RESOLVE_SOURCE);\n      this.handleError(error);\n    }\n  }\n\n  private async loadAgentDefsOrFail(cwd: string): Promise<AgentDefs> {\n    this.log(STATUS_MESSAGES.LOADING_AGENT_PARTIALS);\n    try {\n      const defs = await loadAgentDefs({ projectDir: cwd });\n      this.log(\"Agent partials loaded\");\n      verbose(`  Agents: ${defs.agentSourcePaths.agentsDir}`);\n      verbose(`  Templates: ${defs.agentSourcePaths.templatesDir}`);\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 compileAllScopes(\n    installations: BothInstallations,\n    agentDefs: AgentDefs,\n    cwd: string,\n    sourceFlag?: string,\n  ): Promise<void> {\n    // When both installations exist, filter each pass to its own scope to prevent\n    // the project pass from overwriting global agents with zero-skill versions\n    // (the project config's stack only has project agent entries).\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, sourceFlag);\n      if (hadSkills) totalPassesWithSkills++;\n    }\n\n    if (totalPassesWithSkills === 0) {\n      this.error(\n        `No skills found. Add skills with '${CLI_INVOKE_COMMAND} add <skill>' or create in .claude/skills/.`,\n        { exit: EXIT_CODES.ERROR },\n      );\n    }\n  }\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.totalSkillCount === 0) return result;\n    this.log(formatDiscoveryMessage(result));\n    return result;\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   * 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(\n    pass: CompilePass,\n    cwd: string,\n    sourceFlag?: string,\n  ): 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        sourceFlag,\n        projectDir: pass.projectDir,\n        skipExtraSources: true,\n        matrixOnly: true,\n      });\n      // `cwd` is excluded from the fan-out: when compile runs inside a registered\n      // project, the project pass compiles that project's agents itself, so\n      // letting the home pass reach it would compile them twice.\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    for (const warning of report.recompile.warnings) {\n      this.warn(warning);\n    }\n    if (report.propagated.updated.length === 0) return;\n\n    const { recompiledCount, failedCount } = report.recompile;\n    const failureSuffix = failedCount > 0 ? ` (${failedCount} failed)` : \"\";\n    this.log(`Recompiled agents in ${recompiledCount} registered projects${failureSuffix}`);\n  }\n\n  private async runCompilePass(\n    params: CompilePass,\n    cwd: string,\n    sourceFlag?: string,\n  ): 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, sourceFlag);\n      return false;\n    }\n\n    await this.warnUnresolvedStackSkills(projectDir, allSkills);\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,\n      });\n\n      if (recompileResult.failed.length > 0) {\n        this.log(\n          `Recompiled ${recompileResult.compiled.length} ${label.toLowerCase()} agents (${recompileResult.failed.length} failed)`,\n        );\n        for (const warning of recompileResult.warnings) {\n          this.warn(warning);\n        }\n      } else if (recompileResult.compiled.length > 0) {\n        this.log(`Recompiled ${recompileResult.compiled.length} ${label.toLowerCase()} agents`);\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 (recompileResult.compiled.length > 0) {\n        verbose(`  Compiled: ${recompileResult.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, sourceFlag);\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: Record<AgentName, AgentDefinition>;\n  scopeFilter?: SkillScope;\n};\n\nfunction buildCompilePasses(\n  installations: BothInstallations,\n  cwd: string,\n  agentDefs: AgentDefs,\n): CompilePass[] {\n  const { sourcePath, agents } = agentDefs;\n  const passes: CompilePass[] = [];\n\n  if (installations.global) {\n    passes.push({\n      label: \"Global\",\n      projectDir: os.homedir(),\n      installation: installations.global,\n      sourcePath,\n      agents,\n      scopeFilter: installations.hasBoth ? \"global\" : undefined,\n    });\n  }\n\n  if (installations.project) {\n    passes.push({\n      label: \"Project\",\n      projectDir: cwd,\n      installation: installations.project,\n      sourcePath,\n      agents,\n      scopeFilter: installations.hasBoth ? \"project\" : undefined,\n    });\n  }\n\n  return passes;\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":[]}