@ketvietlab/ketsuite 0.1.29 → 0.1.30

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"}

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

@@ -0,0 +1,171 @@
+import { actorRequired, commandKey, commandRecordId, invalid, issue, n, now } from './command.js';
+import { deleteFrom, eq, inArray } from '@ketvietlab/ketjs';
+import { readableProject, readableRow } from '../membership.js';
+import { saveIssue } from './issue-write.js';
+export async function planTransfer(ctx, held, projectId, columnId) {
+    const columns = await ctx.db.select('flow.Column', { projectId, active: true });
+    if (!columns.length)
+        return issue('projectId', 'flow.error.projectHasNoColumns');
+    const named = columnId ? columns.find((row) => String(row.id) === String(columnId)) : undefined;
+    if (columnId && !named)
+        return issue('columnId', 'flow.error.notFound');
+    // No column named: the first one work arrives in, by the order the board
+    // shows. Landing in a terminal column would report the issue as finished
+    // the moment it moved, which is the one answer a move must not invent.
+    const landing = named ??
+        [...columns]
+            .filter((row) => row.terminalState !== true)
+            .sort((a, b) => n(a.sequence) - n(b.sequence) || String(a.id).localeCompare(String(b.id)))[0] ??
+        columns[0];
+    let typeId = null;
+    if (held.typeId) {
+        const from = (await ctx.db.select('flow.IssueType', { id: held.typeId }))[0];
+        const to = from
+            ? (await ctx.db.select('flow.IssueType', { projectId, code: from.code, active: true }))[0]
+            : undefined;
+        typeId = to ? String(to.id) : null;
+    }
+    return {
+        columnId: String(landing.id),
+        typeId,
+        epicCleared: held.epicId != null,
+        sprintCleared: held.sprintId != null,
+    };
+}
+/** Carry the custom field values whose code exists on the other side. */
+export async function carryFields(ctx, fromIssueId, toIssueId, projectId) {
+    const values = await ctx.db.select('flow.IssueFieldValue', { issueId: fromIssueId });
+    if (!values.length)
+        return { carried: 0, dropped: 0 };
+    const defs = await ctx.db.select('flow.FieldDef', { projectId, active: true });
+    const byCode = new Map(defs.map((def) => [String(def.code), def]));
+    let carried = 0;
+    for (const value of values) {
+        const from = (await ctx.db.select('flow.FieldDef', { id: value.fieldId }))[0];
+        const to = from ? byCode.get(String(from.code)) : undefined;
+        if (!to)
+            continue;
+        await ctx.db.insertIfAbsent('flow.IssueFieldValue', {
+            id: `${toIssueId}:${String(to.id)}`,
+            issueId: toIssueId,
+            fieldId: to.id,
+            value: value.value ?? null,
+        });
+        carried += 1;
+    }
+    return { carried, dropped: values.length - carried };
+}
+export async function transferIssue(ctx, input) {
+    if (!actorRequired(ctx))
+        return invalid(issue('actor', 'flow.error.actorRequired'));
+    if (!commandKey(input.idempotencyKey))
+        return invalid(issue('idempotencyKey', 'flow.error.idempotencyRequired'));
+    return ctx.tx(async (tx) => {
+        const held = await readableRow(tx, 'flow.Issue', input.id);
+        if (!held)
+            return invalid(issue('id', 'flow.error.notFound'));
+        if (String(held.projectId) === String(input.projectId))
+            return invalid(issue('projectId', 'flow.error.sameProject'));
+        if (n(held.version) !== input.expectedVersion)
+            return invalid(issue('version', 'flow.error.conflict', { current: held.version }));
+        const destination = await readableProject(tx, input.projectId);
+        if (!destination || destination.active !== true)
+            return invalid(issue('projectId', 'flow.error.notFound'));
+        const children = await tx.db.select('flow.Issue', { parentIssueId: input.id, active: true });
+        if (children.length)
+            return invalid(issue('id', 'flow.error.issueHasChildren'));
+        const plan = await planTransfer(tx, held, String(input.projectId), input.columnId);
+        if ('code' in plan)
+            return invalid(plan);
+        // The values move rather than being copied, so they are read before the
+        // old ones go and written against the destination's own definitions.
+        const carried = await carryFields(tx, input.id, input.id, String(input.projectId));
+        const V = tx.table('flow.IssueFieldValue');
+        const defs = await tx.db.select('flow.FieldDef', { projectId: held.projectId });
+        if (defs.length)
+            await tx.db.del(deleteFrom(V).where(eq(V.issueId, input.id), inArray(V.fieldId, defs.map((def) => String(def.id)))));
+        const version = n(held.version) + 1;
+        await tx.db.update('flow.Issue', { id: input.id }, {
+            projectId: input.projectId,
+            columnId: plan.columnId,
+            typeId: plan.typeId,
+            // Neither means anything on the other side, and keeping either would
+            // put an issue in a sprint its new project does not run.
+            epicId: null,
+            sprintId: null,
+            parentIssueId: null,
+            version,
+            updatedAt: now(),
+        });
+        return {
+            ok: true,
+            id: input.id,
+            version,
+            columnId: plan.columnId,
+            fieldsCarried: carried.carried,
+            fieldsDropped: carried.dropped,
+            typeCleared: Boolean(held.typeId) && plan.typeId === null,
+            epicCleared: plan.epicCleared,
+            sprintCleared: plan.sprintCleared,
+        };
+    });
+}
+/**
+ * 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 async function copyIssue(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.id);
+    if (!held)
+        return invalid(issue('id', 'flow.error.notFound'));
+    const destination = await readableProject(ctx, input.projectId);
+    if (!destination || destination.active !== true)
+        return invalid(issue('projectId', 'flow.error.notFound'));
+    const plan = await planTransfer(ctx, held, String(input.projectId), input.columnId);
+    if ('code' in plan)
+        return invalid(plan);
+    // Derived from the key, so a double click makes one copy rather than two —
+    // the same reason the create form derives its id (FLW-033).
+    const id = commandRecordId(`flow.issue.copy:${input.id}:${String(input.projectId)}`, input.idempotencyKey);
+    const tags = await ctx.db.select('flow.IssueTag', { issueId: input.id });
+    const made = await saveIssue(ctx, {
+        id,
+        projectId: String(input.projectId),
+        columnId: plan.columnId,
+        typeId: plan.typeId,
+        title: String(input.title ?? held.title ?? ''),
+        assigneeUserId: held.assigneeUserId ? String(held.assigneeUserId) : null,
+        priority: String(held.priority ?? '2'),
+        startDate: held.startDate ? String(held.startDate) : null,
+        dueDate: held.dueDate ? String(held.dueDate) : null,
+        estimate: held.estimate ?? undefined,
+        // A tag is the company's, so it means the same thing in both projects.
+        tagIds: tags.map((row) => String(row.tagId)),
+        idempotencyKey: input.idempotencyKey,
+    });
+    if (!made.ok)
+        return made;
+    const carried = await carryFields(ctx, input.id, id, String(input.projectId));
+    return {
+        ok: true,
+        id,
+        columnId: plan.columnId,
+        fieldsCarried: carried.carried,
+        fieldsDropped: carried.dropped,
+        typeCleared: Boolean(held.typeId) && plan.typeId === null,
+    };
+}
+//# sourceMappingURL=issue-transfer.js.map

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

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

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

@@ -0,0 +1,68 @@
+import type { Ctx, Row } from '@ketvietlab/ketjs';
+import type { FlowIssue } from './command.ts';
+/**
+ * Live, and readable by this caller.
+ *
+ * Creating an issue in a project somebody cannot see is writing to a project
+ * they cannot see, so the same gate answers both. The caller turns a false here
+ * into "not found", which is also the right answer for a project that is real
+ * but not theirs.
+ */
+export declare const projectExists: (ctx: Ctx, id: unknown) => Promise<boolean>;
+export declare const columnOf: (ctx: Ctx, id: unknown) => Promise<Row | null>;
+export declare const userExists: (ctx: Ctx, id: unknown) => Promise<boolean>;
+/**
+ * A sprint an issue may still be dropped into.
+ *
+ * `null` reads as "no sprint" (always allowed). A closed sprint is the one
+ * state that refuses new membership — see the design note on the Sprint model.
+ */
+export declare function assignableSprint(ctx: Ctx, sprintId: unknown): Promise<Row | null | undefined>;
+/**
+ * An epic an issue may belong to.
+ *
+ * `undefined` means "named but not found". Every other reference on an issue
+ * — column, sprint, parent — is checked for existence and for belonging to
+ * the same project; epic was the one that was written straight through, so an
+ * issue in project A could be filed under project B's epic and would then
+ * appear on B's epic panel and dependency map while still living on A's board.
+ */
+export declare function issueEpic(ctx: Ctx, epicId: unknown): Promise<Row | null | undefined>;
+/**
+ * A type an issue may be filed as.
+ *
+ * Checked for existence and for belonging to the same project, which is what
+ * `epicId` was not and had to be taught — a reference written straight through
+ * puts a row on a board it does not belong to, and every screen downstream
+ * then agrees with it.
+ */
+export declare function issueType(ctx: Ctx, typeId: unknown): Promise<Row | null | undefined>;
+/** The options a `select` field offers, as codes. */
+export declare const optionCodes: (config: unknown) => string[];
+/**
+ * Whether a value is well-formed for the kind of field holding it.
+ *
+ * Empty always passes and clears the value: a field a team added last week is
+ * blank on every issue that already existed, and refusing to save those until
+ * somebody fills it in would make adding a field an act of vandalism.
+ */
+export declare function fieldValueError(field: Row, raw: unknown): FlowIssue | null;
+/**
+ * The custom fields of one project, by id and by code.
+ *
+ * Callers name a field either way — a screen posts ids, an agent writing
+ * `{ environment: 'production' }` names codes — and both have to land on the
+ * same definition.
+ */
+export declare function fieldsOfProject(ctx: Ctx, projectId: unknown): Promise<Map<string, Row>>;
+/**
+ * A parent an issue may point at.
+ *
+ * Sub-tasks nest inside one project's board, so a parent from another project
+ * would put a child on a board its parent is not on. A cycle is worse: the
+ * pair becomes each other's ancestor and any walk up the tree runs forever.
+ * `blocks` already refuses cycles for the same reason (see createsBlockCycle);
+ * parentage had no check at all, and accepted a parent id that did not exist.
+ */
+export declare function parentIssueError(ctx: Ctx, issueId: string, parentIssueId: unknown, projectId: string): Promise<FlowIssue | null>;
+//# sourceMappingURL=issue-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issue-validation.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/domain/issue-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAI7C;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAAe,GAAG,MAAM,OAAO,KAAG,OAAO,CAAC,OAAO,CAG1E,CAAA;AAED,eAAO,MAAM,QAAQ,QAAe,GAAG,MAAM,OAAO,KAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CACF,CAAA;AAEvE,eAAO,MAAM,UAAU,QAAe,GAAG,MAAM,OAAO,KAAG,OAAO,CAAC,OAAO,CACK,CAAA;AAE7E;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC,CAKnG;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC,CAG1F;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC,CAG1F;AAED,qDAAqD;AACrD,eAAO,MAAM,WAAW,WAAY,OAAO,KAAG,MAAM,EAGnD,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAa1E;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAQ7F;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,OAAO,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAgB3B"}

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

