@cat-factory/orchestration 0.298.0 → 0.300.0

package/dist/modules/bootstrap/MonorepoBootstrapController.js

@@ -1,4 +1,4 @@
-import { ConflictError, getErrorMessage, monorepoBootstrapBranch, NotFoundError, parseAdoptionDecisions, PR_ADOPTION_MARKERS, redactSecrets, renderAdoptionPrSection, spliceManagedSection, UnavailableError, ValidationError, } from '@cat-factory/kernel';
+import { ConflictError, getErrorMessage, NotFoundError, parseAdoptionDecisions, PR_ADOPTION_MARKERS, redactSecrets, renderAdoptionPrSection, spliceManagedSection, UnavailableError, ValidationError, } from '@cat-factory/kernel';
 import { normalizeServiceDirectory } from '../board/serviceRepoLinkage.js';
 import { surveyMonorepo } from './monorepoSurvey.js';
 /**
@@ -118,10 +118,6 @@ export class MonorepoBootstrapController {
             installationId: repo.installationId,
         };
     }
-    /** The branch the apply phase pushes; stable per run so a retry resumes rather than forks. */
-    branchFor(jobId) {
-        return monorepoBootstrapBranch(jobId);
-    }
     /**
      * Survey both repositories and produce the plan a human reviews. NEVER throws: every failure
      * becomes a plan recorded `unavailable` with the cause, because the run parks either way and a

package/dist/modules/bootstrap/MonorepoBootstrapController.js.map

@@ -1 +1 @@
-{"version":3,"file":"MonorepoBootstrapController.js","sourceRoot":"","sources":["../../../src/modules/bootstrap/MonorepoBootstrapController.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAmB,MAAM,qBAAqB,CAAA;AAiCrE;;;;;;;;;;;GAWG;AACH,SAAS,WAAW;IAClB,OAAO;QACL,KAAK,EAAE,EAAE;QACT,eAAe,EAAE,EAAE;QACnB,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;YACR,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,CAAC;YACR,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,CAAC;SAClB;KACF,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,KAAK,GAAG,kCAAkC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA;IACpD,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACnE,CAAC;AASD,MAAM,OAAO,2BAA2B;IACT,IAAI;IAAjC,YAA6B,IAA2B;oBAA3B,IAAI;IAA0B,CAAC;IAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,aAAa,CACjB,YAA8B,EAC9B,WAAmB,EACnB,MAA+B;QAE/B,MAAM,SAAS,GAAG,yBAAyB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,eAAe,CAAC,qDAAqD,EAAE;gBAC/E,MAAM,EAAE,6BAA6B;aACtC,CAAC,CAAA;QACJ,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAA;QACxD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,4FAA4F;YAC5F,wFAAwF;YACxF,MAAM,IAAI,gBAAgB,CACxB,0GAA0G,CAC3G,CAAA;QACH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;QACvF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,0FAA0F;YAC1F,qFAAqF;YACrF,mFAAmF;YACnF,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;gBACjE,MAAM,EAAE,iBAAiB;aAC1B,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACrF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,eAAe,CACvB,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,yLAAyL,EACnN,EAAE,MAAM,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAC1E,CAAA;QACH,CAAC;QACD,2FAA2F;QAC3F,0FAA0F;QAC1F,yFAAyF;QACzF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;QAC5E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,aAAa,CACrB,KAAK,SAAS,wBAAwB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,mIAAmI,EAChM,0BAA0B,EAC1B,EAAE,SAAS,EAAE,CACd,CAAA;QACH,CAAC;QAED,MAAM,YAAY,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;QACvE,OAAO;YACL,GAAG,EAAE;gBACH,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,SAAS;gBACT,SAAS,EAAE,IAAI,CAAC,KAAK;gBACrB,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,MAAM,EAAE,IAAI;aACb;YACD,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAA;IACH,CAAC;IAED,8FAA8F;IAC9F,SAAS,CAAC,KAAa;QACrB,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CACrB,WAAmB,EACnB,MAA0B,EAC1B,SAA6C;QAE7C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;QAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,2CAA2C,CAAC,CAAA;QACzF,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;QAEtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACpF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,WAAW,CACrB,iBAAiB,EACjB,GAAG,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,QAAQ,6DAA6D,CACxG,CAAA;QACH,CAAC;QACD,4FAA4F;QAC5F,4FAA4F;QAC5F,0FAA0F;QAC1F,mEAAmE;QACnE,MAAM,YAAY,GAAG,SAAS;YAC5B,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,QAAQ,CAAC;YACvE,CAAC,CAAC,SAAS,CAAA;QAEb,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC;YACnC,QAAQ,EAAE,QAAQ;YAClB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,MAAM,EAAE,GAAG;SACZ,CAAC,CAAA;QACF,IAAI,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,OAAO,CAAC,eAAe,CACrB,UAAU,EACV,GAAG,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,QAAQ,EAAE,EAC9C,sDAAsD,CACvD,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAA;QACzC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YACtB,OAAO;gBACL,GAAG,IAAI,CAAC,WAAW,CACjB,mBAAmB,EACnB,oIAAoI,CACrI;gBACD,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;aACzB,CAAA;QACH,CAAC;QAED,kFAAkF;QAClF,6FAA6F;QAC7F,8FAA8F;QAC9F,wFAAwF;QACxF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;QAC1D,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,GAAG,IAAI,CAAC,WAAW,CACjB,kBAAkB,EAClB,iMAAiM,CAClM;gBACD,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;aACzB,CAAA;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBAC3C,WAAW;gBACX,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,kFAAkF;gBAClF,iEAAiE;gBACjE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;gBACxB,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;gBAC1B,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAA;YACF,yFAAyF;YACzF,2FAA2F;YAC3F,4FAA4F;YAC5F,wFAAwF;YACxF,0BAA0B;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAA;YAC/B,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACnE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO;oBACL,GAAG,IAAI,CAAC,WAAW,CACjB,mBAAmB,EACnB,OAAO,CAAC,MAAM,GAAG,CAAC;wBAChB,CAAC,CAAC,8CAA8C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;wBACrE,CAAC,CAAC,sCAAsC,CAC3C;oBACD,MAAM;oBACN,kBAAkB,EAAE,OAAO;oBAC3B,KAAK;iBACN,CAAA;YACH,CAAC;YACD,GAAG,EAAE,IAAI,CAAC,yCAAyC,EAAE;gBACnD,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,0FAA0F;gBAC1F,kDAAkD;gBAClD,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;gBAChC,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK;gBAC1C,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS;gBACvC,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,cAAc;gBACjD,KAAK;aACN,CAAC,CAAA;YACF,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,iBAAiB,EAAE,IAAI;gBACvB,iBAAiB,EAAE,IAAI;gBACvB,MAAM;gBACN,SAAS;gBACT,kBAAkB,EAAE,OAAO;gBAC3B,KAAK;gBACL,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;aACnC,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wFAAwF;YACxF,yFAAyF;YACzF,4FAA4F;YAC5F,OAAO;gBACL,GAAG,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;gBAChE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;aACzB,CAAA;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,UAAU,CAAC,WAAmB,EAAE,GAAuB;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAA;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QACxB,IAAI,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,WAAW,CAAC,CAAA;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,EAAE,IAAI,CAAC,qEAAqE,EAAE;gBAC/E,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC;aAC5B,CAAC,CAAA;YACF,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,wBAAwB,CAC5B,WAAmB,EACnB,QAA8B,EAC9B,KAAa,EACb,QAA0B;QAE1B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,MAAM,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,KAAK,EAAE,CAAC,CAAA;QAC1F,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,WAAW,EAAE;YACrE,KAAK,EAAE,QAAQ,CAAC,SAAS;YACzB,IAAI,EAAE,QAAQ,CAAC,QAAQ;SACxB,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,kBAAkB,CAAA;QAC3C,MAAM,KAAK,GAAG,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAA;QAC/C,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;QACzF,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAA;QAClC,4FAA4F;QAC5F,gDAAgD;QAChD,MAAM,OAAO,GAAG,aAAa,CAAC,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1F,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAA;QACxE,IAAI,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;YAAE,OAAM;QACpC,MAAM,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC3B,CAAC;IAED,8FAA8F;IACtF,KAAK,CAAC,IAAI,CAChB,WAAmB,EACnB,KAAa,EACb,IAAY;QAEZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1F,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAA;QAC/B,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAA;IAC9D,CAAC;IAED,iEAAiE;IACzD,WAAW,CAAC,MAAqC,EAAE,MAAc;QACvE,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,iBAAiB,EAAE,MAAM;YACzB,iBAAiB,EAAE,MAAM;YACzB,MAAM,EAAE,WAAW,EAAE;YACrB,SAAS,EAAE,EAAE;YACb,kBAAkB,EAAE,EAAE;YACtB,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;SACnC,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"MonorepoBootstrapController.js","sourceRoot":"","sources":["../../../src/modules/bootstrap/MonorepoBootstrapController.ts"],"names":[],"mappings":"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"}

package/dist/modules/bootstrap/bootstrapDelivery.d.ts

@@ -0,0 +1,20 @@
+import type { BootstrapDelivery, BootstrapDeliveryPlan, BootstrapJobRecord } from '@cat-factory/kernel';
+/**
+ * The delivery a request that named none takes.
+ *
+ * The two targets want opposite answers and that is the whole reason the rule lives here rather
+ * than as a schema default: a repository this run is creating has nobody to review its first
+ * commit, and a monorepo's default branch is the branch every other service is built from.
+ */
+export declare function defaultDelivery(intoMonorepo: boolean): BootstrapDelivery;
+/**
+ * Turn a run's recorded `delivery` into the plan a dispatch acts on: the work branch and
+ * pull-request text, or nothing at all.
+ *
+ * One place, read by both targets, because the two dispatch sites otherwise each decide what a
+ * `pull_request` run means and only one of them is ever exercised by the test you are writing.
+ * `resolved` is the settled adoption review, present only on a monorepo apply; without one the
+ * body is the new-repo fallback, since there is no reviewed decision to publish.
+ */
+export declare function deliveryPlanFor(record: BootstrapJobRecord, resolved?: NonNullable<BootstrapJobRecord['adoptionReview']>): BootstrapDeliveryPlan;
+//# sourceMappingURL=bootstrapDelivery.d.ts.map

