@on-par/factory-core 0.9.28-next.26 → 0.9.28-next.28

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.26",
+  "version": "0.9.28-next.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.26",
-    "@on-par/contracts": "0.9.28-next.26",
-    "@on-par/factory-config": "0.9.28-next.26",
-    "@on-par/repo-context": "0.9.28-next.26",
+    "@on-par/adr-kit": "0.9.28-next.28",
+    "@on-par/contracts": "0.9.28-next.28",
+    "@on-par/factory-config": "0.9.28-next.28",
+    "@on-par/repo-context": "0.9.28-next.28",
     "@octokit/rest": "^22.0.0",
     "execa": "^10.2.1",
     "gray-matter": "^4.0.3",