@nocobase/app-plugin-projects 0.0.0-stage → 0.1.0-beta.2

package/dist/server/domains/subtasks/subtask.events.d.ts

@@ -0,0 +1,40 @@
+import type { Executor } from '../../../shared/issues.js';
+import type { EventActor } from '../issues/issue.events.js';
+declare module '../../kernel/events.js' {
+    interface DomainEventMap {
+        /** Nothing holds the issue any more: what it waited for finished, was deleted, or stopped being a blocker. */
+        'issue.dependencyReleased': {
+            readonly issueId: string;
+            readonly identifier: string;
+            readonly title: string;
+            readonly ownerUserId: string;
+            readonly executor: Executor | null;
+            /** The issue that held it; its revision tells a later release of the same blocker from this one. */
+            readonly releasedBy: {
+                readonly issueId: string;
+                readonly identifier: string;
+                readonly revision: number;
+            };
+            /** Who finished or removed the blocker. */
+            readonly actor: EventActor;
+        };
+        /** Every live sub-issue of the parent (`all`), or every one of a stage, is finished. */
+        'issue.batchDone': {
+            readonly parentIssueId: string;
+            readonly identifier: string;
+            readonly title: string;
+            readonly ownerUserId: string;
+            readonly stage: number | null;
+            readonly all: boolean;
+            readonly childIssueIds: readonly string[];
+            /** The sub-issue that finished the batch. */
+            readonly finishedBy: {
+                readonly issueId: string;
+                readonly revision: number;
+            };
+            readonly actor: EventActor;
+        };
+    }
+}
+export {};
+//# sourceMappingURL=subtask.events.d.ts.map

package/dist/server/domains/subtasks/subtask.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.events.d.ts","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,cAAc;QACtB,8GAA8G;QAC9G,0BAA0B,EAAE;YAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;YAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;YAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;YACnC,oGAAoG;YACpG,QAAQ,CAAC,UAAU,EAAE;gBACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;aAC3B,CAAC;YACF,2CAA2C;YAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;SAC5B,CAAC;QACF,wFAAwF;QACxF,iBAAiB,EAAE;YACjB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;YAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;YAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;YAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YAC9B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;YACtB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;YAC1C,6CAA6C;YAC7C,QAAQ,CAAC,UAAU,EAAE;gBACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;aAC3B,CAAC;YACF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;SAC5B,CAAC;KACH;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/server/domains/subtasks/subtask.events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subtask.events.js.map

package/dist/server/domains/subtasks/subtask.events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.events.js","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.events.ts"],"names":[],"mappings":""}

package/dist/server/domains/subtasks/subtask.graph.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Issues waiting for each other must not form a cycle. An issue waits for the issues it is `blockedBy`, for its
+ * siblings of an earlier stage, and for its own sub-issues (a parent waits for its children). Any new cycle passes
+ * through the issue just changed, so after writing the change one search answers whether that issue can reach
+ * itself: write first, then verify, and roll back on a cycle.
+ *
+ * The search reads one layer at a time (three batched queries per layer) and stops at `DEPENDENCY_DEPTH_MAX` layers or
+ * `DEPENDENCY_NODES_MAX` issues.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+/** 400 `DEPENDENCY_CYCLE` (with the identifiers along the cycle) when the issue now waits for itself. */
+export declare function assertNoCycleThrough(conn: DatabaseConnection, issueId: string): Promise<void>;
+//# sourceMappingURL=subtask.graph.d.ts.map

package/dist/server/domains/subtasks/subtask.graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.graph.d.ts","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAwDvD,yGAAyG;AACzG,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/server/domains/subtasks/subtask.graph.js

