@mastra/factory 0.16.0-alpha.6 → 0.16.0-alpha.7

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

@@ -0,0 +1,114 @@
+/**
+ * `JiraIntegration` — the self-contained Jira Cloud integration.
+ *
+ * Implements the system-wide `FactoryIntegration` contract
+ * (`../base.ts`): the deploy entry reads the `JIRA_*` env vars ONCE,
+ * constructs an instance with explicit credentials, and passes it to
+ * `MastraFactory`. Everything Jira-flavored the system does — project/issue
+ * reads for Intake and the agent's issue tools — flows through this
+ * instance. No other module reads `JIRA_*` env vars.
+ *
+ * Unlike Linear, credentials are **deployment-global** (Basic auth with
+ * `email:apiToken` from the environment): there is no OAuth flow, no state
+ * signer, and no per-org connection storage. The `IntegrationConnection`
+ * arguments required by the `Intake` contract are accepted but not consulted
+ * — the instance's own credentials authenticate every call.
+ */
+import type { RequestContext } from '@mastra/core/request-context';
+import type { ApiRoute } from '@mastra/core/server';
+import type { MastraWorker } from '@mastra/core/worker';
+import type { IntegrationConnection } from '../../capabilities/connection.js';
+import type { Intake, IntakeIssue } from '../../capabilities/intake.js';
+import type { RouteAuth } from '../../routes/route.js';
+import type { FactoryProjectsStorage } from '../../storage/domains/projects/base.js';
+import type { FactoryIntegration, IntegrationContext, IntegrationTools } from '../base.js';
+import { JiraApiClient } from './api.js';
+import type { JiraEventRules, JiraRuleOverrides } from './default-rules.js';
+/** Deployment-global Jira Cloud credentials. All credential fields are required. */
+export interface JiraIntegrationConfig {
+    /** Site base URL, e.g. `https://acme.atlassian.net`. */
+    baseUrl: string;
+    /** Atlassian account email the API token belongs to. */
+    email: string;
+    /** API token from id.atlassian.com → Security → API tokens. */
+    apiToken: string;
+    /** Per-event replacements; omitted events retain defaults, null disables. */
+    rules?: JiraRuleOverrides;
+}
+/**
+ * The `Intake` contract requires a connection argument, but Jira credentials
+ * live on the integration instance — this inert placeholder is accepted and
+ * ignored everywhere, and keeps the real API token out of resolved dispatches
+ * and agent-tool calls.
+ */
+export declare const DEPLOYMENT_CONNECTION: IntegrationConnection;
+export declare class JiraIntegration implements FactoryIntegration {
+    #private;
+    /** Stable integration identifier (see `../base.ts`). */
+    readonly id = "jira";
+    /** Typed REST client bound to the deployment credentials. */
+    readonly api: JiraApiClient;
+    get rules(): JiraEventRules;
+    constructor(config: JiraIntegrationConfig);
+    /**
+     * Bind the projects domain and the host auth seam. Jira has no per-org
+     * connection rows, so the generic storage handle is unused — credentials
+     * are deployment-global constructor config.
+     */
+    initialize({ projects, auth }: {
+        projects: FactoryProjectsStorage;
+        auth: RouteAuth;
+    }): void;
+    /** Factory projects domain — maps a session's resourceId to its owning org. */
+    get projects(): FactoryProjectsStorage;
+    /**
+     * Whether the host runs with web auth enabled. Intake selections are
+     * org-owned, so every Jira surface is inert without a tenant auth seam.
+     */
+    get authEnabled(): boolean;
+    /**
+     * Map a session's resourceId (the factory project id) to its owning org.
+     * Same caching semantics as the Linear integration: definitive misses are
+     * cached, transient database failures are not.
+     */
+    resolveOrgId(resourceId: string): Promise<string | null>;
+    /** Test hook: clear the org cache between specs. */
+    clearCaches(): void;
+    /** Normalized site base URL (no trailing slash) — `/browse/<key>` links hang off this. */
+    get baseUrl(): string;
+    readonly intake: Intake;
+    /**
+     * One page of active issues (status category not Done), most recently
+     * updated first, optionally filtered to projects and labels. The
+     * capability cursor is Jira's opaque `nextPageToken` passed through.
+     */
+    listActiveIssues(cursor?: string, projectIds?: string[], labels?: string[]): Promise<{
+        issues: Array<IntakeIssue & {
+            sourceId: string;
+        }>;
+        nextCursor: string | null;
+    }>;
+    /**
+     * The integration's HTTP surface: `/web/jira/*` Mastra `apiRoutes` (status,
+     * projects + issues for Intake). No OAuth routes — credentials are
+     * deployment-global. Handlers operate on this instance.
+     */
+    routes(ctx: IntegrationContext): ApiRoute[];
+    /**
+     * Background reconciliation, matching the Platform integration: keeps filed
+     * Jira cards' metadata fresh and replays close events through the rules
+     * ingress. Registered only when reconciliation is enabled.
+     */
+    workers(ctx: IntegrationContext): MastraWorker[];
+    /**
+     * Org-scoped agent tools: the read-only issue-detail tool for sessions whose
+     * resource is a factory project (Jira credentials are deployment-global,
+     * so no per-org connection gates apply). v1 exposes no mutating Jira tools.
+     */
+    agentTools(args: {
+        requestContext: RequestContext;
+    }): Promise<IntegrationTools>;
+    /** Non-secret config snapshot for system diagnostics/startup logs. */
+    diagnostics(): Record<string, unknown>;
+}
+//# sourceMappingURL=integration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/integrations/jira/integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAIV,MAAM,EACN,WAAW,EASZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK3F,OAAO,EAAE,aAAa,EAAgB,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO5E,oFAAoF;AACpF,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAQD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAA2E,CAAC;AAgChH,qBAAa,eAAgB,YAAW,kBAAkB;;IACxD,wDAAwD;IACxD,QAAQ,CAAC,EAAE,UAAU;IAGrB,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAS5B,IAAI,KAAK,IAAI,cAAc,CAE1B;gBAEW,MAAM,EAAE,qBAAqB;IAOzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAK3F,+EAA+E;IAC/E,IAAI,QAAQ,IAAI,sBAAsB,CAKrC;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;OAIG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuB9D,oDAAoD;IACpD,WAAW,IAAI,IAAI;IAInB,0FAA0F;IAC1F,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,QAAQ,CAAC,MAAM,EAAE,MAAM,CAQrB;IA6EF;;;;OAIG;IACG,gBAAgB,CACpB,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,CAAC,WAAW,GAAG;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAmH5F;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ,EAAE;IAS3C;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,kBAAkB,GAAG,YAAY,EAAE;IAchD;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE;QAAE,cAAc,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrF,sEAAsE;IACtE,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOvC"}

