@catladder/cli 0.0.0-next-2b60440e → 0.0.0-next-148db771

package/dist/bundles/catenv/index.js

@@ -1676,25 +1676,37 @@ exports.getShippedSkills = getShippedSkills;
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.getAgentSkillTargets = exports.AGENT_SKILL_TARGET_DIRS = void 0;
+exports.getAgentSkillTargets = exports.DEFAULT_AGENT_SKILL_TARGETS = exports.AGENT_SKILL_TARGET_DIRS = void 0;
 /**
  * where agent skills get materialized, per agent ecosystem:
- * - claude-code: the Claude Code project skills directory
+ * - claude-code: the Claude Code project skills directory (the default)
  * - agents: the cross-agent universal skills directory
- *   (https://agents.md convention, picked up by Cursor, Codex, ...)
+ *   (https://agents.md convention). Opt-in — as of now no widely-used
+ *   agent reads `.agents/skills/`; a repo that wants cross-agent
+ *   discovery can also just symlink `.agents/skills` → `.claude/skills`
+ *   once itself instead of enabling this target.
  */
 exports.AGENT_SKILL_TARGET_DIRS = {
     "claude-code": ".claude/skills",
     agents: ".agents/skills",
 };
+/**
+ * the target(s) written when `agentSkills` does not name any explicitly.
+ * Claude Code is the only agent that consumes these skills today, so we
+ * default to it alone rather than duplicating every skill into
+ * `.agents/skills/` (extra committed files + diff noise on every run).
+ */
+exports.DEFAULT_AGENT_SKILL_TARGETS = [
+    "claude-code",
+];
 const getAgentSkillTargets = (agentSkills) => {
     var _a;
     if (agentSkills === false)
         return [];
     if (agentSkills === true || agentSkills === undefined) {
-        return Object.keys(exports.AGENT_SKILL_TARGET_DIRS);
+        return [...exports.DEFAULT_AGENT_SKILL_TARGETS];
     }
-    return ((_a = agentSkills.targets) !== null && _a !== void 0 ? _a : Object.keys(exports.AGENT_SKILL_TARGET_DIRS));
+    return (_a = agentSkills.targets) !== null && _a !== void 0 ? _a : [...exports.DEFAULT_AGENT_SKILL_TARGETS];
 };
 exports.getAgentSkillTargets = getAgentSkillTargets;
 //# sourceMappingURL=types.js.map
@@ -9302,6 +9314,7 @@ __exportStar(__nccwpck_require__(47666), exports);
 __exportStar(__nccwpck_require__(60250), exports);
 __exportStar(__nccwpck_require__(38016), exports);
 __exportStar(__nccwpck_require__(35233), exports);
+__exportStar(__nccwpck_require__(8853), exports);
 //# sourceMappingURL=index.js.map
 
 /***/ }),

package/dist/bundles/cli/index.js

@@ -970,6 +970,7 @@ exports.ensureGcloudProjectNumbers = ensureGcloudProjectNumbers;
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.setupProject = void 0;
+const pipeline_1 = __nccwpck_require__(60241);
 const getProjectConfig_1 = __nccwpck_require__(50001);
 const setupAccessTokens_1 = __nccwpck_require__(64775);
 const setupContext_1 = __nccwpck_require__(63516);