@@ -0,0 +1,65 @@
+import { DEPENDENCY_DEPTH_MAX, DEPENDENCY_NODES_MAX, } from '../../../shared/subtasks.js';
+import { invalid } from '../../kernel/errors.js';
+import { findIssue, findIssues, liveChildren } from '../issues/index.js';
+import { outgoing } from './subtask.store.js';
+/** For each issue of the layer, the live issues it waits for. */
+async function waitsFor(conn, layer) {
+    const ids = layer.map((issue) => issue.id);
+    const result = new Map(ids.map((id) => [id, []]));
+    const edges = await outgoing(conn, ids, 'blockedBy');
+    const targets = new Map((await findIssues(conn, edges.map((edge) => edge.dependsOnIssueId)))
+        .filter((issue) => !issue.deletedAt)
+        .map((issue) => [issue.id, issue]));
+    for (const edge of edges) {
+        const target = targets.get(edge.dependsOnIssueId);
+        if (target)
+            result.get(edge.issueId)?.push(target);
+    }
+    for (const child of await liveChildren(conn, ids))
+        result.get(child.parentIssueId)?.push(child);
+    const staged = layer.filter((issue) => issue.parentIssueId && issue.stage !== null);
+    if (staged.length > 0) {
+        const siblings = await liveChildren(conn, staged.map((issue) => issue.parentIssueId));
+        for (const issue of staged)
+            for (const sibling of siblings)
+                if (sibling.id !== issue.id &&
+                    sibling.parentIssueId === issue.parentIssueId &&
+                    sibling.stage !== null &&
+                    sibling.stage < issue.stage)
+                    result.get(issue.id)?.push(sibling);
+    }
+    return result;
+}
+/** 400 `DEPENDENCY_CYCLE` (with the identifiers along the cycle) when the issue now waits for itself. */
+export async function assertNoCycleThrough(conn, issueId) {
+    const start = await findIssue(conn, issueId);
+    if (!start || start.deletedAt)
+        return;
+    const previous = new Map();
+    const seen = new Set([start.id]);
+    let layer = [start];
+    for (let depth = 0; layer.length > 0; depth += 1) {
+        if (depth >= DEPENDENCY_DEPTH_MAX || seen.size >= DEPENDENCY_NODES_MAX)
+            throw invalid('DEPENDENCY_TOO_DEEP', 'Too many issues wait for each other here to check this change.');
+        const next = [];
+        for (const [fromId, targets] of await waitsFor(conn, layer)) {
+            const from = layer.find((issue) => issue.id === fromId);
+            for (const target of targets) {
+                if (target.id === start.id) {
+                    const path = [start.identifier];
+                    for (let cursor = from; cursor && cursor.id !== start.id; cursor = previous.get(cursor.id))
+                        path.unshift(cursor.identifier);
+                    path.unshift(start.identifier);
+                    throw invalid('DEPENDENCY_CYCLE', `These issues would wait for each other: ${path.join(' → ')}.`, { via: path });
+                }
+                if (seen.has(target.id))
+                    continue;
+                seen.add(target.id);
+                previous.set(target.id, from);
+                next.push(target);
+            }
+        }
+        layer = next;
+    }
+}
+//# sourceMappingURL=subtask.graph.js.map

package/dist/server/domains/subtasks/subtask.graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.graph.js","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.graph.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/subtasks/subtask.notices.d.ts

@@ -0,0 +1,8 @@
+import type { DomainEvent } from '../../kernel/events.js';
+import type { ProjectNotice } from '../../tokens.js';
+import './subtask.events.js';
+type Translate = (key: string, options?: Record<string, unknown>) => string;
+export declare function dependencyReleasedNotice(event: DomainEvent<'issue.dependencyReleased'>, t: Translate): ProjectNotice | null;
+export declare function batchDoneNotice(event: DomainEvent<'issue.batchDone'>, t: Translate): ProjectNotice | null;
+export {};
+//# sourceMappingURL=subtask.notices.d.ts.map

package/dist/server/domains/subtasks/subtask.notices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.notices.d.ts","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.notices.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,qBAAqB,CAAC;AAE7B,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;AAa5E,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,CAAC,0BAA0B,CAAC,EAC9C,CAAC,EAAE,SAAS,GACX,aAAa,GAAG,IAAI,CA0BtB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,CAAC,iBAAiB,CAAC,EACrC,CAAC,EAAE,SAAS,GACX,aAAa,GAAG,IAAI,CAuBtB"}