@@ -0,0 +1,136 @@
+import { readableProject } from '../membership.js';
+import { issue } from './command.js';
+/**
+ * Live, and readable by this caller.
+ *
+ * Creating an issue in a project somebody cannot see is writing to a project
+ * they cannot see, so the same gate answers both. The caller turns a false here
+ * into "not found", which is also the right answer for a project that is real
+ * but not theirs.
+ */
+export const projectExists = async (ctx, id) => {
+    const project = await readableProject(ctx, id);
+    return Boolean(project && project.active === true);
+};
+export const columnOf = async (ctx, id) => (await ctx.db.select('flow.Column', { id, active: true }))[0] ?? null;
+export const userExists = async (ctx, id) => !id || Boolean((await ctx.db.select('user.User', { id, active: true }))[0]);
+/**
+ * A sprint an issue may still be dropped into.
+ *
+ * `null` reads as "no sprint" (always allowed). A closed sprint is the one
+ * state that refuses new membership — see the design note on the Sprint model.
+ */
+export async function assignableSprint(ctx, sprintId) {
+    if (!sprintId)
+        return null;
+    const sprint = (await ctx.db.select('flow.Sprint', { id: sprintId }))[0];
+    if (!sprint)
+        return undefined;
+    return sprint.state === 'closed' ? undefined : sprint;
+}
+/**
+ * An epic an issue may belong to.
+ *
+ * `undefined` means "named but not found". Every other reference on an issue
+ * — column, sprint, parent — is checked for existence and for belonging to
+ * the same project; epic was the one that was written straight through, so an
+ * issue in project A could be filed under project B's epic and would then
+ * appear on B's epic panel and dependency map while still living on A's board.
+ */
+export async function issueEpic(ctx, epicId) {
+    if (!epicId)
+        return null;
+    return (await ctx.db.select('flow.Epic', { id: epicId }))[0] ?? undefined;
+}
+/**
+ * A type an issue may be filed as.
+ *
+ * Checked for existence and for belonging to the same project, which is what
+ * `epicId` was not and had to be taught — a reference written straight through
+ * puts a row on a board it does not belong to, and every screen downstream
+ * then agrees with it.
+ */
+export async function issueType(ctx, typeId) {
+    if (!typeId)
+        return null;
+    return (await ctx.db.select('flow.IssueType', { id: typeId }))[0] ?? undefined;
+}
+/** The options a `select` field offers, as codes. */
+export const optionCodes = (config) => {
+    const options = config?.options;
+    return Array.isArray(options) ? options.map((option) => String(option?.code ?? '')) : [];
+};
+/**
+ * Whether a value is well-formed for the kind of field holding it.
+ *
+ * Empty always passes and clears the value: a field a team added last week is
+ * blank on every issue that already existed, and refusing to save those until
+ * somebody fills it in would make adding a field an act of vandalism.
+ */
+export function fieldValueError(field, raw) {
+    const value = String(raw ?? '').trim();
+    if (!value)
+        return null;
+    const kind = String(field.kind);
+    const bad = (code) => issue(`field:${String(field.code)}`, code);
+    if (kind === 'number' && !Number.isFinite(Number(value)))
+        return bad('flow.error.fieldNumber');
+    if (kind === 'date' && Number.isNaN(Date.parse(value)))
+        return bad('flow.error.fieldDate');
+    if (kind === 'bool' && value !== 'true' && value !== 'false')
+        return bad('flow.error.fieldBool');
+    // http/https only, the same rule the editor applies to a link it renders:
+    // this one ends up in an href on somebody else's screen too.
+    if (kind === 'url' && !/^https?:\/\//i.test(value))
+        return bad('flow.error.fieldUrl');
+    if (kind === 'select' && !optionCodes(field.config).includes(value))
+        return bad('flow.error.fieldOption');
+    return null;
+}
+/**
+ * The custom fields of one project, by id and by code.
+ *
+ * Callers name a field either way — a screen posts ids, an agent writing
+ * `{ environment: 'production' }` names codes — and both have to land on the
+ * same definition.
+ */
+export async function fieldsOfProject(ctx, projectId) {
+    const defs = await ctx.db.select('flow.FieldDef', { projectId, active: true });
+    const by = new Map();
+    for (const def of defs) {
+        by.set(String(def.id), def);
+        by.set(String(def.code), def);
+    }
+    return by;
+}
+/**
+ * A parent an issue may point at.
+ *
+ * Sub-tasks nest inside one project's board, so a parent from another project
+ * would put a child on a board its parent is not on. A cycle is worse: the
+ * pair becomes each other's ancestor and any walk up the tree runs forever.
+ * `blocks` already refuses cycles for the same reason (see createsBlockCycle);
+ * parentage had no check at all, and accepted a parent id that did not exist.
+ */
+export async function parentIssueError(ctx, issueId, parentIssueId, projectId) {
+    if (!parentIssueId)
+        return null;
+    if (String(parentIssueId) === issueId)
+        return issue('parentIssueId', 'flow.error.selfParent');
+    const parent = (await ctx.db.select('flow.Issue', { id: parentIssueId }))[0];
+    if (!parent)
+        return issue('parentIssueId', 'flow.error.notFound');
+    if (String(parent.projectId) !== projectId)
+        return issue('parentIssueId', 'flow.error.parentProjectMismatch');
+    const seen = new Set([issueId]);
+    let at = parent;
+    while (at) {
+        const id = String(at.id);
+        if (seen.has(id))
+            return issue('parentIssueId', 'flow.error.parentCycle');
+        seen.add(id);
+        at = at.parentIssueId ? (await ctx.db.select('flow.Issue', { id: at.parentIssueId }))[0] : undefined;
+    }
+    return null;
+}
+//# sourceMappingURL=issue-validation.js.map

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

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

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

@@ -0,0 +1,118 @@
+import type { Ctx, Row } from '@ketvietlab/ketjs';
+import type { FlowResult } from './command.ts';
+export type SaveIssueInput = {
+    id: string;
+    projectId: string;
+    columnId: string;
+    typeId?: string | null;
+    epicId?: string | null;
+    sprintId?: string | null;
+    parentIssueId?: string | null;
+    title: string;
+    assigneeUserId?: string | null;
+    priority?: string;
+    startDate?: string | null;
+    dueDate?: string | null;
+    estimate?: unknown;
+    tagIds?: string[];
+    /** Custom field values, keyed by field id or by field code. */
+    fields?: Record<string, unknown>;
+    expectedVersion?: number;
+    idempotencyKey: string;
+};
+export declare function saveIssue(ctx: Ctx, input: SaveIssueInput): Promise<FlowResult>;
+/**
+ * One system entry per command, carrying every tracked field that moved.
+ *
+ * The timeline used to record exactly one thing — who an issue was handed to —
+ * so "who put this in Done, and when" had no answer anywhere in the system. The
+ * fields tracked are the ones a person asks about afterwards: the column, the
+ * deadline, the priority and the sprint. Title and description are deliberately
+ * out: an entry per keystroke is what makes a timeline unreadable, and both
+ * already have their own history in the Live Doc.
+ *
+ * One message rather than one per field, because a single edit that moved three
+ * of them is one thing that happened.
+ */
+export declare function trackIssueChange(tx: Ctx, input: {
+    issueId: string;
+    threadId: unknown;
+    version: number;
+    body: string;
+    changes: Array<{
+        field: string;
+        oldValue?: string;
+        newValue?: string;
+    }>;
+}): Promise<void>;
+/** A change worth an entry, or nothing when the value did not actually move. */
+export declare const moved: (field: string, before: unknown, after: unknown) => Array<{
+    field: string;
+    oldValue?: string;
+    newValue?: string;
+}>;
+export declare function ensureIssueThread(ctx: Ctx, issueId: string, title: string, createdAt: string): Promise<Row>;
+export declare function moveIssue(ctx: Ctx, input: {
+    id: string;
+    columnId: string;
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+export declare function assignSprint(ctx: Ctx, input: {
+    id: string;
+    sprintId: string | null;
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+/**
+ * Leaves an issue's thread.
+ *
+ * The only way out of a subscription this module hands out freely: being
+ * assigned an issue, commenting on one, or being mentioned in one all
+ * subscribe you, and every comment afterwards reaches you. Without this the
+ * follower set only ever grows, and a single mention in a busy spec is a
+ * standing appointment nobody agreed to.
+ *
+ * Answers ok when there was nothing to remove, because "I do not want these"
+ * is satisfied either way.
+ */
+/**
+ * Take an issue off the board without pretending it was finished.
+ *
+ * `Issue.active` has been in the model and in four indexes since Flow was
+ * written, `issue.list` has taken `includeArchived`, and nothing has ever
+ * written `false` — so the only way to clear a cancelled task was to drop it in
+ * the done column, which made every progress figure lie about it.
+ *
+ * Under compare-and-set, unlike `page.archive`: an issue carries a version
+ * because two people work the same one, and archiving from a stale screen is
+ * exactly the kind of mistake that guard exists for.
+ *
+ * What archiving is *not*: it is not completion and it is not deletion.
+ * Dependencies stay, so an archived blocker still blocks — silently unblocking
+ * work is the worst way to clear a blocker (FLW-DEC-011). Sub-tasks keep their
+ * parent, so restoring a parent restores the branch as it was.
+ */
+export declare function archiveIssue(ctx: Ctx, input: {
+    id: string;
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+/**
+ * Put it back, exactly where it was.
+ *
+ * Unlike `page.restore` this needs no reparenting rule: a sub-task of an
+ * archived parent is still listed on every board and list of its own, so it
+ * cannot come back invisible the way a page under an archived page would.
+ */
+export declare function restoreIssue(ctx: Ctx, input: {
+    id: string;
+    expectedVersion: number;
+    idempotencyKey: string;
+}): Promise<FlowResult>;
+export declare function setIssueActive(ctx: Ctx, input: {
+    id: string;
+    expectedVersion: number;
+    idempotencyKey: string;
+}, active: boolean): Promise<FlowResult>;
+//# sourceMappingURL=issue-write.d.ts.map

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

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