package/dist/integrations/jira/integration.js

@@ -0,0 +1,401 @@
+import { IssueReconcileWorker } from "../issue-reconcile-worker.js";
+import { adfToText } from "./adf.js";
+import { JiraApiClient, JiraApiError } from "./api.js";
+import { resolveJiraRules } from "./default-rules.js";
+import { attachJiraRules } from "./rules.js";
+import { attachJiraIssueReconciler } from "./issue-reconciler.js";
+import { jiraReconciliationEnabled, jiraReconciliationInterval } from "./reconciliation-config.js";
+import { buildJiraRoutes } from "./routes.js";
+import { buildJiraAgentTools } from "./agent-tools.js";
+//#region src/integrations/jira/integration.ts
+/** Hard stop for comment pagination so a misbehaving `total` can't loop forever. */
+const ISSUE_COMMENTS_MAX_PAGES = 20;
+/** Hard stop for project pagination so a misbehaving `isLast` can't loop forever. */
+const PROJECT_SEARCH_MAX_PAGES = 50;
+/**
+* The `Intake` contract requires a connection argument, but Jira credentials
+* live on the integration instance — this inert placeholder is accepted and
+* ignored everywhere, and keeps the real API token out of resolved dispatches
+* and agent-tool calls.
+*/
+const DEPLOYMENT_CONNECTION = {
+	type: "oauth",
+	accessToken: "deployment-global"
+};
+/** Jira issue keys look like `ENG-42`. */
+const ISSUE_KEY_PATTERN = /^[A-Za-z][A-Za-z0-9_]*-\d+$/;
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+* Capability state types (`capabilities/intake.ts`) → Jira status-category
+* keys. `canceled` has no Jira category — it is resolved separately against
+* `done`-category transitions whose status name contains "cancel".
+*/
+const STATE_TYPE_TO_CATEGORY = {
+	unstarted: "new",
+	started: "indeterminate",
+	completed: "done"
+};
+/** Jira status-category keys → capability state types. */
+function stateTypeFromCategory(key) {
+	switch (key) {
+		case "new": return "unstarted";
+		case "indeterminate": return "started";
+		case "done": return "completed";
+		default: return null;
+	}
+}
+var JiraIntegration = class {
+	/** Stable integration identifier (see `../base.ts`). */
+	id = "jira";
+	#config;
+	/** Typed REST client bound to the deployment credentials. */
+	api;
+	/** Bound once by the factory via `initialize()` before any surface is used. */
+	#projects;
+	#auth;
+	#orgIdByResourceId = /* @__PURE__ */ new Map();
+	#rules;
+	get rules() {
+		return this.#rules;
+	}
+	constructor(config) {
+		this.#rules = resolveJiraRules(config.rules);
+		this.api = new JiraApiClient(config);
+		this.#config = config;
+	}
+	/**
+	* Bind the projects domain and the host auth seam. Jira has no per-org
+	* connection rows, so the generic storage handle is unused — credentials
+	* are deployment-global constructor config.
+	*/
+	initialize({ projects, auth }) {
+		this.#projects = projects;
+		this.#auth = auth;
+	}
+	/** Factory projects domain — maps a session's resourceId to its owning org. */
+	get projects() {
+		if (!this.#projects) throw new Error("JiraIntegration is not initialized — the factory binds storage during prepare().");
+		return this.#projects;
+	}
+	/**
+	* Whether the host runs with web auth enabled. Intake selections are
+	* org-owned, so every Jira surface is inert without a tenant auth seam.
+	*/
+	get authEnabled() {
+		return this.#auth?.enabled() ?? false;
+	}
+	/**
+	* Map a session's resourceId (the factory project id) to its owning org.
+	* Same caching semantics as the Linear integration: definitive misses are
+	* cached, transient database failures are not.
+	*/
+	async resolveOrgId(resourceId) {
+		const cached = this.#orgIdByResourceId.get(resourceId);
+		if (cached !== void 0) return cached;
+		if (!UUID_PATTERN.test(resourceId)) {
+			this.#orgIdByResourceId.set(resourceId, null);
+			return null;
+		}
+		let orgId;
+		try {
+			await this.projects.ensureReady();
+			orgId = (await this.projects.getById({ id: resourceId }))?.orgId ?? null;
+		} catch {
+			return null;
+		}
+		this.#orgIdByResourceId.set(resourceId, orgId);
+		return orgId;
+	}
+	/** Test hook: clear the org cache between specs. */
+	clearCaches() {
+		this.#orgIdByResourceId.clear();
+	}
+	/** Normalized site base URL (no trailing slash) — `/browse/<key>` links hang off this. */
+	get baseUrl() {
+		return this.api.baseUrl;
+	}
+	intake = {
+		resolveIntakeDispatch: (input) => this.#resolveIntakeDispatch(input),
+		listSources: () => this.#listSources(),
+		listItems: (input) => this.#listItems(input),
+		listIssues: (input) => this.#listIssues(input),
+		getIssue: (input) => this.#getIssue(input),
+		createComment: (input) => this.#createComment(input),
+		updateIssue: (input) => this.#updateIssue(input)
+	};
+	/**
+	* Background-dispatch context. Credentials are deployment-global, so the
+	* returned connection is a formality the Jira intake methods ignore; the
+	* issue key is stored directly as the work item's `externalId` (mirroring
+	* Linear, which stores the issue UUID).
+	*/
+	async #resolveIntakeDispatch({ externalSource }) {
+		if (externalSource.type !== "issue") return null;
+		return {
+			connection: DEPLOYMENT_CONNECTION,
+			issueId: externalSource.externalId
+		};
+	}
+	/** All the site's projects (Settings intake-source picker), following `isLast` paging. */
+	async #listSources() {
+		const sources = [];
+		let startAt = 0;
+		for (let pageCount = 0; pageCount < PROJECT_SEARCH_MAX_PAGES; pageCount++) {
+			const page = await this.api.listProjects({ startAt });
+			for (const project of page.values) sources.push({
+				id: project.id,
+				name: project.name,
+				type: "project",
+				metadata: { key: project.key }
+			});
+			if (page.isLast || page.values.length === 0) break;
+			startAt += page.values.length;
+		}
+		return sources;
+	}
+	async #listItems({ sourceIds, cursor }) {
+		if (sourceIds.length === 0) return {
+			items: [],
+			nextCursor: null
+		};
+		const page = await this.listActiveIssues(cursor, sourceIds);
+		return {
+			items: page.issues.map((issue) => ({
+				source: {
+					type: "issue",
+					externalId: issue.identifier,
+					url: issue.url
+				},
+				sourceId: issue.sourceId,
+				title: `${issue.identifier}: ${issue.title}`,
+				status: issue.state ?? void 0,
+				labels: issue.labels,
+				assignee: issue.assignee,
+				createdAt: issue.createdAt,
+				updatedAt: issue.updatedAt,
+				metadata: {
+					identifier: issue.identifier,
+					issueRef: issue.identifier,
+					state: issue.state,
+					stateType: issue.stateType,
+					priority: issue.priority,
+					project: issue.source,
+					assignee: issue.assignee,
+					assignees: issue.assignees ?? [],
+					creator: issue.author,
+					author: issue.author,
+					labels: issue.labels,
+					createdAt: issue.createdAt,
+					updatedAt: issue.updatedAt
+				}
+			})),
+			nextCursor: page.nextCursor
+		};
+	}
+	async #listIssues(input) {
+		const page = await this.listActiveIssues(input.cursor, input.sourceIds, input.labels);
+		return {
+			issues: page.issues,
+			nextCursor: page.nextCursor
+		};
+	}
+	/**
+	* One page of active issues (status category not Done), most recently
+	* updated first, optionally filtered to projects and labels. The
+	* capability cursor is Jira's opaque `nextPageToken` passed through.
+	*/
+	async listActiveIssues(cursor, projectIds, labels) {
+		const page = await this.api.searchIssues({
+			jql: buildIntakeJql(projectIds, labels),
+			...cursor ? { nextPageToken: cursor } : {}
+		});
+		return {
+			issues: page.issues.map((issue) => ({
+				...this.#toIntakeIssue(issue),
+				sourceId: issue.fields.project?.id ?? ""
+			})),
+			nextCursor: page.nextPageToken ?? null
+		};
+	}
+	async #getIssue({ issueId }) {
+		let issue;
+		try {
+			issue = await this.api.getIssue(issueId);
+		} catch (err) {
+			if (err instanceof JiraApiError && err.status === 404) return null;
+			throw err;
+		}
+		const { comments, total } = await this.#listAllComments(issue.key);
+		return {
+			...this.#toIntakeIssue(issue),
+			commentCount: total,
+			description: issue.fields.description ? adfToText(issue.fields.description) || null : null,
+			comments: comments.map((comment) => ({
+				author: comment.author?.displayName ?? null,
+				body: adfToText(comment.body),
+				createdAt: comment.created
+			}))
+		};
+	}
+	/** Every comment on the issue, oldest first, bounded by {@link ISSUE_COMMENTS_MAX_PAGES}. */
+	async #listAllComments(keyOrId) {
+		const comments = [];
+		let total = 0;
+		for (let page = 0; page < ISSUE_COMMENTS_MAX_PAGES; page++) {
+			const result = await this.api.listComments(keyOrId, { startAt: comments.length });
+			comments.push(...result.comments);
+			total = result.total;
+			if (result.comments.length === 0 || comments.length >= total) break;
+		}
+		return {
+			comments,
+			total
+		};
+	}
+	async #createComment({ issueId, body }) {
+		let key = issueId;
+		if (!ISSUE_KEY_PATTERN.test(issueId)) try {
+			key = (await this.api.getIssue(issueId)).key;
+		} catch (err) {
+			if (err instanceof JiraApiError && err.status === 404) return null;
+			throw err;
+		}
+		const comment = await this.api.createComment(key, body);
+		return {
+			id: comment.id,
+			url: `${this.baseUrl}/browse/${key}?focusedCommentId=${comment.id}`
+		};
+	}
+	/**
+	* Move an issue to a target state by applying a workflow transition. Jira
+	* only exposes transitions that are currently legal, so a policy miss (no
+	* transition reaches the target) returns `null` per the `Intake` contract —
+	* infrastructure errors (network, auth) still throw.
+	*/
+	async #updateIssue(input) {
+		let issue;
+		try {
+			issue = await this.api.getIssue(input.issueId);
+		} catch (err) {
+			if (err instanceof JiraApiError && err.status === 404) return null;
+			throw err;
+		}
+		if (currentStatusMatches(issue, input.state)) return this.#toIntakeIssue(issue);
+		const transition = resolveTransition(await this.api.listTransitions(issue.key), input.state);
+		if (!transition) return null;
+		await this.api.applyTransition(issue.key, transition.id);
+		const fresh = await this.api.getIssue(issue.key);
+		return this.#toIntakeIssue(fresh);
+	}
+	#toIntakeIssue(issue) {
+		const { fields } = issue;
+		return {
+			id: issue.id,
+			identifier: issue.key,
+			title: fields.summary ?? issue.key,
+			url: `${this.baseUrl}/browse/${issue.key}`,
+			author: fields.reporter?.displayName ?? null,
+			state: fields.status?.name ?? null,
+			stateType: stateTypeFromCategory(fields.status?.statusCategory?.key),
+			priority: fields.priority?.name ?? null,
+			assignee: fields.assignee?.displayName ?? null,
+			source: fields.project?.key ?? null,
+			sourceId: fields.project?.id ?? null,
+			labels: fields.labels ?? [],
+			commentCount: null,
+			createdAt: fields.created ?? "",
+			updatedAt: fields.updated ?? ""
+		};
+	}
+	/**
+	* The integration's HTTP surface: `/web/jira/*` Mastra `apiRoutes` (status,
+	* projects + issues for Intake). No OAuth routes — credentials are
+	* deployment-global. Handlers operate on this instance.
+	*/
+	routes(ctx) {
+		return buildJiraRoutes({
+			jira: this,
+			auth: ctx.auth,
+			intake: ctx.storage.intake,
+			ingestFactoryIssues: attachJiraRules(this, ctx)
+		});
+	}
+	/**
+	* Background reconciliation, matching the Platform integration: keeps filed
+	* Jira cards' metadata fresh and replays close events through the rules
+	* ingress. Registered only when reconciliation is enabled.
+	*/
+	workers(ctx) {
+		if (!jiraReconciliationEnabled()) return [];
+		const reconcile = attachJiraIssueReconciler(this, ctx);
+		if (!reconcile) return [];
+		const intervalMs = jiraReconciliationInterval();
+		return [new IssueReconcileWorker({
+			integrationId: this.id,
+			reconcile,
+			...intervalMs ? { intervalMs } : {}
+		})];
+	}
+	/**
+	* Org-scoped agent tools: the read-only issue-detail tool for sessions whose
+	* resource is a factory project (Jira credentials are deployment-global,
+	* so no per-org connection gates apply). v1 exposes no mutating Jira tools.
+	*/
+	async agentTools(args) {
+		return buildJiraAgentTools({
+			requestContext: args.requestContext,
+			jira: this
+		});
+	}
+	/** Non-secret config snapshot for system diagnostics/startup logs. */
+	diagnostics() {
+		return {
+			configured: true,
+			site: new URL(this.baseUrl).host,
+			email: maskEmail(this.#config.email)
+		};
+	}
+};
+/** `ops@acme.test` → `o***@acme.test` — enough to identify, never the value. */
+function maskEmail(email) {
+	const at = email.indexOf("@");
+	if (at <= 0) return "***";
+	return `${email[0]}***${email.slice(at)}`;
+}
+/**
+* Build the intake JQL. Source ids and labels come from stored org config /
+* request input, so both are sanitized before interpolation: numeric project
+* ids pass through bare, project keys are restricted to a safe charset, and
+* label quotes/backslashes are stripped.
+*/
+function buildIntakeJql(projectIds, labels) {
+	const clauses = [];
+	const safeProjects = (projectIds ?? []).map((id) => id.trim()).filter((id) => /^[A-Za-z0-9_]+$/.test(id)).map((id) => /^\d+$/.test(id) ? id : `"${id}"`);
+	if (safeProjects.length > 0) clauses.push(`project IN (${safeProjects.join(", ")})`);
+	clauses.push("statusCategory != Done");
+	const safeLabels = [...new Set((labels ?? []).map((label) => label.trim().replace(/["\\]/g, "")).filter(Boolean))];
+	if (safeLabels.length > 0) clauses.push(`labels IN (${safeLabels.map((label) => `"${label}"`).join(", ")})`);
+	return `${clauses.join(" AND ")} ORDER BY updated DESC`;
+}
+/** Whether the issue is already in the requested target state. */
+function currentStatusMatches(issue, target) {
+	const status = issue.fields.status;
+	if (!status) return false;
+	if (target.kind === "byName") return status.name.toLowerCase() === target.name.toLowerCase();
+	if (target.stateType === "canceled") return status.statusCategory?.key === "done" && /cancel/i.test(status.name);
+	return status.statusCategory?.key === STATE_TYPE_TO_CATEGORY[target.stateType];
+}
+/** Resolve the target state against the issue's currently-legal transitions. */
+function resolveTransition(transitions, target) {
+	if (target.kind === "byName") {
+		const wanted = target.name.toLowerCase();
+		return transitions.find((transition) => transition.to?.name.toLowerCase() === wanted) ?? null;
+	}
+	if (target.stateType === "canceled") return transitions.find((transition) => transition.to?.statusCategory?.key === "done" && /cancel/i.test(transition.to.name)) ?? null;
+	const category = STATE_TYPE_TO_CATEGORY[target.stateType];
+	return transitions.find((transition) => transition.to?.statusCategory?.key === category) ?? null;
+}
+//#endregion
+export { DEPLOYMENT_CONNECTION, JiraIntegration };
+
+//# sourceMappingURL=integration.js.map

package/dist/integrations/jira/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","names":["#config","#orgIdByResourceId","#rules","#projects","#auth","#resolveIntakeDispatch","#listSources","#listItems","#listIssues","#getIssue","#createComment","#updateIssue","#toIntakeIssue","#listAllComments"],"sources":["../../../src/integrations/jira/integration.ts"],"sourcesContent":["/**\n * `JiraIntegration` — the self-contained Jira Cloud integration.\n *\n * Implements the system-wide `FactoryIntegration` contract\n * (`../base.ts`): the deploy entry reads the `JIRA_*` env vars ONCE,\n * constructs an instance with explicit credentials, and passes it to\n * `MastraFactory`. Everything Jira-flavored the system does — project/issue\n * reads for Intake and the agent's issue tools — flows through this\n * instance. No other module reads `JIRA_*` env vars.\n *\n * Unlike Linear, credentials are **deployment-global** (Basic auth with\n * `email:apiToken` from the environment): there is no OAuth flow, no state\n * signer, and no per-org connection storage. The `IntegrationConnection`\n * arguments required by the `Intake` contract are accepted but not consulted\n * — the instance's own credentials authenticate every call.\n */\n\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { ApiRoute } from '@mastra/core/server';\nimport type { MastraWorker } from '@mastra/core/worker';\n\nimport type { IntegrationConnection } from '../../capabilities/connection.js';\nimport type {\n  CreateIntakeCommentInput,\n  CreatedIntakeComment,\n  GetIntakeIssueInput,\n  Intake,\n  IntakeIssue,\n  IntakeIssueDetail,\n  IntakeItemPage,\n  IntakeSource,\n  ListIntakeIssuesInput,\n  ListIntakeItemsInput,\n  ResolveIntakeDispatchInput,\n  ResolvedIntakeDispatch,\n  UpdateIntakeIssueInput,\n} from '../../capabilities/intake.js';\nimport type { RouteAuth } from '../../routes/route.js';\nimport type { FactoryProjectsStorage } from '../../storage/domains/projects/base.js';\nimport type { FactoryIntegration, IntegrationContext, IntegrationTools } from '../base.js';\nimport { IssueReconcileWorker } from '../issue-reconcile-worker.js';\nimport { adfToText } from './adf.js';\nimport { buildJiraAgentTools } from './agent-tools.js';\nimport type { JiraComment, JiraIssue, JiraTransition } from './api.js';\nimport { JiraApiClient, JiraApiError } from './api.js';\nimport type { JiraEventRules, JiraRuleOverrides } from './default-rules.js';\nimport { resolveJiraRules } from './default-rules.js';\nimport { attachJiraIssueReconciler } from './issue-reconciler.js';\nimport { jiraReconciliationEnabled, jiraReconciliationInterval } from './reconciliation-config.js';\nimport { buildJiraRoutes } from './routes.js';\nimport { attachJiraRules } from './rules.js';\n\n/** Deployment-global Jira Cloud credentials. All credential fields are required. */\nexport interface JiraIntegrationConfig {\n  /** Site base URL, e.g. `https://acme.atlassian.net`. */\n  baseUrl: string;\n  /** Atlassian account email the API token belongs to. */\n  email: string;\n  /** API token from id.atlassian.com → Security → API tokens. */\n  apiToken: string;\n  /** Per-event replacements; omitted events retain defaults, null disables. */\n  rules?: JiraRuleOverrides;\n}\n\n/** Hard stop for comment pagination so a misbehaving `total` can't loop forever. */\nconst ISSUE_COMMENTS_MAX_PAGES = 20;\n\n/** Hard stop for project pagination so a misbehaving `isLast` can't loop forever. */\nconst PROJECT_SEARCH_MAX_PAGES = 50;\n\n/**\n * The `Intake` contract requires a connection argument, but Jira credentials\n * live on the integration instance — this inert placeholder is accepted and\n * ignored everywhere, and keeps the real API token out of resolved dispatches\n * and agent-tool calls.\n */\nexport const DEPLOYMENT_CONNECTION: IntegrationConnection = { type: 'oauth', accessToken: 'deployment-global' };\n\n/** Jira issue keys look like `ENG-42`. */\nconst ISSUE_KEY_PATTERN = /^[A-Za-z][A-Za-z0-9_]*-\\d+$/;\n\nconst UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/**\n * Capability state types (`capabilities/intake.ts`) → Jira status-category\n * keys. `canceled` has no Jira category — it is resolved separately against\n * `done`-category transitions whose status name contains \"cancel\".\n */\nconst STATE_TYPE_TO_CATEGORY: Record<'unstarted' | 'started' | 'completed', string> = {\n  unstarted: 'new',\n  started: 'indeterminate',\n  completed: 'done',\n};\n\n/** Jira status-category keys → capability state types. */\nfunction stateTypeFromCategory(key: string | undefined): string | null {\n  switch (key) {\n    case 'new':\n      return 'unstarted';\n    case 'indeterminate':\n      return 'started';\n    case 'done':\n      return 'completed';\n    default:\n      return null;\n  }\n}\n\nexport class JiraIntegration implements FactoryIntegration {\n  /** Stable integration identifier (see `../base.ts`). */\n  readonly id = 'jira';\n\n  readonly #config: JiraIntegrationConfig;\n  /** Typed REST client bound to the deployment credentials. */\n  readonly api: JiraApiClient;\n\n  /** Bound once by the factory via `initialize()` before any surface is used. */\n  #projects: FactoryProjectsStorage | undefined;\n  #auth: RouteAuth | undefined;\n  readonly #orgIdByResourceId = new Map<string, string | null>();\n\n  readonly #rules: JiraEventRules;\n\n  get rules(): JiraEventRules {\n    return this.#rules;\n  }\n\n  constructor(config: JiraIntegrationConfig) {\n    this.#rules = resolveJiraRules(config.rules);\n    // JiraApiClient validates the credential group and normalizes the URL.\n    this.api = new JiraApiClient(config);\n    this.#config = config;\n  }\n\n  /**\n   * Bind the projects domain and the host auth seam. Jira has no per-org\n   * connection rows, so the generic storage handle is unused — credentials\n   * are deployment-global constructor config.\n   */\n  initialize({ projects, auth }: { projects: FactoryProjectsStorage; auth: RouteAuth }): void {\n    this.#projects = projects;\n    this.#auth = auth;\n  }\n\n  /** Factory projects domain — maps a session's resourceId to its owning org. */\n  get projects(): FactoryProjectsStorage {\n    if (!this.#projects) {\n      throw new Error('JiraIntegration is not initialized — the factory binds storage during prepare().');\n    }\n    return this.#projects;\n  }\n\n  /**\n   * Whether the host runs with web auth enabled. Intake selections are\n   * org-owned, so every Jira surface is inert without a tenant auth seam.\n   */\n  get authEnabled(): boolean {\n    return this.#auth?.enabled() ?? false;\n  }\n\n  /**\n   * Map a session's resourceId (the factory project id) to its owning org.\n   * Same caching semantics as the Linear integration: definitive misses are\n   * cached, transient database failures are not.\n   */\n  async resolveOrgId(resourceId: string): Promise<string | null> {\n    const cached = this.#orgIdByResourceId.get(resourceId);\n    if (cached !== undefined) return cached;\n    // Non-UUID resource ids (local/dev resources) would make the uuid column\n    // comparison throw — they're definitively \"not a project\", so cache that.\n    if (!UUID_PATTERN.test(resourceId)) {\n      this.#orgIdByResourceId.set(resourceId, null);\n      return null;\n    }\n    let orgId: string | null;\n    try {\n      await this.projects.ensureReady();\n      const project = await this.projects.getById({ id: resourceId });\n      orgId = project?.orgId ?? null;\n    } catch {\n      // Transient database failure: skip the tools for this request but don't\n      // cache the miss, so the next request retries the lookup.\n      return null;\n    }\n    this.#orgIdByResourceId.set(resourceId, orgId);\n    return orgId;\n  }\n\n  /** Test hook: clear the org cache between specs. */\n  clearCaches(): void {\n    this.#orgIdByResourceId.clear();\n  }\n\n  /** Normalized site base URL (no trailing slash) — `/browse/<key>` links hang off this. */\n  get baseUrl(): string {\n    return this.api.baseUrl;\n  }\n\n  readonly intake: Intake = {\n    resolveIntakeDispatch: input => this.#resolveIntakeDispatch(input),\n    listSources: () => this.#listSources(),\n    listItems: input => this.#listItems(input),\n    listIssues: input => this.#listIssues(input),\n    getIssue: input => this.#getIssue(input),\n    createComment: input => this.#createComment(input),\n    updateIssue: input => this.#updateIssue(input),\n  };\n\n  /**\n   * Background-dispatch context. Credentials are deployment-global, so the\n   * returned connection is a formality the Jira intake methods ignore; the\n   * issue key is stored directly as the work item's `externalId` (mirroring\n   * Linear, which stores the issue UUID).\n   */\n  async #resolveIntakeDispatch({ externalSource }: ResolveIntakeDispatchInput): Promise<ResolvedIntakeDispatch | null> {\n    if (externalSource.type !== 'issue') return null;\n    return {\n      // Inert placeholder, never the real token: the Jira intake methods read\n      // credentials from the client, and the resolved dispatch travels through\n      // generic reconciler/dispatcher code that must stay secret-free.\n      connection: DEPLOYMENT_CONNECTION,\n      issueId: externalSource.externalId,\n    };\n  }\n\n  /** All the site's projects (Settings intake-source picker), following `isLast` paging. */\n  async #listSources(): Promise<IntakeSource[]> {\n    const sources: IntakeSource[] = [];\n    let startAt = 0;\n    for (let pageCount = 0; pageCount < PROJECT_SEARCH_MAX_PAGES; pageCount++) {\n      const page = await this.api.listProjects({ startAt });\n      for (const project of page.values) {\n        sources.push({\n          id: project.id,\n          name: project.name,\n          type: 'project',\n          metadata: { key: project.key },\n        });\n      }\n      if (page.isLast || page.values.length === 0) break;\n      startAt += page.values.length;\n    }\n    return sources;\n  }\n\n  async #listItems({ sourceIds, cursor }: ListIntakeItemsInput): Promise<IntakeItemPage> {\n    if (sourceIds.length === 0) return { items: [], nextCursor: null };\n    const page = await this.listActiveIssues(cursor, sourceIds);\n    return {\n      items: page.issues.map(issue => ({\n        source: { type: 'issue', externalId: issue.identifier, url: issue.url },\n        sourceId: issue.sourceId,\n        title: `${issue.identifier}: ${issue.title}`,\n        status: issue.state ?? undefined,\n        labels: issue.labels,\n        assignee: issue.assignee,\n        createdAt: issue.createdAt,\n        updatedAt: issue.updatedAt,\n        metadata: {\n          identifier: issue.identifier,\n          issueRef: issue.identifier,\n          state: issue.state,\n          stateType: issue.stateType,\n          priority: issue.priority,\n          project: issue.source,\n          assignee: issue.assignee,\n          assignees: issue.assignees ?? [],\n          creator: issue.author,\n          author: issue.author,\n          labels: issue.labels,\n          createdAt: issue.createdAt,\n          updatedAt: issue.updatedAt,\n        },\n      })),\n      nextCursor: page.nextCursor,\n    };\n  }\n\n  async #listIssues(input: ListIntakeIssuesInput): Promise<{ issues: IntakeIssue[]; nextCursor: string | null }> {\n    const page = await this.listActiveIssues(input.cursor, input.sourceIds, input.labels);\n    return { issues: page.issues, nextCursor: page.nextCursor };\n  }\n\n  /**\n   * One page of active issues (status category not Done), most recently\n   * updated first, optionally filtered to projects and labels. The\n   * capability cursor is Jira's opaque `nextPageToken` passed through.\n   */\n  async listActiveIssues(\n    cursor?: string,\n    projectIds?: string[],\n    labels?: string[],\n  ): Promise<{ issues: Array<IntakeIssue & { sourceId: string }>; nextCursor: string | null }> {\n    const page = await this.api.searchIssues({\n      jql: buildIntakeJql(projectIds, labels),\n      ...(cursor ? { nextPageToken: cursor } : {}),\n    });\n    return {\n      issues: page.issues.map(issue => ({\n        ...this.#toIntakeIssue(issue),\n        sourceId: issue.fields.project?.id ?? '',\n      })),\n      nextCursor: page.nextPageToken ?? null,\n    };\n  }\n\n  async #getIssue({ issueId }: GetIntakeIssueInput): Promise<IntakeIssueDetail | null> {\n    let issue: JiraIssue;\n    try {\n      issue = await this.api.getIssue(issueId);\n    } catch (err) {\n      if (err instanceof JiraApiError && err.status === 404) return null;\n      throw err;\n    }\n    const { comments, total } = await this.#listAllComments(issue.key);\n    return {\n      ...this.#toIntakeIssue(issue),\n      commentCount: total,\n      description: issue.fields.description ? adfToText(issue.fields.description) || null : null,\n      comments: comments.map(comment => ({\n        author: comment.author?.displayName ?? null,\n        body: adfToText(comment.body),\n        createdAt: comment.created,\n      })),\n    };\n  }\n\n  /** Every comment on the issue, oldest first, bounded by {@link ISSUE_COMMENTS_MAX_PAGES}. */\n  async #listAllComments(keyOrId: string): Promise<{ comments: JiraComment[]; total: number }> {\n    const comments: JiraComment[] = [];\n    let total = 0;\n    for (let page = 0; page < ISSUE_COMMENTS_MAX_PAGES; page++) {\n      const result = await this.api.listComments(keyOrId, { startAt: comments.length });\n      comments.push(...result.comments);\n      total = result.total;\n      if (result.comments.length === 0 || comments.length >= total) break;\n    }\n    return { comments, total };\n  }\n\n  async #createComment({ issueId, body }: CreateIntakeCommentInput): Promise<CreatedIntakeComment | null> {\n    // The browse URL needs the issue key; resolve it when the caller passed a\n    // numeric id instead.\n    let key = issueId;\n    if (!ISSUE_KEY_PATTERN.test(issueId)) {\n      try {\n        key = (await this.api.getIssue(issueId)).key;\n      } catch (err) {\n        if (err instanceof JiraApiError && err.status === 404) return null;\n        throw err;\n      }\n    }\n    const comment = await this.api.createComment(key, body);\n    return {\n      id: comment.id,\n      url: `${this.baseUrl}/browse/${key}?focusedCommentId=${comment.id}`,\n    };\n  }\n\n  /**\n   * Move an issue to a target state by applying a workflow transition. Jira\n   * only exposes transitions that are currently legal, so a policy miss (no\n   * transition reaches the target) returns `null` per the `Intake` contract —\n   * infrastructure errors (network, auth) still throw.\n   */\n  async #updateIssue(input: UpdateIntakeIssueInput): Promise<IntakeIssue | null> {\n    let issue: JiraIssue;\n    try {\n      issue = await this.api.getIssue(input.issueId);\n    } catch (err) {\n      if (err instanceof JiraApiError && err.status === 404) return null;\n      throw err;\n    }\n    if (currentStatusMatches(issue, input.state)) {\n      return this.#toIntakeIssue(issue);\n    }\n    const transitions = await this.api.listTransitions(issue.key);\n    const transition = resolveTransition(transitions, input.state);\n    if (!transition) return null;\n    await this.api.applyTransition(issue.key, transition.id);\n    const fresh = await this.api.getIssue(issue.key);\n    return this.#toIntakeIssue(fresh);\n  }\n\n  #toIntakeIssue(issue: JiraIssue): IntakeIssue {\n    const { fields } = issue;\n    return {\n      id: issue.id,\n      identifier: issue.key,\n      title: fields.summary ?? issue.key,\n      url: `${this.baseUrl}/browse/${issue.key}`,\n      author: fields.reporter?.displayName ?? null,\n      state: fields.status?.name ?? null,\n      stateType: stateTypeFromCategory(fields.status?.statusCategory?.key),\n      priority: fields.priority?.name ?? null,\n      assignee: fields.assignee?.displayName ?? null,\n      source: fields.project?.key ?? null,\n      sourceId: fields.project?.id ?? null,\n      labels: fields.labels ?? [],\n      commentCount: null,\n      createdAt: fields.created ?? '',\n      updatedAt: fields.updated ?? '',\n    };\n  }\n\n  // ── FactoryIntegration surface ───────────────────────────────────────────\n\n  /**\n   * The integration's HTTP surface: `/web/jira/*` Mastra `apiRoutes` (status,\n   * projects + issues for Intake). No OAuth routes — credentials are\n   * deployment-global. Handlers operate on this instance.\n   */\n  routes(ctx: IntegrationContext): ApiRoute[] {\n    return buildJiraRoutes({\n      jira: this,\n      auth: ctx.auth,\n      intake: ctx.storage.intake,\n      ingestFactoryIssues: attachJiraRules(this, ctx),\n    });\n  }\n\n  /**\n   * Background reconciliation, matching the Platform integration: keeps filed\n   * Jira cards' metadata fresh and replays close events through the rules\n   * ingress. Registered only when reconciliation is enabled.\n   */\n  workers(ctx: IntegrationContext): MastraWorker[] {\n    if (!jiraReconciliationEnabled()) return [];\n    const reconcile = attachJiraIssueReconciler(this, ctx);\n    if (!reconcile) return [];\n    const intervalMs = jiraReconciliationInterval();\n    return [\n      new IssueReconcileWorker({\n        integrationId: this.id,\n        reconcile,\n        ...(intervalMs ? { intervalMs } : {}),\n      }),\n    ];\n  }\n\n  /**\n   * Org-scoped agent tools: the read-only issue-detail tool for sessions whose\n   * resource is a factory project (Jira credentials are deployment-global,\n   * so no per-org connection gates apply). v1 exposes no mutating Jira tools.\n   */\n  async agentTools(args: { requestContext: RequestContext }): Promise<IntegrationTools> {\n    return buildJiraAgentTools({ requestContext: args.requestContext, jira: this });\n  }\n\n  /** Non-secret config snapshot for system diagnostics/startup logs. */\n  diagnostics(): Record<string, unknown> {\n    return {\n      configured: true,\n      site: new URL(this.baseUrl).host,\n      email: maskEmail(this.#config.email),\n    };\n  }\n}\n\n/** `ops@acme.test` → `o***@acme.test` — enough to identify, never the value. */\nfunction maskEmail(email: string): string {\n  const at = email.indexOf('@');\n  if (at <= 0) return '***';\n  return `${email[0]}***${email.slice(at)}`;\n}\n\n/**\n * Build the intake JQL. Source ids and labels come from stored org config /\n * request input, so both are sanitized before interpolation: numeric project\n * ids pass through bare, project keys are restricted to a safe charset, and\n * label quotes/backslashes are stripped.\n */\nfunction buildIntakeJql(projectIds?: string[], labels?: string[]): string {\n  const clauses: string[] = [];\n  const safeProjects = (projectIds ?? [])\n    .map(id => id.trim())\n    .filter(id => /^[A-Za-z0-9_]+$/.test(id))\n    .map(id => (/^\\d+$/.test(id) ? id : `\"${id}\"`));\n  if (safeProjects.length > 0) {\n    clauses.push(`project IN (${safeProjects.join(', ')})`);\n  }\n  clauses.push('statusCategory != Done');\n  const safeLabels = [...new Set((labels ?? []).map(label => label.trim().replace(/[\"\\\\]/g, '')).filter(Boolean))];\n  if (safeLabels.length > 0) {\n    clauses.push(`labels IN (${safeLabels.map(label => `\"${label}\"`).join(', ')})`);\n  }\n  return `${clauses.join(' AND ')} ORDER BY updated DESC`;\n}\n\n/** Whether the issue is already in the requested target state. */\nfunction currentStatusMatches(issue: JiraIssue, target: UpdateIntakeIssueInput['state']): boolean {\n  const status = issue.fields.status;\n  if (!status) return false;\n  if (target.kind === 'byName') {\n    return status.name.toLowerCase() === target.name.toLowerCase();\n  }\n  if (target.stateType === 'canceled') {\n    return status.statusCategory?.key === 'done' && /cancel/i.test(status.name);\n  }\n  return status.statusCategory?.key === STATE_TYPE_TO_CATEGORY[target.stateType];\n}\n\n/** Resolve the target state against the issue's currently-legal transitions. */\nfunction resolveTransition(\n  transitions: JiraTransition[],\n  target: UpdateIntakeIssueInput['state'],\n): JiraTransition | null {\n  if (target.kind === 'byName') {\n    const wanted = target.name.toLowerCase();\n    return transitions.find(transition => transition.to?.name.toLowerCase() === wanted) ?? null;\n  }\n  if (target.stateType === 'canceled') {\n    return (\n      transitions.find(\n        transition => transition.to?.statusCategory?.key === 'done' && /cancel/i.test(transition.to.name),\n      ) ?? null\n    );\n  }\n  const category = STATE_TYPE_TO_CATEGORY[target.stateType];\n  return transitions.find(transition => transition.to?.statusCategory?.key === category) ?? null;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,10 @@
+import type { Intake } from '../../capabilities/intake.js';
+import type { IntegrationContext } from '../base.js';
+import type { IssueReconciler } from '../issue-reconciler.js';
+import type { JiraEventRules } from './default-rules.js';
+export type JiraIssueReconciler = IssueReconciler;
+export declare function attachJiraIssueReconciler(jira: {
+    intake: Intake;
+    rules: JiraEventRules;
+}, context: IntegrationContext): JiraIssueReconciler | undefined;
+//# sourceMappingURL=issue-reconciler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issue-reconciler.d.ts","sourceRoot":"","sources":["../../../src/integrations/jira/issue-reconciler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAqBlD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,EAC/C,OAAO,EAAE,kBAAkB,GAC1B,mBAAmB,GAAG,SAAS,CA4CjC"}

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

@@ -0,0 +1,70 @@
+import { workItemPhaseSemantics } from "../../boards/semantics.js";
+import "../../boards/index.js";
+import { createIssueReconciler } from "../issue-reconciler.js";
+import { JiraRules } from "./rules.js";
+//#region src/integrations/jira/issue-reconciler.ts
+function issueToIngress(issueRef, issue) {
+	return {
+		id: issueRef,
+		identifier: issue.identifier,
+		title: issue.title,
+		url: issue.url,
+		state: issue.state ?? "",
+		stateType: issue.stateType ?? "",
+		priorityLabel: issue.priority ?? "",
+		assignee: issue.assignee ?? null,
+		author: issue.author ?? null,
+		project: issue.source ?? null,
+		site: null,
+		labels: [...issue.labels ?? []],
+		createdAt: issue.createdAt,
+		updatedAt: issue.updatedAt
+	};
+}
+function attachJiraIssueReconciler(jira, context) {
+	if (!context.runtime || !jira.intake.resolveIntakeDispatch) return void 0;
+	const boards = context.runtime.boards;
+	const rules = new JiraRules({
+		projects: context.storage.projects,
+		storage: context.runtime.workItems,
+		configVersion: context.runtime.configVersion,
+		boards,
+		jiraRules: jira.rules
+	});
+	return createIssueReconciler({
+		integrationId: "jira",
+		intake: jira.intake,
+		projects: context.storage.projects,
+		storage: context.runtime.workItems,
+		isTerminal: (item) => workItemPhaseSemantics(boards, item)?.kind === "terminal",
+		issueId: (item) => item.externalSource?.externalId,
+		metadata: (item, issue) => ({
+			identifier: issue.identifier,
+			issueRef: item.externalSource?.externalId ?? issue.id,
+			autoStartCandidate: issue.stateType === "unstarted" || issue.stateType === "started",
+			state: issue.state,
+			stateType: issue.stateType,
+			priority: issue.priority,
+			project: issue.source,
+			assignee: issue.assignee,
+			assignees: issue.assignees ?? [],
+			creator: issue.author,
+			author: issue.author,
+			labels: issue.labels ?? [],
+			createdAt: issue.createdAt,
+			updatedAt: issue.updatedAt
+		}),
+		onClosed: async (item, issue, project) => {
+			await rules.ingest({
+				orgId: project.orgId,
+				userId: "factory-rule-dispatcher",
+				factoryProjectId: project.id,
+				issues: [issueToIngress(item.externalSource?.externalId ?? issue.id, issue)]
+			});
+		}
+	});
+}
+//#endregion
+export { attachJiraIssueReconciler };
+
+//# sourceMappingURL=issue-reconciler.js.map