package/dist/server/domains/subtasks/subtask.notices.js

@@ -0,0 +1,70 @@
+/**
+ * The notices sub-issues and dependencies send, as rules from an event to a notice: who is told and in which words
+ * (already in the application's default language, with `params` for an inbox that words them per reader). The
+ * provider (`providers/notifications.ts`) runs them after the change commits. Nobody is told about their own action.
+ *
+ * | Type                  | Event                       | Who                                                         |
+ * | --------------------- | --------------------------- | ----------------------------------------------------------- |
+ * | `dependency_released` | `issue.dependencyReleased`  | the executor when a person works on it; else, with nobody   |
+ * |                       |                             | working on it, the owner; other kinds of executor: nobody   |
+ * | `batch_done`          | `issue.batchDone`           | the parent's owner                                          |
+ */
+import { USER_KIND } from '../../../shared/kinds.js';
+import './subtask.events.js';
+const issuePath = (identifier) => `/issues/${encodeURIComponent(identifier)}`;
+/** `userIds` without whoever acted, when a person acted. */
+function others(userIds, actor) {
+    return userIds.filter((id) => !(actor.type === USER_KIND && actor.id === id));
+}
+export function dependencyReleasedNotice(event, t) {
+    const recipients = event.executor === null
+        ? [event.ownerUserId]
+        : event.executor.type === USER_KIND
+            ? [event.executor.id]
+            : [];
+    const userIds = others(recipients, event.actor);
+    if (userIds.length === 0)
+        return null;
+    return {
+        key: `pm:dependency-released:${event.issueId}:${event.releasedBy.issueId}:${event.releasedBy.revision}`,
+        kind: 'info',
+        type: 'dependency_released',
+        userIds,
+        title: t('notifications.dependencyReleased', {
+            identifier: event.identifier,
+            releasedBy: event.releasedBy.identifier,
+        }),
+        body: event.title,
+        path: issuePath(event.identifier),
+        issue: { id: event.issueId, identifier: event.identifier },
+        params: {
+            identifier: event.identifier,
+            releasedByIdentifier: event.releasedBy.identifier,
+        },
+    };
+}
+export function batchDoneNotice(event, t) {
+    const userIds = others([event.ownerUserId], event.actor);
+    if (userIds.length === 0)
+        return null;
+    return {
+        key: `pm:batch-done:${event.parentIssueId}:${event.stage ?? 'all'}:${event.finishedBy.issueId}:${event.finishedBy.revision}`,
+        kind: 'info',
+        type: 'batch_done',
+        userIds,
+        title: event.stage === null
+            ? t('notifications.batchDone', { identifier: event.identifier })
+            : t('notifications.batchDoneStage', {
+                identifier: event.identifier,
+                stage: event.stage,
+            }),
+        body: event.title,
+        path: issuePath(event.identifier),
+        issue: { id: event.parentIssueId, identifier: event.identifier },
+        params: {
+            identifier: event.identifier,
+            ...(event.stage === null ? {} : { stage: String(event.stage) }),
+        },
+    };
+}
+//# sourceMappingURL=subtask.notices.js.map

package/dist/server/domains/subtasks/subtask.notices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.notices.js","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.notices.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/subtasks/subtask.release.d.ts

