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

package/dist/shared/projects.d.ts

@@ -0,0 +1,134 @@
+import type { Priority, UserRef } from './common.js';
+export declare const PROJECT_VISIBILITIES: readonly ["everyone", "members"];
+/** `everyone`: every member sees it; `members`: only its members and whoever may see every project. */
+export type ProjectVisibility = (typeof PROJECT_VISIBILITIES)[number];
+export declare const PROJECT_STATUSES: readonly ["planned", "in_progress", "paused", "completed", "cancelled"];
+export type ProjectStatus = (typeof PROJECT_STATUSES)[number];
+export interface Project {
+    readonly id: string;
+    readonly name: string;
+    /** Markdown. */
+    readonly description: string | null;
+    readonly visibility: ProjectVisibility;
+    readonly status: ProjectStatus;
+    readonly priority: Priority;
+    /** The one project lead, always also a member. */
+    readonly leadUserId: string | null;
+    readonly startDate: string | null;
+    readonly dueDate: string | null;
+    /**
+     * The issue that sets the project up (created with `projectSetup`): until it is finished, every issue created in the
+     * project is created waiting for it (`blockedBy`). Null when there is none.
+     */
+    readonly setupIssueId: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface IssueCounts {
+    readonly total: number;
+    /** Issues in a status of the `done` category. */
+    readonly done: number;
+    readonly byStatus: Readonly<Record<string, number>>;
+}
+export interface ProjectListItem extends Project {
+    readonly lead: UserRef | null;
+    readonly memberCount: number;
+    readonly issueCounts: IssueCounts;
+}
+/**
+ * What a project's working directory is: a git repository, checked out for each piece of work, or a directory that
+ * already exists on one machine that runs agents, used in place.
+ */
+export declare const PROJECT_RESOURCE_TYPES: readonly ["gitRepo", "directory"];
+export type ProjectResourceType = (typeof PROJECT_RESOURCE_TYPES)[number];
+/**
+ * Where a git repository is hosted, as the application that linked it records it: the host (`github`), the connection
+ * it reaches the repository through, the host's id of the repository and its `owner/name`. This plugin stores it and
+ * never interprets it.
+ */
+export interface ProjectResourceBinding {
+    readonly provider: string;
+    readonly connectionId: string;
+    readonly repoId: string;
+    readonly fullName: string;
+}
+/**
+ * A working directory of the project. The project's directories are ordered (`position`); the first is the primary
+ * one, where work starts.
+ */
+export interface ProjectResource {
+    readonly id: string;
+    readonly projectId: string;
+    readonly type: ProjectResourceType;
+    /** `gitRepo`: the remote. */
+    readonly url: string | null;
+    /** `gitRepo`: the base branch, tag or commit; null for the remote's default branch. */
+    readonly defaultRef: string | null;
+    /** `gitRepo`: the repository on its host, when it was linked through one; null for a remote given by URL alone. */
+    readonly binding: ProjectResourceBinding | null;
+    /**
+     * `directory`: the machine that holds it, as the plugin that runs agents names its machines (its runner id); this
+     * plugin stores it and never interprets it.
+     */
+    readonly runnerId: string | null;
+    /** `directory`: its absolute path on that machine. */
+    readonly path: string | null;
+    readonly label: string | null;
+    /**
+     * What to do in the directory before working in it for the first time (`run pnpm install, then copy .env.example to
+     * .env`): plain text given to whoever works there when the directory was just prepared for them; never run as a
+     * script.
+     */
+    readonly initPrompt: string | null;
+    readonly position: number;
+}
+export interface ProjectDetail extends ProjectListItem {
+    readonly members: readonly UserRef[];
+    readonly resources: readonly ProjectResource[];
+}
+export interface CreateProjectRequest {
+    readonly name: string;
+    readonly description?: string | null;
+    readonly visibility?: ProjectVisibility;
+    readonly status?: ProjectStatus;
+    readonly priority?: Priority;
+    /** Defaults to the creator. */
+    readonly leadUserId?: string | null;
+    readonly startDate?: string | null;
+    readonly dueDate?: string | null;
+}
+export type UpdateProjectRequest = Partial<CreateProjectRequest>;
+export interface AddProjectMemberRequest {
+    readonly userId: string;
+}
+export interface CreateProjectResourceRequest {
+    readonly type: ProjectResourceType;
+    /** Required for `gitRepo`. */
+    readonly url?: string | null;
+    readonly defaultRef?: string | null;
+    /** `gitRepo` only. */
+    readonly binding?: ProjectResourceBinding | null;
+    /** Required for `directory`. */
+    readonly runnerId?: string | null;
+    /** Required for `directory`: absolute. */
+    readonly path?: string | null;
+    readonly label?: string | null;
+    readonly initPrompt?: string | null;
+}
+/** The type does not change; fields of the other type are refused. */
+export interface UpdateProjectResourceRequest {
+    readonly url?: string;
+    readonly defaultRef?: string | null;
+    /** `gitRepo` only; null unlinks it from its host. */
+    readonly binding?: ProjectResourceBinding | null;
+    readonly runnerId?: string;
+    readonly path?: string;
+    readonly label?: string | null;
+    readonly initPrompt?: string | null;
+    readonly position?: number;
+}
+/** An absolute path: POSIX (`/srv/app`) or Windows (`C:\\work\\app`). */
+export declare function isAbsoluteDirectory(value: string): boolean;
+export declare const RESOURCE_INIT_PROMPT_MAX = 10000;
+export declare const PROJECT_NAME_MAX = 255;
+//# sourceMappingURL=projects.d.ts.map

package/dist/shared/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../shared/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,oBAAoB,kCAAmC,CAAC;AACrE,uGAAuG;AACvG,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,eAAO,MAAM,gBAAgB,yEAMnB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,mCAAoC,CAAC;AAExE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,6BAA6B;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uFAAuF;IACvF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mHAAmH;IACnH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,sBAAsB;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACjD,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,sEAAsE;AACtE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,eAAO,MAAM,gBAAgB,MAAM,CAAC"}

package/dist/shared/projects.js

@@ -0,0 +1,23 @@
+export const PROJECT_VISIBILITIES = ['everyone', 'members'];
+export const PROJECT_STATUSES = [
+    'planned',
+    'in_progress',
+    'paused',
+    'completed',
+    'cancelled',
+];
+/**
+ * What a project's working directory is: a git repository, checked out for each piece of work, or a directory that
+ * already exists on one machine that runs agents, used in place.
+ */
+export const PROJECT_RESOURCE_TYPES = ['gitRepo', 'directory'];
+/** An absolute path: POSIX (`/srv/app`) or Windows (`C:\\work\\app`). */
+export function isAbsoluteDirectory(value) {
+    const path = value.trim();
+    return ((path.startsWith('/') || /^[A-Za-z]:[\\/]/u.test(path)) &&
+        !path.split(/[\\/]/u).some((part) => part === '..') &&
+        path.length <= 1024);
+}
+export const RESOURCE_INIT_PROMPT_MAX = 10_000;
+export const PROJECT_NAME_MAX = 255;
+//# sourceMappingURL=projects.js.map

package/dist/shared/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../shared/projects.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,SAAS,CAAU,CAAC;AAIrE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS;IACT,aAAa;IACb,QAAQ;IACR,WAAW;IACX,WAAW;CACH,CAAC;AAqCX;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAAS,EAAE,WAAW,CAAU,CAAC;AAkGxE,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,OAAO,CACL,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;QACnD,IAAI,CAAC,MAAM,IAAI,IAAI,CACpB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC"}

package/dist/shared/realtime.d.ts

@@ -0,0 +1,18 @@
+/**
+ * What the server announces when this plugin's data changes, once for the events of a moment. The event names the kind
+ * of data and, for issues, at most which issues changed (their ids, never their content): an open page refetches what
+ * it shows of them, and the server decides what each viewer may see.
+ */
+export declare const PM_REALTIME_TOPIC = "pm:changes";
+export type PmChangeDomain = 'issues' | 'labels' | 'plans';
+export interface PmChangeEvent {
+    readonly kind: 'pm.changed';
+    readonly domain: PmChangeDomain;
+    /**
+     * The issues that changed, when every change named one and none moved an issue into or out of a list (created,
+     * deleted, restored, owner, status, project, parent or executor changed). Absent, any issue may have changed, and
+     * which issues a list or a project holds may have changed too.
+     */
+    readonly issueIds?: readonly string[];
+}
+//# sourceMappingURL=realtime.d.ts.map

package/dist/shared/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../shared/realtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC"}

package/dist/shared/realtime.js

@@ -0,0 +1,7 @@
+/**
+ * What the server announces when this plugin's data changes, once for the events of a moment. The event names the kind
+ * of data and, for issues, at most which issues changed (their ids, never their content): an open page refetches what
+ * it shows of them, and the server decides what each viewer may see.
+ */
+export const PM_REALTIME_TOPIC = 'pm:changes';
+//# sourceMappingURL=realtime.js.map

package/dist/shared/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../shared/realtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC"}

package/dist/shared/settings.d.ts

@@ -0,0 +1,9 @@
+/** Workspace settings (`GET` / `PATCH /api/projects/settings`). */
+export interface WorkspaceSettings {
+    /** The prefix of new issue identifiers (`PM-12`); existing identifiers keep theirs. */
+    readonly issuePrefix: string;
+}
+export type UpdateSettingsRequest = Partial<WorkspaceSettings>;
+/** Upper-case letters and digits, starting with a letter. */
+export declare const ISSUE_PREFIX_PATTERN: RegExp;
+//# sourceMappingURL=settings.d.ts.map

package/dist/shared/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../shared/settings.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/D,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,EAAE,MAAgC,CAAC"}

package/dist/shared/settings.js

@@ -0,0 +1,3 @@
+/** Upper-case letters and digits, starting with a letter. */
+export const ISSUE_PREFIX_PATTERN = /^[A-Z][A-Z0-9]{0,9}$/u;
+//# sourceMappingURL=settings.js.map

package/dist/shared/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../shared/settings.ts"],"names":[],"mappings":"AAQA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAW,uBAAuB,CAAC"}

package/dist/shared/statuses.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The six statuses every issue moves through. They are fixed: no project adds, renames or removes one.
+ *
+ * - `backlog`: waiting; nothing starts there.
+ * - `in_progress`: being worked on. Creating an issue there, or moving it there, starts the work its executor was given.
+ * - `blocked`: waiting for a person to decide something; its owner is told.
+ * - `in_review`: done and waiting to be accepted; its owner is told.
+ * - `done` and `cancelled`: finished.
+ *
+ * People move an issue between any two of them. Other kinds of principal move it only where their kind allows
+ * (`PrincipalKind.moves`), and the system only along a status event another plugin registered
+ * (`projectsStatusEventsToken`), such as a merged pull request.
+ */
+import type { StatusCategory, StatusDefinition } from './issues.js';
+export declare const STATUS_CATEGORIES: readonly StatusCategory[];
+export declare const BACKLOG_STATUS = "backlog";
+export declare const IN_PROGRESS_STATUS = "in_progress";
+export declare const BLOCKED_STATUS = "blocked";
+export declare const IN_REVIEW_STATUS = "in_review";
+export declare const DONE_STATUS = "done";
+export declare const CANCELLED_STATUS = "cancelled";
+/** The fixed statuses, in order. Names are English; the browser shows each in the viewer's language. */
+export declare const FIXED_STATUSES: readonly StatusDefinition[];
+export declare const STATUS_KEYS: readonly string[];
+/** The statuses a new issue may start in: right away, or later. */
+export declare const START_STATUSES: readonly string[];
+/** Where a new issue starts when its creator names no status: nothing starts. */
+export declare const DEFAULT_START_STATUS: string;
+/** The owner is told when an issue enters one of these. */
+export declare const OWNER_NOTIFIED_STATUSES: readonly string[];
+export declare function isFixedStatus(key: string): boolean;
+export declare function statusCategory(key: string): StatusCategory | null;
+export declare function statusOf(key: string): StatusDefinition | null;
+export declare function isTerminalCategory(category: StatusCategory | null): boolean;
+/** Whether a status still has its fixed English name, so the interface shows the translation instead. */
+export declare function hasDefaultName(status: {
+    readonly key: string;
+    readonly name: string;
+}): boolean;
+/** A status event's key: dotted, its plugin's prefix first, such as `acme.merged`. */
+export declare const STATUS_EVENT_PATTERN: RegExp;
+//# sourceMappingURL=statuses.d.ts.map

package/dist/shared/statuses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statuses.d.ts","sourceRoot":"","sources":["../../shared/statuses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAKtD,CAAC;AAEF,eAAO,MAAM,cAAc,YAAY,CAAC;AACxC,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,eAAO,MAAM,cAAc,YAAY,CAAC;AACxC,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAC5C,eAAO,MAAM,WAAW,SAAS,CAAC;AAClC,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,wGAAwG;AACxG,eAAO,MAAM,cAAc,EAAE,SAAS,gBAAgB,EA2BrD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAExC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAG3C,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,MAAuB,CAAC;AAE3D,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAGpD,CAAC;AAEF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEjE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAE3E;AAED,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAIV;AAED,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,EAAE,MACyB,CAAC"}

package/dist/shared/statuses.js

@@ -0,0 +1,73 @@
+export const STATUS_CATEGORIES = [
+    'unstarted',
+    'started',
+    'done',
+    'closed',
+];
+export const BACKLOG_STATUS = 'backlog';
+export const IN_PROGRESS_STATUS = 'in_progress';
+export const BLOCKED_STATUS = 'blocked';
+export const IN_REVIEW_STATUS = 'in_review';
+export const DONE_STATUS = 'done';
+export const CANCELLED_STATUS = 'cancelled';
+/** The fixed statuses, in order. Names are English; the browser shows each in the viewer's language. */
+export const FIXED_STATUSES = [
+    {
+        key: BACKLOG_STATUS,
+        name: 'Backlog',
+        category: 'unstarted',
+        color: 'gray',
+    },
+    {
+        key: IN_PROGRESS_STATUS,
+        name: 'In progress',
+        category: 'started',
+        color: 'yellow',
+    },
+    { key: BLOCKED_STATUS, name: 'Blocked', category: 'started', color: 'red' },
+    {
+        key: IN_REVIEW_STATUS,
+        name: 'In review',
+        category: 'started',
+        color: 'purple',
+    },
+    { key: DONE_STATUS, name: 'Done', category: 'done', color: 'green' },
+    {
+        key: CANCELLED_STATUS,
+        name: 'Cancelled',
+        category: 'closed',
+        color: 'gray',
+    },
+];
+export const STATUS_KEYS = FIXED_STATUSES.map((status) => status.key);
+/** The statuses a new issue may start in: right away, or later. */
+export const START_STATUSES = [
+    IN_PROGRESS_STATUS,
+    BACKLOG_STATUS,
+];
+/** Where a new issue starts when its creator names no status: nothing starts. */
+export const DEFAULT_START_STATUS = BACKLOG_STATUS;
+/** The owner is told when an issue enters one of these. */
+export const OWNER_NOTIFIED_STATUSES = [
+    BLOCKED_STATUS,
+    IN_REVIEW_STATUS,
+];
+export function isFixedStatus(key) {
+    return STATUS_KEYS.includes(key);
+}
+export function statusCategory(key) {
+    return FIXED_STATUSES.find((status) => status.key === key)?.category ?? null;
+}
+export function statusOf(key) {
+    return FIXED_STATUSES.find((status) => status.key === key) ?? null;
+}
+export function isTerminalCategory(category) {
+    return category === 'done' || category === 'closed';
+}
+/** Whether a status still has its fixed English name, so the interface shows the translation instead. */
+export function hasDefaultName(status) {
+    return FIXED_STATUSES.some((fixed) => fixed.key === status.key && fixed.name === status.name);
+}
+/** A status event's key: dotted, its plugin's prefix first, such as `acme.merged`. */
+export const STATUS_EVENT_PATTERN = /^[a-z][a-zA-Z0-9]{0,31}(\.[a-z][a-zA-Z0-9]{0,63}){1,3}$/u;
+//# sourceMappingURL=statuses.js.map

package/dist/shared/statuses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statuses.js","sourceRoot":"","sources":["../../shared/statuses.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,iBAAiB,GAA8B;IAC1D,WAAW;IACX,SAAS;IACT,MAAM;IACN,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE5C,wGAAwG;AACxG,MAAM,CAAC,MAAM,cAAc,GAAgC;IACzD;QACE,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,MAAM;KACd;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,QAAQ;KAChB;IACD,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE;IAC3E;QACE,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,QAAQ;KAChB;IACD,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;IACpE;QACE,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,MAAM;KACd;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAsB,cAAc,CAAC,GAAG,CAC9D,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CACvB,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,kBAAkB;IAClB,cAAc;CACf,CAAC;AAEF,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAW,cAAc,CAAC;AAE3D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,cAAc;IACd,gBAAgB;CACjB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAA+B;IAChE,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,QAAQ,CAAC;AACtD,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,cAAc,CAAC,MAG9B;IACC,OAAO,cAAc,CAAC,IAAI,CACxB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAClE,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAC/B,0DAA0D,CAAC"}

package/dist/shared/subscriptions.d.ts

@@ -0,0 +1,13 @@
+/** Who follows an issue and why. Following brings its comments and status changes to the inbox. */
+export declare const SUBSCRIPTION_REASONS: readonly ["creator", "owner", "executor", "commenter", "mentioned", "manual"];
+export type SubscriptionReason = (typeof SUBSCRIPTION_REASONS)[number];
+export interface IssueSubscriber {
+    readonly userId: string;
+    readonly name: string;
+    readonly reason: SubscriptionReason;
+}
+/** `POST /api/projects/issues/{issueId}/subscribe` and `/unsubscribe`. */
+export interface SubscriptionState {
+    readonly subscribed: boolean;
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/shared/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../shared/subscriptions.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG,eAAO,MAAM,oBAAoB,+EAOvB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B"}

package/dist/shared/subscriptions.js

@@ -0,0 +1,10 @@
+/** Who follows an issue and why. Following brings its comments and status changes to the inbox. */
+export const SUBSCRIPTION_REASONS = [
+    'creator',
+    'owner',
+    'executor',
+    'commenter',
+    'mentioned',
+    'manual',
+];
+//# sourceMappingURL=subscriptions.js.map

package/dist/shared/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../shared/subscriptions.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,OAAO;IACP,UAAU;IACV,WAAW;IACX,WAAW;IACX,QAAQ;CACA,CAAC"}

package/dist/shared/subtasks.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Sub-issues and dependencies. An issue may wait for others: `blockedBy` holds it until the other is finished (in a
+ * done or closed status), `relatedTo` only links the two. Sub-issues with a stage form batches: a
+ * sub-issue waits until every sibling of a lower stage is finished.
+ */
+import type { Executor, StatusDefinition } from './issues.js';
+export type DependencyType = 'blockedBy' | 'relatedTo';
+export declare const DEPENDENCY_TYPES: readonly DependencyType[];
+export declare const STAGE_MAX = 1000;
+/** How far a chain of issues waiting for each other may reach. */
+export declare const DEPENDENCY_DEPTH_MAX = 100;
+/** How many issues one cycle check may visit. */
+export declare const DEPENDENCY_NODES_MAX = 5000;
+export declare const BLOCKED_BY_ON_CREATE_MAX = 50;
+export interface IssueDependency {
+    readonly dependencyId: string;
+    /** The issue on the other side. */
+    readonly issueId: string;
+    readonly identifier: string;
+    readonly title: string;
+    /** That issue's current status, as it is now (it may be in another project). */
+    readonly status: StatusDefinition;
+    readonly type: DependencyType;
+}
+/** An issue that holds another: one it is `blockedBy` (`dependency`), or a sibling of an earlier stage (`stage`). */
+export interface Blocker {
+    readonly issueId: string;
+    readonly identifier: string;
+    readonly title: string;
+    readonly status: StatusDefinition;
+    readonly reason: 'dependency' | 'stage';
+}
+export interface SubtaskSummary {
+    readonly id: string;
+    readonly identifier: string;
+    readonly title: string;
+    readonly status: StatusDefinition;
+    readonly stage: number | null;
+    readonly executor: Executor | null;
+    readonly executorName: string | null;
+    /** Unfinished issues it waits for. */
+    readonly blockedCount: number;
+    /** Finished: done or cancelled. */
+    readonly terminal: boolean;
+}
+/**
+ * `POST /api/projects/issues/{issueId}/dependencies`, and `POST /api/projects/issues/{issueId}/removeDependency`,
+ * which removes the link to that issue.
+ */
+export interface AddDependencyRequest {
+    /** An id or identifier. */
+    readonly dependsOnIssueId: string;
+    /** `blockedBy` when left out. */
+    readonly type?: DependencyType;
+}
+/** Changes a link in place; a stale type or an existing target relationship is a conflict. */
+export interface UpdateDependencyRequest {
+    readonly type: DependencyType;
+    readonly expectedType: DependencyType;
+}
+//# sourceMappingURL=subtasks.d.ts.map

package/dist/shared/subtasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtasks.d.ts","sourceRoot":"","sources":["../../shared/subtasks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,CAAC;AACvD,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAGrD,CAAC;AAEF,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B;AAED,qHAAqH;AACrH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sCAAsC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,8FAA8F;AAC9F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;CACvC"}

package/dist/shared/subtasks.js

@@ -0,0 +1,11 @@
+export const DEPENDENCY_TYPES = [
+    'blockedBy',
+    'relatedTo',
+];
+export const STAGE_MAX = 1000;
+/** How far a chain of issues waiting for each other may reach. */
+export const DEPENDENCY_DEPTH_MAX = 100;
+/** How many issues one cycle check may visit. */
+export const DEPENDENCY_NODES_MAX = 5000;
+export const BLOCKED_BY_ON_CREATE_MAX = 50;
+//# sourceMappingURL=subtasks.js.map

package/dist/shared/subtasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtasks.js","sourceRoot":"","sources":["../../shared/subtasks.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,WAAW;IACX,WAAW;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9B,kEAAkE;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,iDAAiD;AACjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC"}