@ketvietlab/ketsuite 0.1.25 → 0.1.30

package/dist/modules/flow/domain/command.d.ts

@@ -0,0 +1,33 @@
+import type { Ctx } from '@ketvietlab/ketjs';
+export type FlowIssue = {
+    field: string;
+    code: string;
+    params?: Record<string, unknown>;
+};
+export type FlowResult = {
+    ok: boolean;
+    id?: string;
+    errors?: FlowIssue[];
+    [key: string]: unknown;
+};
+export declare const issue: (field: string, code: string, params?: Record<string, unknown>) => FlowIssue;
+export declare const invalid: (...errors: FlowIssue[]) => FlowResult;
+export declare const now: () => string;
+export declare const n: (value: unknown) => number;
+export declare const normalized: (value: unknown) => string;
+export declare const actorRequired: (ctx: Ctx) => string | null;
+/**
+ * The id of a record a command creates, derived from what the command is
+ * deduplicated under.
+ *
+ * A form that is submitted twice — a double click, a back button, a retry from
+ * a phone that lost its connection — sends the same idempotency key both
+ * times. If the id is fresh on each attempt, the second attempt is a different
+ * record and gets written as one: two issues from one intent. Deriving the id
+ * from the key makes the replay byte-identical, so it lands on the record the
+ * first attempt already made and updates it instead (FLW-033).
+ */
+export declare const commandRecordId: (namespace: string, key: string) => string;
+export declare const commandKey: (value: unknown) => string | null;
+export declare const createFlowId: () => string;
+//# sourceMappingURL=command.d.ts.map

package/dist/modules/flow/domain/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/domain/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAG5C,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAEzF,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AAEnG,eAAO,MAAM,KAAK,UAAW,MAAM,QAAQ,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,SAIpF,CAAA;AAEF,eAAO,MAAM,OAAO,cAAe,SAAS,EAAE,KAAG,UAAqC,CAAA;AAEtF,eAAO,MAAM,GAAG,QAAO,MAAkC,CAAA;AAEzD,eAAO,MAAM,CAAC,UAAW,OAAO,KAAG,MAA4B,CAAA;AAE/D,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,MAI1B,CAAA;AAElB,eAAO,MAAM,aAAa,QAAS,GAAG,KAAG,MAAM,GAAG,IAAyB,CAAA;AAE3E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,cAAe,MAAM,OAAO,MAAM,KAAG,MAGhE,CAAA;AAED,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,MAAM,GAAG,IAGpD,CAAA;AAED,eAAO,MAAM,YAAY,QAAO,MAAsB,CAAA"}

package/dist/modules/flow/domain/command.js