package/dist/modules/bootstrap/bootstrapDelivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapDelivery.d.ts","sourceRoot":"","sources":["../../../src/modules/bootstrap/bootstrapDelivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,qBAAqB,CAAA;AAoB5B;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,OAAO,GAAG,iBAAiB,CAExE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,GAC3D,qBAAqB,CA0BvB"}

package/dist/modules/bootstrap/bootstrapDelivery.js

@@ -0,0 +1,83 @@
+import { bootstrapWorkBranch, hostMarkdown, redactSecrets, renderAdoptionPrSection, } from '@cat-factory/kernel';
+import { bootstrapPrTitle } from '@cat-factory/agents';
+// ---------------------------------------------------------------------------
+// How a bootstrap run's work LEAVES the container: the rule for a request that named no
+// delivery, and the plan a dispatch acts on once one is recorded.
+//
+// A module of its own rather than three more members on `BootstrapService`, because all of it
+// is a pure function of the stored run: nothing here reads a repository, a clock or a port, so
+// keeping it beside the orchestration only made the delivery rule reachable exclusively through
+// a run that had already been started, and put a PR BODY (a host-rendered, untrusted-text
+// surface with its own escaping and scrubbing rules) in the middle of a 1,400-line service.
+// ---------------------------------------------------------------------------
+/**
+ * The delivery a request that named none takes.
+ *
+ * The two targets want opposite answers and that is the whole reason the rule lives here rather
+ * than as a schema default: a repository this run is creating has nobody to review its first
+ * commit, and a monorepo's default branch is the branch every other service is built from.
+ */
+export function defaultDelivery(intoMonorepo) {
+    return intoMonorepo ? 'pull_request' : 'direct_push';
+}
+/**
+ * Turn a run's recorded `delivery` into the plan a dispatch acts on: the work branch and
+ * pull-request text, or nothing at all.
+ *
+ * One place, read by both targets, because the two dispatch sites otherwise each decide what a
+ * `pull_request` run means and only one of them is ever exercised by the test you are writing.
+ * `resolved` is the settled adoption review, present only on a monorepo apply; without one the
+ * body is the new-repo fallback, since there is no reviewed decision to publish.
+ */
+export function deliveryPlanFor(record, resolved) {
+    if (record.delivery === 'direct_push')
+        return { mode: 'direct_push' };
+    const directory = record.monorepo?.directory;
+    return {
+        mode: 'pull_request',
+        // The branch the run RECORDED, which is what a retry carries forward: deriving it off
+        // `record.id` here would mint a new one per attempt (a retry is a new row), so the harness's
+        // resume would never fire and the previous attempt's pushed work would be abandoned on an
+        // orphan branch. A row written before the field existed carries none, and this attempt then
+        // claims one off its own id, exactly as that row's own dispatch did.
+        branch: record.workBranch ?? bootstrapWorkBranch(record.id),
+        pr: {
+            title: bootstrapPrTitle(record.repoName, directory),
+            // The HOST rendering (neutralised holes, scrubbed at compose time), never the agent brief:
+            // this string lands on a pull request body, where a reviewer's note reading "fixes #412"
+            // would close an unrelated issue on merge. It is the FALLBACK body; on a monorepo run the
+            // engine also publishes the same decisions as its own marker region once the pull request
+            // exists, because the harness lets an agent-authored description replace this one. BOTH
+            // bodies are scrubbed: a PR body is strictly more exposed than the telemetry DB, and a
+            // reference architecture's name is free text somebody typed.
+            body: resolved && directory
+                ? (redactSecrets(renderAdoptionPrSection(resolved, directory)) ?? '')
+                : (redactSecrets(newRepoPrBody(record.repoName, record.referenceArchitectureName)) ?? ''),
+        },
+    };
+}
+/**
+ * The pull-request body a run that has no adoption review to publish opens with.
+ *
+ * Only ever the FALLBACK: the harness lets the agent's own `.cat-pr-description.md` replace it
+ * field-wise, and the PR-description guidance rides every agent pass, so a run whose agent wrote
+ * a briefing publishes that instead. What this owes is one honest sentence for the run whose
+ * agent wrote none, naming where the code came from rather than leaving a reviewer an empty body.
+ *
+ * Every hole goes through `hostMarkdown`, which is the rule for a host-rendered surface
+ * regardless of how constrained the value looks from here. Both are rendered as CODE SPANS, so
+ * they go through `inlineCode`, which sizes the backtick run around the value: hand-writing the
+ * ticks around `inline` would be wrong twice over, because `inline` skips escaping whatever it
+ * reads as an existing code span (a name holding `` `#42` `` would auto-link an issue on the new
+ * repository's first pull request) and its numeric entities are not decoded inside a span (a name
+ * holding `@ops` would reach the reader as `@ops`).
+ */
+function newRepoPrBody(repoName, referenceName) {
+    const from = referenceName
+        ? `the ${hostMarkdown.inlineCode(referenceName)} reference architecture`
+        : 'a freeform brief';
+    return (`Bootstrapped ${hostMarkdown.inlineCode(repoName)} from ${from}.\n\n` +
+        `This is the repository's first content: review it before merging, because merging is what ` +
+        `makes it the default branch every later run builds on.`);
+}
+//# sourceMappingURL=bootstrapDelivery.js.map