@@ -978,6 +979,15 @@ const setupAgents_1 = __nccwpck_require__(73861);
 const logSection_1 = __nccwpck_require__(87105);
 const ensureGcloudProjectNumbers_1 = __nccwpck_require__(22661);
 const setupProject = async (instance, onlyComponents) => {
+    // refresh the agent skills first — store-independent, so it survives a
+    // later failure (e.g. missing gcloud auth in ensureGcloudProjectNumbers).
+    // This makes `catladder project setup` the one command that also lands
+    // the skills, so agents helping a migrating project get them even when
+    // catenv itself can't run yet (e.g. before the store is populated).
+    const config = await (0, getProjectConfig_1.getProjectConfig)();
+    if (config) {
+        await (0, pipeline_1.generateAgentSkills)((0, pipeline_1.createCatenvContext)(config));
+    }
     // must come first: creating contexts already requires the store
     await (0, ensureGcloudProjectNumbers_1.ensureGcloudProjectNumbers)(instance);
     const allContext = await (0, getProjectConfig_1.getAllPipelineContexts)(onlyComponents);
@@ -7659,25 +7669,37 @@ exports.getShippedSkills = getShippedSkills;
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.getAgentSkillTargets = exports.AGENT_SKILL_TARGET_DIRS = void 0;
+exports.getAgentSkillTargets = exports.DEFAULT_AGENT_SKILL_TARGETS = exports.AGENT_SKILL_TARGET_DIRS = void 0;
 /**
  * where agent skills get materialized, per agent ecosystem:
- * - claude-code: the Claude Code project skills directory
+ * - claude-code: the Claude Code project skills directory (the default)
  * - agents: the cross-agent universal skills directory
- *   (https://agents.md convention, picked up by Cursor, Codex, ...)
+ *   (https://agents.md convention). Opt-in — as of now no widely-used
+ *   agent reads `.agents/skills/`; a repo that wants cross-agent
+ *   discovery can also just symlink `.agents/skills` → `.claude/skills`
+ *   once itself instead of enabling this target.
  */
 exports.AGENT_SKILL_TARGET_DIRS = {
     "claude-code": ".claude/skills",
     agents: ".agents/skills",
 };
+/**
+ * the target(s) written when `agentSkills` does not name any explicitly.
+ * Claude Code is the only agent that consumes these skills today, so we
+ * default to it alone rather than duplicating every skill into
+ * `.agents/skills/` (extra committed files + diff noise on every run).
+ */
+exports.DEFAULT_AGENT_SKILL_TARGETS = [
+    "claude-code",
+];
 const getAgentSkillTargets = (agentSkills) => {
     var _a;
     if (agentSkills === false)
         return [];
     if (agentSkills === true || agentSkills === undefined) {
-        return Object.keys(exports.AGENT_SKILL_TARGET_DIRS);
+        return [...exports.DEFAULT_AGENT_SKILL_TARGETS];
     }
-    return ((_a = agentSkills.targets) !== null && _a !== void 0 ? _a : Object.keys(exports.AGENT_SKILL_TARGET_DIRS));
+    return (_a = agentSkills.targets) !== null && _a !== void 0 ? _a : [...exports.DEFAULT_AGENT_SKILL_TARGETS];
 };
 exports.getAgentSkillTargets = getAgentSkillTargets;
 //# sourceMappingURL=types.js.map
@@ -15285,6 +15307,7 @@ __exportStar(__nccwpck_require__(47666), exports);
 __exportStar(__nccwpck_require__(60250), exports);
 __exportStar(__nccwpck_require__(38016), exports);
 __exportStar(__nccwpck_require__(35233), exports);
+__exportStar(__nccwpck_require__(8853), exports);
 //# sourceMappingURL=index.js.map
 
 /***/ }),

package/dist/cli/src/apps/cli/commands/project/setup/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupProject = void 0;
+const pipeline_1 = require("../../../../../../../pipeline/src/index.js");
 const getProjectConfig_1 = require("../../../../../config/getProjectConfig");
 const setupAccessTokens_1 = require("./setupAccessTokens");
 const setupContext_1 = require("./setupContext");
