@mastra/factory 0.10.2-alpha.3 → 0.11.0

package/dist/storage/domains/comments/parse.js

@@ -0,0 +1,90 @@
+import { commentBodyError } from "./base.js";
+import { isMentionableActorId } from "./actor.js";
+//#region src/storage/domains/comments/parse.ts
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const CLIENT_TOKEN_RE = /^[A-Za-z0-9-]{8,64}$/;
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readJson(c) {
+	try {
+		return await c.req.json();
+	} catch {
+		return;
+	}
+}
+/** `undefined` when the field is absent, `null` when it is present but malformed. */
+function parseMentions(raw) {
+	if (raw === void 0) return void 0;
+	if (!Array.isArray(raw) || raw.length > 20) return null;
+	const mentions = [];
+	for (const entry of raw) {
+		if (!isRecord(entry)) return null;
+		if (entry.kind !== "user" || typeof entry.id !== "string" || !isMentionableActorId(entry.id)) return null;
+		mentions.push({
+			kind: "user",
+			id: entry.id
+		});
+	}
+	return mentions;
+}
+function parseBody(raw) {
+	if (typeof raw !== "string" || commentBodyError(raw)) return null;
+	return raw;
+}
+function parseClientToken(raw) {
+	if (raw === void 0) return void 0;
+	if (typeof raw !== "string" || !CLIENT_TOKEN_RE.test(raw)) return null;
+	return raw;
+}
+function parseExpectedRevision(raw) {
+	if (raw === void 0) return void 0;
+	if (typeof raw !== "number" || !Number.isInteger(raw)) return null;
+	return raw;
+}
+function parseReplyTo(raw) {
+	if (raw === void 0) return void 0;
+	if (!isRecord(raw)) return null;
+	if (typeof raw.commentId !== "string" || !UUID_RE.test(raw.commentId)) return null;
+	if (raw.quote !== void 0 && typeof raw.quote !== "string") return null;
+	const quote = typeof raw.quote === "string" ? raw.quote.slice(0, 500) : void 0;
+	return {
+		commentId: raw.commentId,
+		...quote ? { quote } : {}
+	};
+}
+function parseCreateCommentBody(raw) {
+	if (!isRecord(raw)) return null;
+	const body = parseBody(raw.body);
+	if (body === null) return null;
+	const mentions = parseMentions(raw.mentions);
+	if (mentions === null) return null;
+	const replyTo = parseReplyTo(raw.replyTo);
+	if (replyTo === null) return null;
+	const clientToken = parseClientToken(raw.clientToken);
+	if (clientToken === null) return null;
+	return {
+		body,
+		...clientToken ? { clientToken } : {},
+		...replyTo ? { replyTo } : {},
+		...mentions ? { mentions } : {}
+	};
+}
+function parseEditCommentBody(raw) {
+	if (!isRecord(raw)) return null;
+	const body = parseBody(raw.body);
+	if (body === null) return null;
+	const mentions = parseMentions(raw.mentions);
+	if (mentions === null) return null;
+	const expectedRevision = parseExpectedRevision(raw.expectedRevision);
+	if (expectedRevision === null) return null;
+	return {
+		body,
+		...mentions ? { mentions } : {},
+		...expectedRevision !== void 0 ? { expectedRevision } : {}
+	};
+}
+//#endregion
+export { UUID_RE, parseCreateCommentBody, parseEditCommentBody, readJson };
+
+//# sourceMappingURL=parse.js.map

