@catladder/cli 0.0.0-next-95928577 → 0.0.0-next-e7541a00

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

@@ -1,19 +1,22 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
 exports.registerGlobalScriptFunction = exports.globalScriptFunctions = void 0;
 class GlobalScriptFunction {
-    constructor(name, script) {
-        this.name = name;
-        this.script = script;
-    }
-    toBashFunction() {
-        return `function ${this.name} () {
+  constructor(name, script) {
+    this.name = name;
+    this.script = script;
+  }
+  toBashFunction() {
+    return `function ${this.name} () {
 ${this.script.trim()}
 }`.trim();
-    }
-    invoke(...args) {
-        return `${this.name} ${args.join(" ")}`;
-    }
+  }
+  invoke(...args) {
+    return `${this.name} ${args.join(" ")}`;
+  }
 }
 exports.globalScriptFunctions = new Map();
 /**
@@ -21,12 +24,11 @@ exports.globalScriptFunctions = new Map();
  * only use that in top-level scopes as it will attach the function to the global scope
  */
 const registerGlobalScriptFunction = (name, script) => {
-    if (exports.globalScriptFunctions.has(name)) {
-        throw new Error(`Global script function ${name} already exists`);
-    }
-    const scriptFunction = new GlobalScriptFunction(name, script);
-    exports.globalScriptFunctions.set(name, scriptFunction);
-    return scriptFunction;
+  if (exports.globalScriptFunctions.has(name)) {
+    throw new Error(`Global script function ${name} already exists`);
+  }
+  const scriptFunction = new GlobalScriptFunction(name, script);
+  exports.globalScriptFunctions.set(name, scriptFunction);
+  return scriptFunction;
 };
-exports.registerGlobalScriptFunction = registerGlobalScriptFunction;
-//# sourceMappingURL=index.js.map
+exports.registerGlobalScriptFunction = registerGlobalScriptFunction;

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

@@ -1,4 +1,5 @@
 export * from "./pipeline";
+export * from "./backends";
 export * from "./types";
 export * from "./rules";
 export * from "./runner";
@@ -7,5 +8,7 @@ export * from "./context";
 export * from "./build";
 export * from "./deploy";
 export * from "./utils/writeFiles";
+export * from "./utils/measureTime";
 export * from "./variables/VariableValue";
 export * from "./bash";
+export * from "./catenv";

package/dist/pipeline/src/index.js

@@ -1,20 +1,29 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+
+var __createBinding = this && this.__createBinding || (Object.create ? function (o, m, k, k2) {
+  if (k2 === undefined) k2 = k;
+  var desc = Object.getOwnPropertyDescriptor(m, k);
+  if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+    desc = {
+      enumerable: true,
+      get: function () {
+        return m[k];
+      }
+    };
+  }
+  Object.defineProperty(o, k2, desc);
+} : function (o, m, k, k2) {
+  if (k2 === undefined) k2 = k;
+  o[k2] = m[k];
+});
+var __exportStar = this && this.__exportStar || function (m, exports) {
+  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-Object.defineProperty(exports, "__esModule", { value: true });
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
 __exportStar(require("./pipeline"), exports);
+__exportStar(require("./backends"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./rules"), exports);
 __exportStar(require("./runner"), exports);
@@ -23,6 +32,7 @@ __exportStar(require("./context"), exports);
 __exportStar(require("./build"), exports);
 __exportStar(require("./deploy"), exports);
 __exportStar(require("./utils/writeFiles"), exports);
+__exportStar(require("./utils/measureTime"), exports);
 __exportStar(require("./variables/VariableValue"), exports);
 __exportStar(require("./bash"), exports);
-//# sourceMappingURL=index.js.map
+__exportStar(require("./catenv"), exports);

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,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,2CAAyB;AACzB,qDAAmC;AACnC,4DAA0C;AAC1C,yCAAuB"}
+{"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,4CAA0B;AAC1B,0CAAwB;AACxB,2CAAyB;AACzB,qDAAmC;AACnC,sDAAoC;AACpC,4DAA0C;AAC1C,yCAAuB;AACvB,2CAAyB"}

package/dist/pipeline/src/pipeline/agent/createAgentContext.d.ts

@@ -0,0 +1,23 @@
+import type { Config } from "../../types";
+export declare class AgentContext {
+  private readonly agentName;
+  private readonly config;
+  constructor(agentName: string, config: Config);
+  readonly type = "agent";
+  get name(): string;
+  get agentConfig(): import("../../types").AgentConfig;
+  get agentUser(): {
+    username: string;
+    userId: string;
+  };
+  get reviews(): {
+    byUser: Record<string, {
+      automatic: boolean;
+    }> | "all-automatic";
+  };
+  get fullConfig(): Config;
+}
+export declare const createAgentContext: (ctx: {
+  agentName: string;
+  config: Config;
+}) => Promise<AgentContext>;

package/dist/pipeline/src/pipeline/agent/createAgentContext.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createAgentContext = exports.AgentContext = void 0;
+class AgentContext {
+  constructor(agentName, config) {
+    this.agentName = agentName;
+    this.config = config;
+    this.type = "agent";
+  }
+  get name() {
+    return this.agentName;
+  }
+  get agentConfig() {
+    var _a;
+    const agentConfig = (_a = this.config.agents) === null || _a === void 0 ? void 0 : _a[this.agentName];
+    if (!agentConfig) {
+      throw new Error(`Agent ${this.agentName} not found in config`);
+    }
+    return agentConfig;
+  }
+  get agentUser() {
+    var _a, _b, _c, _d;
+    return {
+      username: (_b = (_a = this.agentConfig.agentUser) === null || _a === void 0 ? void 0 : _a.username) !== null && _b !== void 0 ? _b : "agent.claude",
+      userId: (_d = (_c = this.agentConfig.agentUser) === null || _c === void 0 ? void 0 : _c.userId) !== null && _d !== void 0 ? _d : "$DEFAULT_AGENT_USER_ID"
+    };
+  }
+  get reviews() {
+    var _a, _b;
+    return {
+      byUser: (_b = (_a = this.agentConfig.reviews) === null || _a === void 0 ? void 0 : _a.byUser) !== null && _b !== void 0 ? _b : {
+        [this.agentUser.username]: {
+          automatic: true
+        }
+      }
+    };
+  }
+  get fullConfig() {
+    return this.config;
+  }
+}
+exports.AgentContext = AgentContext;
+const createAgentContext = async ctx => {
+  return new AgentContext(ctx.agentName, ctx.config);
+};
+exports.createAgentContext = createAgentContext;

package/dist/pipeline/src/pipeline/agent/createAgentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgentContext.js","sourceRoot":"","sources":["../../../../../../pipeline/src/pipeline/agent/createAgentContext.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IACvB,YACmB,SAAiB,EACjB,MAAc;QADd,cAAS,GAAT,SAAS,CAAQ;QACjB,WAAM,GAAN,MAAM,CAAQ;QAGjB,SAAI,GAAG,OAAO,CAAC;IAF5B,CAAC;IAIJ,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,WAAW;;QACb,MAAM,WAAW,GAAG,MAAA,IAAI,CAAC,MAAM,CAAC,MAAM,0CAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,sBAAsB,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,SAAS;;QACX,OAAO;YACL,QAAQ,EAAE,MAAA,MAAA,IAAI,CAAC,WAAW,CAAC,SAAS,0CAAE,QAAQ,mCAAI,cAAc;YAChE,MAAM,EAAE,MAAA,MAAA,IAAI,CAAC,WAAW,CAAC,SAAS,0CAAE,MAAM,mCAAI,wBAAwB;SACvE,CAAC;IACJ,CAAC;IAED,IAAI,OAAO;;QACT,OAAO;YACL,MAAM,EAAE,MAAA,MAAA,IAAI,CAAC,WAAW,CAAC,OAAO,0CAAE,MAAM,mCAAI;gBAC1C,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;aAC/C;SACF,CAAC;IACJ,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAtCD,oCAsCC;AAEM,MAAM,kBAAkB,GAAG,KAAK,EAAE,GAGxC,EAAE,EAAE;IACH,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC,CAAC;AALW,QAAA,kBAAkB,sBAK7B"}

package/dist/pipeline/src/pipeline/agent/createAgentEventJob.d.ts

@@ -0,0 +1,5 @@
+import type { AgentContext } from "../../types";
+import { AgentJob } from "./shared";
+export declare class AgentEventJob extends AgentJob {
+  constructor(context: AgentContext);
+}

package/dist/pipeline/src/pipeline/agent/createAgentEventJob.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgentEventJob = void 0;
+const prompts_1 = require("./prompts");
+const shared_1 = require("./shared");
+const utils_1 = require("./utils");
+class AgentEventJob extends shared_1.AgentJob {
+  constructor(context) {
+    // unfortunatly, we need to manage both, because the "@mention"-feature only works with the username
+    const agentUserId = (0, utils_1.getAgentUserId)(context);
+    const agentUserName = (0, utils_1.getAgentUserName)(context);
+    super(context, {
+      interruptible: false,
+      // do not cancel this job if it is running. Otherwise a commit to main will cancel it
+      name: context.name + "-agent-event",
+      rules: [{
+        if: `$CI_PIPELINE_SOURCE  == "trigger" && ($ASSIGNEE_USER_ID == ${agentUserId} || $OBJECT_DESCRIPTION =~ /@${agentUserName}/)`,
+        when: "always"
+      }, {
+        when: "never"
+      }],
+      script: [...shared_1.baseSetupScript, ...(0, shared_1.callClaude)({
+        prompt: (0, prompts_1.getEventPrompt)({
+          agentUserName: agentUserName
+        })
+      })]
+    });
+  }
+}
+exports.AgentEventJob = AgentEventJob;

package/dist/pipeline/src/pipeline/agent/createAgentEventJob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgentEventJob.js","sourceRoot":"","sources":["../../../../../../pipeline/src/pipeline/agent/createAgentEventJob.ts"],"names":[],"mappings":";;;AACA,uCAA2C;AAC3C,qCAAiE;AACjE,mCAA2D;AAE3D,MAAa,aAAc,SAAQ,iBAAQ;IACzC,YAAY,OAAqB;QAC/B,oGAAoG;QACpG,MAAM,WAAW,GAAG,IAAA,sBAAc,EAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;QAChD,KAAK,CAAC,OAAO,EAAE;YACb,aAAa,EAAE,KAAK,EAAE,qFAAqF;YAC3G,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,cAAc;YACnC,KAAK,EAAE;gBACL;oBACE,EAAE,EAAE,8DAA8D,WAAW,gCAAgC,aAAa,IAAI;oBAC9H,IAAI,EAAE,QAAQ;iBACf;gBAED;oBACE,IAAI,EAAE,OAAO;iBACd;aACF;YACD,MAAM,EAAE;gBACN,GAAG,wBAAe;gBAClB,GAAG,IAAA,mBAAU,EAAC;oBACZ,MAAM,EAAE,IAAA,wBAAc,EAAC,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;iBACzD,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;CACF;AA1BD,sCA0BC"}

package/dist/pipeline/src/pipeline/agent/createAgentReviewJob.d.ts

@@ -0,0 +1,5 @@
+import type { AgentContext } from "../../types";
+import { AgentJob } from "./shared";
+export declare class AgentReviewJob extends AgentJob {
+  constructor(context: AgentContext);
+}

package/dist/pipeline/src/pipeline/agent/createAgentReviewJob.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgentReviewJob = void 0;
+const rules_1 = require("../../rules");
+const prompts_1 = require("./prompts");
+const shared_1 = require("./shared");
+const utils_1 = require("./utils");
+class AgentReviewJob extends shared_1.AgentJob {
+  constructor(context) {
+    const agentUserName = (0, utils_1.getAgentUserName)(context);
+    const rules = context.reviews.byUser === "all-automatic" ? [{
+      ...rules_1.RULE_IS_MERGE_REQUEST,
+      when: "always"
+    }] : Object.entries(context.reviews.byUser).filter(([_, {
+      automatic
+    }]) => automatic).map(([username]) => ({
+      // GITLAB_USER_LOGIN is the username of the user who created the pipeline
+      if: `${rules_1.RULE_IS_MERGE_REQUEST.if} && $GITLAB_USER_LOGIN == "${username}"`,
+      when: "always"
+    }));
+    super(context, {
+      envMode: "jobPerEnv",
+      name: context.name + "-agent-review",
+      allow_failure: true,
+      // make it optional
+      rules: [...rules, {
+        ...rules_1.RULE_IS_MERGE_REQUEST,
+        when: "manual"
+      }, {
+        when: "never"
+      }],
+      script: [...shared_1.baseSetupScript, ...(0, shared_1.callClaude)({
+        prompt: (0, prompts_1.getMergeRequestPrompt)({
+          agentUserName: agentUserName
+        })
+      })]
+    });
+  }
+}
+exports.AgentReviewJob = AgentReviewJob;

package/dist/pipeline/src/pipeline/agent/createAgentReviewJob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgentReviewJob.js","sourceRoot":"","sources":["../../../../../../pipeline/src/pipeline/agent/createAgentReviewJob.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AAEpD,uCAAkD;AAClD,qCAAiE;AACjE,mCAA2C;AAE3C,MAAa,cAAe,SAAQ,iBAAQ;IAC1C,YAAY,OAAqB;QAC/B,MAAM,aAAa,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;QAEhD,MAAM,KAAK,GACT,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,eAAe;YACxC,CAAC,CAAC;gBACE;oBACE,GAAG,6BAAqB;oBACxB,IAAI,EAAE,QAAQ;iBACf;aACF;YACH,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;iBACnC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC;iBACzC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpB,yEAAyE;gBACzE,EAAE,EAAE,GAAG,6BAAqB,CAAC,EAAE,8BAA8B,QAAQ,GAAG;gBACxE,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC,CAAC;QAEZ,KAAK,CAAC,OAAO,EAAE;YACb,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,eAAe;YACpC,aAAa,EAAE,IAAI,EAAE,mBAAmB;YACxC,KAAK,EAAE;gBACL,GAAG,KAAK;gBACR;oBACE,GAAG,6BAAqB;oBACxB,IAAI,EAAE,QAAQ;iBACf;gBACD;oBACE,IAAI,EAAE,OAAO;iBACd;aACF;YACD,MAAM,EAAE;gBACN,GAAG,wBAAe;gBAClB,GAAG,IAAA,mBAAU,EAAC;oBACZ,MAAM,EAAE,IAAA,+BAAqB,EAAC;wBAC5B,aAAa,EAAE,aAAa;qBAC7B,CAAC;iBACH,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;CACF;AA5CD,wCA4CC"}

package/dist/pipeline/src/pipeline/agent/createJobsForAgentContext.d.ts

@@ -0,0 +1,4 @@
+import type { AgentContext } from "../../types";
+import { AgentEventJob } from "./createAgentEventJob";
+import { AgentReviewJob } from "./createAgentReviewJob";
+export declare const createJobsForAgentContext: (context: AgentContext) => (AgentEventJob | AgentReviewJob)[];

package/dist/pipeline/src/pipeline/agent/createJobsForAgentContext.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createJobsForAgentContext = void 0;
+const createAgentEventJob_1 = require("./createAgentEventJob");
+const createAgentReviewJob_1 = require("./createAgentReviewJob");
+const createJobsForAgentContext = context => {
+  return [new createAgentEventJob_1.AgentEventJob(context), new createAgentReviewJob_1.AgentReviewJob(context)];
+};
+exports.createJobsForAgentContext = createJobsForAgentContext;

package/dist/pipeline/src/pipeline/agent/createJobsForAgentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJobsForAgentContext.js","sourceRoot":"","sources":["../../../../../../pipeline/src/pipeline/agent/createJobsForAgentContext.ts"],"names":[],"mappings":";;;AACA,+DAAsD;AACtD,iEAAwD;AAEjD,MAAM,yBAAyB,GAAG,CAAC,OAAqB,EAAE,EAAE;IACjE,OAAO,CAAC,IAAI,mCAAa,CAAC,OAAO,CAAC,EAAE,IAAI,qCAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC"}

package/dist/pipeline/src/pipeline/agent/prompts.d.ts

@@ -0,0 +1,6 @@
+type Ctx = {
+  agentUserName: string;
+};
+export declare const getEventPrompt: (ctx: Ctx) => string;
+export declare const getMergeRequestPrompt: (ctx: Ctx) => string;
+export {};

package/dist/pipeline/src/pipeline/agent/prompts.js

@@ -0,0 +1,286 @@
+"use strict";
+
+// prompts.ts — MCP-only, DRY, review-first-then-push, CI diagnosis (no retries),
+// self-mention guard, conversations-aware (issues & MRs), inline replies, de-duplication.
+// Review-on-demand: resolves MR pipeline and triggers manual "agent-review" when present.
+// Single-runner guard: cancels running "agent-review" on the MR pipeline before acting.
+// Stdout summaries included for both event and MR flows.
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getMergeRequestPrompt = exports.getEventPrompt = void 0;
+/* ---------- Shared blocks ---------- */
+const header = () => `
+Project ID: $CI_PROJECT_ID
+GitLab Host: $CI_SERVER_URL
+Default Branch: $CI_DEFAULT_BRANCH
+`;
+const identity = ({
+  agentUserName
+}) => `
+## Identity
+- Your GitLab username is "${agentUserName}".
+`;
+const goldenRules = ({
+  agentUserName
+}) => `
+## Golden Rules
+- Use the \`gitlab-mcp\` tool for ALL GitLab actions. Do not call any other APIs.
+- If a needed \`gitlab-mcp\` capability is unavailable, post a short comment explaining the limitation and stop.
+- NEVER mention yourself ("@${agentUserName}") anywhere (comments, descriptions, titles, commit messages).
+- NEVER push to $CI_DEFAULT_BRANCH or any protected branch. Always create a new branch and open a Merge Request (MR).
+- Always assign yourself as the assignee of any MR you create.
+- Do not create an MR for a **closed** issue.
+- Keep actions minimal and idempotent. Avoid duplicate comments or duplicate MRs.
+- Use ONE stable \`source_branch\` per run; do not regenerate its name later.
+`;
+/* ---------- Conversations + threading ---------- */
+const conversationsIntake = ({
+  agentUserName
+}) => `
+## Conversations Intake & Threading (MANDATORY before acting)
+Always load and reason about the current conversation to avoid duplicates and to respond in the right place.
+
+- **MRs**: Use \`mr_discussions({ projectId: $CI_PROJECT_ID, mergeRequestIid })\`.
+- **Issues**: Use issue discussions if available; if not, rely on event payload and note IDs.
+
+Rules:
+1) Detect latest human note (exclude "${agentUserName}"). If it replies to you or is in a discussion you started, reply **in the same thread**.
+2) If your last message is still the latest and no one else replied, prefer **update_note** instead of creating a new one.
+3) For MR code discussions: reply inline in the same discussion.
+4) Always sanitize (see Self-mention Guard) before writing.
+`;
+const selfMentionGuard = ({
+  agentUserName
+}) => `
+## Self-mention Guard
+Before ANY write (comment/MR/issue/commit message):
+- Remove all occurrences of "@${agentUserName}" (case-insensitive).
+- If the text becomes empty, skip the write.
+- If the last actor is you, skip acknowledgement comments.
+- To assign yourself, use assignee fields, not mentions.
+`;
+const commentGuidelines = () => `
+## Comment Guidelines
+- Professional, friendly, concise.
+- Always @-mention the human author when replying; never mention yourself.
+- Acknowledge requests, answer questions directly, confirm fixes or updates.
+- Avoid repeating boilerplate.
+`;
+/* ---------- gitlab-mcp tool usage ---------- */
+const mcpOnly = () => `
+## gitlab-mcp Operations
+
+- **Comments / Notes**
+  - create_issue_note({ projectId, issueIid, body })
+  - update_issue_note({ projectId, issueIid, noteId, body })
+  - create_merge_request_note({ projectId, mergeRequestIid, body })
+  - update_merge_request_note({ projectId, mergeRequestIid, noteId, body })
+  - mr_discussions({ projectId, mergeRequestIid })
+
+- **Issues**
+  - create_issue({ projectId, title, description, assigneeUsernames?: string[] })
+
+- **Branch & Files**
+  - create_branch({ projectId, branchName, ref })
+  - push_files({ projectId, branch, commitMessage, files: [{ filePath, content }] })
+  - create_or_update_file({ projectId, branch, filePath, content, commitMessage })
+  - get_branch_diffs({ projectId, from, to })
+
+- **Merge Requests**
+  - create_merge_request({ projectId, sourceBranch, targetBranch, title, description, assigneeUsernames?: string[] })
+  - get_merge_request({ projectId, mergeRequestIid })
+  - get_merge_request_diffs({ projectId, mergeRequestIid })
+  - list_merge_request_diffs({ projectId, mergeRequestIid, page?, perPage? })
+  - update_merge_request({ projectId, mergeRequestIid, title?, description?, draft?, assigneeUsernames? })
+
+- **Pipelines / Jobs**
+  - list_pipelines({ projectId, ref?, sha?, status?, orderBy?, sort? })
+  - list_pipeline_jobs({ projectId, pipelineId })
+  - get_pipeline_job_output({ projectId, pipelineId, jobId })
+  - play_pipeline_job({ projectId, jobId })
+  - cancel_pipeline_job({ projectId, jobId })
+`;
+const outputDiscipline = ({
+  agentUserName
+}) => `
+## Output Discipline
+- Output only \`gitlab-mcp\` tool calls and plain-text summaries where requested.
+- Keep comments concise and professional.
+- Never include "@${agentUserName}" in any body.
+`;
+/* ---------- Event-specific helpers ---------- */
+const eventSelfParse = () => `
+## Self-Parse Raw Payload
+From \`event_json\`, extract:
+- kind: "issue" | "merge_request" | "note"
+- iid from URL (/issues/<n>, /merge_requests/<n>)
+- note_id if present (#note_<id>)
+- description/body, state, author, timestamps
+- project id/path
+- discussion id if available for inline replies
+`;
+/* Resolve MR pipeline from MR IID */
+const resolveMrPipeline = () => `
+## Resolve MR Pipeline
+1) get_merge_request({ projectId, mergeRequestIid }) → sourceBranch, sha
+2) Prefer: list_pipelines({ projectId, sha })
+3) Else: list_pipelines({ projectId, ref: sourceBranch, orderBy: "updated_at", sort: "desc" })
+4) Pick newest → mr_pipeline_id
+`;
+/* Guard against double agent-review jobs */
+const singleRunnerGuard = () => `
+## Single-Runner Guard
+- If mr_pipeline_id available:
+  - list_pipeline_jobs({ projectId, pipelineId: mr_pipeline_id })
+  - cancel_pipeline_job on any running/pending job ending with "agent-review"
+- If not available, note limitation and proceed
+`;
+/* If user asks for review from an event, try manual agent-review job first on the MR's pipeline */
+const reviewOnDemandFromEvents = () => `
+## Review-on-Demand
+If the text asks for a review ("review", "please review", "PTAL", "needs review", "can you look at", "LGTM?"):
+1) Resolve MR IID (from target or text).
+2) Resolve MR pipeline (do NOT use the event pipeline).
+3) If a manual "agent-review" job exists, play it → confirm in-thread → STOP.
+4) Else run Single-Runner Guard, then enter MR Review Mode.
+`;
+/* ---------- Event workflow ---------- */
+const eventWorkflow = ({
+  agentUserName
+}) => `
+## Event Workflow
+0) Conversations Intake first
+1) Acknowledge with note (unless last actor is you)
+2) Default branch: use \`$CI_DEFAULT_BRANCH\`
+3) Create branch from \`$CI_DEFAULT_BRANCH\`:
+   create_branch({ projectId: $CI_PROJECT_ID, branchName: "<source_branch>", ref: $CI_DEFAULT_BRANCH })
+4) Write changes → commit → push:
+   push_files({ projectId: $CI_PROJECT_ID, branch: "<source_branch>", commitMessage, files })
+   - Ensure files list is not empty before calling push_files; if empty, skip pushing.
+5) Verify:
+   get_branch_diffs({ projectId: $CI_PROJECT_ID, from: $CI_DEFAULT_BRANCH, to: "<source_branch>" })
+   - Require non-empty diffs
+6) Create MR (if diffs exist):
+   create_merge_request({
+     projectId: $CI_PROJECT_ID,
+     sourceBranch: "<source_branch>",
+     targetBranch: $CI_DEFAULT_BRANCH,
+     title,
+     description,  // include "Closes #<issue_iid>" when applicable
+     assigneeUsernames: ["${agentUserName}"]
+   })
+7) Follow-up note (in correct thread) with branch, short SHA if available, files-changed count, and MR link (unless last actor is you)
+8) If verification fails: comment error and STOP
+
+## Stdout Summary (Event)
+Print a plain-text summary with:
+- action: "event"
+- source_branch
+- target_branch: $CI_DEFAULT_BRANCH
+- diff_count (from get_branch_diffs)
+- mr_iid and/or mr_url if created
+- any note ids created/updated
+- any limitations encountered (e.g., missing discussions tool)
+`;
+/* ---------- MR-specific ---------- */
+const mrScope = ({
+  agentUserName
+}) => `
+## MR Scope
+- You are reviewing a single MR
+- Never merge the MR yourself
+- Work only on the MR's source branch
+`;
+const mrWorkflow = () => `
+## MR Workflow
+1) get_merge_request + get_merge_request_diffs + mr_discussions
+2) Conversations Intake
+3) Post review comments first via create_merge_request_note (sanitize)
+4) If will_push_changes = true:
+   - push_files to source branch
+   - verify with get_branch_diffs({ from: targetBranch || $CI_DEFAULT_BRANCH, to: sourceBranch })
+   - follow-up note summarizing changes in the right thread (sanitize)
+
+## Stdout Summary (MR)
+Print a plain-text summary with:
+- action: "mr"
+- mr_iid
+- source_branch and target_branch (fallback to $CI_DEFAULT_BRANCH)
+- will_push_changes: true|false
+- diff_count (post-push, if applicable)
+- discussions: number of notes added/updated
+- ci: whether mr_pipeline_id was resolved
+- blocking_failed_jobs (names+stages) if inspected
+`;
+/* ---------- CI Inspection (shared) ---------- */
+const ciInspection = () => `
+## CI Inspection (diagnose only)
+- Use mr_pipeline_id if available
+- list_pipeline_jobs → for each failed + allow_failure=false:
+  - get_pipeline_job_output
+  - classify: code vs infra
+  - Do not retry; only report diagnosis in a note
+- If no mr_pipeline_id, note limitation
+`;
+const outputDisciplineMR = ({
+  agentUserName
+}) => `
+## Output Discipline (MR)
+- Only gitlab-mcp calls + final summary
+- Never merge MR
+- Never mention "@${agentUserName}"
+`;
+/* ---------- MR Review Bundle ---------- */
+const mrReviewBundle = ctx => `
+## MR Review Mode
+${mrScope(ctx)}
+${mrWorkflow()}
+${ciInspection()}
+`;
+/* ---------- Public builders ---------- */
+const getEventPrompt = ctx => `
+You are a GitLab assistant bot. You receive ONE raw GitLab webhook JSON payload.
+
+${header()}
+---
+event_json:
+$(cat $TRIGGER_PAYLOAD)
+---
+
+${identity(ctx)}
+${goldenRules(ctx)}
+${selfMentionGuard(ctx)}
+${conversationsIntake(ctx)}
+${eventSelfParse()}
+${resolveMrPipeline()}
+${singleRunnerGuard()}
+${reviewOnDemandFromEvents()}
+${mrReviewBundle(ctx)}
+${eventWorkflow(ctx)}
+${commentGuidelines()}
+${mcpOnly()}
+${outputDiscipline(ctx)}
+`;
+exports.getEventPrompt = getEventPrompt;
+const getMergeRequestPrompt = ctx => `
+You are a GitLab assistant bot reviewing and updating a single Merge Request (MR).
+
+${header()}
+---
+merge_request_iid: $CI_MERGE_REQUEST_IID
+title: $CI_MERGE_REQUEST_TITLE
+description: $CI_MERGE_REQUEST_DESCRIPTION
+---
+
+${mrScope(ctx)}
+${goldenRules(ctx)}
+${selfMentionGuard(ctx)}
+${conversationsIntake(ctx)}
+${mrWorkflow()}
+${ciInspection()}
+${commentGuidelines()}
+${mcpOnly()}
+${outputDisciplineMR(ctx)}
+`;
+exports.getMergeRequestPrompt = getMergeRequestPrompt;

package/dist/pipeline/src/pipeline/agent/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../../../../pipeline/src/pipeline/agent/prompts.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/src/pipeline/agent/shared.d.ts

@@ -0,0 +1,11 @@
+import type { AgentContext, CatladderJobSpec } from "../../types";
+import { CatladderJob } from "../../types/jobs";
+export declare abstract class AgentJob extends CatladderJob {
+  constructor(context: AgentContext, def: Pick<CatladderJobSpec, "name" | "rules" | "script"> & Partial<Pick<CatladderJobSpec, "envMode" | "interruptible" | "allow_failure" | "variables">>);
+}
+export declare const baseSetupScript: string[];
+export declare const callClaude: ({
+  prompt
+}: {
+  prompt: string;
+}) => string[];