package/dist/modules/bootstrap/bootstrapDelivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapDelivery.js","sourceRoot":"","sources":["../../../src/modules/bootstrap/bootstrapDelivery.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,uBAAuB,GACxB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,8EAA8E;AAC9E,wFAAwF;AACxF,kEAAkE;AAClE,EAAE;AACF,8FAA8F;AAC9F,+FAA+F;AAC/F,gGAAgG;AAChG,0FAA0F;AAC1F,4FAA4F;AAC5F,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,YAAqB;IACnD,OAAO,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAA;AACtD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA0B,EAC1B,QAA4D;IAE5D,IAAI,MAAM,CAAC,QAAQ,KAAK,aAAa;QAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;IACrE,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5C,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,sFAAsF;QACtF,6FAA6F;QAC7F,0FAA0F;QAC1F,4FAA4F;QAC5F,qEAAqE;QACrE,MAAM,EAAE,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,EAAE,EAAE;YACF,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;YACnD,2FAA2F;YAC3F,yFAAyF;YACzF,0FAA0F;YAC1F,0FAA0F;YAC1F,wFAAwF;YACxF,uFAAuF;YACvF,6DAA6D;YAC7D,IAAI,EACF,QAAQ,IAAI,SAAS;gBACnB,CAAC,CAAC,CAAC,aAAa,CAAC,uBAAuB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;gBACrE,CAAC,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,yBAAyB,CAAC,CAAC,IAAI,EAAE,CAAC;SAC9F;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,aAAa,CAAC,QAAgB,EAAE,aAA4B;IACnE,MAAM,IAAI,GAAG,aAAa;QACxB,CAAC,CAAC,OAAO,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,yBAAyB;QACxE,CAAC,CAAC,kBAAkB,CAAA;IACtB,OAAO,CACL,gBAAgB,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,IAAI,OAAO;QACrE,4FAA4F;QAC5F,wDAAwD,CACzD,CAAA;AACH,CAAC"}