package/dist/storage/domains/comments/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","names":[],"sources":["../../../../src/storage/domains/comments/parse.ts"],"sourcesContent":["/** Request-body parsing for the comment routes: unknown JSON in, a typed input or `null` out. */\n\nimport type { Context } from 'hono';\n\nimport { isMentionableActorId } from './actor.js';\nimport type { FactoryMentionRef } from './base.js';\nimport { commentBodyError, MAX_COMMENT_MENTIONS, MAX_COMMENT_QUOTE_LENGTH } from './base.js';\n\nexport const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\nconst CLIENT_TOKEN_RE = /^[A-Za-z0-9-]{8,64}$/;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nexport async function readJson(c: Context): Promise<unknown> {\n  try {\n    return await c.req.json();\n  } catch {\n    return undefined;\n  }\n}\n\n/** `undefined` when the field is absent, `null` when it is present but malformed. */\nfunction parseMentions(raw: unknown): FactoryMentionRef[] | null | undefined {\n  if (raw === undefined) return undefined;\n  if (!Array.isArray(raw) || raw.length > MAX_COMMENT_MENTIONS) return null;\n  const mentions: FactoryMentionRef[] = [];\n  for (const entry of raw) {\n    if (!isRecord(entry)) return null;\n    if (entry.kind !== 'user' || typeof entry.id !== 'string' || !isMentionableActorId(entry.id)) return null;\n    mentions.push({ kind: 'user', id: entry.id });\n  }\n  return mentions;\n}\n\nfunction parseBody(raw: unknown): string | null {\n  if (typeof raw !== 'string' || commentBodyError(raw)) return null;\n  return raw;\n}\n\nfunction parseClientToken(raw: unknown): string | null | undefined {\n  if (raw === undefined) return undefined;\n  if (typeof raw !== 'string' || !CLIENT_TOKEN_RE.test(raw)) return null;\n  return raw;\n}\n\nfunction parseExpectedRevision(raw: unknown): number | null | undefined {\n  if (raw === undefined) return undefined;\n  if (typeof raw !== 'number' || !Number.isInteger(raw)) return null;\n  return raw;\n}\n\nfunction parseReplyTo(raw: unknown): { commentId: string; quote?: string } | null | undefined {\n  if (raw === undefined) return undefined;\n  if (!isRecord(raw)) return null;\n  if (typeof raw.commentId !== 'string' || !UUID_RE.test(raw.commentId)) return null;\n  if (raw.quote !== undefined && typeof raw.quote !== 'string') return null;\n  const quote = typeof raw.quote === 'string' ? raw.quote.slice(0, MAX_COMMENT_QUOTE_LENGTH) : undefined;\n  return { commentId: raw.commentId, ...(quote ? { quote } : {}) };\n}\n\nexport interface ParsedCreateComment {\n  body: string;\n  clientToken?: string;\n  replyTo?: { commentId: string; quote?: string };\n  mentions?: FactoryMentionRef[];\n}\n\nexport function parseCreateCommentBody(raw: unknown): ParsedCreateComment | null {\n  if (!isRecord(raw)) return null;\n\n  const body = parseBody(raw.body);\n  if (body === null) return null;\n  const mentions = parseMentions(raw.mentions);\n  if (mentions === null) return null;\n  const replyTo = parseReplyTo(raw.replyTo);\n  if (replyTo === null) return null;\n  const clientToken = parseClientToken(raw.clientToken);\n  if (clientToken === null) return null;\n\n  return {\n    body,\n    ...(clientToken ? { clientToken } : {}),\n    ...(replyTo ? { replyTo } : {}),\n    ...(mentions ? { mentions } : {}),\n  };\n}\n\nexport interface ParsedEditComment {\n  body: string;\n  mentions?: FactoryMentionRef[];\n  expectedRevision?: number;\n}\n\nexport function parseEditCommentBody(raw: unknown): ParsedEditComment | null {\n  if (!isRecord(raw)) return null;\n\n  const body = parseBody(raw.body);\n  if (body === null) return null;\n  const mentions = parseMentions(raw.mentions);\n  if (mentions === null) return null;\n  const expectedRevision = parseExpectedRevision(raw.expectedRevision);\n  if (expectedRevision === null) return null;\n\n  return {\n    body,\n    ...(mentions ? { mentions } : {}),\n    ...(expectedRevision !== undefined ? { expectedRevision } : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/storage/domains/comments/routes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HTTP for the item feed. Every handler is the same shape: resolve the tenant,
+ * validate the path ids, delegate to a `CommentsDomain` service method, map its
+ * result status to a status code, then emit audit.
+ */
+import type { ApiRoute } from '@mastra/core/server';
+import type { RouteAuth } from '../../../routes/route.js';
+import type { AuditEmitter } from '../audit/domain.js';
+import type { FactoryProjectsStorage } from '../projects/base.js';
+import type { WorkItemsStorage } from '../work-items/base.js';
+import type { WorkItemCommentsStorage } from './base.js';
+import type { CommentsDomain } from './domain.js';
+export interface CommentRouteDependencies {
+    domain: CommentsDomain;
+    auth: RouteAuth;
+    comments: WorkItemCommentsStorage;
+    workItems: WorkItemsStorage;
+    projects: FactoryProjectsStorage;
+    audit?: AuditEmitter;
+}
+export declare function buildCommentRoutes(dependencies: CommentRouteDependencies): ApiRoute[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/storage/domains/comments/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/comments/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEzD,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,aAAa,CAAC;AAOjE,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAWD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,wBAAwB,GAAG,QAAQ,EAAE,CA4OrF"}

package/dist/storage/domains/comments/routes.js

@@ -0,0 +1,248 @@
+import { getFactoryAuthUser } from "../../../auth.js";
+import { decodeCommentCursor } from "./base.js";
+import { actorFromAuthUser } from "./actor.js";
+import { UUID_RE, parseCreateCommentBody, parseEditCommentBody, readJson } from "./parse.js";
+import { toWireComment } from "./wire.js";
+import { registerApiRoute } from "@mastra/core/server";
+//#region src/storage/domains/comments/routes.ts
+const MAX_AUDIT_BODY_SNAPSHOT = 1024;
+function loose(c) {
+	return c;
+}
+function buildCommentRoutes(dependencies) {
+	const { domain, auth, comments, workItems, projects, audit } = dependencies;
+	async function resolveTenant(c) {
+		await auth.ensureUser(c);
+		const tenant = auth.tenant(c);
+		if (!tenant) return { response: c.json({ error: "unauthorized" }, 401) };
+		if (!tenant.orgId) return { response: c.json({
+			error: "organization_required",
+			message: "The item feed requires an organization."
+		}, 403) };
+		return {
+			orgId: tenant.orgId,
+			userId: tenant.userId
+		};
+	}
+	function editorFor(c, tenant) {
+		return {
+			userId: tenant.userId,
+			canModerate: () => auth.isOrganizationAdmin(c, tenant.orgId)
+		};
+	}
+	async function emitMentionAudit(c, target, commentId, mentionedIds) {
+		if (mentionedIds.length === 0) return;
+		await audit?.emit({
+			context: c,
+			input: {
+				action: "factory.work_item.comment_mentioned",
+				factoryProjectId: target.factoryProjectId,
+				targets: [{
+					type: "work_item",
+					id: target.workItemId,
+					...target.title ? { name: target.title } : {}
+				}],
+				metadata: {
+					commentId,
+					mentionedIds
+				}
+			}
+		});
+	}
+	return [
+		registerApiRoute("/web/factory/work-items/:workItemId/comments", {
+			method: "GET",
+			handler: async (cc) => {
+				const c = loose(cc);
+				const tenant = await resolveTenant(c);
+				if ("response" in tenant) return tenant.response;
+				const workItemId = c.req.param("workItemId");
+				if (!workItemId || !UUID_RE.test(workItemId)) return c.json({ error: "Work item not found" }, 404);
+				await workItems.ensureReady();
+				const workItem = await workItems.get({
+					orgId: tenant.orgId,
+					id: workItemId
+				});
+				if (!workItem) return c.json({ error: "Work item not found" }, 404);
+				await comments.ensureReady();
+				const limitRaw = c.req.query("limit");
+				const limit = limitRaw ? Number.parseInt(limitRaw, 10) : void 0;
+				const before = c.req.query("before") || void 0;
+				if (before && !decodeCommentCursor(before)) return c.json({ error: "invalid_cursor" }, 422);
+				const around = c.req.query("around") || void 0;
+				if (around && !UUID_RE.test(around)) return c.json({ error: "invalid_comment_id" }, 422);
+				const page = await comments.list({
+					orgId: tenant.orgId,
+					factoryProjectId: workItem.factoryProjectId,
+					workItemId,
+					before,
+					...around ? { around } : {},
+					...limit !== void 0 && Number.isFinite(limit) ? { limit } : {}
+				});
+				const wirePage = {
+					comments: page.comments.map((comment) => toWireComment(comment, tenant.userId)),
+					...page.nextCursor ? { nextCursor: page.nextCursor } : {}
+				};
+				return c.json(wirePage);
+			}
+		}),
+		registerApiRoute("/web/factory/work-items/:workItemId/comments", {
+			method: "POST",
+			handler: async (cc) => {
+				const c = loose(cc);
+				const tenant = await resolveTenant(c);
+				if ("response" in tenant) return tenant.response;
+				const workItemId = c.req.param("workItemId");
+				if (!workItemId || !UUID_RE.test(workItemId)) return c.json({ error: "Work item not found" }, 404);
+				const parsed = parseCreateCommentBody(await readJson(c));
+				if (!parsed) return c.json({ error: "invalid_comment" }, 422);
+				const result = await domain.createComment({
+					orgId: tenant.orgId,
+					workItemId,
+					author: actorFromAuthUser(tenant.userId, getFactoryAuthUser(c)),
+					body: parsed.body,
+					...parsed.replyTo ? { replyTo: parsed.replyTo } : {},
+					...parsed.mentions ? { mentions: parsed.mentions } : {},
+					...parsed.clientToken ? { clientToken: parsed.clientToken } : {}
+				});
+				if (result.status === "work_item_not_found") return c.json({ error: "Work item not found" }, 404);
+				if (result.status === "token_conflict") return c.json({ error: "comment_token_conflict" }, 409);
+				if (result.status === "invalid") return c.json({
+					error: "invalid_comment",
+					message: result.message
+				}, 422);
+				const { comment, workItem } = result;
+				await audit?.emit({
+					context: c,
+					input: {
+						action: "factory.work_item.comment_created",
+						factoryProjectId: workItem.factoryProjectId,
+						targets: [{
+							type: "work_item",
+							id: workItem.id,
+							name: workItem.title
+						}],
+						metadata: { commentId: comment.id }
+					}
+				});
+				await emitMentionAudit(c, {
+					factoryProjectId: workItem.factoryProjectId,
+					workItemId: workItem.id,
+					title: workItem.title
+				}, comment.id, comment.mentions.map((mention) => mention.id).filter((id) => id !== comment.author.id));
+				return c.json({ comment: toWireComment(comment, tenant.userId) }, 201);
+			}
+		}),
+		registerApiRoute("/web/factory/work-items/:workItemId/comments/:commentId", {
+			method: "PATCH",
+			handler: async (cc) => {
+				const c = loose(cc);
+				const tenant = await resolveTenant(c);
+				if ("response" in tenant) return tenant.response;
+				const workItemId = c.req.param("workItemId");
+				const commentId = c.req.param("commentId");
+				if (!workItemId || !UUID_RE.test(workItemId) || !commentId || !UUID_RE.test(commentId)) return c.json({ error: "Comment not found" }, 404);
+				const parsed = parseEditCommentBody(await readJson(c));
+				if (!parsed) return c.json({ error: "invalid_comment" }, 422);
+				const result = await domain.editComment({
+					orgId: tenant.orgId,
+					workItemId,
+					commentId,
+					editor: editorFor(c, tenant),
+					body: parsed.body,
+					...parsed.mentions ? { mentions: parsed.mentions } : {},
+					...parsed.expectedRevision !== void 0 ? { expectedRevision: parsed.expectedRevision } : {}
+				});
+				if (result.status === "not_found") return c.json({ error: "Comment not found" }, 404);
+				if (result.status === "forbidden") return c.json({ error: "not_comment_author" }, 403);
+				if (result.status === "not_editable") return c.json({ error: "comment_not_editable" }, 409);
+				if (result.status === "conflict") return c.json({ error: "comment_conflict" }, 409);
+				if (result.status === "invalid") return c.json({
+					error: "invalid_comment",
+					message: result.message
+				}, 422);
+				const { comment } = result;
+				await audit?.emit({
+					context: c,
+					input: {
+						action: "factory.work_item.comment_edited",
+						factoryProjectId: comment.factoryProjectId,
+						targets: [{
+							type: "work_item",
+							id: comment.workItemId
+						}],
+						metadata: {
+							commentId: comment.id,
+							previousBody: result.previousBody.slice(0, MAX_AUDIT_BODY_SNAPSHOT)
+						}
+					}
+				});
+				await emitMentionAudit(c, {
+					factoryProjectId: comment.factoryProjectId,
+					workItemId: comment.workItemId
+				}, comment.id, result.addedMentions.map((mention) => mention.id));
+				return c.json({ comment: toWireComment(comment, tenant.userId) });
+			}
+		}),
+		registerApiRoute("/web/factory/work-items/:workItemId/comments/:commentId", {
+			method: "DELETE",
+			handler: async (cc) => {
+				const c = loose(cc);
+				const tenant = await resolveTenant(c);
+				if ("response" in tenant) return tenant.response;
+				const workItemId = c.req.param("workItemId");
+				const commentId = c.req.param("commentId");
+				if (!workItemId || !UUID_RE.test(workItemId) || !commentId || !UUID_RE.test(commentId)) return c.json({ error: "Comment not found" }, 404);
+				const result = await domain.deleteComment({
+					orgId: tenant.orgId,
+					workItemId,
+					commentId,
+					editor: editorFor(c, tenant)
+				});
+				if (result.status === "not_found") return c.json({ error: "Comment not found" }, 404);
+				if (result.status === "forbidden") return c.json({ error: "not_comment_author" }, 403);
+				if (result.status === "not_editable") return c.json({ error: "comment_not_editable" }, 409);
+				await audit?.emit({
+					context: c,
+					input: {
+						action: "factory.work_item.comment_deleted",
+						factoryProjectId: result.comment.factoryProjectId,
+						targets: [{
+							type: "work_item",
+							id: result.comment.workItemId
+						}],
+						metadata: { commentId: result.comment.id }
+					}
+				});
+				return c.json({ comment: toWireComment(result.comment, tenant.userId) });
+			}
+		}),
+		registerApiRoute("/web/factory/projects/:id/mention-roster", {
+			method: "GET",
+			handler: async (cc) => {
+				const c = loose(cc);
+				const tenant = await resolveTenant(c);
+				if ("response" in tenant) return tenant.response;
+				const projectId = c.req.param("id");
+				if (!projectId || !UUID_RE.test(projectId)) return c.json({ error: "Project not found" }, 404);
+				await projects.ensureReady();
+				if (!await projects.get({
+					orgId: tenant.orgId,
+					id: projectId
+				})) return c.json({ error: "Project not found" }, 404);
+				await comments.ensureReady();
+				const roster = await domain.mentionRoster({
+					orgId: tenant.orgId,
+					factoryProjectId: projectId
+				});
+				const query = c.req.query("q")?.trim().toLowerCase();
+				const members = query ? roster.filter((member) => (member.name ?? member.id).toLowerCase().startsWith(query)) : roster;
+				return c.json({ members });
+			}
+		})
+	];
+}
+//#endregion
+export { buildCommentRoutes };
+
+//# sourceMappingURL=routes.js.map

package/dist/storage/domains/comments/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","names":[],"sources":["../../../../src/storage/domains/comments/routes.ts"],"sourcesContent":["/**\n * HTTP for the item feed. Every handler is the same shape: resolve the tenant,\n * validate the path ids, delegate to a `CommentsDomain` service method, map its\n * result status to a status code, then emit audit.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\n\nimport { getFactoryAuthUser } from '../../../auth.js';\nimport type { RouteAuth } from '../../../routes/route.js';\nimport type { AuditEmitter } from '../audit/domain.js';\nimport type { FactoryProjectsStorage } from '../projects/base.js';\nimport type { WorkItemsStorage } from '../work-items/base.js';\nimport { actorFromAuthUser } from './actor.js';\nimport type { WorkItemCommentsStorage } from './base.js';\nimport { decodeCommentCursor } from './base.js';\nimport type { CommentEditor, CommentsDomain } from './domain.js';\nimport { parseCreateCommentBody, parseEditCommentBody, readJson, UUID_RE } from './parse.js';\nimport { toWireComment } from './wire.js';\nimport type { WireCommentPage } from './wire.js';\n\nconst MAX_AUDIT_BODY_SNAPSHOT = 1024;\n\nexport interface CommentRouteDependencies {\n  domain: CommentsDomain;\n  auth: RouteAuth;\n  comments: WorkItemCommentsStorage;\n  workItems: WorkItemsStorage;\n  projects: FactoryProjectsStorage;\n  audit?: AuditEmitter;\n}\n\ninterface Tenant {\n  orgId: string;\n  userId: string;\n}\n\nfunction loose(c: unknown): Context {\n  return c as Context;\n}\n\nexport function buildCommentRoutes(dependencies: CommentRouteDependencies): ApiRoute[] {\n  const { domain, auth, comments, workItems, projects, audit } = dependencies;\n\n  async function resolveTenant(c: Context): Promise<Tenant | { response: Response }> {\n    await auth.ensureUser(c);\n    const tenant = auth.tenant(c);\n    if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n    if (!tenant.orgId) {\n      return {\n        response: c.json({ error: 'organization_required', message: 'The item feed requires an organization.' }, 403),\n      };\n    }\n    return { orgId: tenant.orgId, userId: tenant.userId };\n  }\n\n  function editorFor(c: Context, tenant: Tenant): CommentEditor {\n    return {\n      userId: tenant.userId,\n      canModerate: () => auth.isOrganizationAdmin(c, tenant.orgId),\n    };\n  }\n\n  async function emitMentionAudit(\n    c: Context,\n    target: { factoryProjectId: string; workItemId: string; title?: string },\n    commentId: string,\n    mentionedIds: string[],\n  ): Promise<void> {\n    if (mentionedIds.length === 0) return;\n    await audit?.emit({\n      context: c,\n      input: {\n        action: 'factory.work_item.comment_mentioned',\n        factoryProjectId: target.factoryProjectId,\n        targets: [{ type: 'work_item', id: target.workItemId, ...(target.title ? { name: target.title } : {}) }],\n        metadata: { commentId, mentionedIds },\n      },\n    });\n  }\n\n  return [\n    registerApiRoute('/web/factory/work-items/:workItemId/comments', {\n      method: 'GET',\n      handler: async cc => {\n        const c = loose(cc);\n        const tenant = await resolveTenant(c);\n        if ('response' in tenant) return tenant.response;\n\n        const workItemId = c.req.param('workItemId');\n        if (!workItemId || !UUID_RE.test(workItemId)) return c.json({ error: 'Work item not found' }, 404);\n        await workItems.ensureReady();\n        const workItem = await workItems.get({ orgId: tenant.orgId, id: workItemId });\n        if (!workItem) return c.json({ error: 'Work item not found' }, 404);\n\n        await comments.ensureReady();\n        const limitRaw = c.req.query('limit');\n        const limit = limitRaw ? Number.parseInt(limitRaw, 10) : undefined;\n        const before = c.req.query('before') || undefined;\n        if (before && !decodeCommentCursor(before)) return c.json({ error: 'invalid_cursor' }, 422);\n        const around = c.req.query('around') || undefined;\n        if (around && !UUID_RE.test(around)) return c.json({ error: 'invalid_comment_id' }, 422);\n        const page = await comments.list({\n          orgId: tenant.orgId,\n          factoryProjectId: workItem.factoryProjectId,\n          workItemId,\n          before,\n          ...(around ? { around } : {}),\n          ...(limit !== undefined && Number.isFinite(limit) ? { limit } : {}),\n        });\n        const wirePage: WireCommentPage = {\n          comments: page.comments.map(comment => toWireComment(comment, tenant.userId)),\n          ...(page.nextCursor ? { nextCursor: page.nextCursor } : {}),\n        };\n        return c.json(wirePage);\n      },\n    }),\n\n    registerApiRoute('/web/factory/work-items/:workItemId/comments', {\n      method: 'POST',\n      handler: async cc => {\n        const c = loose(cc);\n        const tenant = await resolveTenant(c);\n        if ('response' in tenant) return tenant.response;\n\n        const workItemId = c.req.param('workItemId');\n        if (!workItemId || !UUID_RE.test(workItemId)) return c.json({ error: 'Work item not found' }, 404);\n\n        const parsed = parseCreateCommentBody(await readJson(c));\n        if (!parsed) return c.json({ error: 'invalid_comment' }, 422);\n\n        const result = await domain.createComment({\n          orgId: tenant.orgId,\n          workItemId,\n          author: actorFromAuthUser(tenant.userId, getFactoryAuthUser(c)),\n          body: parsed.body,\n          ...(parsed.replyTo ? { replyTo: parsed.replyTo } : {}),\n          ...(parsed.mentions ? { mentions: parsed.mentions } : {}),\n          ...(parsed.clientToken ? { clientToken: parsed.clientToken } : {}),\n        });\n        if (result.status === 'work_item_not_found') return c.json({ error: 'Work item not found' }, 404);\n        if (result.status === 'token_conflict') return c.json({ error: 'comment_token_conflict' }, 409);\n        if (result.status === 'invalid') return c.json({ error: 'invalid_comment', message: result.message }, 422);\n\n        const { comment, workItem } = result;\n        await audit?.emit({\n          context: c,\n          input: {\n            action: 'factory.work_item.comment_created',\n            factoryProjectId: workItem.factoryProjectId,\n            targets: [{ type: 'work_item', id: workItem.id, name: workItem.title }],\n            metadata: { commentId: comment.id },\n          },\n        });\n        await emitMentionAudit(\n          c,\n          { factoryProjectId: workItem.factoryProjectId, workItemId: workItem.id, title: workItem.title },\n          comment.id,\n          comment.mentions.map(mention => mention.id).filter(id => id !== comment.author.id),\n        );\n        return c.json({ comment: toWireComment(comment, tenant.userId) }, 201);\n      },\n    }),\n\n    registerApiRoute('/web/factory/work-items/:workItemId/comments/:commentId', {\n      method: 'PATCH',\n      handler: async cc => {\n        const c = loose(cc);\n        const tenant = await resolveTenant(c);\n        if ('response' in tenant) return tenant.response;\n\n        const workItemId = c.req.param('workItemId');\n        const commentId = c.req.param('commentId');\n        if (!workItemId || !UUID_RE.test(workItemId) || !commentId || !UUID_RE.test(commentId)) {\n          return c.json({ error: 'Comment not found' }, 404);\n        }\n\n        const parsed = parseEditCommentBody(await readJson(c));\n        if (!parsed) return c.json({ error: 'invalid_comment' }, 422);\n\n        const result = await domain.editComment({\n          orgId: tenant.orgId,\n          workItemId,\n          commentId,\n          editor: editorFor(c, tenant),\n          body: parsed.body,\n          ...(parsed.mentions ? { mentions: parsed.mentions } : {}),\n          ...(parsed.expectedRevision !== undefined ? { expectedRevision: parsed.expectedRevision } : {}),\n        });\n        if (result.status === 'not_found') return c.json({ error: 'Comment not found' }, 404);\n        if (result.status === 'forbidden') return c.json({ error: 'not_comment_author' }, 403);\n        if (result.status === 'not_editable') return c.json({ error: 'comment_not_editable' }, 409);\n        if (result.status === 'conflict') return c.json({ error: 'comment_conflict' }, 409);\n        if (result.status === 'invalid') return c.json({ error: 'invalid_comment', message: result.message }, 422);\n\n        const { comment } = result;\n        await audit?.emit({\n          context: c,\n          input: {\n            action: 'factory.work_item.comment_edited',\n            factoryProjectId: comment.factoryProjectId,\n            targets: [{ type: 'work_item', id: comment.workItemId }],\n            metadata: {\n              commentId: comment.id,\n              previousBody: result.previousBody.slice(0, MAX_AUDIT_BODY_SNAPSHOT),\n            },\n          },\n        });\n        await emitMentionAudit(\n          c,\n          { factoryProjectId: comment.factoryProjectId, workItemId: comment.workItemId },\n          comment.id,\n          result.addedMentions.map(mention => mention.id),\n        );\n        return c.json({ comment: toWireComment(comment, tenant.userId) });\n      },\n    }),\n\n    registerApiRoute('/web/factory/work-items/:workItemId/comments/:commentId', {\n      method: 'DELETE',\n      handler: async cc => {\n        const c = loose(cc);\n        const tenant = await resolveTenant(c);\n        if ('response' in tenant) return tenant.response;\n\n        const workItemId = c.req.param('workItemId');\n        const commentId = c.req.param('commentId');\n        if (!workItemId || !UUID_RE.test(workItemId) || !commentId || !UUID_RE.test(commentId)) {\n          return c.json({ error: 'Comment not found' }, 404);\n        }\n\n        const result = await domain.deleteComment({\n          orgId: tenant.orgId,\n          workItemId,\n          commentId,\n          editor: editorFor(c, tenant),\n        });\n        if (result.status === 'not_found') return c.json({ error: 'Comment not found' }, 404);\n        if (result.status === 'forbidden') return c.json({ error: 'not_comment_author' }, 403);\n        if (result.status === 'not_editable') return c.json({ error: 'comment_not_editable' }, 409);\n\n        await audit?.emit({\n          context: c,\n          input: {\n            action: 'factory.work_item.comment_deleted',\n            factoryProjectId: result.comment.factoryProjectId,\n            targets: [{ type: 'work_item', id: result.comment.workItemId }],\n            metadata: { commentId: result.comment.id },\n          },\n        });\n        return c.json({ comment: toWireComment(result.comment, tenant.userId) });\n      },\n    }),\n\n    registerApiRoute('/web/factory/projects/:id/mention-roster', {\n      method: 'GET',\n      handler: async cc => {\n        const c = loose(cc);\n        const tenant = await resolveTenant(c);\n        if ('response' in tenant) return tenant.response;\n\n        const projectId = c.req.param('id');\n        if (!projectId || !UUID_RE.test(projectId)) return c.json({ error: 'Project not found' }, 404);\n        await projects.ensureReady();\n        const project = await projects.get({ orgId: tenant.orgId, id: projectId });\n        if (!project) return c.json({ error: 'Project not found' }, 404);\n\n        await comments.ensureReady();\n        const roster = await domain.mentionRoster({ orgId: tenant.orgId, factoryProjectId: projectId });\n        const query = c.req.query('q')?.trim().toLowerCase();\n        const members = query\n          ? roster.filter(member => (member.name ?? member.id).toLowerCase().startsWith(query))\n          : roster;\n        return c.json({ members });\n      },\n    }),\n  ];\n}\n"],"mappings":";;;;;;;AAuBA,MAAM,0BAA0B;AAgBhC,SAAS,MAAM,GAAqB;CAClC,OAAO;AACT;AAEA,SAAgB,mBAAmB,cAAoD;CACrF,MAAM,EAAE,QAAQ,MAAM,UAAU,WAAW,UAAU,UAAU;CAE/D,eAAe,cAAc,GAAsD;EACjF,MAAM,KAAK,WAAW,CAAC;EACvB,MAAM,SAAS,KAAK,OAAO,CAAC;EAC5B,IAAI,CAAC,QAAQ,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,eAAe,GAAG,GAAG,EAAE;EACvE,IAAI,CAAC,OAAO,OACV,OAAO,EACL,UAAU,EAAE,KAAK;GAAE,OAAO;GAAyB,SAAS;EAA0C,GAAG,GAAG,EAC9G;EAEF,OAAO;GAAE,OAAO,OAAO;GAAO,QAAQ,OAAO;EAAO;CACtD;CAEA,SAAS,UAAU,GAAY,QAA+B;EAC5D,OAAO;GACL,QAAQ,OAAO;GACf,mBAAmB,KAAK,oBAAoB,GAAG,OAAO,KAAK;EAC7D;CACF;CAEA,eAAe,iBACb,GACA,QACA,WACA,cACe;EACf,IAAI,aAAa,WAAW,GAAG;EAC/B,MAAM,OAAO,KAAK;GAChB,SAAS;GACT,OAAO;IACL,QAAQ;IACR,kBAAkB,OAAO;IACzB,SAAS,CAAC;KAAE,MAAM;KAAa,IAAI,OAAO;KAAY,GAAI,OAAO,QAAQ,EAAE,MAAM,OAAO,MAAM,IAAI,CAAC;IAAG,CAAC;IACvG,UAAU;KAAE;KAAW;IAAa;GACtC;EACF,CAAC;CACH;CAEA,OAAO;EACL,iBAAiB,gDAAgD;GAC/D,QAAQ;GACR,SAAS,OAAM,OAAM;IACnB,MAAM,IAAI,MAAM,EAAE;IAClB,MAAM,SAAS,MAAM,cAAc,CAAC;IACpC,IAAI,cAAc,QAAQ,OAAO,OAAO;IAExC,MAAM,aAAa,EAAE,IAAI,MAAM,YAAY;IAC3C,IAAI,CAAC,cAAc,CAAC,QAAQ,KAAK,UAAU,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,sBAAsB,GAAG,GAAG;IACjG,MAAM,UAAU,YAAY;IAC5B,MAAM,WAAW,MAAM,UAAU,IAAI;KAAE,OAAO,OAAO;KAAO,IAAI;IAAW,CAAC;IAC5E,IAAI,CAAC,UAAU,OAAO,EAAE,KAAK,EAAE,OAAO,sBAAsB,GAAG,GAAG;IAElE,MAAM,SAAS,YAAY;IAC3B,MAAM,WAAW,EAAE,IAAI,MAAM,OAAO;IACpC,MAAM,QAAQ,WAAW,OAAO,SAAS,UAAU,EAAE,IAAI,KAAA;IACzD,MAAM,SAAS,EAAE,IAAI,MAAM,QAAQ,KAAK,KAAA;IACxC,IAAI,UAAU,CAAC,oBAAoB,MAAM,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,iBAAiB,GAAG,GAAG;IAC1F,MAAM,SAAS,EAAE,IAAI,MAAM,QAAQ,KAAK,KAAA;IACxC,IAAI,UAAU,CAAC,QAAQ,KAAK,MAAM,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,qBAAqB,GAAG,GAAG;IACvF,MAAM,OAAO,MAAM,SAAS,KAAK;KAC/B,OAAO,OAAO;KACd,kBAAkB,SAAS;KAC3B;KACA;KACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;KAC3B,GAAI,UAAU,KAAA,KAAa,OAAO,SAAS,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC;IACnE,CAAC;IACD,MAAM,WAA4B;KAChC,UAAU,KAAK,SAAS,KAAI,YAAW,cAAc,SAAS,OAAO,MAAM,CAAC;KAC5E,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;IAC3D;IACA,OAAO,EAAE,KAAK,QAAQ;GACxB;EACF,CAAC;EAED,iBAAiB,gDAAgD;GAC/D,QAAQ;GACR,SAAS,OAAM,OAAM;IACnB,MAAM,IAAI,MAAM,EAAE;IAClB,MAAM,SAAS,MAAM,cAAc,CAAC;IACpC,IAAI,cAAc,QAAQ,OAAO,OAAO;IAExC,MAAM,aAAa,EAAE,IAAI,MAAM,YAAY;IAC3C,IAAI,CAAC,cAAc,CAAC,QAAQ,KAAK,UAAU,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,sBAAsB,GAAG,GAAG;IAEjG,MAAM,SAAS,uBAAuB,MAAM,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ,OAAO,EAAE,KAAK,EAAE,OAAO,kBAAkB,GAAG,GAAG;IAE5D,MAAM,SAAS,MAAM,OAAO,cAAc;KACxC,OAAO,OAAO;KACd;KACA,QAAQ,kBAAkB,OAAO,QAAQ,mBAAmB,CAAC,CAAC;KAC9D,MAAM,OAAO;KACb,GAAI,OAAO,UAAU,EAAE,SAAS,OAAO,QAAQ,IAAI,CAAC;KACpD,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;KACvD,GAAI,OAAO,cAAc,EAAE,aAAa,OAAO,YAAY,IAAI,CAAC;IAClE,CAAC;IACD,IAAI,OAAO,WAAW,uBAAuB,OAAO,EAAE,KAAK,EAAE,OAAO,sBAAsB,GAAG,GAAG;IAChG,IAAI,OAAO,WAAW,kBAAkB,OAAO,EAAE,KAAK,EAAE,OAAO,yBAAyB,GAAG,GAAG;IAC9F,IAAI,OAAO,WAAW,WAAW,OAAO,EAAE,KAAK;KAAE,OAAO;KAAmB,SAAS,OAAO;IAAQ,GAAG,GAAG;IAEzG,MAAM,EAAE,SAAS,aAAa;IAC9B,MAAM,OAAO,KAAK;KAChB,SAAS;KACT,OAAO;MACL,QAAQ;MACR,kBAAkB,SAAS;MAC3B,SAAS,CAAC;OAAE,MAAM;OAAa,IAAI,SAAS;OAAI,MAAM,SAAS;MAAM,CAAC;MACtE,UAAU,EAAE,WAAW,QAAQ,GAAG;KACpC;IACF,CAAC;IACD,MAAM,iBACJ,GACA;KAAE,kBAAkB,SAAS;KAAkB,YAAY,SAAS;KAAI,OAAO,SAAS;IAAM,GAC9F,QAAQ,IACR,QAAQ,SAAS,KAAI,YAAW,QAAQ,EAAE,CAAC,CAAC,QAAO,OAAM,OAAO,QAAQ,OAAO,EAAE,CACnF;IACA,OAAO,EAAE,KAAK,EAAE,SAAS,cAAc,SAAS,OAAO,MAAM,EAAE,GAAG,GAAG;GACvE;EACF,CAAC;EAED,iBAAiB,2DAA2D;GAC1E,QAAQ;GACR,SAAS,OAAM,OAAM;IACnB,MAAM,IAAI,MAAM,EAAE;IAClB,MAAM,SAAS,MAAM,cAAc,CAAC;IACpC,IAAI,cAAc,QAAQ,OAAO,OAAO;IAExC,MAAM,aAAa,EAAE,IAAI,MAAM,YAAY;IAC3C,MAAM,YAAY,EAAE,IAAI,MAAM,WAAW;IACzC,IAAI,CAAC,cAAc,CAAC,QAAQ,KAAK,UAAU,KAAK,CAAC,aAAa,CAAC,QAAQ,KAAK,SAAS,GACnF,OAAO,EAAE,KAAK,EAAE,OAAO,oBAAoB,GAAG,GAAG;IAGnD,MAAM,SAAS,qBAAqB,MAAM,SAAS,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,OAAO,EAAE,KAAK,EAAE,OAAO,kBAAkB,GAAG,GAAG;IAE5D,MAAM,SAAS,MAAM,OAAO,YAAY;KACtC,OAAO,OAAO;KACd;KACA;KACA,QAAQ,UAAU,GAAG,MAAM;KAC3B,MAAM,OAAO;KACb,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;KACvD,GAAI,OAAO,qBAAqB,KAAA,IAAY,EAAE,kBAAkB,OAAO,iBAAiB,IAAI,CAAC;IAC/F,CAAC;IACD,IAAI,OAAO,WAAW,aAAa,OAAO,EAAE,KAAK,EAAE,OAAO,oBAAoB,GAAG,GAAG;IACpF,IAAI,OAAO,WAAW,aAAa,OAAO,EAAE,KAAK,EAAE,OAAO,qBAAqB,GAAG,GAAG;IACrF,IAAI,OAAO,WAAW,gBAAgB,OAAO,EAAE,KAAK,EAAE,OAAO,uBAAuB,GAAG,GAAG;IAC1F,IAAI,OAAO,WAAW,YAAY,OAAO,EAAE,KAAK,EAAE,OAAO,mBAAmB,GAAG,GAAG;IAClF,IAAI,OAAO,WAAW,WAAW,OAAO,EAAE,KAAK;KAAE,OAAO;KAAmB,SAAS,OAAO;IAAQ,GAAG,GAAG;IAEzG,MAAM,EAAE,YAAY;IACpB,MAAM,OAAO,KAAK;KAChB,SAAS;KACT,OAAO;MACL,QAAQ;MACR,kBAAkB,QAAQ;MAC1B,SAAS,CAAC;OAAE,MAAM;OAAa,IAAI,QAAQ;MAAW,CAAC;MACvD,UAAU;OACR,WAAW,QAAQ;OACnB,cAAc,OAAO,aAAa,MAAM,GAAG,uBAAuB;MACpE;KACF;IACF,CAAC;IACD,MAAM,iBACJ,GACA;KAAE,kBAAkB,QAAQ;KAAkB,YAAY,QAAQ;IAAW,GAC7E,QAAQ,IACR,OAAO,cAAc,KAAI,YAAW,QAAQ,EAAE,CAChD;IACA,OAAO,EAAE,KAAK,EAAE,SAAS,cAAc,SAAS,OAAO,MAAM,EAAE,CAAC;GAClE;EACF,CAAC;EAED,iBAAiB,2DAA2D;GAC1E,QAAQ;GACR,SAAS,OAAM,OAAM;IACnB,MAAM,IAAI,MAAM,EAAE;IAClB,MAAM,SAAS,MAAM,cAAc,CAAC;IACpC,IAAI,cAAc,QAAQ,OAAO,OAAO;IAExC,MAAM,aAAa,EAAE,IAAI,MAAM,YAAY;IAC3C,MAAM,YAAY,EAAE,IAAI,MAAM,WAAW;IACzC,IAAI,CAAC,cAAc,CAAC,QAAQ,KAAK,UAAU,KAAK,CAAC,aAAa,CAAC,QAAQ,KAAK,SAAS,GACnF,OAAO,EAAE,KAAK,EAAE,OAAO,oBAAoB,GAAG,GAAG;IAGnD,MAAM,SAAS,MAAM,OAAO,cAAc;KACxC,OAAO,OAAO;KACd;KACA;KACA,QAAQ,UAAU,GAAG,MAAM;IAC7B,CAAC;IACD,IAAI,OAAO,WAAW,aAAa,OAAO,EAAE,KAAK,EAAE,OAAO,oBAAoB,GAAG,GAAG;IACpF,IAAI,OAAO,WAAW,aAAa,OAAO,EAAE,KAAK,EAAE,OAAO,qBAAqB,GAAG,GAAG;IACrF,IAAI,OAAO,WAAW,gBAAgB,OAAO,EAAE,KAAK,EAAE,OAAO,uBAAuB,GAAG,GAAG;IAE1F,MAAM,OAAO,KAAK;KAChB,SAAS;KACT,OAAO;MACL,QAAQ;MACR,kBAAkB,OAAO,QAAQ;MACjC,SAAS,CAAC;OAAE,MAAM;OAAa,IAAI,OAAO,QAAQ;MAAW,CAAC;MAC9D,UAAU,EAAE,WAAW,OAAO,QAAQ,GAAG;KAC3C;IACF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,cAAc,OAAO,SAAS,OAAO,MAAM,EAAE,CAAC;GACzE;EACF,CAAC;EAED,iBAAiB,4CAA4C;GAC3D,QAAQ;GACR,SAAS,OAAM,OAAM;IACnB,MAAM,IAAI,MAAM,EAAE;IAClB,MAAM,SAAS,MAAM,cAAc,CAAC;IACpC,IAAI,cAAc,QAAQ,OAAO,OAAO;IAExC,MAAM,YAAY,EAAE,IAAI,MAAM,IAAI;IAClC,IAAI,CAAC,aAAa,CAAC,QAAQ,KAAK,SAAS,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,oBAAoB,GAAG,GAAG;IAC7F,MAAM,SAAS,YAAY;IAE3B,IAAI,CAAC,MADiB,SAAS,IAAI;KAAE,OAAO,OAAO;KAAO,IAAI;IAAU,CAAC,GAC3D,OAAO,EAAE,KAAK,EAAE,OAAO,oBAAoB,GAAG,GAAG;IAE/D,MAAM,SAAS,YAAY;IAC3B,MAAM,SAAS,MAAM,OAAO,cAAc;KAAE,OAAO,OAAO;KAAO,kBAAkB;IAAU,CAAC;IAC9F,MAAM,QAAQ,EAAE,IAAI,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,YAAY;IACnD,MAAM,UAAU,QACZ,OAAO,QAAO,YAAW,OAAO,QAAQ,OAAO,GAAA,CAAI,YAAY,CAAC,CAAC,WAAW,KAAK,CAAC,IAClF;IACJ,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC;GAC3B;EACF,CAAC;CACH;AACF"}

package/dist/storage/domains/comments/schema.d.ts

@@ -0,0 +1,4 @@
+import type { CollectionSchema } from '@mastra/core/storage';
+export declare const WORK_ITEM_COMMENTS_SCHEMA: CollectionSchema;
+export declare const WORK_ITEM_COMMENT_MENTIONS_SCHEMA: CollectionSchema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/storage/domains/comments/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/comments/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,eAAO,MAAM,yBAAyB,EAAE,gBA2CvC,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,gBA6B/C,CAAC"}

package/dist/storage/domains/comments/schema.js

@@ -0,0 +1,135 @@
+//#region src/storage/domains/comments/schema.ts
+const WORK_ITEM_COMMENTS_SCHEMA = {
+	name: "work_item_comments",
+	columns: {
+		id: { type: "uuid-pk" },
+		org_id: { type: "text" },
+		factory_project_id: { type: "text" },
+		work_item_id: { type: "text" },
+		kind: {
+			type: "text",
+			default: "comment"
+		},
+		body: { type: "text" },
+		body_format: {
+			type: "text",
+			default: "markdown"
+		},
+		author_kind: { type: "text" },
+		author_id: { type: "text" },
+		author_display_name: {
+			type: "text",
+			nullable: true
+		},
+		author_avatar_url: {
+			type: "text",
+			nullable: true
+		},
+		author_external: {
+			type: "json",
+			nullable: true
+		},
+		reply_to_comment_id: {
+			type: "text",
+			nullable: true
+		},
+		reply_quote: {
+			type: "text",
+			nullable: true
+		},
+		reply_to_author_id: {
+			type: "text",
+			nullable: true
+		},
+		reply_to_author_name: {
+			type: "text",
+			nullable: true
+		},
+		mentions: { type: "json" },
+		external_source: {
+			type: "json",
+			nullable: true
+		},
+		source_key: {
+			type: "text",
+			nullable: true
+		},
+		occurred_at: { type: "timestamp" },
+		edited_at: {
+			type: "timestamp",
+			nullable: true
+		},
+		deleted_at: {
+			type: "timestamp",
+			nullable: true
+		},
+		deleted_by: {
+			type: "text",
+			nullable: true
+		},
+		revision: {
+			type: "integer",
+			default: 1
+		},
+		created_at: { type: "timestamp" },
+		updated_at: { type: "timestamp" }
+	},
+	uniqueIndexes: [{
+		name: "work_item_comments_project_source_key_unique",
+		columns: ["factory_project_id", "source_key"],
+		whereNotNull: "source_key"
+	}],
+	indexes: [{
+		name: "work_item_comments_feed_idx",
+		columns: [
+			"org_id",
+			"factory_project_id",
+			"work_item_id",
+			"occurred_at",
+			"id"
+		]
+	}]
+};
+const WORK_ITEM_COMMENT_MENTIONS_SCHEMA = {
+	name: "work_item_comment_mentions",
+	columns: {
+		id: { type: "uuid-pk" },
+		comment_id: { type: "text" },
+		mentioned_kind: { type: "text" },
+		mentioned_id: { type: "text" },
+		author_id: { type: "text" },
+		org_id: { type: "text" },
+		factory_project_id: { type: "text" },
+		work_item_id: { type: "text" },
+		occurred_at: { type: "timestamp" }
+	},
+	uniqueIndexes: [{
+		name: "work_item_comment_mentions_comment_target_unique",
+		columns: [
+			"comment_id",
+			"mentioned_kind",
+			"mentioned_id"
+		]
+	}],
+	indexes: [{
+		name: "work_item_comment_mentions_inbox_idx",
+		columns: [
+			"org_id",
+			"factory_project_id",
+			"mentioned_id",
+			"occurred_at",
+			"id"
+		]
+	}, {
+		name: "work_item_comment_mentions_item_idx",
+		columns: [
+			"org_id",
+			"factory_project_id",
+			"work_item_id"
+		]
+	}]
+};
+//#endregion
+export { WORK_ITEM_COMMENTS_SCHEMA, WORK_ITEM_COMMENT_MENTIONS_SCHEMA };
+
+//# sourceMappingURL=schema.js.map

package/dist/storage/domains/comments/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../../../src/storage/domains/comments/schema.ts"],"sourcesContent":["import type { CollectionSchema } from '@mastra/core/storage';\n\nexport const WORK_ITEM_COMMENTS_SCHEMA: CollectionSchema = {\n  name: 'work_item_comments',\n  columns: {\n    id: { type: 'uuid-pk' },\n    org_id: { type: 'text' },\n    factory_project_id: { type: 'text' },\n    work_item_id: { type: 'text' },\n    kind: { type: 'text', default: 'comment' },\n    body: { type: 'text' },\n    body_format: { type: 'text', default: 'markdown' },\n    author_kind: { type: 'text' },\n    author_id: { type: 'text' },\n    author_display_name: { type: 'text', nullable: true },\n    author_avatar_url: { type: 'text', nullable: true },\n    author_external: { type: 'json', nullable: true },\n    reply_to_comment_id: { type: 'text', nullable: true },\n    reply_quote: { type: 'text', nullable: true },\n    reply_to_author_id: { type: 'text', nullable: true },\n    reply_to_author_name: { type: 'text', nullable: true },\n    mentions: { type: 'json' },\n    external_source: { type: 'json', nullable: true },\n    source_key: { type: 'text', nullable: true },\n    occurred_at: { type: 'timestamp' },\n    edited_at: { type: 'timestamp', nullable: true },\n    deleted_at: { type: 'timestamp', nullable: true },\n    deleted_by: { type: 'text', nullable: true },\n    revision: { type: 'integer', default: 1 },\n    created_at: { type: 'timestamp' },\n    updated_at: { type: 'timestamp' },\n  },\n  uniqueIndexes: [\n    {\n      name: 'work_item_comments_project_source_key_unique',\n      columns: ['factory_project_id', 'source_key'],\n      whereNotNull: 'source_key',\n    },\n  ],\n  indexes: [\n    {\n      name: 'work_item_comments_feed_idx',\n      columns: ['org_id', 'factory_project_id', 'work_item_id', 'occurred_at', 'id'],\n    },\n  ],\n};\n\nexport const WORK_ITEM_COMMENT_MENTIONS_SCHEMA: CollectionSchema = {\n  name: 'work_item_comment_mentions',\n  columns: {\n    id: { type: 'uuid-pk' },\n    comment_id: { type: 'text' },\n    mentioned_kind: { type: 'text' },\n    mentioned_id: { type: 'text' },\n    author_id: { type: 'text' },\n    org_id: { type: 'text' },\n    factory_project_id: { type: 'text' },\n    work_item_id: { type: 'text' },\n    occurred_at: { type: 'timestamp' },\n  },\n  uniqueIndexes: [\n    {\n      name: 'work_item_comment_mentions_comment_target_unique',\n      columns: ['comment_id', 'mentioned_kind', 'mentioned_id'],\n    },\n  ],\n  indexes: [\n    {\n      name: 'work_item_comment_mentions_inbox_idx',\n      columns: ['org_id', 'factory_project_id', 'mentioned_id', 'occurred_at', 'id'],\n    },\n    {\n      name: 'work_item_comment_mentions_item_idx',\n      columns: ['org_id', 'factory_project_id', 'work_item_id'],\n    },\n  ],\n};\n"],"mappings":";AAEA,MAAa,4BAA8C;CACzD,MAAM;CACN,SAAS;EACP,IAAI,EAAE,MAAM,UAAU;EACtB,QAAQ,EAAE,MAAM,OAAO;EACvB,oBAAoB,EAAE,MAAM,OAAO;EACnC,cAAc,EAAE,MAAM,OAAO;EAC7B,MAAM;GAAE,MAAM;GAAQ,SAAS;EAAU;EACzC,MAAM,EAAE,MAAM,OAAO;EACrB,aAAa;GAAE,MAAM;GAAQ,SAAS;EAAW;EACjD,aAAa,EAAE,MAAM,OAAO;EAC5B,WAAW,EAAE,MAAM,OAAO;EAC1B,qBAAqB;GAAE,MAAM;GAAQ,UAAU;EAAK;EACpD,mBAAmB;GAAE,MAAM;GAAQ,UAAU;EAAK;EAClD,iBAAiB;GAAE,MAAM;GAAQ,UAAU;EAAK;EAChD,qBAAqB;GAAE,MAAM;GAAQ,UAAU;EAAK;EACpD,aAAa;GAAE,MAAM;GAAQ,UAAU;EAAK;EAC5C,oBAAoB;GAAE,MAAM;GAAQ,UAAU;EAAK;EACnD,sBAAsB;GAAE,MAAM;GAAQ,UAAU;EAAK;EACrD,UAAU,EAAE,MAAM,OAAO;EACzB,iBAAiB;GAAE,MAAM;GAAQ,UAAU;EAAK;EAChD,YAAY;GAAE,MAAM;GAAQ,UAAU;EAAK;EAC3C,aAAa,EAAE,MAAM,YAAY;EACjC,WAAW;GAAE,MAAM;GAAa,UAAU;EAAK;EAC/C,YAAY;GAAE,MAAM;GAAa,UAAU;EAAK;EAChD,YAAY;GAAE,MAAM;GAAQ,UAAU;EAAK;EAC3C,UAAU;GAAE,MAAM;GAAW,SAAS;EAAE;EACxC,YAAY,EAAE,MAAM,YAAY;EAChC,YAAY,EAAE,MAAM,YAAY;CAClC;CACA,eAAe,CACb;EACE,MAAM;EACN,SAAS,CAAC,sBAAsB,YAAY;EAC5C,cAAc;CAChB,CACF;CACA,SAAS,CACP;EACE,MAAM;EACN,SAAS;GAAC;GAAU;GAAsB;GAAgB;GAAe;EAAI;CAC/E,CACF;AACF;AAEA,MAAa,oCAAsD;CACjE,MAAM;CACN,SAAS;EACP,IAAI,EAAE,MAAM,UAAU;EACtB,YAAY,EAAE,MAAM,OAAO;EAC3B,gBAAgB,EAAE,MAAM,OAAO;EAC/B,cAAc,EAAE,MAAM,OAAO;EAC7B,WAAW,EAAE,MAAM,OAAO;EAC1B,QAAQ,EAAE,MAAM,OAAO;EACvB,oBAAoB,EAAE,MAAM,OAAO;EACnC,cAAc,EAAE,MAAM,OAAO;EAC7B,aAAa,EAAE,MAAM,YAAY;CACnC;CACA,eAAe,CACb;EACE,MAAM;EACN,SAAS;GAAC;GAAc;GAAkB;EAAc;CAC1D,CACF;CACA,SAAS,CACP;EACE,MAAM;EACN,SAAS;GAAC;GAAU;GAAsB;GAAgB;GAAe;EAAI;CAC/E,GACA;EACE,MAAM;EACN,SAAS;GAAC;GAAU;GAAsB;EAAc;CAC1D,CACF;AACF"}

package/dist/storage/domains/comments/wire.d.ts

@@ -0,0 +1,40 @@
+import type { FactoryActorKind } from './actor.js';
+import type { FactoryMentionRef, WorkItemCommentReplyRef, WorkItemCommentRow } from './base.js';
+/**
+ * Display-only author. The stored `FactoryActorRef` also carries the platform
+ * join keys (team, message, bot flag) that linked a sender to a tenant user;
+ * those never reach a thread reader.
+ */
+export interface WireCommentAuthor {
+    kind: FactoryActorKind;
+    id: string;
+    displayName?: string;
+    avatarUrl?: string;
+}
+export interface WireComment {
+    id: string;
+    workItemId: string;
+    kind: string;
+    body: string;
+    bodyFormat: string;
+    author: WireCommentAuthor;
+    replyTo?: WorkItemCommentReplyRef;
+    mentions: FactoryMentionRef[];
+    /** The viewer's own local sends only, so their client can match pending rows. */
+    clientToken?: string;
+    origin?: {
+        integrationId: string;
+        type: string;
+        url?: string;
+    };
+    revision: number;
+    occurredAt: string;
+    editedAt?: string;
+    deletedAt?: string;
+}
+export interface WireCommentPage {
+    comments: WireComment[];
+    nextCursor?: string;
+}
+export declare function toWireComment(comment: WorkItemCommentRow, viewerId: string): WireComment;
+//# sourceMappingURL=wire.d.ts.map

package/dist/storage/domains/comments/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/comments/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEhG;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CA6BxF"}

package/dist/storage/domains/comments/wire.js

@@ -0,0 +1,37 @@
+//#region src/storage/domains/comments/wire.ts
+const LOCAL_SOURCE_KEY_PREFIX = "local:comment:";
+function toWireAuthor({ kind, id, displayName, avatarUrl }) {
+	return {
+		kind,
+		id,
+		...displayName ? { displayName } : {},
+		...avatarUrl ? { avatarUrl } : {}
+	};
+}
+function toWireComment(comment, viewerId) {
+	const clientToken = comment.author.id === viewerId && comment.sourceKey?.startsWith(LOCAL_SOURCE_KEY_PREFIX) ? comment.sourceKey.slice(14) : void 0;
+	return {
+		id: comment.id,
+		workItemId: comment.workItemId,
+		kind: comment.kind,
+		body: comment.body,
+		bodyFormat: comment.bodyFormat,
+		author: toWireAuthor(comment.author),
+		...comment.replyTo ? { replyTo: comment.replyTo } : {},
+		mentions: comment.mentions,
+		...clientToken ? { clientToken } : {},
+		...comment.externalSource ? { origin: {
+			integrationId: comment.externalSource.integrationId,
+			type: comment.externalSource.type,
+			...comment.externalSource.url ? { url: comment.externalSource.url } : {}
+		} } : {},
+		revision: comment.revision,
+		occurredAt: comment.occurredAt.toISOString(),
+		...comment.editedAt ? { editedAt: comment.editedAt.toISOString() } : {},
+		...comment.deletedAt ? { deletedAt: comment.deletedAt.toISOString() } : {}
+	};
+}
+//#endregion
+export { toWireComment };
+
+//# sourceMappingURL=wire.js.map