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

package/dist/server/domains/workflows/built-in-rule-types.js

@@ -0,0 +1,260 @@
+import { CHECKLIST_ITEMS_MAX, CHECKLIST_ITEM_KEY_PATTERN, CHECKLIST_LABEL_MAX, isLocalizedMessage, messageText, MESSAGE_KEY_MAX, MESSAGE_NAMESPACE_PATTERN, NOTIFY_MESSAGE_MAX, START_LABEL_MAX, } from '../../../shared/workflows.js';
+import { addMissingItems, uncheckedRequired } from '../checklists/index.js';
+import './workflow.events.js';
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+function checklistIssues(config) {
+    const issues = [];
+    for (const field of Object.keys(config))
+        if (field !== 'items')
+            issues.push({ path: field, message: 'Unknown field.' });
+    const { items } = config;
+    if (!Array.isArray(items) ||
+        items.length === 0 ||
+        items.length > CHECKLIST_ITEMS_MAX)
+        return [
+            ...issues,
+            { path: 'items', message: `1 to ${CHECKLIST_ITEMS_MAX} items.` },
+        ];
+    const keys = new Set();
+    items.forEach((item, index) => {
+        const at = `items[${index}]`;
+        if (!isObject(item)) {
+            issues.push({
+                path: at,
+                message: 'An item is { key, label, required }.',
+            });
+            return;
+        }
+        for (const field of Object.keys(item))
+            if (!['key', 'label', 'required'].includes(field))
+                issues.push({ path: `${at}.${field}`, message: 'Unknown field.' });
+        if (typeof item.key !== 'string' ||
+            !CHECKLIST_ITEM_KEY_PATTERN.test(item.key))
+            issues.push({
+                path: `${at}.key`,
+                message: 'A key is 1 to 64 lowercase letters, digits, hyphens or underscores.',
+            });
+        else if (keys.has(item.key))
+            issues.push({
+                path: `${at}.key`,
+                message: `The key ${item.key} is used twice.`,
+            });
+        else
+            keys.add(item.key);
+        if (typeof item.label !== 'string' ||
+            !item.label.trim() ||
+            item.label.length > CHECKLIST_LABEL_MAX)
+            issues.push({
+                path: `${at}.label`,
+                message: `A label is 1 to ${CHECKLIST_LABEL_MAX} characters.`,
+            });
+        if (typeof item.required !== 'boolean')
+            issues.push({
+                path: `${at}.required`,
+                message: 'required is true or false.',
+            });
+    });
+    return issues;
+}
+/** Problems with a rule's message at `path`: text of at most `max` characters, or `{ key, ns, defaultValue }`. */
+function messageIssues(path, message, max) {
+    const issues = [];
+    if (message === undefined)
+        return issues;
+    if (isLocalizedMessage(message)) {
+        const fields = message;
+        for (const field of Object.keys(fields))
+            if (!['key', 'ns', 'defaultValue'].includes(field))
+                issues.push({ path: `${path}.${field}`, message: 'Unknown field.' });
+        if (!message.key.trim() || message.key.length > MESSAGE_KEY_MAX)
+            issues.push({
+                path: `${path}.key`,
+                message: `A message key is 1 to ${MESSAGE_KEY_MAX} characters.`,
+            });
+        if (fields.ns !== undefined &&
+            (typeof fields.ns !== 'string' ||
+                !MESSAGE_NAMESPACE_PATTERN.test(fields.ns)))
+            issues.push({ path: `${path}.ns`, message: 'Not a namespace.' });
+        if (fields.defaultValue !== undefined &&
+            (typeof fields.defaultValue !== 'string' ||
+                fields.defaultValue.length > max))
+            issues.push({
+                path: `${path}.defaultValue`,
+                message: `A message is at most ${max} characters.`,
+            });
+    }
+    else if (typeof message !== 'string' || message.length > max)
+        issues.push({
+            path,
+            message: `A message is text of at most ${max} characters, or { key, ns, defaultValue }.`,
+        });
+    return issues;
+}
+function notifyIssues(config) {
+    return [
+        ...Object.keys(config)
+            .filter((field) => field !== 'message')
+            .map((field) => ({ path: field, message: 'Unknown field.' })),
+        ...messageIssues('message', config.message, NOTIFY_MESSAGE_MAX),
+    ];
+}
+function startOptionIssues(config) {
+    return [
+        ...Object.keys(config)
+            .filter((field) => field !== 'label' && field !== 'hint')
+            .map((field) => ({ path: field, message: 'Unknown field.' })),
+        ...messageIssues('label', config.label, START_LABEL_MAX),
+        ...messageIssues('hint', config.hint, NOTIFY_MESSAGE_MAX),
+    ];
+}
+/** A valid rule's message as it is kept and sent: trimmed text, the key with what it has, or null for none. */
+export function ruleMessage(message) {
+    if (typeof message === 'string')
+        return message.trim() || null;
+    if (!isLocalizedMessage(message))
+        return null;
+    return {
+        key: message.key,
+        ...(message.ns ? { ns: message.ns } : {}),
+        ...(message.defaultValue?.trim()
+            ? { defaultValue: message.defaultValue.trim() }
+            : {}),
+    };
+}
+function noSettings(config) {
+    return Object.keys(config).map((field) => ({
+        path: field,
+        message: 'Unknown field.',
+    }));
+}
+export function builtInStatusRuleTypes(deps) {
+    return [
+        {
+            type: 'checklist',
+            validate: checklistIssues,
+            describe: (config) => ({
+                summary: `Gives the issue a checklist of ${Array.isArray(config.items) ? config.items.length : 0} item(s).`,
+            }),
+            async canLeave(check) {
+                if (check.status.category === 'closed')
+                    return null;
+                const missing = await uncheckedRequired(check.tx.conn, check.issue.id, check.from);
+                return missing.length === 0
+                    ? null
+                    : {
+                        code: 'CHECKLIST_INCOMPLETE',
+                        message: `Check the required items of ${check.from} first: ${missing.join('; ')}.`,
+                        details: { statusKey: check.from, items: missing },
+                    };
+            },
+            async entered(entry, config) {
+                const items = (config.items ?? []);
+                await addMissingItems(entry.tx.conn, () => deps.ids.next(), entry.issue.id, entry.status.key, items.map((item) => ({ ...item, label: item.label.trim() })));
+                return undefined;
+            },
+        },
+        {
+            type: 'notifyOwner',
+            validate: notifyIssues,
+            describe(config) {
+                // Described in the words it falls back to, not translated: the summary is the plugin's own English.
+                const message = messageText(config.message, (key, options) => options?.defaultValue ?? key);
+                return {
+                    summary: message
+                        ? `Notifies the issue owner: "${message}".`
+                        : 'Notifies the issue owner.',
+                };
+            },
+            async entered(entry, config) {
+                const { issue, actor, status } = entry;
+                if (actor.type === 'user' && actor.id === issue.ownerUserId)
+                    return { status: 'skipped', reason: 'ownerMovedIt' };
+                const message = ruleMessage(config.message);
+                await deps.activity.record(entry.tx.conn, {
+                    issueId: issue.id,
+                    actor,
+                    action: 'owner_notified',
+                    details: {
+                        statusKey: status.key,
+                        ownerUserId: issue.ownerUserId,
+                        message,
+                    },
+                });
+                entry.tx.emit({
+                    type: 'workflow.ownerNotified',
+                    issueId: issue.id,
+                    identifier: issue.identifier,
+                    title: issue.title,
+                    ownerUserId: issue.ownerUserId,
+                    statusKey: status.key,
+                    statusName: status.name,
+                    message,
+                });
+                return undefined;
+            },
+        },
+        {
+            type: 'subtasksDone',
+            validate: noSettings,
+            describe: () => ({ summary: 'Waits until every sub-issue is finished.' }),
+            async canEnter(check) {
+                if (check.status.category === 'closed')
+                    return null;
+                const open = await deps
+                    .relations()
+                    .openChildren(check.tx.conn, check.issue.id);
+                return open.length === 0
+                    ? null
+                    : {
+                        code: 'SUBTASKS_OPEN',
+                        message: `Finish the sub-issues first: ${open
+                            .slice(0, 10)
+                            .map((child) => child.identifier)
+                            .join(', ')}.`,
+                        details: {
+                            count: open.length,
+                            issues: open.slice(0, 10).map((child) => child.identifier),
+                        },
+                    };
+            },
+        },
+        {
+            type: 'blockersDone',
+            validate: noSettings,
+            describe: () => ({ summary: 'Waits until nothing blocks the issue.' }),
+            async canEnter(check) {
+                const blockers = await deps
+                    .relations()
+                    .blockers(check.tx.conn, check.issue);
+                return blockers.length === 0
+                    ? null
+                    : {
+                        code: 'ISSUE_BLOCKED',
+                        message: `The issue waits for ${blockers
+                            .map((blocker) => blocker.identifier)
+                            .join(', ')}.`,
+                        details: {
+                            blockers: blockers.map((blocker) => ({
+                                identifier: blocker.identifier,
+                                reason: blocker.reason,
+                            })),
+                        },
+                    };
+            },
+        },
+        {
+            type: 'startOption',
+            categories: ['unstarted', 'started'],
+            validate: startOptionIssues,
+            describe(config) {
+                const label = messageText(config.label, (key, options) => options?.defaultValue ?? key);
+                return {
+                    summary: label
+                        ? `Offered as "${label}" when creating an issue.`
+                        : 'Offered when creating an issue.',
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=built-in-rule-types.js.map

package/dist/server/domains/workflows/built-in-rule-types.js.map

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

package/dist/server/domains/workflows/event-types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Workflow events other plugins contribute (`projectsWorkflowEventsToken`), next to the built-in `subtasks.done`. A
+ * contributed event is a key and where a workflow may use it; this plugin never knows what it means. Its plugin fires
+ * it for the issues it concerns (`Projects.workflowEvents.fire`), and each issue moves along its workflow's transition
+ * on the event, if there is one.
+ *
+ * - A type is looked up on each use, so a plugin may add it after this plugin's services are created.
+ * - A definition may keep a transition on an event whose type is gone (its plugin was removed): saving leaves it as it
+ *   was, nobody fires it, and the editor shows it as unavailable. A new transition on it is refused.
+ * - `from` and `to` limit the categories of status a transition on the event may leave and enter, when saving.
+ */
+import { type WorkflowEventPlacement } from '../../../shared/workflows.js';
+export type WorkflowEventType = WorkflowEventPlacement;
+export interface WorkflowEventTypes {
+    /** Adds an event; returns what removes it. Throws when the key is taken, built in or malformed. */
+    add(type: WorkflowEventType): () => void;
+    get(key: string): WorkflowEventType | undefined;
+    list(): readonly WorkflowEventType[];
+}
+export declare function createWorkflowEventTypes(): WorkflowEventTypes;
+//# sourceMappingURL=event-types.d.ts.map

package/dist/server/domains/workflows/event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../../../server/domains/workflows/event-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,mGAAmG;IACnG,GAAG,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAChD,IAAI,IAAI,SAAS,iBAAiB,EAAE,CAAC;CACtC;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAoB7D"}

package/dist/server/domains/workflows/event-types.js

@@ -0,0 +1,31 @@
+/**
+ * Workflow events other plugins contribute (`projectsWorkflowEventsToken`), next to the built-in `subtasks.done`. A
+ * contributed event is a key and where a workflow may use it; this plugin never knows what it means. Its plugin fires
+ * it for the issues it concerns (`Projects.workflowEvents.fire`), and each issue moves along its workflow's transition
+ * on the event, if there is one.
+ *
+ * - A type is looked up on each use, so a plugin may add it after this plugin's services are created.
+ * - A definition may keep a transition on an event whose type is gone (its plugin was removed): saving leaves it as it
+ *   was, nobody fires it, and the editor shows it as unavailable. A new transition on it is refused.
+ * - `from` and `to` limit the categories of status a transition on the event may leave and enter, when saving.
+ */
+import { WORKFLOW_EVENT_PATTERN, isBuiltInEvent, } from '../../../shared/workflows.js';
+export function createWorkflowEventTypes() {
+    const types = new Map();
+    return {
+        add(type) {
+            if (!WORKFLOW_EVENT_PATTERN.test(type.key))
+                throw new TypeError(`Workflow event ${type.key} must match ${String(WORKFLOW_EVENT_PATTERN)}.`);
+            if (isBuiltInEvent(type.key) || types.has(type.key))
+                throw new TypeError(`Workflow event ${type.key} is registered already.`);
+            types.set(type.key, type);
+            return () => {
+                if (types.get(type.key) === type)
+                    types.delete(type.key);
+            };
+        },
+        get: (key) => types.get(key),
+        list: () => [...types.values()],
+    };
+}
+//# sourceMappingURL=event-types.js.map

package/dist/server/domains/workflows/event-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.js","sourceRoot":"","sources":["../../../../server/domains/workflows/event-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,sBAAsB,EACtB,cAAc,GAEf,MAAM,8BAA8B,CAAC;AAWtC,MAAM,UAAU,wBAAwB;IACtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC;IACnD,OAAO;QACL,GAAG,CAAC,IAAI;YACN,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;gBACxC,MAAM,IAAI,SAAS,CACjB,kBAAkB,IAAI,CAAC,GAAG,eAAe,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAC3E,CAAC;YACJ,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;gBACjD,MAAM,IAAI,SAAS,CACjB,kBAAkB,IAAI,CAAC,GAAG,yBAAyB,CACpD,CAAC;YACJ,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO,GAAG,EAAE;gBACV,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI;oBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3D,CAAC,CAAC;QACJ,CAAC;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/server/domains/workflows/index.d.ts

@@ -0,0 +1,10 @@
+export { createWorkflowService, type ProjectWorkflows, type WorkflowService, } from './workflow.service.js';
+export { createWorkflowRoutes } from './workflow.routes.js';
+export { createIssueRegistry, type ApproverDirectory, type RelationChecks, } from './workflow.registry.js';
+export { builtInStatusRuleTypes } from './built-in-rule-types.js';
+export { createStatusRuleTypes, withBuiltInTypes, type EnteredStatus, type StatusRuleCheck, type StatusRuleDescription, type StatusRuleEntry, type StatusRuleRefusal, type StatusRuleOutcome, type StatusRuleType, type StatusRuleTypes, } from './rule-types.js';
+export { createWorkflowTemplates, type WorkflowTemplate, type WorkflowTemplateInstaller, type WorkflowTemplateText, type WorkflowTemplates, } from './templates.js';
+export { describeRule, previewRules } from './workflow.diff.js';
+export { createWorkflowEventTypes, type WorkflowEventType, type WorkflowEventTypes, } from './event-types.js';
+export { createWorkflowEventService, type WorkflowEventFiring, type WorkflowEventMove, type WorkflowEventService, type WorkflowEventTarget, } from './workflow.fire.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/domains/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/domains/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/server/domains/workflows/index.js

@@ -0,0 +1,10 @@
+export { createWorkflowService, } from './workflow.service.js';
+export { createWorkflowRoutes } from './workflow.routes.js';
+export { createIssueRegistry, } from './workflow.registry.js';
+export { builtInStatusRuleTypes } from './built-in-rule-types.js';
+export { createStatusRuleTypes, withBuiltInTypes, } from './rule-types.js';
+export { createWorkflowTemplates, } from './templates.js';
+export { describeRule, previewRules } from './workflow.diff.js';
+export { createWorkflowEventTypes, } from './event-types.js';
+export { createWorkflowEventService, } from './workflow.fire.js';
+//# sourceMappingURL=index.js.map

package/dist/server/domains/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/domains/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAGtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,mBAAmB,GAGpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GASjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,GAKxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,wBAAwB,GAGzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,GAK3B,MAAM,oBAAoB,CAAC"}

package/dist/server/domains/workflows/rule-types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Status rule types: the ones other plugins contribute (`projectsStatusRulesToken`) and this plugin's own
+ * (`built-in-rule-types.ts`), which follow the same contract and are put in front of the contributed ones
+ * (`withBuiltInTypes`). A type names itself, checks its settings, says what it does in a sentence, and
+ * acts once an issue entered a status carrying it, inside the transaction of the move: what it cannot do there is a
+ * skip, not a refusal.
+ *
+ * A type may also hold an entry condition (`canEnter`): asked inside the move's transaction before the issue enters a
+ * status carrying the rule, it lets the move through (null) or refuses it with 400 (`FAILED_PRECONDITION`) and its own code. Every move asks
+ * it, whoever moves: a person, an agent, a plan's row, an approved request when it is applied, and the system moving
+ * an issue on a workflow event (`StatusRuleCheck.event` says which). A refusal of an event move does not fail the
+ * event: the issue stays, `auto_move_skipped` records the code, and the firer hears it as `refused`. A condition that
+ * should let the system through says so itself (`actor.type === 'system'`). Nothing is asked when the rule's plugin is
+ * gone. A type may likewise hold an exit condition (`canLeave`), asked before an issue leaves a status carrying the
+ * rule (the checklist waits for its required items this way).
+ *
+ * - A type is looked up on each use, so a plugin may add it after this plugin's services are created.
+ * - A definition may keep a rule whose type is gone (its plugin was removed): saving leaves it as it was, entering the
+ *   status skips it (`unavailable`), and the editor shows it as unavailable.
+ * - Each outcome is recorded on the issue (`stage_action_applied`, `stage_action_skipped` with `reason`, or
+ *   `stage_action_failed` when it throws); what the issue's owner should hear about is the type's to tell, through
+ *   the notice rules (`projectsNoticeRulesToken`).
+ */
+import type { Executor, Issue } from '../../../shared/issues.js';
+import type { StatusCategory } from '../../../shared/issues.js';
+import { type WorkflowValidationIssue } from '../../../shared/workflows.js';
+import type { Actor } from '../../kernel/actor.js';
+import type { Tx } from '../../kernel/tx.js';
+import type { RuleConfig } from '../../lifecycle/index.js';
+/** The status an issue entered, as a rule sees it. */
+export interface EnteredStatus {
+    readonly key: string;
+    /** As the workflow names it. */
+    readonly name: string;
+    readonly category: StatusCategory;
+}
+/** What a rule gets when an issue entered its status. */
+export interface StatusRuleEntry {
+    /** The move's transaction: what the rule writes commits with the move. Its events are kept only when it succeeds. */
+    readonly tx: Tx;
+    /** The issue as it is now, in the status it entered. */
+    readonly issue: Issue;
+    /** The status it came from. */
+    readonly from: string;
+    readonly status: EnteredStatus;
+    /** Who moved it: a person, the system, or a principal of another kind. */
+    readonly actor: Actor;
+    /**
+     * Makes `executor` the issue's executor, recorded as `executor_changed` with `trigger: 'stageEntered'`; the change
+     * reaches the executor's kind like any other once the move is announced. Returns the issue as it is then.
+     */
+    setExecutor(executor: Executor): Promise<Issue>;
+}
+/** What an entry or exit condition is asked, before the issue moves. */
+export interface StatusRuleCheck {
+    /** The move's transaction; read only. */
+    readonly tx: Tx;
+    /** The issue as it is before the move. */
+    readonly issue: Issue;
+    /** The status it would leave: the one carrying the rule, for an exit condition. */
+    readonly from: string;
+    /** The status it would enter. */
+    readonly status: EnteredStatus;
+    /** Who moves it: a person, the system, or a principal of another kind. */
+    readonly actor: Actor;
+    /** The workflow event the move answers, or null for an ordinary move. */
+    readonly event: string | null;
+}
+/**
+ * Why an entry condition refuses a move: reaches the caller as 400 with `code` (upper snake case, prefixed by the
+ * plugin so it cannot be mistaken for this plugin's own, such as `ACME_PR_NOT_MERGED`), the message, and `details`
+ * plus `rule` (the type) in the error's details.
+ */
+export interface StatusRuleRefusal {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+/** What a rule did; `undefined` counts as applied. `details` are recorded with it. */
+export type StatusRuleOutcome = undefined | {
+    readonly status: 'applied';
+    readonly details?: Readonly<Record<string, unknown>>;
+} | {
+    readonly status: 'skipped';
+    readonly reason: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+};
+/** A rule in a sentence, for a workflow's change summary. */
+export interface StatusRuleDescription {
+    /** English, such as "Runs Reviewer with an instruction." */
+    readonly summary: string;
+    /** Entering the status wakes someone without anybody confirming it: a change summary points it out. */
+    readonly attention?: boolean;
+}
+export interface StatusRuleType {
+    /** `^[a-z][A-Za-z0-9]{1,63}$`; a contributed type cannot take a built-in type's key. */
+    readonly type: string;
+    /** The categories of status it may be put on; every category when left out. */
+    readonly categories?: readonly StatusCategory[];
+    /** Problems with its settings, at paths relative to them (`agentId`). */
+    validate?(config: RuleConfig): readonly WorkflowValidationIssue[];
+    describe?(config: RuleConfig): StatusRuleDescription;
+    /** An entry condition: null lets the issue enter a status carrying the rule, a refusal stops the move (400). */
+    canEnter?(check: StatusRuleCheck, config: RuleConfig): Promise<StatusRuleRefusal | null>;
+    /** An exit condition: null lets the issue leave a status carrying the rule, a refusal stops the move (400). */
+    canLeave?(check: StatusRuleCheck, config: RuleConfig): Promise<StatusRuleRefusal | null>;
+    /**
+     * Runs after an issue entered a status carrying the rule; a failure never undoes the move. Left out by a type that
+     * is only a condition.
+     */
+    entered?(entry: StatusRuleEntry, config: RuleConfig): Promise<StatusRuleOutcome>;
+}
+export interface StatusRuleTypes {
+    /** Adds a contributed type; returns what removes it. Throws when the key is taken (or built in) or malformed. */
+    add(type: StatusRuleType): () => void;
+    get(type: string): StatusRuleType | undefined;
+    list(): readonly StatusRuleType[];
+}
+export declare function createStatusRuleTypes(): StatusRuleTypes;
+/**
+ * `types` with this plugin's own types in front: what the workflows domain looks every rule up in. `add` goes to
+ * `types`, so a plugin contributing through the view is the same as contributing through `types`.
+ */
+export declare function withBuiltInTypes(types: StatusRuleTypes, builtIn: readonly StatusRuleType[]): StatusRuleTypes;
+//# sourceMappingURL=rule-types.d.ts.map

package/dist/server/domains/workflows/rule-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-types.d.ts","sourceRoot":"","sources":["../../../../server/domains/workflows/rule-types.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/workflows/rule-types.js

@@ -0,0 +1,33 @@
+import { STATUS_RULE_TYPES, STATUS_RULE_TYPE_PATTERN, } from '../../../shared/workflows.js';
+export function createStatusRuleTypes() {
+    const types = new Map();
+    return {
+        add(type) {
+            if (!STATUS_RULE_TYPE_PATTERN.test(type.type))
+                throw new TypeError(`Status rule type ${type.type} must match ${String(STATUS_RULE_TYPE_PATTERN)}.`);
+            if (STATUS_RULE_TYPES.includes(type.type) ||
+                types.has(type.type))
+                throw new TypeError(`Status rule type ${type.type} is registered already.`);
+            types.set(type.type, type);
+            return () => {
+                if (types.get(type.type) === type)
+                    types.delete(type.type);
+            };
+        },
+        get: (type) => types.get(type),
+        list: () => [...types.values()],
+    };
+}
+/**
+ * `types` with this plugin's own types in front: what the workflows domain looks every rule up in. `add` goes to
+ * `types`, so a plugin contributing through the view is the same as contributing through `types`.
+ */
+export function withBuiltInTypes(types, builtIn) {
+    const own = new Map(builtIn.map((type) => [type.type, type]));
+    return {
+        add: (type) => types.add(type),
+        get: (type) => own.get(type) ?? types.get(type),
+        list: () => [...own.values(), ...types.list()],
+    };
+}
+//# sourceMappingURL=rule-types.js.map

package/dist/server/domains/workflows/rule-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-types.js","sourceRoot":"","sources":["../../../../server/domains/workflows/rule-types.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GAEzB,MAAM,8BAA8B,CAAC;AAkHtC,MAAM,UAAU,qBAAqB;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,OAAO;QACL,GAAG,CAAC,IAAI;YACN,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3C,MAAM,IAAI,SAAS,CACjB,oBAAoB,IAAI,CAAC,IAAI,eAAe,MAAM,CAAC,wBAAwB,CAAC,GAAG,CAChF,CAAC;YACJ,IACG,iBAAuC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC5D,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAEpB,MAAM,IAAI,SAAS,CACjB,oBAAoB,IAAI,CAAC,IAAI,yBAAyB,CACvD,CAAC;YACJ,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC3B,OAAO,GAAG,EAAE;gBACV,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI;oBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7D,CAAC,CAAC;QACJ,CAAC;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAC9B,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAsB,EACtB,OAAkC;IAElC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAC9B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAC/C,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/server/domains/workflows/templates.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Workflow templates other plugins contribute (`projectsWorkflowTemplatesToken`): built-in workflows this plugin
+ * cannot spell out itself, because they name another plugin's kinds or rule types (an agent runtime's agent moves and
+ * `runAgent`, say). The plugin itself ships no workflow: without one, every project uses the built-in statuses.
+ *
+ * A template is installed once (`WorkflowService.installTemplate`): it becomes a workflow marked with the template's
+ * key, validated like any other, and the default workflow when it says `makeDefault` and none is the default yet.
+ * People may then change, rename or delete it like any workflow; a deleted one is not installed again, because the
+ * settings remember every template installed.
+ *
+ * The plugin installs templates in the background, from its `boot()` on: those added before then at once, the others as
+ * they are added. `installed()` waits for them; the plugin awaits it in its `ready()` phase, so an application that
+ * starts the usual way serves no request before the templates its plugins added while booting are workflows.
+ */
+import type { KindTitle } from '../../../shared/kinds.js';
+import type { WorkflowDefinition } from '../../../shared/workflows.js';
+/** A template's translatable text: stored as `defaultValue`, shown as `key` in `ns` while unchanged. */
+export interface WorkflowTemplateText {
+    readonly key: string;
+    readonly ns: string;
+    readonly defaultValue: string;
+}
+export interface WorkflowTemplate {
+    /** The workflow's `builtInKey`: `^[a-z][A-Za-z0-9]{1,63}$`, unique across templates. */
+    readonly key: string;
+    /** Its stored name, in English; unique among workflows. */
+    readonly name: string;
+    /** Its name in the reader's language while nobody renamed it. */
+    readonly title?: KindTitle;
+    /**
+     * Its stored description: a plain string, or an i18n key in the contributing plugin's namespace whose
+     * `defaultValue` (English) is stored and translated for the reader while nobody changed it.
+     */
+    readonly description?: string | WorkflowTemplateText;
+    readonly definition: WorkflowDefinition;
+    /**
+     * Installed as the default workflow when no workflow is the default at that moment (and the issues on the built-in
+     * statuses all have their status in it). Afterwards the administrators choose the default.
+     */
+    readonly makeDefault?: boolean;
+}
+/** Installs one template; what it returns or throws is its own business (the plugin logs a failure). */
+export type WorkflowTemplateInstaller = (template: WorkflowTemplate) => Promise<unknown>;
+export interface WorkflowTemplates {
+    /** Adds a template; returns what removes it (an installed workflow stays). */
+    add(template: WorkflowTemplate): () => void;
+    get(key: string): WorkflowTemplate | undefined;
+    list(): readonly WorkflowTemplate[];
+    /**
+     * Resolves once every template added so far has been installed, or failed to be. Never rejects. A template added
+     * before the plugin booted waits for it, so call this after the plugins' `boot()` (from a provider's `boot()`
+     * registered after the plugins, or from `start()`/`ready()`).
+     */
+    installed(): Promise<void>;
+    /**
+     * Installs each template with `installer`: those added before now, then each one as it is added. The plugin calls it
+     * once, at boot; returns what stops it.
+     */
+    installWith(installer: WorkflowTemplateInstaller): () => void;
+}
+export declare function createWorkflowTemplates(): WorkflowTemplates;
+//# sourceMappingURL=templates.d.ts.map

package/dist/server/domains/workflows/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../server/domains/workflows/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,wGAAwG;AACxG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wGAAwG;AACxG,MAAM,MAAM,yBAAyB,GAAG,CACtC,QAAQ,EAAE,gBAAgB,KACvB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,GAAG,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;IAC5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC/C,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAAC;IACpC;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,yBAAyB,GAAG,MAAM,IAAI,CAAC;CAC/D;AAMD,wBAAgB,uBAAuB,IAAI,iBAAiB,CA8D3D"}