@@ -0,0 +1,35 @@
+import { createHash, randomUUID } from 'node:crypto';
+export const issue = (field, code, params) => ({
+    field,
+    code,
+    ...(params ? { params } : {}),
+});
+export const invalid = (...errors) => ({ ok: false, errors });
+export const now = () => new Date().toISOString();
+export const n = (value) => Number(value ?? 0);
+export const normalized = (value) => String(value ?? '')
+    .normalize('NFKC')
+    .trim()
+    .toLowerCase();
+export const actorRequired = (ctx) => ctx.actor || null;
+/**
+ * The id of a record a command creates, derived from what the command is
+ * deduplicated under.
+ *
+ * A form that is submitted twice — a double click, a back button, a retry from
+ * a phone that lost its connection — sends the same idempotency key both
+ * times. If the id is fresh on each attempt, the second attempt is a different
+ * record and gets written as one: two issues from one intent. Deriving the id
+ * from the key makes the replay byte-identical, so it lands on the record the
+ * first attempt already made and updates it instead (FLW-033).
+ */
+export const commandRecordId = (namespace, key) => {
+    const hex = createHash('sha256').update(`${namespace}\n${key}`).digest('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+};
+export const commandKey = (value) => {
+    const key = String(value ?? '').trim();
+    return key.length >= 8 && key.length <= 200 ? key : null;
+};
+export const createFlowId = () => randomUUID();
+//# sourceMappingURL=command.js.map

package/dist/modules/flow/domain/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/domain/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAMpD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,MAAgC,EAAa,EAAE,CAAC,CAAC;IAClG,KAAK;IACL,IAAI;IACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAC9B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,MAAmB,EAAc,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAEtF,MAAM,CAAC,MAAM,GAAG,GAAG,GAAW,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AAEzD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAU,EAAE,CACnD,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;KAChB,SAAS,CAAC,MAAM,CAAC;KACjB,IAAI,EAAE;KACN,WAAW,EAAE,CAAA;AAElB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAQ,EAAiB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAA;AAE3E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAE,GAAW,EAAU,EAAE;IACxE,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,KAAK,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7E,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAA;AAChH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAiB,EAAE;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACtC,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,UAAU,EAAE,CAAA"}

package/dist/modules/flow/domain/issue-bulk.d.ts

@@ -0,0 +1,50 @@
+import type { Ctx } from '@ketvietlab/ketjs';
+import type { FlowResult } from './command.ts';
+/**
+ * Move an issue into another project.
+ *
+ * Both ends go through the membership gate: moving work into a project you
+ * cannot see is writing to a project you cannot see, and moving it out of one
+ * is reading it. Either way the answer is the same "not found" every other
+ * Flow path gives (FLW-DEC-012).
+ *
+ * An issue with children refuses rather than leaving them behind pointing at a
+ * parent in another project. That is the same shape of orphan the purge job
+ * takes care to avoid, and silently splitting a tree is worse than saying no.
+ */
+export declare const BULK_ACTIONS: readonly ['move', 'assign', 'archive', 'restore'];
+export type BulkAction = (typeof BULK_ACTIONS)[number];
+/** How many issues one request may touch. */
+export declare const BULK_LIMIT = 200;
+export type BulkOutcome = {
+    applied: number;
+    refused: Array<{
+        id: string;
+        code: string;
+    }>;
+};
+/**
+ * One action over many issues, applied one at a time and reported per issue.
+ *
+ * **This is not protected against concurrent edits, and cannot be.** Every
+ * single-issue command takes an `expectedVersion` because the caller read the
+ * record and is saying which version they meant. A person who ticked forty
+ * rows on a list has read no versions and could not supply them, so this reads
+ * each issue's current version and acts on it. Filling in a version on the
+ * caller's behalf would be pretending to a guarantee that is not there — the
+ * point of saying so here is that the guarantee is genuinely absent, not that
+ * it is hidden.
+ *
+ * What replaces it is the report. Nothing is rolled back for a neighbour's
+ * failure: an issue the caller cannot see, one already in the state asked for,
+ * one that lost a race — each is named with its reason, and the rest still
+ * happen. A bulk action that failed atomically would leave somebody with forty
+ * rows and no idea which one was the problem.
+ */
+export declare function bulkIssues(ctx: Ctx, input: {
+    ids: readonly string[];
+    action: BulkAction;
+    value?: string | null;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+//# sourceMappingURL=issue-bulk.d.ts.map

package/dist/modules/flow/domain/issue-bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-bulk.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/domain/issue-bulk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,cAAc,CAAA;AAKzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,YAAI,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAA;AAE7E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,UAAU,MAAM,CAAA;AAE7B,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7C,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE;IAAE,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACnG,OAAO,CAAC,UAAU,CAAC,CAwDrB"}

package/dist/modules/flow/domain/issue-bulk.js

@@ -0,0 +1,97 @@
+import { actorRequired, commandKey, commandRecordId, invalid, issue, n } from './command.js';
+import { readableRow } from '../membership.js';
+import { archiveIssue, moveIssue, restoreIssue, saveIssue } from './issue-write.js';
+/**
+ * Move an issue into another project.
+ *
+ * Both ends go through the membership gate: moving work into a project you
+ * cannot see is writing to a project you cannot see, and moving it out of one
+ * is reading it. Either way the answer is the same "not found" every other
+ * Flow path gives (FLW-DEC-012).
+ *
+ * An issue with children refuses rather than leaving them behind pointing at a
+ * parent in another project. That is the same shape of orphan the purge job
+ * takes care to avoid, and silently splitting a tree is worse than saying no.
+ */
+export const BULK_ACTIONS = ['move', 'assign', 'archive', 'restore'];
+/** How many issues one request may touch. */
+export const BULK_LIMIT = 200;
+/**
+ * One action over many issues, applied one at a time and reported per issue.
+ *
+ * **This is not protected against concurrent edits, and cannot be.** Every
+ * single-issue command takes an `expectedVersion` because the caller read the
+ * record and is saying which version they meant. A person who ticked forty
+ * rows on a list has read no versions and could not supply them, so this reads
+ * each issue's current version and acts on it. Filling in a version on the
+ * caller's behalf would be pretending to a guarantee that is not there — the
+ * point of saying so here is that the guarantee is genuinely absent, not that
+ * it is hidden.
+ *
+ * What replaces it is the report. Nothing is rolled back for a neighbour's
+ * failure: an issue the caller cannot see, one already in the state asked for,
+ * one that lost a race — each is named with its reason, and the rest still
+ * happen. A bulk action that failed atomically would leave somebody with forty
+ * rows and no idea which one was the problem.
+ */
+export async function bulkIssues(ctx, input) {
+    if (!actorRequired(ctx))
+        return invalid(issue('actor', 'flow.error.actorRequired'));
+    if (!commandKey(input.idempotencyKey))
+        return invalid(issue('idempotencyKey', 'flow.error.idempotencyRequired'));
+    if (!BULK_ACTIONS.includes(input.action))
+        return invalid(issue('action', 'flow.error.invalidAction'));
+    const ids = [...new Set(input.ids.map(String).filter(Boolean))];
+    if (!ids.length)
+        return invalid(issue('ids', 'flow.error.required'));
+    if (ids.length > BULK_LIMIT)
+        return invalid(issue('ids', 'flow.error.tooMany', { limit: BULK_LIMIT }));
+    if ((input.action === 'move' || input.action === 'assign') && !input.value)
+        return invalid(issue('value', 'flow.error.required'));
+    const outcome = { applied: 0, refused: [] };
+    for (const id of ids) {
+        // Read through the gate, one at a time. An issue in a project this caller
+        // is not on is not found, and is refused for that reason rather than
+        // being silently skipped — a count that does not add up is worse than a
+        // refusal that says why.
+        const held = await readableRow(ctx, 'flow.Issue', id);
+        if (!held) {
+            outcome.refused.push({ id, code: 'flow.error.notFound' });
+            continue;
+        }
+        // A key per issue, derived from the one the request carries, so a retry
+        // of the whole batch replays each item rather than being refused as a
+        // duplicate of the first.
+        const key = commandRecordId(`flow.issue.bulk:${input.action}:${id}`, input.idempotencyKey);
+        const version = n(held.version);
+        const result = input.action === 'move'
+            ? await moveIssue(ctx, {
+                id,
+                columnId: String(input.value),
+                expectedVersion: version,
+                idempotencyKey: key,
+            })
+            : input.action === 'archive'
+                ? await archiveIssue(ctx, { id, expectedVersion: version, idempotencyKey: key })
+                : input.action === 'restore'
+                    ? await restoreIssue(ctx, { id, expectedVersion: version, idempotencyKey: key })
+                    : await saveIssue(ctx, {
+                        id,
+                        projectId: String(held.projectId),
+                        columnId: String(held.columnId),
+                        title: String(held.title ?? ''),
+                        assigneeUserId: input.value ? String(input.value) : null,
+                        expectedVersion: version,
+                        idempotencyKey: key,
+                    });
+        if (result.ok)
+            outcome.applied += 1;
+        else
+            outcome.refused.push({
+                id,
+                code: String(result.errors?.[0]?.code ?? 'flow.error.invalid'),
+            });
+    }
+    return { ok: true, ...outcome };
+}
+//# sourceMappingURL=issue-bulk.js.map

package/dist/modules/flow/domain/issue-bulk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-bulk.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/domain/issue-bulk.ts"],"names":[],"mappings":"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"}

package/dist/modules/flow/domain/issue-dependency.d.ts

@@ -0,0 +1,19 @@
+import type { Ctx } from '@ketvietlab/ketjs';
+import type { FlowResult } from './command.ts';
+/**
+ * Only `blocks` is checked for cycles.
+ *
+ * `related` carries no ordering — an issue "related to" another can point back
+ * without contradiction — so a cycle there is not a bug. A `blocks` cycle would
+ * make every issue in the loop permanently unblockable, which is worth refusing
+ * up front rather than discovering at move time.
+ */
+export declare function createsBlockCycle(ctx: Ctx, issueId: string, dependsOnIssueId: string): Promise<boolean>;
+export declare function addDependency(ctx: Ctx, input: {
+    id: string;
+    issueId: string;
+    dependsOnIssueId: string;
+    relation: string;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+//# sourceMappingURL=issue-dependency.d.ts.map

package/dist/modules/flow/domain/issue-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-dependency.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/domain/issue-dependency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAK9C;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC,CAelB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,GAAG,EACR,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACzG,OAAO,CAAC,UAAU,CAAC,CA0BrB"}

package/dist/modules/flow/domain/issue-dependency.js

@@ -0,0 +1,59 @@
+import { actorRequired, commandKey, invalid, issue } from './command.js';
+import { DEPENDENCY_RELATIONS } from '../types.js';
+import { readableRow } from '../membership.js';
+/**
+ * Only `blocks` is checked for cycles.
+ *
+ * `related` carries no ordering — an issue "related to" another can point back
+ * without contradiction — so a cycle there is not a bug. A `blocks` cycle would
+ * make every issue in the loop permanently unblockable, which is worth refusing
+ * up front rather than discovering at move time.
+ */
+export async function createsBlockCycle(ctx, issueId, dependsOnIssueId) {
+    const seen = new Set([issueId]);
+    let frontier = [dependsOnIssueId];
+    while (frontier.length) {
+        if (frontier.includes(issueId))
+            return true;
+        const next = [];
+        for (const id of frontier) {
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            const edges = await ctx.db.select('flow.IssueDependency', { issueId: id, relation: 'blocks' });
+            next.push(...edges.map((row) => String(row.dependsOnIssueId)));
+        }
+        frontier = next;
+    }
+    return false;
+}
+export async function addDependency(ctx, input) {
+    if (!actorRequired(ctx))
+        return invalid(issue('actor', 'flow.error.actorRequired'));
+    if (!commandKey(input.idempotencyKey))
+        return invalid(issue('idempotencyKey', 'flow.error.idempotencyRequired'));
+    if (!DEPENDENCY_RELATIONS.includes(input.relation))
+        return invalid(issue('relation', 'flow.error.invalidRelation'));
+    if (input.issueId === input.dependsOnIssueId)
+        return invalid(issue('dependsOnIssueId', 'flow.error.selfDependency'));
+    return ctx.tx(async (tx) => {
+        const [held, target] = await Promise.all([
+            readableRow(tx, 'flow.Issue', input.issueId).then((row) => (row ? [row] : [])),
+            readableRow(tx, 'flow.Issue', input.dependsOnIssueId).then((row) => (row ? [row] : [])),
+        ]);
+        if (!held[0] || !target[0])
+            return invalid(issue('id', 'flow.error.notFound'));
+        if (input.relation === 'blocks' && (await createsBlockCycle(tx, input.issueId, input.dependsOnIssueId)))
+            return invalid(issue('dependsOnIssueId', 'flow.error.cycle'));
+        const inserted = await tx.db.insertIfAbsent('flow.IssueDependency', {
+            id: input.id,
+            issueId: input.issueId,
+            dependsOnIssueId: input.dependsOnIssueId,
+            relation: input.relation,
+        });
+        if (!('dryRun' in inserted) && !inserted.inserted)
+            return invalid(issue('dependsOnIssueId', 'flow.error.duplicateDependency'));
+        return { ok: true, id: input.id };
+    });
+}
+//# sourceMappingURL=issue-dependency.js.map

package/dist/modules/flow/domain/issue-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-dependency.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/domain/issue-dependency.ts"],"names":[],"mappings":"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"}

package/dist/modules/flow/domain/issue-discussion.d.ts

@@ -0,0 +1,52 @@
+import type { Ctx } from '@ketvietlab/ketjs';
+import type { FlowResult } from './command.ts';
+/**
+ * Subscribes a user to an issue's thread, when the platform can address them.
+ *
+ * Followers are partner-keyed the whole way down — `mail.Notification`'s
+ * `recipientPartnerId` is required — while `user.User.partnerId` is optional
+ * by design ("an internal operator needs no entry in the address book"). So a
+ * user without one cannot be subscribed and cannot be notified. Skipping is
+ * the truthful outcome: the alternative is creating address-book rows as a
+ * side effect of assigning a task, which is not a decision this module gets
+ * to make.
+ */
+export declare function followIssue(ctx: Ctx, threadId: unknown, userId: unknown): Promise<void>;
+/**
+ * The partners behind a list of mentioned users.
+ *
+ * Mentions are partner-keyed the whole way down, the same as followers, so a
+ * user without a partner cannot be mentioned any more than they can be
+ * notified — see `followIssue` above for why that is the platform's shape
+ * rather than something to work around here. They are dropped rather than
+ * refused: a comment naming five people should still reach the four the system
+ * can address.
+ */
+export declare function mentionPartners(ctx: Ctx, userIds: readonly string[]): Promise<string[]>;
+export declare function addComment(ctx: Ctx, input: {
+    id: string;
+    issueId: string;
+    body: string;
+    kind?: 'comment' | 'note';
+    /** Who this comment is addressed to, beyond whoever already follows it. */
+    mentionUserIds?: string[];
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+/**
+ * Follow an issue on purpose, rather than by being assigned it, commenting on
+ * it or being named in it.
+ *
+ * Those three are how everybody who follows an issue got there, and `unfollow`
+ * was the only door in the other direction. Somebody who wanted to watch
+ * another person's work had to comment on it — which is noise in the timeline —
+ * or ask to be mentioned.
+ */
+export declare function startFollowing(ctx: Ctx, input: {
+    issueId: string;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+export declare function stopFollowing(ctx: Ctx, input: {
+    issueId: string;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+//# sourceMappingURL=issue-discussion.d.ts.map

package/dist/modules/flow/domain/issue-discussion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-discussion.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/domain/issue-discussion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAI9C;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7F;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa7F;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE;IACL,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;CACvB,GACA,OAAO,CAAC,UAAU,CAAC,CAwBrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,GAAG,EACR,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,GAAG,EACR,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC,UAAU,CAAC,CAUrB"}

package/dist/modules/flow/domain/issue-discussion.js

@@ -0,0 +1,114 @@
+import { followThread, postMessage, unfollowThread } from '../../mail/index.js';
+import { from, inArray } from '@ketvietlab/ketjs';
+import { actorRequired, commandKey, invalid, issue } from './command.js';
+import { readableRow } from '../membership.js';
+/**
+ * Subscribes a user to an issue's thread, when the platform can address them.
+ *
+ * Followers are partner-keyed the whole way down — `mail.Notification`'s
+ * `recipientPartnerId` is required — while `user.User.partnerId` is optional
+ * by design ("an internal operator needs no entry in the address book"). So a
+ * user without one cannot be subscribed and cannot be notified. Skipping is
+ * the truthful outcome: the alternative is creating address-book rows as a
+ * side effect of assigning a task, which is not a decision this module gets
+ * to make.
+ */
+export async function followIssue(ctx, threadId, userId) {
+    if (!threadId || !userId)
+        return;
+    const user = (await ctx.db.select('user.User', { id: userId }))[0];
+    if (!user?.partnerId)
+        return;
+    await followThread(ctx, {
+        id: `${String(threadId)}:${String(user.partnerId)}`,
+        threadId: String(threadId),
+        partnerId: String(user.partnerId),
+    });
+}
+/**
+ * The partners behind a list of mentioned users.
+ *
+ * Mentions are partner-keyed the whole way down, the same as followers, so a
+ * user without a partner cannot be mentioned any more than they can be
+ * notified — see `followIssue` above for why that is the platform's shape
+ * rather than something to work around here. They are dropped rather than
+ * refused: a comment naming five people should still reach the four the system
+ * can address.
+ */
+export async function mentionPartners(ctx, userIds) {
+    const wanted = [...new Set(userIds.filter(Boolean).map(String))];
+    if (!wanted.length)
+        return [];
+    const U = ctx.table('user.User');
+    const users = await ctx.db.all(from(U).where(inArray(U.id, wanted)));
+    return [
+        ...new Set(users
+            .map((user) => user.partnerId)
+            .filter(Boolean)
+            .map(String)),
+    ];
+}
+export async function addComment(ctx, input) {
+    if (!actorRequired(ctx))
+        return invalid(issue('actor', 'flow.error.actorRequired'));
+    if (!commandKey(input.idempotencyKey))
+        return invalid(issue('idempotencyKey', 'flow.error.idempotencyRequired'));
+    if (!input.body.trim())
+        return invalid(issue('body', 'flow.error.required'));
+    const held = await readableRow(ctx, 'flow.Issue', input.issueId);
+    if (!held)
+        return invalid(issue('issueId', 'flow.error.notFound'));
+    // Before the message, so the author is subscribed to the replies to it.
+    // `postMessage` excludes the author from its own recipients, so this does
+    // not notify them about their own comment.
+    await followIssue(ctx, held.threadId, ctx.actor);
+    // Naming somebody subscribes them, so the answer to what they were asked
+    // reaches them too. Being mentioned once is how most people end up following
+    // an issue at all, which is also why `stopFollowing` exists below.
+    for (const userId of input.mentionUserIds ?? [])
+        await followIssue(ctx, held.threadId, userId);
+    const result = await postMessage(ctx, {
+        id: input.id,
+        threadId: String(held.threadId),
+        authorUserId: ctx.actor ?? undefined,
+        kind: input.kind ?? 'comment',
+        body: input.body.trim(),
+        mentionPartnerIds: await mentionPartners(ctx, input.mentionUserIds ?? []),
+    });
+    return { ok: true, id: String(result.message.id) };
+}
+/**
+ * Follow an issue on purpose, rather than by being assigned it, commenting on
+ * it or being named in it.
+ *
+ * Those three are how everybody who follows an issue got there, and `unfollow`
+ * was the only door in the other direction. Somebody who wanted to watch
+ * another person's work had to comment on it — which is noise in the timeline —
+ * or ask to be mentioned.
+ */
+export async function startFollowing(ctx, input) {
+    if (!actorRequired(ctx))
+        return invalid(issue('actor', 'flow.error.actorRequired'));
+    if (!commandKey(input.idempotencyKey))
+        return invalid(issue('idempotencyKey', 'flow.error.idempotencyRequired'));
+    const held = await readableRow(ctx, 'flow.Issue', input.issueId);
+    if (!held)
+        return invalid(issue('issueId', 'flow.error.notFound'));
+    await followIssue(ctx, held.threadId, ctx.actor);
+    return { ok: true, id: input.issueId };
+}
+export async function stopFollowing(ctx, input) {
+    if (!actorRequired(ctx))
+        return invalid(issue('actor', 'flow.error.actorRequired'));
+    if (!commandKey(input.idempotencyKey))
+        return invalid(issue('idempotencyKey', 'flow.error.idempotencyRequired'));
+    const held = await readableRow(ctx, 'flow.Issue', input.issueId);
+    if (!held)
+        return invalid(issue('issueId', 'flow.error.notFound'));
+    const user = (await ctx.db.select('user.User', { id: ctx.actor }))[0];
+    if (!user?.partnerId)
+        return { ok: true, removed: 0 };
+    const removed = await unfollowThread(ctx, String(held.threadId), String(user.partnerId));
+    return { ok: true, removed };
+}
+//# sourceMappingURL=issue-discussion.js.map

package/dist/modules/flow/domain/issue-discussion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-discussion.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/domain/issue-discussion.ts"],"names":[],"mappings":"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"}

package/dist/modules/flow/domain/issue-transfer.d.ts

@@ -0,0 +1,62 @@
+import type { Ctx, Row } from '@ketvietlab/ketjs';
+import type { FlowIssue, FlowResult } from './command.ts';
+/**
+ * A `blocks` dependency that has not itself reached a terminal column keeps the
+ * blocked issue out of one too — the one place the fixed dependency vocabulary
+ * (see types.ts) drives actual behavior instead of just being a label.
+ */
+/**
+ * What a project keeps to itself, and what travels with an issue that leaves.
+ *
+ * Almost everything an issue points at belongs to the project it is in:
+ * columns, issue types, epics, sprints and custom field definitions are all
+ * keyed by project, so none of them mean anything on the other side. Tags are
+ * the exception and stay untouched, because a tag belongs to the company
+ * rather than to the project that happened to use it (FLW-DEC-006).
+ *
+ * The mapping is by `code`, not by id. A destination that has its own "bug"
+ * type or its own "severity" field is asking for the same thing under the same
+ * name, and carrying the value across is what somebody moving work expects.
+ * Anything with no counterpart is dropped and counted, because a move that
+ * quietly loses a field value is a move nobody can audit afterwards.
+ */
+export type TransferReport = {
+    columnId: string;
+    typeId: string | null;
+    epicCleared: boolean;
+    sprintCleared: boolean;
+};
+export declare function planTransfer(ctx: Ctx, held: Row, projectId: string, columnId: unknown): Promise<TransferReport | FlowIssue>;
+/** Carry the custom field values whose code exists on the other side. */
+export declare function carryFields(ctx: Ctx, fromIssueId: string, toIssueId: string, projectId: string): Promise<{
+    carried: number;
+    dropped: number;
+}>;
+export declare function transferIssue(ctx: Ctx, input: {
+    id: string;
+    projectId: string;
+    columnId?: string | null;
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+/**
+ * Put a copy of an issue into another project, leaving the original alone.
+ *
+ * The same mapping `transferIssue` uses, because the crossing is the same
+ * crossing — a type or a field that has no counterpart on the other side has
+ * none whether the issue is moving or being duplicated.
+ *
+ * What a copy deliberately does not bring is the history: the comments, the
+ * followers and the document are the record of a conversation that happened
+ * about *that* issue, and duplicating them would put words in people's mouths
+ * on a record they never saw. The copy starts with a title and the fields, and
+ * whoever asked for it can say the rest themselves (FLW-020).
+ */
+export declare function copyIssue(ctx: Ctx, input: {
+    id: string;
+    projectId: string;
+    columnId?: string | null;
+    title?: string | null;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+//# sourceMappingURL=issue-transfer.d.ts.map

package/dist/modules/flow/domain/issue-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-transfer.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/domain/issue-transfer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAMzD;;;;GAIG;AACH;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA6BrC;AAED,yEAAyE;AACzE,wBAAsB,WAAW,CAC/B,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB/C;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,GAAG,EACR,KAAK,EAAE;IACL,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;CACvB,GACA,OAAO,CAAC,UAAU,CAAC,CAgErB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE;IACL,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;CACvB,GACA,OAAO,CAAC,UAAU,CAAC,CAwCrB"}