@on-par/factory-core 0.9.28-next.8 → 0.9.28

package/dist/utils/in-place.js

@@ -0,0 +1,105 @@
+// src/utils/in-place.ts — in-place workspace mode (#3904): run the pipeline in the current
+// checkout instead of a factory worktree. The clone is the isolation boundary, so the checkout
+// must be clean and at the fetched default-branch tip, and nothing here ever deletes anything.
+import { execGit } from './git-exec.js';
+import { defaultRemoteBase, detectRemoteBranch, gitFetch, } from './index.js';
+const MAX_LISTED_FILES = 20;
+function porcelainPath(line) {
+    const path = line.slice(3);
+    const arrow = path.indexOf(' -> ');
+    return arrow === -1 ? path : path.slice(arrow + 4);
+}
+async function revParse(repoRoot, args) {
+    const { stdout } = await execGit(['rev-parse', ...args], { cwd: repoRoot });
+    return stdout.trim();
+}
+/** Why the checkout cannot host an in-place run, or null when it is clean and at origin/<default>. */
+export async function checkInPlaceCheckout(repoRoot) {
+    await gitFetch(repoRoot);
+    const { stdout: status } = await execGit(['status', '--porcelain'], { cwd: repoRoot });
+    const files = status
+        .split('\n')
+        .filter((line) => line.trim() !== '')
+        .map(porcelainPath);
+    if (files.length > 0) {
+        const listed = files.slice(0, MAX_LISTED_FILES).join(', ');
+        const more = files.length > MAX_LISTED_FILES ? ` (+${files.length - MAX_LISTED_FILES} more)` : '';
+        return {
+            kind: 'dirty',
+            files,
+            message: `in-place run refused: the checkout has uncommitted changes: ${listed}${more} — commit, stash or discard them, or use a fresh clone`,
+        };
+    }
+    const expected = await defaultRemoteBase(repoRoot);
+    const defaultName = expected.replace(/^origin\//, '');
+    const current = await revParse(repoRoot, ['--abbrev-ref', 'HEAD']);
+    if (current !== defaultName) {
+        return {
+            kind: 'wrong-branch',
+            current,
+            expected: defaultName,
+            message: `in-place run refused: the checkout is on '${current}' (detached HEAD when 'HEAD'), not the default branch '${defaultName}' — git switch ${defaultName}`,
+        };
+    }
+    const head = await revParse(repoRoot, ['HEAD']);
+    const tip = await revParse(repoRoot, [`${expected}^{commit}`]);
+    if (head !== tip) {
+        return {
+            kind: 'not-at-tip',
+            head,
+            tip,
+            expected,
+            message: `in-place run refused: HEAD ${head.slice(0, 8)} is not the fetched ${expected} tip ${tip.slice(0, 8)} — git reset --hard ${expected} in a disposable clone`,
+        };
+    }
+    return null;
+}
+/** Switches the checkout to the factory branch, cut from origin/<default> (or the branch's open
+ *  PR head). Re-checks readiness first to guard a race with the preflight. Never deletes. */
+export async function setupInPlaceCheckout(repoRoot, branch, log, opts) {
+    const problem = await checkInPlaceCheckout(repoRoot);
+    if (problem)
+        throw new Error(problem.message);
+    let openPrBranch = false;
+    let remoteBranch = null;
+    const remoteSha = await detectRemoteBranch(repoRoot, branch);
+    if (remoteSha) {
+        remoteBranch = { sha: remoteSha };
+        let prText = 'open PR not checked';
+        if (opts?.findOpenPr) {
+            let lookup;
+            try {
+                lookup = await opts.findOpenPr(branch);
+            }
+            catch (err) {
+                lookup = { status: 'error', detail: err instanceof Error ? err.message : String(err) };
+            }
+            if (lookup.status === 'found') {
+                remoteBranch.prNumber = lookup.prNumber;
+                openPrBranch = true;
+                prText = `open PR #${lookup.prNumber} — continuing on origin/${branch}`;
+            }
+            else if (lookup.status === 'absent') {
+                prText = 'no open PR';
+            }
+            else {
+                prText = `open PR lookup failed: ${lookup.detail}`;
+            }
+        }
+        log?.('remote-branch-preexisting', `origin/${branch} already exists @ ${remoteSha}; ${prText}`);
+    }
+    const base = openPrBranch ? `origin/${branch}` : await defaultRemoteBase(repoRoot);
+    try {
+        await execGit(['switch', '--no-track', '-c', branch, base], { cwd: repoRoot });
+    }
+    catch (err) {
+        const stderr = (err?.stderr ?? (err instanceof Error ? err.message : String(err)))
+            .toString()
+            .trim();
+        throw new Error(`in-place run refused: could not create branch '${branch}' in the checkout (${stderr}) — delete the local branch or use a fresh clone`, { cause: err });
+    }
+    const head = await revParse(repoRoot, ['--verify', 'HEAD']);
+    log?.('worktree-base', `in-place: switched ${repoRoot} to ${branch} from ${base} @ ${head}`);
+    return { base, head, remoteBranch };
+}
+//# sourceMappingURL=in-place.js.map

package/dist/utils/in-place.js.map

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

package/dist/work/internal-exports.d.ts

@@ -0,0 +1,3 @@
+export { closesTrailer, createLinearTicketWriteback, mirrorSlicePlanToTicket, postTicketComment, ticketKeyOf, ticketTrackerOf, type LinearTicketClient, type TicketTrackerKind, type TicketWriteback, } from './ticket-writeback.js';
+export { isTicketKey } from './work-key.js';
+//# sourceMappingURL=internal-exports.d.ts.map

package/dist/work/internal-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-exports.d.ts","sourceRoot":"","sources":["../../src/work/internal-exports.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/work/internal-exports.js

@@ -0,0 +1,4 @@
+// Work-source ticket write-back exports re-exported from internal.ts (keeps that file under its max-lines ceiling)
+export { closesTrailer, createLinearTicketWriteback, mirrorSlicePlanToTicket, postTicketComment, ticketKeyOf, ticketTrackerOf, } from './ticket-writeback.js';
+export { isTicketKey } from './work-key.js';
+//# sourceMappingURL=internal-exports.js.map

package/dist/work/internal-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-exports.js","sourceRoot":"","sources":["../../src/work/internal-exports.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,eAAe,GAIhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/work/ticket-writeback.d.ts

@@ -0,0 +1,22 @@
+import type { LinearQueueLifecycleClient } from '../queue/linear-queue-lifecycle.js';
+import type { SlicePlanStore } from '../readiness/slice-plan-store.js';
+import type { WorkRequest } from './index.js';
+import type { WorkKey } from './work-key.js';
+export type TicketTrackerKind = 'github' | 'linear';
+export type LinearTicketClient = Pick<LinearQueueLifecycleClient, 'findIssue' | 'addComment'>;
+export interface TicketWriteback {
+    comment(key: WorkKey, body: string): Promise<void>;
+    labels(key: WorkKey): Promise<string[]>;
+}
+/** The tracker a work request lives in; undefined for a work source with no ticket (e.g. a local brief). */
+export declare function ticketTrackerOf(work: Pick<WorkRequest, 'kind'> | undefined): TicketTrackerKind | undefined;
+/** The Linear issue key of a work request; undefined for any other work. */
+export declare function ticketKeyOf(work: Pick<WorkRequest, 'kind' | 'key'> | undefined): WorkKey | undefined;
+/** The single PR-body trailer line: closes the ticket on the final slice, otherwise only references it. */
+export declare function closesTrailer(tracker: TicketTrackerKind, key: WorkKey, finalSlice: boolean): string;
+export declare function createLinearTicketWriteback(client: LinearTicketClient): TicketWriteback;
+/** Posts a comment to the ticket; never throws. A missing writeback or a failed post only warns. */
+export declare function postTicketComment(writeback: TicketWriteback | undefined, key: WorkKey, body: string, warn: (msg: string) => void): Promise<boolean>;
+/** A slice-plan store that also mirrors each saved plan to the ticket; the inner store stays the source of truth. */
+export declare function mirrorSlicePlanToTicket(store: SlicePlanStore, writeback: TicketWriteback | undefined, key: WorkKey, warn: (msg: string) => void): SlicePlanStore;
+//# sourceMappingURL=ticket-writeback.d.ts.map

package/dist/work/ticket-writeback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-writeback.d.ts","sourceRoot":"","sources":["../../src/work/ticket-writeback.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;AAC9F,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC;AAED,4GAA4G;AAC5G,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAI1G;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAEpG;AAED,2GAA2G;AAC3G,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAGnG;AAOD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAgBvF;AAED,oGAAoG;AACpG,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,eAAe,GAAG,SAAS,EACtC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,qHAAqH;AACrH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,eAAe,GAAG,SAAS,EACtC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,cAAc,CAShB"}

package/dist/work/ticket-writeback.js

@@ -0,0 +1,73 @@
+// packages/core/src/work/ticket-writeback.ts — write-back to a Linear ticket: closing trailer, comments, labels (#3894).
+import { renderSlicePlanComment } from '../readiness/slice-plan.js';
+import { GITHUB_ISSUE_SOURCE } from './github-issue.js';
+import { LINEAR_ISSUE_SOURCE } from './linear-issue.js';
+import { stripHiddenContent } from '../filing/sanitize.js';
+/** The tracker a work request lives in; undefined for a work source with no ticket (e.g. a local brief). */
+export function ticketTrackerOf(work) {
+    if (work === undefined || work.kind === GITHUB_ISSUE_SOURCE)
+        return 'github';
+    if (work.kind === LINEAR_ISSUE_SOURCE)
+        return 'linear';
+    return undefined;
+}
+/** The Linear issue key of a work request; undefined for any other work. */
+export function ticketKeyOf(work) {
+    return ticketTrackerOf(work) === 'linear' && work?.key !== undefined ? work.key : undefined;
+}
+/** The single PR-body trailer line: closes the ticket on the final slice, otherwise only references it. */
+export function closesTrailer(tracker, key, finalSlice) {
+    if (tracker === 'github')
+        return finalSlice ? `Closes #${key}` : `Part of #${key}`;
+    return finalSlice ? `Fixes ${key}` : `Part of ${key}`;
+}
+/** Linear renders HTML comments literally, so factory markers (and any hidden content) are removed before posting. */
+function stripMarkers(body) {
+    return stripHiddenContent(body).trim();
+}
+export function createLinearTicketWriteback(client) {
+    async function find(key) {
+        const issue = await client.findIssue(key);
+        if (!issue)
+            throw new Error(`Linear issue ${key} not found`);
+        return issue;
+    }
+    return {
+        async comment(key, body) {
+            const issue = await find(key);
+            await client.addComment(issue.id, stripMarkers(body));
+        },
+        async labels(key) {
+            const issue = await find(key);
+            return issue.labels.map((l) => l.name);
+        },
+    };
+}
+/** Posts a comment to the ticket; never throws. A missing writeback or a failed post only warns. */
+export async function postTicketComment(writeback, key, body, warn) {
+    if (!writeback) {
+        warn(`no Linear writeback is wired; could not post to ${key}`);
+        return false;
+    }
+    try {
+        await writeback.comment(key, body);
+        return true;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        warn(`could not post to Linear issue ${key}: ${message}`);
+        return false;
+    }
+}
+/** A slice-plan store that also mirrors each saved plan to the ticket; the inner store stays the source of truth. */
+export function mirrorSlicePlanToTicket(store, writeback, key, warn) {
+    return {
+        find: () => store.find(),
+        async save(plan) {
+            const saved = await store.save(plan);
+            await postTicketComment(writeback, key, renderSlicePlanComment(plan), warn);
+            return saved;
+        },
+    };
+}
+//# sourceMappingURL=ticket-writeback.js.map

package/dist/work/ticket-writeback.js.map

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

package/dist/work/work-key.d.ts

@@ -11,5 +11,7 @@ export declare function toWorkKey(raw: string): WorkKey;
 export declare function isNumericWorkKey(key: WorkKey): boolean;
 /** The only sanctioned path from a key to an Octokit `issue_number`; throws for non-numeric keys. */
 export declare function issueNumberOf(key: WorkKey): number;
+/** True for a real ticket key in the event log: a GitHub issue number or an upper-case tracker key like ON-12. */
+export declare function isTicketKey(issue: string): boolean;
 export {};
 //# sourceMappingURL=work-key.d.ts.map

package/dist/work/work-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work-key.d.ts","sourceRoot":"","sources":["../../src/work/work-key.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAE1C,8GAA8G;AAC9G,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjE,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ9C;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGlD"}
+{"version":3,"file":"work-key.d.ts","sourceRoot":"","sources":["../../src/work/work-key.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAE1C,8GAA8G;AAC9G,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjE,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ9C;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGlD;AAED,kHAAkH;AAClH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/work/work-key.js

@@ -24,4 +24,8 @@ export function issueNumberOf(key) {
         throw new Error(`work key "${key}" is not a numeric GitHub issue number`);
     return Number(key);
 }
+/** True for a real ticket key in the event log: a GitHub issue number or an upper-case tracker key like ON-12. */
+export function isTicketKey(issue) {
+    return /^\d+$/.test(issue) || /^[A-Z][A-Z0-9]*-[1-9]\d*$/.test(issue);
+}
 //# sourceMappingURL=work-key.js.map

package/dist/work/work-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"work-key.js","sourceRoot":"","sources":["../../src/work/work-key.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAOhF,gGAAgG;AAChG,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,UAAU,CAAC,yDAAyD,KAAK,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAY,CAAC;AAClC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,qBAAqB,GAAG,+EAA+E,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,GAAc,CAAC;AACxB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;AAC1D,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,wCAAwC,CAAC,CAAC;IACtG,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"work-key.js","sourceRoot":"","sources":["../../src/work/work-key.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAOhF,gGAAgG;AAChG,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,UAAU,CAAC,yDAAyD,KAAK,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAY,CAAC;AAClC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,qBAAqB,GAAG,+EAA+E,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,GAAc,CAAC;AACxB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;AAC1D,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,wCAAwC,CAAC,CAAC;IACtG,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@on-par/factory-core",
-  "version": "0.9.28-next.8",
+  "version": "0.9.28",
   "description": "Core engine: model router, constitutions, checkers, and pipeline phases for the Software Factory.",
   "type": "module",
   "main": "dist/index.js",
@@ -54,10 +54,10 @@
     "prepack": "node ../../scripts/pack-hygiene-cli.ts prepack"
   },
   "dependencies": {
-    "@on-par/adr-kit": "0.9.28-next.8",
-    "@on-par/contracts": "0.9.28-next.8",
-    "@on-par/factory-config": "0.9.28-next.8",
-    "@on-par/repo-context": "0.9.28-next.8",
+    "@on-par/adr-kit": "0.9.28",
+    "@on-par/contracts": "0.9.28",
+    "@on-par/factory-config": "0.9.28",
+    "@on-par/repo-context": "0.9.28",
     "@octokit/rest": "^22.0.0",
     "execa": "^10.2.1",
     "gray-matter": "^4.0.3",