@@ -0,0 +1,29 @@
+/**
+ * What finishing an issue (or deleting it, or removing what held another) sets off, in the transaction of the change:
+ *
+ * 1. Release: each issue that waited for it, or a later-stage sibling, that is unfinished and held by nothing now gets
+ *    one `issue.dependencyReleased` (and the `onUnblocked` hook).
+ * 2. Join: when it has a parent, the parent's row is written first (`lastActivityAt`), which locks it, so two siblings
+ *    finishing at once take turns here and the second reads what the first committed. Then, if every live sub-issue
+ *    is finished, one `issue.batchDone` for all of them and the workflow event `subtasks.done` on the parent; else, if
+ *    its stage is finished, one `issue.batchDone` for the stage.
+ *
+ * A parent the event moves to a finished status goes through the same steps, up the tree, in the same transaction.
+ */
+import type { Issue } from '../../../shared/issues.js';
+import type { Actor } from '../../kernel/actor.js';
+import type { Tx } from '../../kernel/tx.js';
+import { type IssueService, type IssueTriggers } from '../issues/index.js';
+import type { StatusCatalogs } from '../issues/index.js';
+import { type Catalogs } from './subtask.blocking.js';
+import './subtask.events.js';
+export interface ReleaseDeps {
+    readonly statuses: StatusCatalogs;
+    readonly triggers: () => IssueTriggers;
+    readonly issues: () => Pick<IssueService, 'fireEvent'>;
+}
+/** Tells the issue nothing holds it any more, when that is so. */
+export declare function releaseIfFree(deps: ReleaseDeps, tx: Tx, catalogs: Catalogs, issue: Issue, releasedBy: Issue, actor: Actor): Promise<void>;
+/** `finished` entered a finished status, or was deleted: release what waited for it, then join at its parent. */
+export declare function onTerminal(deps: ReleaseDeps, tx: Tx, finished: Issue, actor: Actor): Promise<void>;
+//# sourceMappingURL=subtask.release.d.ts.map

package/dist/server/domains/subtasks/subtask.release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.release.d.ts","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.release.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,qBAAqB,CAAC;AAE7B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,aAAa,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;CACxD;AAID,kEAAkE;AAClE,wBAAsB,aAAa,CACjC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,KAAK,EACjB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,IAAI,CAAC,CAmBf;AA+DD,iHAAiH;AACjH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,KAAK,EACf,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/server/domains/subtasks/subtask.release.js

@@ -0,0 +1,108 @@
+import { findIssue, findIssues, liveChildren, updateIssue, } from '../issues/index.js';
+import { blockersOf, catalogsFor } from './subtask.blocking.js';
+import { incoming } from './subtask.store.js';
+import './subtask.events.js';
+const eventActor = (actor) => ({ type: actor.type, id: actor.id });
+/** Tells the issue nothing holds it any more, when that is so. */
+export async function releaseIfFree(deps, tx, catalogs, issue, releasedBy, actor) {
+    if (issue.deletedAt || (await catalogs.terminal(issue)))
+        return;
+    if ((await blockersOf(tx.conn, catalogs, issue)).length > 0)
+        return;
+    await deps.triggers().onUnblocked?.(tx, { issue, releasedBy });
+    tx.emit({ type: 'issue.changed', issueId: issue.id });
+    tx.emit({
+        type: 'issue.dependencyReleased',
+        issueId: issue.id,
+        identifier: issue.identifier,
+        title: issue.title,
+        ownerUserId: issue.ownerUserId,
+        executor: issue.executor,
+        releasedBy: {
+            issueId: releasedBy.id,
+            identifier: releasedBy.identifier,
+            revision: releasedBy.revision,
+        },
+        actor: eventActor(actor),
+    });
+}
+async function join(deps, tx, catalogs, finished, actor) {
+    const parentId = finished.parentIssueId;
+    if (!parentId)
+        return;
+    const before = await findIssue(tx.conn, parentId);
+    if (!before || before.deletedAt)
+        return;
+    // Writing the parent's row locks it until the transaction ends: siblings finishing at once take turns here.
+    await updateIssue(tx.conn, parentId, {
+        lastActivityAt: new Date().toISOString(),
+    });
+    const parent = (await findIssue(tx.conn, parentId));
+    if (await catalogs.terminal(parent))
+        return;
+    const children = await liveChildren(tx.conn, [parentId]);
+    if (children.length === 0)
+        return;
+    const done = new Map();
+    for (const child of children)
+        done.set(child.id, await catalogs.terminal(child));
+    const batch = (stage, members) => {
+        tx.emit({
+            type: 'issue.batchDone',
+            parentIssueId: parent.id,
+            identifier: parent.identifier,
+            title: parent.title,
+            ownerUserId: parent.ownerUserId,
+            stage,
+            all: stage === null,
+            childIssueIds: members.map((child) => child.id),
+            finishedBy: { issueId: finished.id, revision: finished.revision },
+            actor: eventActor(actor),
+        });
+        tx.emit({ type: 'issue.changed', issueId: parent.id });
+    };
+    if (children.every((child) => done.get(child.id))) {
+        batch(null, children);
+        await deps.triggers().onSubtasksFinished?.(tx, {
+            parent,
+            stage: null,
+            childIssueIds: children.map((child) => child.id),
+        });
+        await deps
+            .issues()
+            .fireEvent(tx, parent.id, 'subtasks.done', { issueId: finished.id });
+        return;
+    }
+    if (finished.stage === null || finished.deletedAt)
+        return;
+    const stage = children.filter((child) => child.stage === finished.stage);
+    if (stage.length > 0 && stage.every((child) => done.get(child.id))) {
+        batch(finished.stage, stage);
+        await deps.triggers().onSubtasksFinished?.(tx, {
+            parent,
+            stage: finished.stage,
+            childIssueIds: stage.map((child) => child.id),
+        });
+    }
+}
+/** `finished` entered a finished status, or was deleted: release what waited for it, then join at its parent. */
+export async function onTerminal(deps, tx, finished, actor) {
+    const catalogs = catalogsFor(deps.statuses, tx.conn);
+    const waiting = (await incoming(tx.conn, [finished.id], 'blockedBy')).map((dependency) => dependency.issueId);
+    const candidates = await findIssues(tx.conn, waiting);
+    if (finished.parentIssueId && finished.stage !== null) {
+        const own = finished.stage;
+        for (const sibling of await liveChildren(tx.conn, [finished.parentIssueId]))
+            if (sibling.stage !== null && sibling.stage > own)
+                candidates.push(sibling);
+    }
+    const seen = new Set([finished.id]);
+    for (const candidate of candidates.sort((a, b) => a.number - b.number)) {
+        if (seen.has(candidate.id))
+            continue;
+        seen.add(candidate.id);
+        await releaseIfFree(deps, tx, catalogs, candidate, finished, actor);
+    }
+    await join(deps, tx, catalogs, finished, actor);
+}
+//# sourceMappingURL=subtask.release.js.map