@@ -9,6 +10,15 @@ const setupAgents_1 = require("./setupAgents");
 const logSection_1 = require("./logSection");
 const ensureGcloudProjectNumbers_1 = require("./ensureGcloudProjectNumbers");
 const setupProject = async (instance, onlyComponents) => {
+    // refresh the agent skills first — store-independent, so it survives a
+    // later failure (e.g. missing gcloud auth in ensureGcloudProjectNumbers).
+    // This makes `catladder project setup` the one command that also lands
+    // the skills, so agents helping a migrating project get them even when
+    // catenv itself can't run yet (e.g. before the store is populated).
+    const config = await (0, getProjectConfig_1.getProjectConfig)();
+    if (config) {
+        await (0, pipeline_1.generateAgentSkills)((0, pipeline_1.createCatenvContext)(config));
+    }
     // must come first: creating contexts already requires the store
     await (0, ensureGcloudProjectNumbers_1.ensureGcloudProjectNumbers)(instance);
     const allContext = await (0, getProjectConfig_1.getAllPipelineContexts)(onlyComponents);

package/dist/cli/src/apps/cli/commands/project/setup/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../src/apps/cli/commands/project/setup/index.ts"],"names":[],"mappings":";;;AACA,6EAAgF;AAChF,2DAAwD;AACxD,iDAA8C;AAC9C,6CAA0C;AAC1C,+CAA4C;AAC5C,6CAA0C;AAC1C,6EAA0E;AAEnE,MAAM,YAAY,GAAG,KAAK,EAC/B,QAAY,EACZ,cAAkC,EAClC,EAAE;IACF,gEAAgE;IAChE,MAAM,IAAA,uDAA0B,EAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,IAAA,yCAAsB,EAAC,cAAc,CAAC,CAAC;IAChE,QAAQ,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC3C,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,IAAA,uBAAU,EAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,IAAA,qCAAiB,EAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,IAAA,uBAAU,EAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,IAAA,yBAAW,EAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,IAAA,2BAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IACjD;QACE,kCAAkC;QAClC,2BAA2B;QAC3B,qDAAqD;QACrD,qBAAqB;QACrB,eAAe;KAChB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC;AAlCW,QAAA,YAAY,gBAkCvB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../src/apps/cli/commands/project/setup/index.ts"],"names":[],"mappings":";;;AAAA,kDAA+E;AAE/E,6EAGgD;AAChD,2DAAwD;AACxD,iDAA8C;AAC9C,6CAA0C;AAC1C,+CAA4C;AAC5C,6CAA0C;AAC1C,6EAA0E;AAEnE,MAAM,YAAY,GAAG,KAAK,EAC/B,QAAY,EACZ,cAAkC,EAClC,EAAE;IACF,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,uEAAuE;IACvE,oEAAoE;IACpE,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAgB,GAAE,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAA,8BAAmB,EAAC,IAAA,8BAAmB,EAAC,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,gEAAgE;IAChE,MAAM,IAAA,uDAA0B,EAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,IAAA,yCAAsB,EAAC,cAAc,CAAC,CAAC;IAChE,QAAQ,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC3C,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,IAAA,uBAAU,EAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,IAAA,qCAAiB,EAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,IAAA,uBAAU,EAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,IAAA,yBAAW,EAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,IAAA,2BAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IACjD;QACE,kCAAkC;QAClC,2BAA2B;QAC3B,qDAAqD;QACrD,qBAAqB;QACrB,eAAe;KAChB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC;AA5CW,QAAA,YAAY,gBA4CvB"}

package/dist/pipeline/src/agentSkills/types.d.ts

@@ -1,21 +1,31 @@
 /**
  * where agent skills get materialized, per agent ecosystem:
- * - claude-code: the Claude Code project skills directory
+ * - claude-code: the Claude Code project skills directory (the default)
  * - agents: the cross-agent universal skills directory
- *   (https://agents.md convention, picked up by Cursor, Codex, ...)
+ *   (https://agents.md convention). Opt-in — as of now no widely-used
+ *   agent reads `.agents/skills/`; a repo that wants cross-agent
+ *   discovery can also just symlink `.agents/skills` → `.claude/skills`
+ *   once itself instead of enabling this target.
  */
 export declare const AGENT_SKILL_TARGET_DIRS: {
     readonly "claude-code": ".claude/skills";
     readonly agents: ".agents/skills";
 };
 export type AgentSkillTargetName = keyof typeof AGENT_SKILL_TARGET_DIRS;
+/**
+ * the target(s) written when `agentSkills` does not name any explicitly.
+ * Claude Code is the only agent that consumes these skills today, so we
+ * default to it alone rather than duplicating every skill into
+ * `.agents/skills/` (extra committed files + diff noise on every run).
+ */
+export declare const DEFAULT_AGENT_SKILL_TARGETS: AgentSkillTargetName[];
 /**
  * agent skills materialization, see {@link Config.agentSkills}
  */
 export type AgentSkillsConfig = boolean | {
     /**
      * which agent skill directories to write to.
-     * Defaults to all known targets.
+     * Defaults to {@link DEFAULT_AGENT_SKILL_TARGETS} (`claude-code`).
      */
     targets?: AgentSkillTargetName[];
 };

package/dist/pipeline/src/agentSkills/types.js

@@ -1,24 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAgentSkillTargets = exports.AGENT_SKILL_TARGET_DIRS = void 0;
+exports.getAgentSkillTargets = exports.DEFAULT_AGENT_SKILL_TARGETS = exports.AGENT_SKILL_TARGET_DIRS = void 0;
 /**
  * where agent skills get materialized, per agent ecosystem:
- * - claude-code: the Claude Code project skills directory
+ * - claude-code: the Claude Code project skills directory (the default)
  * - agents: the cross-agent universal skills directory
- *   (https://agents.md convention, picked up by Cursor, Codex, ...)
+ *   (https://agents.md convention). Opt-in — as of now no widely-used
+ *   agent reads `.agents/skills/`; a repo that wants cross-agent
+ *   discovery can also just symlink `.agents/skills` → `.claude/skills`
+ *   once itself instead of enabling this target.
  */
 exports.AGENT_SKILL_TARGET_DIRS = {
     "claude-code": ".claude/skills",
     agents: ".agents/skills",
 };
+/**
+ * the target(s) written when `agentSkills` does not name any explicitly.
+ * Claude Code is the only agent that consumes these skills today, so we
+ * default to it alone rather than duplicating every skill into
+ * `.agents/skills/` (extra committed files + diff noise on every run).
+ */
+exports.DEFAULT_AGENT_SKILL_TARGETS = [
+    "claude-code",
+];
 const getAgentSkillTargets = (agentSkills) => {
     var _a;
     if (agentSkills === false)
         return [];
     if (agentSkills === true || agentSkills === undefined) {
-        return Object.keys(exports.AGENT_SKILL_TARGET_DIRS);
+        return [...exports.DEFAULT_AGENT_SKILL_TARGETS];
     }
-    return ((_a = agentSkills.targets) !== null && _a !== void 0 ? _a : Object.keys(exports.AGENT_SKILL_TARGET_DIRS));
+    return (_a = agentSkills.targets) !== null && _a !== void 0 ? _a : [...exports.DEFAULT_AGENT_SKILL_TARGETS];
 };
 exports.getAgentSkillTargets = getAgentSkillTargets;
 //# sourceMappingURL=types.js.map

package/dist/pipeline/src/agentSkills/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../pipeline/src/agentSkills/types.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,uBAAuB,GAAG;IACrC,aAAa,EAAE,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB;CAChB,CAAC;AAiBJ,MAAM,oBAAoB,GAAG,CAClC,WAA0C,EAClB,EAAE;;IAC1B,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACrC,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,MAAM,CAAC,IAAI,CAAC,+BAAuB,CAA2B,CAAC;IACxE,CAAC;IACD,OAAO,CACL,MAAA,WAAW,CAAC,OAAO,mCAClB,MAAM,CAAC,IAAI,CAAC,+BAAuB,CAA4B,CACjE,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,oBAAoB,wBAW/B"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../pipeline/src/agentSkills/types.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACU,QAAA,uBAAuB,GAAG;IACrC,aAAa,EAAE,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB;CAChB,CAAC;AAIX;;;;;GAKG;AACU,QAAA,2BAA2B,GAA2B;IACjE,aAAa;CACd,CAAC;AAeK,MAAM,oBAAoB,GAAG,CAClC,WAA0C,EAClB,EAAE;;IAC1B,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACrC,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,mCAA2B,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAA,WAAW,CAAC,OAAO,mCAAI,CAAC,GAAG,mCAA2B,CAAC,CAAC;AACjE,CAAC,CAAC;AARW,QAAA,oBAAoB,wBAQ/B"}