package/dist/modules/execution/BugFishingController.d.ts

@@ -0,0 +1,277 @@
+import type { AddressBugFishingFindingsInput, Block, BlockRepository, BugFishingAgentOutput, BugFishingStepState, Clock, ExecutionInstance, ExecutionEventPublisher, ExecutionRepository, IdGenerator, Logger, PipelineRepository, PipelineStep, ServiceRepository, WorkspaceSettingsRepository } from '@cat-factory/kernel';
+import type { TaskTypeCreationDefaults } from '../board/taskTypeCreationDefaults.js';
+import type { NotificationService } from '../notifications/NotificationService.js';
+import type { AdvanceResult } from './advance.js';
+import type { RunStateMachine } from './RunStateMachine.js';
+import type { StepGraph } from './StepGraph.js';
+/** The step kind the bug-fishing phase loop runs on (the read-only expedition agent). */
+export declare const BUG_FISHING_STEP_KIND = "bug-fisher";
+/** What the bug-fishing controller needs beyond the shared run state-machine spine. */
+export interface BugFishingControllerDeps {
+    executionRepository: ExecutionRepository;
+    blockRepository: BlockRepository;
+    pipelineRepository: PipelineRepository;
+    /**
+     * Where a board's default fix pipeline lives. Optional for the same reason the verification
+     * report's read of it is: a deployment that wires no settings store has no configured default,
+     * which is a different fact from a store that cannot be read (see
+     * {@link BugFishingController.resolveDefaultFixPipelineId}).
+     */
+    workspaceSettingsRepository?: WorkspaceSettingsRepository;
+    /** The async instance/block spine (park/advance/persist/emit/progress). */
+    stateMachine: RunStateMachine;
+    /** The pure step mutators (start/finish/pause a step). */
+    stepGraph: StepGraph;
+    idGenerator: IdGenerator;
+    clock: Clock;
+    /** Resolves the frame block's service row, so a spawned task lands in the right service. */
+    serviceRepository?: ServiceRepository;
+    /**
+     * The task-type creation defaults, narrowed to the one question a spawn asks: which
+     * best-practice fragments a new `bug` task under this service is created with. The SAME seam
+     * `BoardService.addTask` reads, so a spawned fix and a hand-filed one are held to one set of
+     * standards. Absent ⇒ no fragments, the answer a deployment with no fragment pool gets anyway.
+     */
+    taskTypeDefaults?: Pick<TaskTypeCreationDefaults, 'fragmentIdsFor'>;
+    /** Bound `ExecutionService.start` — a spawned fix starts through the real entry point. */
+    start: (workspaceId: string, blockId: string, pipelineId: string, opts: {
+        initiatedBy: string | null;
+    }) => Promise<{
+        id: string;
+    } | unknown>;
+    /** Board fan-out, so a spawned task appears on open boards without a refresh. */
+    events?: ExecutionEventPublisher;
+    /** Optional inbox channel; when unwired the `bug_fishing_triage` card is skipped. */
+    notificationService?: NotificationService;
+    logger?: Logger;
+}
+/**
+ * Drives the BUG-FISHING EXPEDITION: the read-only `bug-fisher` agent's phase loop, the human
+ * triage that follows it, and the bug-fix tasks that triage spawns.
+ *
+ * The shape is the Ralph loop's (one step, dispatched repeatedly) joined to the PR review's
+ * (park, then let a human act on findings). {@link recordPhaseResult} runs as the completion
+ * interceptor's body: it stamps the finished pass's findings onto `step.bugFishing` and either
+ * RE-ARMS the same step for the next angle or, once every angle has settled, parks the run for
+ * triage. {@link address} spawns a bug-fix task per marked finding, and {@link resolve} finishes
+ * the parked expedition.
+ *
+ * Two properties are worth stating because they are what the design is FOR:
+ *
+ * - **Marking does not wait for the expedition.** {@link address} accepts findings while later
+ *   angles are still fishing. That is the whole reason the angles run as separate dispatches
+ *   rather than as one prompt: a human who reads the concurrency pass at minute six should be
+ *   able to start its fix then, not after the requirements pass finishes at minute forty.
+ * - **A failed angle costs only that angle.** The passes share nothing but the checkout, so
+ *   {@link recordPhaseFailure} settles the one that died with its reason on the record and moves
+ *   to the next, rather than failing a run that has already caught something.
+ *
+ * All expedition state rides the run's `bug-fisher` step (`step.bugFishing`) — no side table —
+ * so it is runtime-symmetric by construction, exactly like `prReview` / `forkDecision`.
+ */
+export declare class BugFishingController {
+    private readonly deps;
+    private readonly log;
+    constructor(deps: BugFishingControllerDeps);
+    /**
+     * The expedition state a `bug-fisher` step should carry on THIS dispatch, seeded on first
+     * entry from the task's angle selection and the workspace's fix-pipeline default.
+     *
+     * Called by the step handler before dispatching, and idempotent: a step that already carries
+     * an expedition (every dispatch after the first, and every durable replay of the first) keeps
+     * it, because re-planning would discard the phases already fished.
+     *
+     * ALWAYS plans at least one angle, because {@link planBugFishingPhases} falls back to the whole
+     * catalog: an empty or entirely unrecognised selection means "fish everything", which is the
+     * point of an expedition, so narrowing it is the deliberate act. There is deliberately no
+     * "planned nothing" outcome for the handler to pass through — one existed, could not be
+     * reached, and would have dispatched a full container run for a step it had just marked
+     * skipped.
+     */
+    ensurePlanned(workspaceId: string, step: PipelineStep, block: Block): Promise<BugFishingStepState>;
+    /**
+     * Record a COMPLETED pass and decide the flow. Runs as the completion interceptor's body
+     * (short-circuiting `recordStepResult` when it parks or loops).
+     *
+     * With angles left: stamp the findings, re-arm the SAME step and return `continue`, so the
+     * durable driver re-enters and dispatches the next angle (the dispatch epoch gives it a job id
+     * of its own — see `dispatchEpochFor`). With the last angle settled: park on a durable
+     * decision-wait and raise the triage card. An expedition that caught nothing at all still
+     * parks: "we looked from eight angles and found nothing" is the answer a human asked for, and
+     * advancing silently past it would present that as no answer.
+     *
+     * Idempotent against a durable replay: a step whose expedition is no longer `fishing` has
+     * already been recorded, so it falls through to whatever its status says.
+     */
+    recordPhaseResult(workspaceId: string, instance: ExecutionInstance, step: PipelineStep, output: BugFishingAgentOutput | undefined, model: string | null | undefined, block: Block | null | undefined): Promise<AdvanceResult | null>;
+    /**
+     * Settle a pass whose container job FAILED, then carry on with the next angle.
+     *
+     * Run from the driver's failed-job path (the analogue of the PR-review challenge failure
+     * branch). The angles are independent by construction, so one crashing must not cost the
+     * expedition the passes that already landed nor the ones still to come; the failure is NAMED
+     * on the phase, because a phase that silently reported nothing is indistinguishable from a
+     * phase that honestly found nothing. Returns null when the step carries no live expedition, so
+     * an ordinary failure still fails the run.
+     */
+    recordPhaseFailure(workspaceId: string, instance: ExecutionInstance, step: PipelineStep, reason: string | null, block: Block | null | undefined): Promise<AdvanceResult | null>;
+    /**
+     * Re-arm the `bug-fisher` step for the NEXT angle and let the driver re-enter.
+     *
+     * `resetStepForRerun` clears the job handle (which is what makes the driver dispatch again on
+     * re-entry) while deliberately leaving `bugFishing` alone — the state is the accumulated catch,
+     * and clearing it would throw away every pass before this one. The container is reclaimed
+     * first so the next angle boots a fresh context: a container-reusing transport would otherwise
+     * re-attach to the finished job and replay its result, which reads as an angle that found
+     * exactly what the previous one did.
+     */
+    private rearmForNextPhase;
+    /**
+     * MARK findings to be addressed: spawn a bug-fix task per finding, linked to the expedition.
+     *
+     * Accepted while the expedition is still fishing later angles as well as once it has parked —
+     * see the class doc for why that is the point rather than a convenience.
+     *
+     * Order of operations per finding, and why: the spawn record is CLAIMED under the run's
+     * compare-and-swap first, with the task id it is about to create, and only then is the block
+     * inserted and its run started; the claim is settled to `spawned` or `failed` afterwards.
+     * Creating first and recording after was the first cut and it is not safe: two people marking
+     * the same finding (or one person and a retried request) both read a snapshot with no spawn on
+     * it, and both file the same bug and start a run for it. The claim is what makes exactly one
+     * of them win, and it is why a spawn record must be read through its STATUS rather than by
+     * being present: `pending` means a task is being made, not that one exists.
+     *
+     * The pipeline is resolved ONCE for the whole batch and validated against the workspace's
+     * catalog before anything is created: a caller naming a pipeline that does not exist gets a
+     * refusal naming it, rather than N tasks pinned to a pipeline nothing can run.
+     */
+    address(workspaceId: string, executionId: string, input: AddressBugFishingFindingsInput, initiatedBy: string | null): Promise<BugFishingStepState>;
+    /**
+     * Claim ONE finding, create its fix task behind the claim, and settle the claim either way.
+     *
+     * The three writes are separate on purpose. The CLAIM is the concurrency boundary: it lands
+     * under CAS, and the caller learns whether it won by re-reading the finding and comparing the
+     * task id it minted — the initiative loop's spawn recognises its own the same way, and for the
+     * same reason (the loser's transform is a no-op, so a lost race creates nothing rather than
+     * duplicating the winner's work).
+     *
+     * The SETTLE writes cannot be skipped on either branch. On success the record becomes terminal,
+     * which is what stops the finding being marked twice. On failure it records the cause and
+     * becomes claimable again, which is what stops a finding whose fix task was never created from
+     * reading as one that is being worked on. The failure then PROPAGATES: marking is the caller's
+     * own request, so answering 200 with a finding nobody is fixing would report work the platform
+     * did not do.
+     */
+    private spawnForFinding;
+    /**
+     * Apply a pure reduction to the run's live expedition state under CAS, and answer the result.
+     *
+     * REFUSES rather than returning when the winning snapshot carries no expedition. That case was
+     * a silent `return` and it is the worst shape available here: on the settle path the task and
+     * its run already exist, so dropping the write leaves a finding that reads as untouched beside
+     * a fix task nothing on the expedition points at, and the caller is told it all worked.
+     */
+    private mutateExpedition;
+    /**
+     * Dismiss a finding: it stays on the expedition's record, struck through, and can no longer be
+     * marked. A curation action, not a resolution — the run stays exactly where it is, whether it
+     * is still fishing or already parked.
+     *
+     * REFUSES an id this expedition does not carry, and one whose fix task exists or is being
+     * created, with the same two reasons {@link address} uses for the same two cases. Answering 200
+     * to either was a filter that quietly matched nothing: the SPA then struck the row through on
+     * its optimistic echo and the next snapshot silently put it back, which reads as a dismissal
+     * the platform undid rather than as one it never accepted.
+     */
+    dismissFinding(workspaceId: string, executionId: string, findingId: string): Promise<BugFishingStepState>;
+    /**
+     * Finish a parked expedition: mark it `done` and advance the run past the step.
+     *
+     * Mirrors the review gate's resolved-gate advance — the pure in-memory advance runs inside the
+     * CAS, its side effects (settle / emit) once after, on the winning snapshot. Findings left
+     * untriaged are left as they are: they stay on the run's record, and the expedition's own
+     * state is the honest account of what was decided and what was not.
+     */
+    resolve(workspaceId: string, executionId: string): Promise<BugFishingStepState>;
+    /** The active expedition state for a run's GET, or null when no step carries one. */
+    getActive(workspaceId: string, executionId: string): Promise<BugFishingStepState | null>;
+    /**
+     * The run's "active" expedition step: prefer the step the run is currently on, else the latest
+     * `bug-fisher` step carrying expedition state. Mirrors `PrReviewController.activePrReviewStep`.
+     */
+    private activeExpeditionStep;
+    /**
+     * The pipeline a marked finding's task runs: the caller's override, else the expedition's
+     * recorded default, else the workspace setting as it stands now, else the built-in bug-fix
+     * preset — and in every case validated against the workspace's own catalog.
+     *
+     * Validated rather than trusted because both the override and the workspace setting are bare
+     * ids a human typed or picked, and a workspace can delete the pipeline it named. Spawning onto
+     * a missing pipeline would create tasks that cannot start, so the refusal NAMES the pipeline
+     * instead: which one is missing is the whole content of the fix.
+     */
+    private resolveSpawnPipelineId;
+    /**
+     * The workspace's configured fix pipeline, else the built-in bug-fix preset.
+     *
+     * A settings read that THROWS is deliberately NOT swallowed into the built-in default: an
+     * unreachable settings store and a workspace that configured nothing are opposite facts, and
+     * silently spawning onto the platform preset would put a team's bug work on a pipeline they
+     * moved off. An UNWIRED store is the third case and genuinely does mean "no configured
+     * default", so that one answers the built-in.
+     */
+    private resolveDefaultFixPipelineId;
+    /**
+     * The frame a spawned fix task lives under, its service row, and the standards that frame's
+     * service holds every task under it to.
+     *
+     * The expedition's OWN parent frame, so the fix runs against the same repository the
+     * expedition fished. A task whose frame cannot be resolved has nothing to host the work and no
+     * repo to fix, so this refuses rather than dropping the task somewhere plausible.
+     *
+     * The frame is also where the service's standing standards live (`serviceFragmentIds`), which
+     * is why it is carried rather than reduced to an id: a spawned task has to be handed them
+     * EXPLICITLY, since a task-level run folds only its own `fragmentIds` and never re-unions the
+     * service's (kernel's `applicableFragmentIds`).
+     */
+    private resolveSpawnHost;
+    /**
+     * The best-practice fragments a spawned fix task is created with.
+     *
+     * Resolved through the SAME seam the create form goes through (`BoardService.addTask`'s
+     * `fragmentIdsFor`), against the same inputs a person filing this bug by hand under this
+     * service would supply: the service's standing standards, the `bug` type's own defaults, and
+     * whichever standing-context entries hold for the fields the finding filled in. Anything less
+     * would make a spawned fix quietly weaker than the identical bug filed by hand, and the
+     * difference would only ever show up in the fix's output.
+     *
+     * Unwired (a facade that passes no defaults seam) means no fragments, which is the same answer
+     * that seam gives a deployment with no fragment pool at all.
+     */
+    private resolveSpawnFragmentIds;
+    /**
+     * Create ONE bug-fix task for a finding and start its run, answering the run's id (or null when
+     * the start entry point reported none).
+     *
+     * The task is a `bug`-typed block carrying the finding as its description and its evidence as
+     * the reproduction field, so the bug-fix pipeline's investigator starts from what the
+     * expedition actually found rather than from a title. On a start failure the block is rolled
+     * back, exactly as the initiative loop does: a task on the board with no run and no record on
+     * either side is the one outcome nothing later reconciles.
+     *
+     * The block id is passed IN rather than minted here, because the claim that authorised this
+     * call already carries it — see {@link spawnForFinding}.
+     *
+     * A failure PROPAGATES rather than being swallowed into "this finding stays untriaged". The
+     * marking is the caller's own request, not a best-effort background pass, and the failures that
+     * reach here are exactly the ones they can act on: a pipeline that refuses a one-off task
+     * start, a per-service task limit, a board write that was denied. Answering 200 with an
+     * unchanged finding would report the request as done and leave somebody waiting for a fix task
+     * that is never going to appear. Findings spawned EARLIER in the batch are already persisted,
+     * so the error names what is left rather than undoing what worked.
+     */
+    private spawnFixTask;
+    /** Raise the "finish triaging the catch" inbox card when the expedition parks. */
+    private raiseTriageReady;
+}
+//# sourceMappingURL=BugFishingController.d.ts.map

package/dist/modules/execution/BugFishingController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BugFishingController.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/BugFishingController.ts"],"names":[],"mappings":"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"}