package/dist/server/domains/subtasks/subtask.release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.release.js","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.release.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/subtasks/subtask.routes.d.ts

@@ -0,0 +1,10 @@
+import type { Hono } from 'hono';
+import { type ViewerEnv } from '../../access/request.js';
+import type { SubtaskService } from './subtask.service.js';
+/**
+ * Under `/api/projects/issues`: `POST /{issueId}/dependencies` (201, the link as the issue page shows it),
+ * `DELETE /{issueId}/dependencies/{dependencyId}` and `POST /{issueId}/removeDependency { dependsOnIssueId, type? }`
+ * (204), which removes the link by the other issue.
+ */
+export declare function createSubtaskRoutes(subtasks: SubtaskService): Hono<ViewerEnv>;
+//# sourceMappingURL=subtask.routes.d.ts.map

package/dist/server/domains/subtasks/subtask.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.routes.d.ts","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.routes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAC;AASjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,CAyJ7E"}

package/dist/server/domains/subtasks/subtask.routes.js

@@ -0,0 +1,131 @@
+import { apiErrorResponse, apiErrorResponses, apiValidator, cliRoute, dataResponse, describeRoute, emptyResponse, } from '@nocobase/app-server/router';
+import { delegatedWrite, viewerOf, } from '../../access/request.js';
+import { domainRouter, personOrRunSecurity, tags } from '../../kernel/http.js';
+import { AddDependencyBody, DependencyParams, IssueDependencySchema, IssueParams, RemoveDependencyBody, } from '../../routes/schemas.js';
+const access = 'Needs `edit` on the issue. `issueId` and `dependsOnIssueId` are ids or identifiers.';
+/**
+ * Under `/api/projects/issues`: `POST /{issueId}/dependencies` (201, the link as the issue page shows it),
+ * `DELETE /{issueId}/dependencies/{dependencyId}` and `POST /{issueId}/removeDependency { dependsOnIssueId, type? }`
+ * (204), which removes the link by the other issue.
+ */
+export function createSubtaskRoutes(subtasks) {
+    const routes = domainRouter();
+    routes.post('/:issueId/dependencies', describeRoute({
+        tags,
+        summary: 'Add a dependency to an issue',
+        operationId: 'projectsAddIssueDependency',
+        security: personOrRunSecurity,
+        ...cliRoute({
+            command: 'issue dependency add',
+            args: ['issueId', 'dependsOnIssueId'],
+            flags: {
+                issueId: { name: 'issue' },
+                dependsOnIssueId: {
+                    name: 'dependsOn',
+                    description: 'The issue it waits for, by identifier or id.',
+                },
+            },
+            action: 'pm.issues/edit',
+        }),
+        description: `${access} \`blockedBy\` (the default) holds the issue until the other is finished; \`relatedTo\` only links them.`,
+        responses: {
+            201: dataResponse(IssueDependencySchema),
+            ...apiErrorResponses,
+            400: apiErrorResponse(400, 'When `dependsOnIssueId` names no issue the caller sees or the issue itself (`INVALID_DEPENDENCY`), or the link would make issues wait in a cycle (`DEPENDENCY_CYCLE`) or too deep a chain (`DEPENDENCY_TOO_DEEP`).'),
+            404: apiErrorResponse(404),
+            409: apiErrorResponse(409, 'When the issues are already linked (`DEPENDENCY_EXISTS`).'),
+        },
+    }), apiValidator('param', IssueParams), apiValidator('json', AddDependencyBody), async (context) => {
+        const { issueId } = context.req.valid('param');
+        const input = context.req.valid('json');
+        const delegated = await delegatedWrite(context, {
+            title: `Link ${issueId} and ${input.dependsOnIssueId}`,
+            rows: [
+                {
+                    op: 'dependency',
+                    params: {
+                        action: 'add',
+                        issue: issueId,
+                        dependsOn: input.dependsOnIssueId,
+                        type: input.type ?? 'blockedBy',
+                    },
+                },
+            ],
+        });
+        if (delegated)
+            return context.json({
+                data: delegated.plan.rows[0]?.result?.created ?? null,
+                meta: delegated.meta,
+            }, 201);
+        return context.json({
+            data: await subtasks.addDependency(viewerOf(context), issueId, input),
+        }, 201);
+    });
+    routes.delete('/:issueId/dependencies/:dependencyId', describeRoute({
+        tags,
+        summary: 'Remove a dependency by its id',
+        operationId: 'projectsDeleteIssueDependency',
+        // The issue page removes a link by its row; `issue dependency remove` names the other issue instead.
+        ...cliRoute(false),
+        description: access,
+        responses: {
+            204: emptyResponse(),
+            ...apiErrorResponses,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', DependencyParams), async (context) => {
+        const { issueId, dependencyId } = context.req.valid('param');
+        await subtasks.removeDependency(viewerOf(context), issueId, dependencyId);
+        return context.body(null, 204);
+    });
+    routes.post('/:issueId/removeDependency', describeRoute({
+        tags,
+        summary: 'Remove a dependency by the other issue',
+        operationId: 'projectsRemoveIssueDependency',
+        security: personOrRunSecurity,
+        ...cliRoute({
+            command: 'issue dependency remove',
+            args: ['issueId', 'dependsOnIssueId'],
+            flags: {
+                issueId: { name: 'issue' },
+                dependsOnIssueId: {
+                    name: 'dependsOn',
+                    description: 'The issue it waits for, by identifier or id.',
+                },
+            },
+            action: 'pm.issues/edit',
+        }),
+        description: `${access} Removes the link of \`type\` (\`blockedBy\` by default) to \`dependsOnIssueId\`.`,
+        responses: {
+            200: {
+                description: 'For a caller acting for someone else, such as an agent in a conversation: the link was removed as an undoable plan of theirs, described in `meta`.',
+            },
+            204: emptyResponse(),
+            ...apiErrorResponses,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', IssueParams), apiValidator('json', RemoveDependencyBody), async (context) => {
+        const { dependsOnIssueId, type } = context.req.valid('json');
+        const { issueId } = context.req.valid('param');
+        const delegated = await delegatedWrite(context, {
+            title: `Unlink ${issueId} and ${dependsOnIssueId}`,
+            rows: [
+                {
+                    op: 'dependency',
+                    params: {
+                        action: 'remove',
+                        issue: issueId,
+                        dependsOn: dependsOnIssueId,
+                        type: type ?? 'blockedBy',
+                    },
+                },
+            ],
+        });
+        if (delegated)
+            return context.json({ data: null, meta: delegated.meta });
+        await subtasks.removeDependencyTo(viewerOf(context), context.req.valid('param').issueId, dependsOnIssueId, type);
+        return context.body(null, 204);
+    });
+    return routes;
+}
+//# sourceMappingURL=subtask.routes.js.map

package/dist/server/domains/subtasks/subtask.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.routes.js","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.routes.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/subtasks/subtask.service.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Sub-issues and dependencies. People link issues on the issue page: an issue can wait for others (`blockedBy`) or be
+ * linked to them (`relatedTo`), and sub-issues with a stage wait for the earlier stages. Linking needs `pm.issues/edit`
+ * and both issues visible; the "blocks" side is read-only (the link belongs to the issue that waits).
+ *
+ * Toward the issues domain this implements `IssueRelations` (linking on create, cycle checks, release and join), the
+ * extras the issue page and list show, and the checks the `subtasksDone` and `blockersDone` workflow rules make.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import type { Issue } from '../../../shared/issues.js';
+import { type AddDependencyRequest, type Blocker, type IssueDependency } from '../../../shared/subtasks.js';
+import type { Viewer } from '../../access/viewer.js';
+import type { ActivityRecorder } from '../../kernel/activity.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { KindRegistry } from '../../kernel/kinds.js';
+import type { TxRunner } from '../../kernel/tx.js';
+import { type IssueExtras, type IssueRelations } from '../issues/index.js';
+import type { RelationChecks } from '../workflows/index.js';
+import { type ReleaseDeps } from './subtask.release.js';
+export interface SubtaskService {
+    addDependency(viewer: Viewer, idOrKey: string, input: AddDependencyRequest): Promise<IssueDependency>;
+    removeDependency(viewer: Viewer, idOrKey: string, dependencyId: string): Promise<void>;
+    /** By the other issue and type (`blockedBy` when left out). */
+    removeDependencyTo(viewer: Viewer, idOrKey: string, dependsOnIssueId: string, type?: string): Promise<void>;
+    /** What holds the issue now, visible or not; for other plugins (an executor's work waits on it). */
+    blockersOf(conn: DatabaseConnection, issue: Issue): Promise<Blocker[]>;
+    /**
+     * What holds each of the issues the viewer sees among `issueIds` now, leaving out the blockers they may not see, in a
+     * fixed number of reads; for another plugin's board (what an agent's work waits for). Issues they may not see, and
+     * issues nothing holds, are not in the map.
+     */
+    visibleBlockers(viewer: Viewer, issueIds: readonly string[]): Promise<Map<string, Blocker[]>>;
+    readonly relations: IssueRelations;
+    readonly checks: RelationChecks;
+    readonly extras: Pick<IssueExtras, 'relations' | 'listCounts'>;
+}
+export interface SubtaskDeps extends ReleaseDeps {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly activity: ActivityRecorder;
+    readonly kinds: KindRegistry;
+}
+export declare function createSubtaskService(deps: SubtaskDeps): SubtaskService;
+//# sourceMappingURL=subtask.service.d.ts.map

package/dist/server/domains/subtasks/subtask.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask.service.d.ts","sourceRoot":"","sources":["../../../../server/domains/subtasks/subtask.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,OAAO,EAEZ,KAAK,eAAe,EAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAM,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAQL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAS5D,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAW9B,MAAM,WAAW,cAAc;IAC7B,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,+DAA+D;IAC/D,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,oGAAoG;IACpG,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACvE;;;;OAIG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAYD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CA8XtE"}