@agents-inc/cli 0.60.1 → 0.61.0

package/CHANGELOG.md

@@ -9,6 +9,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.61.0] - 2026-03-08
+
+**Dual-pass compile for global and project installations**
+
+- `compile` detects both global and project installations, runs independent passes for each
+- `writeProjectConfig()` E2E helper with `ProjectConfig` typing, all inline config writes migrated
+- 6 new dual-scope E2E tests covering scope isolation, single-installation fallbacks, and verbose output
+
+See [changelogs/0.61.0.md](./changelogs/0.61.0.md) for full details.
+
+---
+
 ## [0.60.1] - 2026-03-08
 
 **Type redundancy cleanup and test infrastructure improvements**

package/dist/{chunk-6G3KZSO4.js → chunk-46DQG2N7.js}

@@ -1,22 +1,22 @@
 #!/usr/bin/env node
 import {
   StepSettings
-} from "./chunk-52M2XF3W.js";
+} from "./chunk-GH2RQ4MI.js";
 import {
   StepSources
-} from "./chunk-SZRK3VOR.js";
+} from "./chunk-M6YWRMXH.js";
 import {
   StepStack
-} from "./chunk-MKCHLXMY.js";
+} from "./chunk-H5DASUX5.js";
 import {
   WizardLayout
-} from "./chunk-EMIUPGPL.js";
+} from "./chunk-WHISPMAQ.js";
 import {
   StepAgents
-} from "./chunk-SEJF7CGJ.js";
+} from "./chunk-Z3TM4N37.js";
 import {
   StepBuild
-} from "./chunk-TC3NHO34.js";
+} from "./chunk-KD2YS76O.js";
 import {
   StepConfirm
 } from "./chunk-KIWFEBKH.js";
@@ -25,14 +25,14 @@ import {
 } from "./chunk-BKJHAJQW.js";
 import {
   useWizardStore
-} from "./chunk-WF6RM73R.js";
+} from "./chunk-IGM6HA3S.js";
 import {
   cliTheme
 } from "./chunk-XUDTFI4M.js";
 import {
   resolveAlias,
   validateSelection
-} from "./chunk-TZXYBG3R.js";
+} from "./chunk-FWMWWE3X.js";
 import {
   warn
 } from "./chunk-LWXRUR6B.js";