package/dist/pipeline/src/index.d.ts

@@ -15,3 +15,4 @@ export * from "./utils/measureTime";
 export * from "./variables/VariableValue";
 export * from "./bash";
 export * from "./catenv";
+export * from "./agentSkills";

package/dist/pipeline/src/index.js

@@ -31,4 +31,5 @@ __exportStar(require("./utils/measureTime"), exports);
 __exportStar(require("./variables/VariableValue"), exports);
 __exportStar(require("./bash"), exports);
 __exportStar(require("./catenv"), exports);
+__exportStar(require("./agentSkills"), exports);
 //# sourceMappingURL=index.js.map

package/dist/pipeline/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../pipeline/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,4CAA0B;AAC1B,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,qDAAmC;AACnC,sDAAoC;AACpC,4DAA0C;AAC1C,yCAAuB;AACvB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../pipeline/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,4CAA0B;AAC1B,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,qDAAmC;AACnC,sDAAoC;AACpC,4DAA0C;AAC1C,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B"}

package/dist/pipeline/src/types/config.d.ts

@@ -260,9 +260,12 @@ export type Config<C extends ConfigProps = never> = {
      * `.claude/skills/`) — that namespace is owned by catladder and must
      * not be edited manually.
      *
-     * - `true` (default): write to all known agent skill directories
+     * - `true` / omitted (default): write to `.claude/skills/` only
+     *   (Claude Code is the only agent that consumes these today)
      * - `false`: opt out (previously generated skills are removed)
-     * - `{ targets: [...] }`: only write to the given targets
+     * - `{ targets: [...] }`: write to the given targets, e.g.
+     *   `["claude-code", "agents"]` to also populate the cross-agent
+     *   `.agents/skills/` directory
      */
     agentSkills?: AgentSkillsConfig;
     /**