@mastra/factory 0.5.1-alpha.0 → 0.6.0-alpha.10

package/dist/integrations/issue-reconcile-worker.js

@@ -0,0 +1,98 @@
+import { randomUUID } from "crypto";
+import { NoopLeaseProvider, isLeaseProvider } from "@mastra/core/events";
+import { MastraWorker } from "@mastra/core/worker";
+//#region src/integrations/issue-reconcile-worker.ts
+const DEFAULT_ISSUE_RECONCILE_INTERVAL_MS = 5 * 6e4;
+const MIN_LEASE_TTL_MS = 3e4;
+var IssueReconcileWorker = class extends MastraWorker {
+	name;
+	#integrationId;
+	#reconcile;
+	#intervalMs;
+	#leaseTtlMs;
+	#leaseKey;
+	#leaseOwner = randomUUID();
+	#running = false;
+	#timer;
+	#inFlight;
+	#leaseProvider = NoopLeaseProvider;
+	constructor(config) {
+		super();
+		this.#integrationId = config.integrationId;
+		this.name = `${config.integrationId}-issue-reconcile`;
+		this.#leaseKey = `${config.integrationId}:issue-reconcile`;
+		this.#reconcile = config.reconcile;
+		this.#intervalMs = config.intervalMs ?? 3e5;
+		if (!Number.isFinite(this.#intervalMs) || this.#intervalMs <= 0) throw new Error(`${config.integrationId} issue reconcile interval must be a positive number.`);
+		this.#leaseTtlMs = Math.max(MIN_LEASE_TTL_MS, this.#intervalMs * 3);
+	}
+	async init(deps) {
+		await super.init(deps);
+		this.#leaseProvider = getLeaseProvider(deps.pubsub);
+	}
+	async start() {
+		if (this.#running) return;
+		if (!this.deps) throw new Error("IssueReconcileWorker: call init() before start()");
+		this.#running = true;
+		this.deps.logger.info(`${this.#integrationId} issue reconcile worker started`, { intervalMs: this.#intervalMs });
+		this.#schedule(0);
+	}
+	async stop() {
+		if (!this.#running) return;
+		this.#running = false;
+		if (this.#timer) clearTimeout(this.#timer);
+		this.#timer = void 0;
+		await this.#inFlight;
+	}
+	get isRunning() {
+		return this.#running;
+	}
+	#schedule(delayMs) {
+		if (!this.#running) return;
+		this.#timer = setTimeout(() => {
+			this.#timer = void 0;
+			const run = this.#tick().finally(() => {
+				this.#inFlight = void 0;
+				this.#schedule(this.#intervalMs);
+			});
+			this.#inFlight = run;
+		}, delayMs);
+		this.#timer.unref?.();
+	}
+	async #tick() {
+		if (!(await this.#leaseProvider.acquireLease(this.#leaseKey, this.#leaseOwner, this.#leaseTtlMs).catch(() => ({ acquired: false }))).acquired) return;
+		const renewalTimer = setInterval(() => {
+			this.#leaseProvider.renewLease(this.#leaseKey, this.#leaseOwner, this.#leaseTtlMs).catch((error) => {
+				this.deps?.logger.warn(`${this.#integrationId} issue reconcile lease renewal failed`, { error: error instanceof Error ? error.message : String(error) });
+			});
+		}, Math.max(1e3, Math.floor(this.#leaseTtlMs / 3)));
+		renewalTimer.unref?.();
+		try {
+			const startedAt = Date.now();
+			const { errors, ...counts } = await this.#reconcile();
+			const context = {
+				...counts,
+				durationMs: Date.now() - startedAt
+			};
+			if (counts.failed > 0) this.deps?.logger.warn(`${this.#integrationId} issue reconcile sweep completed with failures`, {
+				...context,
+				errors
+			});
+			else this.deps?.logger.debug(`${this.#integrationId} issue reconcile sweep completed`, context);
+		} catch (error) {
+			this.deps?.logger.warn(`${this.#integrationId} issue reconcile sweep failed`, { error: error instanceof Error ? error.message : String(error) });
+		} finally {
+			clearInterval(renewalTimer);
+			await this.#leaseProvider.releaseLease(this.#leaseKey, this.#leaseOwner).catch(() => void 0);
+		}
+	}
+};
+function getLeaseProvider(pubsub) {
+	const getProvider = pubsub.getLeaseProvider;
+	if (typeof getProvider === "function") return getProvider.call(pubsub) ?? NoopLeaseProvider;
+	return isLeaseProvider(pubsub) ? pubsub : pubsub.lease ?? NoopLeaseProvider;
+}
+//#endregion
+export { DEFAULT_ISSUE_RECONCILE_INTERVAL_MS, IssueReconcileWorker };
+
+//# sourceMappingURL=issue-reconcile-worker.js.map

package/dist/integrations/issue-reconcile-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-reconcile-worker.js","names":["#integrationId","#reconcile","#intervalMs","#leaseTtlMs","#leaseKey","#leaseOwner","#leaseProvider","#running","#schedule","#timer","#inFlight","#tick"],"sources":["../../src/integrations/issue-reconcile-worker.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { isLeaseProvider, NoopLeaseProvider } from '@mastra/core/events';\nimport type { LeaseProvider, PubSub } from '@mastra/core/events';\nimport { MastraWorker } from '@mastra/core/worker';\nimport type { WorkerDeps } from '@mastra/core/worker';\n\nimport type { IssueReconciler } from './issue-reconciler.js';\n\nexport const DEFAULT_ISSUE_RECONCILE_INTERVAL_MS = 5 * 60_000;\nconst MIN_LEASE_TTL_MS = 30_000;\n\nexport interface IssueReconcileWorkerConfig {\n  integrationId: string;\n  reconcile: IssueReconciler;\n  intervalMs?: number;\n}\n\nexport class IssueReconcileWorker extends MastraWorker {\n  readonly name: string;\n\n  readonly #integrationId: string;\n  readonly #reconcile: IssueReconciler;\n  readonly #intervalMs: number;\n  readonly #leaseTtlMs: number;\n  readonly #leaseKey: string;\n  readonly #leaseOwner = randomUUID();\n\n  #running = false;\n  #timer: ReturnType<typeof setTimeout> | undefined;\n  #inFlight: Promise<void> | undefined;\n  #leaseProvider: LeaseProvider = NoopLeaseProvider;\n\n  constructor(config: IssueReconcileWorkerConfig) {\n    super();\n    this.#integrationId = config.integrationId;\n    this.name = `${config.integrationId}-issue-reconcile`;\n    this.#leaseKey = `${config.integrationId}:issue-reconcile`;\n    this.#reconcile = config.reconcile;\n    this.#intervalMs = config.intervalMs ?? DEFAULT_ISSUE_RECONCILE_INTERVAL_MS;\n    if (!Number.isFinite(this.#intervalMs) || this.#intervalMs <= 0) {\n      throw new Error(`${config.integrationId} issue reconcile interval must be a positive number.`);\n    }\n    this.#leaseTtlMs = Math.max(MIN_LEASE_TTL_MS, this.#intervalMs * 3);\n  }\n\n  async init(deps: WorkerDeps): Promise<void> {\n    await super.init(deps);\n    this.#leaseProvider = getLeaseProvider(deps.pubsub);\n  }\n\n  async start(): Promise<void> {\n    if (this.#running) return;\n    if (!this.deps) throw new Error('IssueReconcileWorker: call init() before start()');\n    this.#running = true;\n    this.deps.logger.info(`${this.#integrationId} issue reconcile worker started`, { intervalMs: this.#intervalMs });\n    this.#schedule(0);\n  }\n\n  async stop(): Promise<void> {\n    if (!this.#running) return;\n    this.#running = false;\n    if (this.#timer) clearTimeout(this.#timer);\n    this.#timer = undefined;\n    await this.#inFlight;\n  }\n\n  get isRunning(): boolean {\n    return this.#running;\n  }\n\n  #schedule(delayMs: number): void {\n    if (!this.#running) return;\n    this.#timer = setTimeout(() => {\n      this.#timer = undefined;\n      const run = this.#tick().finally(() => {\n        this.#inFlight = undefined;\n        this.#schedule(this.#intervalMs);\n      });\n      this.#inFlight = run;\n    }, delayMs);\n    this.#timer.unref?.();\n  }\n\n  async #tick(): Promise<void> {\n    const lease = await this.#leaseProvider\n      .acquireLease(this.#leaseKey, this.#leaseOwner, this.#leaseTtlMs)\n      .catch(() => ({ acquired: false }));\n    if (!lease.acquired) return;\n\n    // A sweep that traverses many projects/orgs can outrun the lease TTL;\n    // renew periodically so a replica can't grab the expired lease and start\n    // an overlapping sweep partway through this one.\n    const renewalTimer = setInterval(\n      () => {\n        void this.#leaseProvider\n          .renewLease(this.#leaseKey, this.#leaseOwner, this.#leaseTtlMs)\n          .catch(error => {\n            this.deps?.logger.warn(`${this.#integrationId} issue reconcile lease renewal failed`, {\n              error: error instanceof Error ? error.message : String(error),\n            });\n          });\n      },\n      Math.max(1_000, Math.floor(this.#leaseTtlMs / 3)),\n    );\n    renewalTimer.unref?.();\n\n    try {\n      const startedAt = Date.now();\n      const { errors, ...counts } = await this.#reconcile();\n      const context = { ...counts, durationMs: Date.now() - startedAt };\n      if (counts.failed > 0) {\n        this.deps?.logger.warn(`${this.#integrationId} issue reconcile sweep completed with failures`, {\n          ...context,\n          errors,\n        });\n      } else {\n        this.deps?.logger.debug(`${this.#integrationId} issue reconcile sweep completed`, context);\n      }\n    } catch (error) {\n      this.deps?.logger.warn(`${this.#integrationId} issue reconcile sweep failed`, {\n        error: error instanceof Error ? error.message : String(error),\n      });\n    } finally {\n      clearInterval(renewalTimer);\n      await this.#leaseProvider.releaseLease(this.#leaseKey, this.#leaseOwner).catch(() => undefined);\n    }\n  }\n}\n\nfunction getLeaseProvider(pubsub: PubSub): LeaseProvider {\n  const getProvider = (pubsub as PubSub & { getLeaseProvider?: () => LeaseProvider | undefined }).getLeaseProvider;\n  if (typeof getProvider === 'function') return getProvider.call(pubsub) ?? NoopLeaseProvider;\n  return isLeaseProvider(pubsub)\n    ? pubsub\n    : ((pubsub as PubSub & { lease?: LeaseProvider }).lease ?? NoopLeaseProvider);\n}\n"],"mappings":"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"}

package/dist/integrations/issue-reconciler.d.ts

@@ -0,0 +1,47 @@
+import type { Intake, IntakeIssue } from '../capabilities/intake.js';
+import type { FactoryProject, FactoryProjectsStorage } from '../storage/domains/projects/base.js';
+import type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';
+export interface IssueReconcileSummary {
+    projects: number;
+    checked: number;
+    updated: number;
+    closed: number;
+    missing: number;
+    failed: number;
+    errors: Array<{
+        projectId: string;
+        workItemId?: string;
+        error: string;
+    }>;
+}
+/**
+ * Scope passed in by the caller. Providers that reconcile per-repository (like
+ * GitHub, sharing target discovery with the PR reconciler) pass a target set
+ * and a `matches(item, scope)` predicate. Providers with no repository concept
+ * (Linear) pass no scope and every issue item is considered.
+ */
+export interface IssueReconcileScope<TScope> {
+    scopes: TScope[];
+    matches(item: WorkItemRow, scope: TScope): boolean;
+}
+export interface IssueReconcilerOptions<TScope = void> {
+    integrationId: string;
+    intake: Intake;
+    projects: Pick<FactoryProjectsStorage, 'listAll'>;
+    storage: WorkItemsStorage;
+    externalSource?(item: WorkItemRow): {
+        type: string;
+        externalId: string;
+    };
+    issueId(item: WorkItemRow): string | undefined;
+    metadata(item: WorkItemRow, issue: IntakeIssue): Record<string, unknown>;
+    /**
+     * Called when a closed issue (stateType 'completed' or 'canceled') is detected
+     * on a non-terminal work item. Use this to replay the close event through
+     * the provider's rules ingress.
+     */
+    onClosed?(item: WorkItemRow, issue: IntakeIssue, project: FactoryProject): Promise<void>;
+}
+export type IssueReconciler<TScope = void> = TScope extends void ? () => Promise<IssueReconcileSummary> : (scope: IssueReconcileScope<TScope>) => Promise<IssueReconcileSummary>;
+export declare function createIssueReconciler<TScope = void>(options: IssueReconcilerOptions<TScope>): IssueReconciler<TScope>;
+//# sourceMappingURL=issue-reconciler.d.ts.map

package/dist/integrations/issue-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-reconciler.d.ts","sourceRoot":"","sources":["../../src/integrations/issue-reconciler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE3F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACpD;AAED,MAAM,WAAW,sBAAsB,CAAC,MAAM,GAAG,IAAI;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;IAClD,OAAO,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzE;;;;OAIG;IACH,QAAQ,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1F;AAED,MAAM,MAAM,eAAe,CAAC,MAAM,GAAG,IAAI,IAAI,MAAM,SAAS,IAAI,GAC5D,MAAM,OAAO,CAAC,qBAAqB,CAAC,GACpC,CAAC,KAAK,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAsC3E,wBAAgB,qBAAqB,CAAC,MAAM,GAAG,IAAI,EACjD,OAAO,EAAE,sBAAsB,CAAC,MAAM,CAAC,GACtC,eAAe,CAAC,MAAM,CAAC,CA8EzB"}

package/dist/integrations/issue-reconciler.js

@@ -0,0 +1,104 @@
+//#region src/integrations/issue-reconciler.ts
+function sameValue(left, right) {
+	if (Array.isArray(right)) {
+		if (!Array.isArray(left)) return right.length === 0;
+		const leftStrings = left.filter((value) => typeof value === "string").slice().sort();
+		const rightStrings = right.filter((value) => typeof value === "string").slice().sort();
+		return leftStrings.length === rightStrings.length && leftStrings.every((value, index) => value === rightStrings[index]);
+	}
+	return left === right;
+}
+function metadataMatches(current, desired) {
+	return Object.entries(desired).every(([key, value]) => sameValue(current?.[key], value));
+}
+/**
+* Drop `undefined` entries so we never spread them into stored metadata. An
+* `undefined` field on the desired patch means "no signal from the live issue"
+* — we must preserve whatever was already stored, not clobber it.
+*/
+function withoutUndefined(record) {
+	const out = {};
+	for (const [key, value] of Object.entries(record)) if (value !== void 0) out[key] = value;
+	return out;
+}
+function issueItems(project, items, integrationId) {
+	return items.filter((item) => item.factoryProjectId === project.id && item.externalSource?.integrationId === integrationId && item.externalSource.type === "issue");
+}
+function createIssueReconciler(options) {
+	const run = async (scope) => {
+		const summary = {
+			projects: 0,
+			checked: 0,
+			updated: 0,
+			closed: 0,
+			missing: 0,
+			failed: 0,
+			errors: []
+		};
+		if (scope && scope.scopes.length === 0) return summary;
+		const projects = await options.projects.listAll();
+		for (const project of projects) {
+			const candidates = issueItems(project, await options.storage.list({
+				orgId: project.orgId,
+				factoryProjectId: project.id
+			}), options.integrationId);
+			const items = scope ? candidates.filter((item) => scope.scopes.some((target) => scope.matches(item, target))) : candidates;
+			if (items.length === 0) continue;
+			summary.projects += 1;
+			for (const item of items) {
+				summary.checked += 1;
+				try {
+					const resolved = await options.intake.resolveIntakeDispatch?.({
+						orgId: project.orgId,
+						externalSource: options.externalSource?.(item) ?? item.externalSource
+					});
+					if (!resolved) {
+						summary.missing += 1;
+						continue;
+					}
+					const issueId = options.issueId(item) ?? resolved.issueId;
+					const issue = await options.intake.getIssue({
+						...resolved,
+						issueId
+					});
+					if (!issue) {
+						summary.missing += 1;
+						continue;
+					}
+					const isClosed = issue.stateType === "completed" || issue.stateType === "canceled";
+					const stage = item.stages[0];
+					if (isClosed && !(stage === "done" || stage === "canceled") && options.onClosed) {
+						await options.onClosed(item, issue, project);
+						summary.closed += 1;
+						continue;
+					}
+					const metadata = withoutUndefined(options.metadata(item, issue));
+					if (metadataMatches(item.metadata, metadata)) continue;
+					await options.storage.update({
+						orgId: project.orgId,
+						id: item.id,
+						userId: "factory-rule-dispatcher",
+						patch: { metadata: {
+							...item.metadata ?? {},
+							...metadata
+						} }
+					});
+					summary.updated += 1;
+				} catch (error) {
+					summary.failed += 1;
+					summary.errors.push({
+						projectId: project.id,
+						workItemId: item.id,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+			}
+		}
+		return summary;
+	};
+	return run;
+}
+//#endregion
+export { createIssueReconciler };
+
+//# sourceMappingURL=issue-reconciler.js.map

package/dist/integrations/issue-reconciler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-reconciler.js","names":[],"sources":["../../src/integrations/issue-reconciler.ts"],"sourcesContent":["import type { Intake, IntakeIssue } from '../capabilities/intake.js';\nimport type { FactoryProject, FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';\n\nexport interface IssueReconcileSummary {\n  projects: number;\n  checked: number;\n  updated: number;\n  closed: number;\n  missing: number;\n  failed: number;\n  errors: Array<{ projectId: string; workItemId?: string; error: string }>;\n}\n\n/**\n * Scope passed in by the caller. Providers that reconcile per-repository (like\n * GitHub, sharing target discovery with the PR reconciler) pass a target set\n * and a `matches(item, scope)` predicate. Providers with no repository concept\n * (Linear) pass no scope and every issue item is considered.\n */\nexport interface IssueReconcileScope<TScope> {\n  scopes: TScope[];\n  matches(item: WorkItemRow, scope: TScope): boolean;\n}\n\nexport interface IssueReconcilerOptions<TScope = void> {\n  integrationId: string;\n  intake: Intake;\n  projects: Pick<FactoryProjectsStorage, 'listAll'>;\n  storage: WorkItemsStorage;\n  externalSource?(item: WorkItemRow): { type: string; externalId: string };\n  issueId(item: WorkItemRow): string | undefined;\n  metadata(item: WorkItemRow, issue: IntakeIssue): Record<string, unknown>;\n  /**\n   * Called when a closed issue (stateType 'completed' or 'canceled') is detected\n   * on a non-terminal work item. Use this to replay the close event through\n   * the provider's rules ingress.\n   */\n  onClosed?(item: WorkItemRow, issue: IntakeIssue, project: FactoryProject): Promise<void>;\n}\n\nexport type IssueReconciler<TScope = void> = TScope extends void\n  ? () => Promise<IssueReconcileSummary>\n  : (scope: IssueReconcileScope<TScope>) => Promise<IssueReconcileSummary>;\n\nfunction sameValue(left: unknown, right: unknown): boolean {\n  if (Array.isArray(right)) {\n    if (!Array.isArray(left)) return right.length === 0;\n    const leftStrings = left.filter((value): value is string => typeof value === 'string').slice().sort();\n    const rightStrings = right.filter((value): value is string => typeof value === 'string').slice().sort();\n    return leftStrings.length === rightStrings.length && leftStrings.every((value, index) => value === rightStrings[index]);\n  }\n  return left === right;\n}\n\nfunction metadataMatches(current: Record<string, unknown> | null, desired: Record<string, unknown>): boolean {\n  return Object.entries(desired).every(([key, value]) => sameValue(current?.[key], value));\n}\n\n/**\n * Drop `undefined` entries so we never spread them into stored metadata. An\n * `undefined` field on the desired patch means \"no signal from the live issue\"\n * — we must preserve whatever was already stored, not clobber it.\n */\nfunction withoutUndefined(record: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(record)) {\n    if (value !== undefined) out[key] = value;\n  }\n  return out;\n}\n\nfunction issueItems(project: FactoryProject, items: WorkItemRow[], integrationId: string): WorkItemRow[] {\n  return items.filter(\n    item =>\n      item.factoryProjectId === project.id &&\n      item.externalSource?.integrationId === integrationId &&\n      item.externalSource.type === 'issue',\n  );\n}\n\nexport function createIssueReconciler<TScope = void>(\n  options: IssueReconcilerOptions<TScope>,\n): IssueReconciler<TScope> {\n  const run = async (scope?: IssueReconcileScope<TScope>): Promise<IssueReconcileSummary> => {\n    const summary: IssueReconcileSummary = {\n      projects: 0,\n      checked: 0,\n      updated: 0,\n      closed: 0,\n      missing: 0,\n      failed: 0,\n      errors: [],\n    };\n\n    // A scoped sweep with zero targets is a no-op: the caller is telling us\n    // there are no configured repositories to consider.\n    if (scope && scope.scopes.length === 0) return summary;\n\n    const projects = await options.projects.listAll();\n    for (const project of projects) {\n      const all = await options.storage.list({ orgId: project.orgId, factoryProjectId: project.id });\n      const candidates = issueItems(project, all, options.integrationId);\n      const items = scope\n        ? candidates.filter(item => scope.scopes.some(target => scope.matches(item, target)))\n        : candidates;\n      if (items.length === 0) continue;\n      summary.projects += 1;\n\n      for (const item of items) {\n        summary.checked += 1;\n        try {\n          const resolved = await options.intake.resolveIntakeDispatch?.({\n            orgId: project.orgId,\n            externalSource: options.externalSource?.(item) ?? item.externalSource!,\n          });\n          if (!resolved) {\n            summary.missing += 1;\n            continue;\n          }\n          const issueId = options.issueId(item) ?? resolved.issueId;\n          const issue = await options.intake.getIssue({ ...resolved, issueId });\n          if (!issue) {\n            summary.missing += 1;\n            continue;\n          }\n\n          // Close detection for Linear: replay through rules ingress if closed\n          const isClosed = issue.stateType === 'completed' || issue.stateType === 'canceled';\n          const stage = item.stages[0];\n          const isTerminal = stage === 'done' || stage === 'canceled';\n          if (isClosed && !isTerminal && options.onClosed) {\n            await options.onClosed(item, issue, project);\n            summary.closed += 1;\n            continue; // Skip metadata patch for closed issues\n          }\n\n          const metadata = withoutUndefined(options.metadata(item, issue));\n          if (metadataMatches(item.metadata, metadata)) continue;\n          await options.storage.update({\n            orgId: project.orgId,\n            id: item.id,\n            userId: 'factory-rule-dispatcher',\n            patch: { metadata: { ...(item.metadata ?? {}), ...metadata } },\n          });\n          summary.updated += 1;\n        } catch (error) {\n          summary.failed += 1;\n          summary.errors.push({\n            projectId: project.id,\n            workItemId: item.id,\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n      }\n    }\n\n    return summary;\n  };\n\n  return run as IssueReconciler<TScope>;\n}\n"],"mappings":"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"}

package/dist/integrations/linear/integration.d.ts

@@ -20,6 +20,7 @@
  */
 import type { RequestContext } from '@mastra/core/request-context';
 import type { ApiRoute } from '@mastra/core/server';
+import type { MastraWorker } from '@mastra/core/worker';
 import type { Intake } from '../../capabilities/intake.js';
 import type { RouteAuth } from '../../routes/route.js';
 import type { IntegrationStorageHandle } from '../../storage/domains/integrations/base.js';
@@ -64,6 +65,8 @@ export interface LinearIssue {
     stateType: string;
     priorityLabel: string;
     assignee: string | null;
+    /** Display name of the Linear user who created the issue, when Linear returns one. */
+    creator: string | null;
     team: string | null;
     labels: string[];
     createdAt: string;
@@ -214,6 +217,7 @@ export declare class LinearIntegration implements FactoryIntegration {
      * issue doesn't exist.
      */
     createIssueComment(accessToken: string, idOrIdentifier: string, body: string): Promise<LinearCreatedComment | null>;
+    workers(ctx: IntegrationContext): MastraWorker[];
     /**
      * The integration's HTTP surface: `/web/linear/*` + `/auth/linear/*` Mastra
      * `apiRoutes` (status, OAuth connect/callback, projects + issues for

package/dist/integrations/linear/integration.d.ts.map

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

package/dist/integrations/linear/integration.js

@@ -1,5 +1,7 @@
-import { buildLinearRoutes } from "./routes.js";
+import { IssueReconcileWorker } from "../issue-reconcile-worker.js";
 import { attachLinearRules } from "./rules.js";
+import { attachLinearIssueReconciler } from "./issue-reconciler.js";
+import { buildLinearRoutes } from "./routes.js";
 import { buildLinearAgentTools } from "./agent-tools.js";
 //#region src/integrations/linear/integration.ts
 const LINEAR_GRAPHQL_URL = "https://api.linear.app/graphql";
@@ -474,6 +476,7 @@ var LinearIntegration = class {
             state { name type }
             project { id }
             assignee { name }
+            creator { name }
             team { key }
             labels { nodes { name } }
           }
@@ -496,6 +499,7 @@ var LinearIntegration = class {
 				stateType: node.state.type,
 				priorityLabel: node.priorityLabel,
 				assignee: node.assignee?.name ?? null,
+				creator: node.creator?.name ?? null,
 				team: node.team?.key ?? null,
 				labels: node.labels.nodes.map((label) => label.name),
 				createdAt: node.createdAt,
@@ -549,6 +553,7 @@ var LinearIntegration = class {
             state { name type }
             project { id }
             assignee { name }
+            creator { name }
             team { key }
             labels { nodes { name } }
             comments(first: $commentsFirst) {
@@ -578,6 +583,7 @@ var LinearIntegration = class {
 			stateType: issue.state.type,
 			priorityLabel: issue.priorityLabel,
 			assignee: issue.assignee?.name ?? null,
+			creator: issue.creator?.name ?? null,
 			team: issue.team?.key ?? null,
 			labels: issue.labels.nodes.map((label) => label.name),
 			createdAt: issue.createdAt,
@@ -614,6 +620,17 @@ var LinearIntegration = class {
 		if (!data.commentCreate.success || !data.commentCreate.comment) throw new Error("Linear did not accept the comment.");
 		return data.commentCreate.comment;
 	}
+	workers(ctx) {
+		if (process.env.MASTRACODE_LINEAR_RECONCILE_ENABLED?.trim().toLowerCase() === "false") return [];
+		const reconcile = attachLinearIssueReconciler(this, ctx);
+		if (!reconcile) return [];
+		const intervalMs = Number(process.env.MASTRACODE_LINEAR_RECONCILE_INTERVAL_MS);
+		return [new IssueReconcileWorker({
+			integrationId: this.id,
+			reconcile,
+			...Number.isSafeInteger(intervalMs) && intervalMs > 0 ? { intervalMs } : {}
+		})];
+	}
 	/**
 	* The integration's HTTP surface: `/web/linear/*` + `/auth/linear/*` Mastra
 	* `apiRoutes` (status, OAuth connect/callback, projects + issues for
@@ -654,7 +671,7 @@ function linearIssueToIntakeIssue(issue) {
 		identifier: issue.identifier,
 		title: issue.title,
 		url: issue.url,
-		author: null,
+		author: issue.creator,
 		state: issue.state,
 		stateType: issue.stateType,
 		priority: issue.priorityLabel,