@@ -342,4 +342,4 @@ var Wizard = ({
 export {
   Wizard
 };
-//# sourceMappingURL=chunk-6G3KZSO4.js.map
+//# sourceMappingURL=chunk-46DQG2N7.js.map

package/dist/{chunk-BMJZBLP7.js → chunk-6DAZG54T.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-BNQ5O6LE.js";
 import {
   useWizardStore
-} from "./chunk-WF6RM73R.js";
+} from "./chunk-IGM6HA3S.js";
 import {
   DEFAULT_SCRATCH_DOMAINS
 } from "./chunk-6OWHQ7HM.js";
@@ -108,4 +108,4 @@ var StackSelection = ({
 export {
   StackSelection
 };
-//# sourceMappingURL=chunk-BMJZBLP7.js.map
+//# sourceMappingURL=chunk-6DAZG54T.js.map

package/dist/{chunk-TZXYBG3R.js → chunk-FWMWWE3X.js}

@@ -3150,7 +3150,7 @@ function loadConfigTypesDataInBackground(sourceFlag, projectDir) {
     if (!await directoryExists(claudeSrcDir)) {
       throw new Error(`${CLAUDE_SRC_DIR}/ not found \u2014 run '${CLI_BIN_NAME} init' first`);
     }
-    const { loadSkillsMatrixFromSource: loadSkillsMatrixFromSource2 } = await import("./source-loader-A6B3NDI4.js");
+    const { loadSkillsMatrixFromSource: loadSkillsMatrixFromSource2 } = await import("./source-loader-KMEBBZCQ.js");
     const { loadAllAgents: loadAllAgents2 } = await import("./loader-2O32KKAQ.js");
     const sourceResult = await loadSkillsMatrixFromSource2({
       sourceFlag,
@@ -5285,7 +5285,6 @@ export {
   splitConfigByScope,
   loadStacks,
   getStackSkillIds,
-  loadProjectConfigFromDir,
   loadProjectConfig,
   validateProjectConfig,
   saveSourceToProjectConfig,
@@ -5358,4 +5357,4 @@ export {
   validateAllPlugins,
   printPluginValidationResult
 };
-//# sourceMappingURL=chunk-TZXYBG3R.js.map
+//# sourceMappingURL=chunk-FWMWWE3X.js.map

package/dist/{chunk-52M2XF3W.js → chunk-GH2RQ4MI.js}

@@ -19,7 +19,7 @@ import {
   addSource,
   getSourceSummary,
   removeSource
-} from "./chunk-TZXYBG3R.js";
+} from "./chunk-FWMWWE3X.js";
 import {
   getErrorMessage,
   verbose
@@ -262,4 +262,4 @@ var StepSettings = ({
 export {
   StepSettings
 };
-//# sourceMappingURL=chunk-52M2XF3W.js.map
+//# sourceMappingURL=chunk-GH2RQ4MI.js.map

package/dist/{chunk-MKCHLXMY.js → chunk-H5DASUX5.js}

@@ -4,16 +4,16 @@ import {
 } from "./chunk-K77I4XGL.js";
 import {
   StackSelection
-} from "./chunk-BMJZBLP7.js";
+} from "./chunk-6DAZG54T.js";
 import {
   DomainSelection
-} from "./chunk-TGLRDEEL.js";
+} from "./chunk-KDO6WU76.js";
 import {
   ViewTitle
 } from "./chunk-MGNYPVOJ.js";
 import {
   useWizardStore
-} from "./chunk-WF6RM73R.js";
+} from "./chunk-IGM6HA3S.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";
@@ -37,4 +37,4 @@ var StepStack = ({ matrix, onCancel }) => {
 export {
   StepStack
 };
-//# sourceMappingURL=chunk-MKCHLXMY.js.map
+//# sourceMappingURL=chunk-H5DASUX5.js.map

package/dist/{chunk-RO6LX3UV.js → chunk-IEEVXLJB.js}

@@ -7,7 +7,7 @@ import {
   loadConfigTypesDataInBackground,
   regenerateConfigTypes,
   resolveAuthor
-} from "./chunk-TZXYBG3R.js";
+} from "./chunk-FWMWWE3X.js";
 import {
   BaseCommand,
   EXIT_CODES
@@ -339,4 +339,4 @@ export {
   generateSkillRulesTs,
   NewSkill
 };
-//# sourceMappingURL=chunk-RO6LX3UV.js.map
+//# sourceMappingURL=chunk-IEEVXLJB.js.map

package/dist/{chunk-WF6RM73R.js → chunk-IGM6HA3S.js}

@@ -3,7 +3,7 @@ import {
   deriveInstallMode,
   getAvailableSkills,
   resolveAlias
-} from "./chunk-TZXYBG3R.js";
+} from "./chunk-FWMWWE3X.js";
 import {
   typedEntries,
   typedKeys
@@ -635,4 +635,4 @@ export {
   buildCategoriesForDomain,
   useWizardStore
 };
-//# sourceMappingURL=chunk-WF6RM73R.js.map
+//# sourceMappingURL=chunk-IGM6HA3S.js.map

package/dist/{chunk-TC3NHO34.js → chunk-KD2YS76O.js}

@@ -16,7 +16,7 @@ import {
   buildCategoriesForDomain,
   useWizardStore,
   validateBuildStep
-} from "./chunk-WF6RM73R.js";
+} from "./chunk-IGM6HA3S.js";
 import {
   CLI_COLORS
 } from "./chunk-6OWHQ7HM.js";
@@ -148,4 +148,4 @@ var StepBuild = ({
 export {
   StepBuild
 };
-//# sourceMappingURL=chunk-TC3NHO34.js.map
+//# sourceMappingURL=chunk-KD2YS76O.js.map

package/dist/{chunk-TGLRDEEL.js → chunk-KDO6WU76.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-CIG7IKX3.js";
 import {
   useWizardStore
-} from "./chunk-WF6RM73R.js";
+} from "./chunk-IGM6HA3S.js";
 import {
   typedEntries
 } from "./chunk-T4EXUIBY.js";
@@ -62,4 +62,4 @@ var DomainSelection = ({ matrix }) => {
 export {
   DomainSelection
 };
-//# sourceMappingURL=chunk-TGLRDEEL.js.map
+//# sourceMappingURL=chunk-KDO6WU76.js.map

package/dist/{chunk-SZRK3VOR.js → chunk-M6YWRMXH.js}

@@ -16,11 +16,11 @@ import {
 } from "./chunk-MGNYPVOJ.js";
 import {
   useWizardStore
-} from "./chunk-WF6RM73R.js";
+} from "./chunk-IGM6HA3S.js";
 import {
   resolveAllSources,
   searchExtraSources
-} from "./chunk-TZXYBG3R.js";
+} from "./chunk-FWMWWE3X.js";
 import {
   CLI_COLORS,
   DEFAULT_BRANDING
@@ -169,4 +169,4 @@ var StepSources = ({
 export {
   StepSources
 };
-//# sourceMappingURL=chunk-SZRK3VOR.js.map
+//# sourceMappingURL=chunk-M6YWRMXH.js.map

package/dist/{chunk-K6OLORQL.js → chunk-SDLDPFNV.js}

@@ -7,7 +7,7 @@ import {
   loadProjectSourceConfig,
   resolveAgentsSource,
   resolveSource
-} from "./chunk-TZXYBG3R.js";
+} from "./chunk-FWMWWE3X.js";
 import {
   BaseCommand
 } from "./chunk-VR3CDXDT.js";
@@ -90,4 +90,4 @@ ${DEFAULT_BRANDING.NAME} Configuration
 export {
   ConfigShow
 };
-//# sourceMappingURL=chunk-K6OLORQL.js.map
+//# sourceMappingURL=chunk-SDLDPFNV.js.map

package/dist/{chunk-YHCYKUA3.js → chunk-SRBN6RRD.js}

@@ -17,7 +17,7 @@ import {
   resolveAgents,
   writeContentHash,
   writePluginManifest
-} from "./chunk-TZXYBG3R.js";
+} from "./chunk-FWMWWE3X.js";
 import {
   loadAllAgents,
   loadProjectAgents
@@ -319,4 +319,4 @@ export {
   compileAllAgentPlugins,
   printAgentCompilationSummary
 };
-//# sourceMappingURL=chunk-YHCYKUA3.js.map
+//# sourceMappingURL=chunk-SRBN6RRD.js.map

package/dist/{chunk-EMIUPGPL.js → chunk-WHISPMAQ.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-52XO4ULK.js";
 import {
   useWizardStore
-} from "./chunk-WF6RM73R.js";
+} from "./chunk-IGM6HA3S.js";
 import {
   CLI_COLORS,
   DEFAULT_PLUGIN_NAME
@@ -184,4 +184,4 @@ var WizardLayout = ({
 export {
   WizardLayout
 };
-//# sourceMappingURL=chunk-EMIUPGPL.js.map
+//# sourceMappingURL=chunk-WHISPMAQ.js.map

package/dist/{chunk-G6WHCALR.js → chunk-YHOHLNHM.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Wizard
-} from "./chunk-6G3KZSO4.js";
+} from "./chunk-46DQG2N7.js";
 import {
   STATUS_MESSAGES,
   SUCCESS_MESSAGES
@@ -21,7 +21,7 @@ import {
   installPluginConfig,
   loadProjectConfig,
   loadSkillsMatrixFromSource
-} from "./chunk-TZXYBG3R.js";
+} from "./chunk-FWMWWE3X.js";
 import {
   BaseCommand,
   EXIT_CODES
@@ -590,4 +590,4 @@ export {
   showDashboard,
   Init
 };
-//# sourceMappingURL=chunk-G6WHCALR.js.map
+//# sourceMappingURL=chunk-YHOHLNHM.js.map

package/dist/{chunk-SEJF7CGJ.js → chunk-Z3TM4N37.js}

@@ -13,7 +13,7 @@ import {
 } from "./chunk-MGNYPVOJ.js";
 import {
   useWizardStore
-} from "./chunk-WF6RM73R.js";
+} from "./chunk-IGM6HA3S.js";
 import {
   typedKeys
 } from "./chunk-T4EXUIBY.js";
@@ -268,4 +268,4 @@ var StepAgents = ({ matrix }) => {
 export {
   StepAgents
 };
-//# sourceMappingURL=chunk-SEJF7CGJ.js.map
+//# sourceMappingURL=chunk-Z3TM4N37.js.map

package/dist/commands/build/plugins.js

@@ -2,12 +2,12 @@
 import {
   compileAllAgentPlugins,
   printAgentCompilationSummary
-} from "../../chunk-YHCYKUA3.js";
+} from "../../chunk-SRBN6RRD.js";
 import {
   compileAllSkillPlugins,
   compileSkillPlugin,
   printCompilationSummary
-} from "../../chunk-TZXYBG3R.js";
+} from "../../chunk-FWMWWE3X.js";
 import "../../chunk-OCEFD7V6.js";
 import "../../chunk-T4EXUIBY.js";
 import {

package/dist/commands/build/stack.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   getAgentDefinitions
-} from "../../chunk-YHCYKUA3.js";
+} from "../../chunk-SRBN6RRD.js";
 import {
   compileStackPlugin,
   loadStacks,
   printStackCompilationSummary
-} from "../../chunk-TZXYBG3R.js";
+} from "../../chunk-FWMWWE3X.js";
 import "../../chunk-OCEFD7V6.js";
 import "../../chunk-T4EXUIBY.js";
 import {

package/dist/commands/compile.js

@@ -2,7 +2,7 @@
 import {
   getAgentDefinitions,
   recompileAgents
-} from "../chunk-YHCYKUA3.js";
+} from "../chunk-SRBN6RRD.js";
 import {
   ERROR_MESSAGES,
   INFO_MESSAGES,
@@ -10,12 +10,11 @@ import {
   SUCCESS_MESSAGES
 } from "../chunk-MR6OBL3B.js";
 import {
-  detectInstallation,
+  detectGlobalInstallation,
+  detectProjectInstallation,
   discoverAllPluginSkills,
-  getStackSkillIds,
-  loadProjectConfigFromDir,
   resolveSource
-} from "../chunk-TZXYBG3R.js";
+} from "../chunk-FWMWWE3X.js";
 import {
   parseFrontmatter
 } from "../chunk-OCEFD7V6.js";
@@ -138,25 +137,43 @@ var Compile = class _Compile extends BaseCommand {
       });
       return;
     }
-    const installation = await detectInstallation();
-    if (!installation) {
+    const cwd = process.cwd();
+    const homeDir = os.homedir();
+    const globalInstallation = await detectGlobalInstallation();
+    const projectInstallation = cwd === homeDir ? null : await detectProjectInstallation(cwd);
+    if (!globalInstallation && !projectInstallation) {
       this.error(ERROR_MESSAGES.NO_INSTALLATION, {
         exit: EXIT_CODES.ERROR
       });
     }
-    if (installation.projectDir === os.homedir()) {
-      this.log("Using global installation from ~/.claude-src/");
+    await this.resolveSourceForCompile(flags);
+    const agentDefs = await this.loadAgentDefsForCompile(flags);
+    let totalPassesWithSkills = 0;
+    if (globalInstallation) {
+      const hadSkills = await this.runCompilePass({
+        label: "Global",
+        projectDir: homeDir,
+        installation: globalInstallation,
+        agentDefs,
+        flags
+      });
+      if (hadSkills) totalPassesWithSkills++;
     }
-    if (installation.mode === "local") {
-      this.log("");
-      this.log("Local Mode Compile (auto-detected)");
-      this.log("");
-      await this.runCustomOutputCompile({
-        ...flags,
-        output: installation.agentsDir
+    if (projectInstallation) {
+      const hadSkills = await this.runCompilePass({
+        label: "Project",
+        projectDir: cwd,
+        installation: projectInstallation,
+        agentDefs,
+        flags
       });
-    } else {
-      await this.runPluginModeCompile(flags, installation);
+      if (hadSkills) totalPassesWithSkills++;
+    }
+    if (totalPassesWithSkills === 0) {
+      this.error(
+        `No skills found. Add skills with '${CLI_BIN_NAME} add <skill>' or create in .claude/skills/.`,
+        { exit: EXIT_CODES.ERROR }
+      );
     }
   }
   async discoverAllSkills(projectDir = process.cwd()) {
@@ -177,11 +194,7 @@ var Compile = class _Compile extends BaseCommand {
     const allSkills = mergeSkills(pluginSkills, globalLocalSkills, localSkills);
     const totalSkillCount = typedKeys(allSkills).length;
     if (totalSkillCount === 0) {
-      this.log(ERROR_MESSAGES.NO_SKILLS_FOUND);
-      this.error(
-        `No skills found. Add skills with '${CLI_BIN_NAME} add <skill>' or create in .claude/skills/.`,
-        { exit: EXIT_CODES.ERROR }
-      );
+      return { allSkills, totalSkillCount };
     }
     if (pluginSkillCount > 0 && totalSkillCount > pluginSkillCount) {
       const localCount = totalSkillCount - pluginSkillCount;
@@ -195,56 +208,18 @@ var Compile = class _Compile extends BaseCommand {
     }
     return { allSkills, totalSkillCount };
   }
-  async resolveSourceForCompile(flags) {
-    this.log(STATUS_MESSAGES.RESOLVING_SOURCE);
-    try {
-      const sourceConfig = await resolveSource(flags.source);
-      this.log(`Source: ${sourceConfig.sourceOrigin}`);
-    } catch (error) {
-      this.log(ERROR_MESSAGES.FAILED_RESOLVE_SOURCE);
-      this.handleError(error);
-    }
-  }
-  async loadAgentDefsForCompile(flags) {
-    const projectDir = process.cwd();
-    this.log(
-      flags["agent-source"] ? STATUS_MESSAGES.FETCHING_AGENT_PARTIALS : STATUS_MESSAGES.LOADING_AGENT_PARTIALS
-    );
-    try {
-      const agentDefs = await getAgentDefinitions(flags["agent-source"], {
-        projectDir
-      });
-      this.log(flags["agent-source"] ? "Agent partials fetched" : "Agent partials loaded");
-      verbose(`  Agents: ${agentDefs.agentsDir}`);
-      verbose(`  Templates: ${agentDefs.templatesDir}`);
-      return agentDefs;
-    } catch (error) {
-      this.log(ERROR_MESSAGES.FAILED_LOAD_AGENT_PARTIALS);
-      return this.handleError(error);
-    }
-  }
-  async runPluginModeCompile(flags, installation) {
+  async runCompilePass(params) {
+    const { label, projectDir, installation, agentDefs, flags } = params;
     this.log("");
-    this.log("Plugin Mode Compile");
+    this.log(`Compiling ${label.toLowerCase()} agents...`);
     this.log("");
-    const projectDir = installation.projectDir;
-    const agentsDir = installation.agentsDir;
-    this.log("Using individual plugin mode");
     verbose(`  Project: ${projectDir}`);
-    verbose(`  Agents: ${agentsDir}`);
-    const loaded = await loadProjectConfigFromDir(projectDir);
-    if (loaded) {
-      const config = loaded.config;
-      const agentCount = config.agents?.length ?? 0;
-      const stackSkillCount = config.stack ? getStackSkillIds(config.stack).length : 0;
-      this.log(`Using config (${agentCount} agents, ${stackSkillCount} skills)`);
-      verbose(`  Config: ${loaded.configPath}`);
-    } else {
-      verbose(`  No config found - using defaults`);
+    verbose(`  Agents: ${installation.agentsDir}`);
+    const { allSkills, totalSkillCount } = await this.discoverAllSkills(projectDir);
+    if (totalSkillCount === 0) {
+      this.log(`No skills found for ${label.toLowerCase()} pass, skipping`);
+      return false;
     }
-    const { allSkills } = await this.discoverAllSkills(projectDir);
-    await this.resolveSourceForCompile(flags);
-    const agentDefs = await this.loadAgentDefsForCompile(flags);
     this.log(STATUS_MESSAGES.RECOMPILING_AGENTS);
     try {
       const recompileResult = await recompileAgents({
@@ -252,17 +227,17 @@ var Compile = class _Compile extends BaseCommand {
         sourcePath: agentDefs.sourcePath,
         skills: allSkills,
         projectDir,
-        outputDir: agentsDir
+        outputDir: installation.agentsDir
       });
       if (recompileResult.failed.length > 0) {
         this.log(
-          `Recompiled ${recompileResult.compiled.length} agents (${recompileResult.failed.length} failed)`
+          `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} agents`);
+        this.log(`Recompiled ${recompileResult.compiled.length} ${label.toLowerCase()} agents`);
       } else {
         this.log(INFO_MESSAGES.NO_AGENTS_TO_RECOMPILE);
       }
@@ -274,8 +249,37 @@ var Compile = class _Compile extends BaseCommand {
       this.handleError(error);
     }
     this.log("");
-    this.logSuccess(SUCCESS_MESSAGES.PLUGIN_COMPILE_COMPLETE);
+    this.logSuccess(`${label} compile complete!`);
     this.log("");
+    return true;
+  }
+  async resolveSourceForCompile(flags) {
+    this.log(STATUS_MESSAGES.RESOLVING_SOURCE);
+    try {
+      const sourceConfig = await resolveSource(flags.source);
+      this.log(`Source: ${sourceConfig.sourceOrigin}`);
+    } catch (error) {
+      this.log(ERROR_MESSAGES.FAILED_RESOLVE_SOURCE);
+      this.handleError(error);
+    }
+  }
+  async loadAgentDefsForCompile(flags) {
+    const projectDir = process.cwd();
+    this.log(
+      flags["agent-source"] ? STATUS_MESSAGES.FETCHING_AGENT_PARTIALS : STATUS_MESSAGES.LOADING_AGENT_PARTIALS
+    );
+    try {
+      const agentDefs = await getAgentDefinitions(flags["agent-source"], {
+        projectDir
+      });
+      this.log(flags["agent-source"] ? "Agent partials fetched" : "Agent partials loaded");
+      verbose(`  Agents: ${agentDefs.agentsDir}`);
+      verbose(`  Templates: ${agentDefs.templatesDir}`);
+      return agentDefs;
+    } catch (error) {
+      this.log(ERROR_MESSAGES.FAILED_LOAD_AGENT_PARTIALS);
+      return this.handleError(error);
+    }
   }
   async runCustomOutputCompile(flags) {
     const outputDir = path.resolve(process.cwd(), flags.output);
@@ -285,7 +289,13 @@ var Compile = class _Compile extends BaseCommand {
     this.log(`Output directory: ${outputDir}`);
     this.log("");
     await ensureDir(outputDir);
-    const { allSkills } = await this.discoverAllSkills();
+    const { allSkills, totalSkillCount } = await this.discoverAllSkills();
+    if (totalSkillCount === 0) {
+      this.error(
+        `No skills found. Add skills with '${CLI_BIN_NAME} add <skill>' or create in .claude/skills/.`,
+        { exit: EXIT_CODES.ERROR }
+      );
+    }
     await this.resolveSourceForCompile(flags);
     const agentDefs = await this.loadAgentDefsForCompile(flags);
     const projectDir = process.cwd();