@things-factory/worklist 10.1.248 → 10.1.249

package/dist-server/service/approval-notice/approval-notice-rules.d.ts

@@ -0,0 +1,67 @@
+import type { NoticeWords } from '@things-factory/notification';
+import type { ApprovalLineItem } from '@things-factory/organization';
+/**
+ * What happened.
+ *
+ * - `request`   a seat's turn came - the first one on submit, the next one after an approval
+ * - `delegated` a seat was handed to someone
+ * - `reference` someone was seated to read along
+ * - `approved`  the last approval ended the case
+ * - `rejected`  an approver sent it back
+ */
+export type ApprovalNoticeKind = 'request' | 'delegated' | 'reference' | 'approved' | 'rejected';
+export declare const APPROVAL_NOTICE_KINDS: readonly ApprovalNoticeKind[];
+/** A notice for the person whose turn it is - the other kinds tell the requester of a judgment. */
+export declare function isTurnNotice(kind: ApprovalNoticeKind): boolean;
+export type NoticePerson = {
+    id: string;
+    name?: string | null;
+    email?: string | null;
+    locale?: string | null;
+};
+/**
+ * Who is told.
+ *
+ * A turn reaches the seat: its person, or - for a seat held by a role - everyone holding the role. A judgment
+ * reaches the requester. Whoever did the thing is not told of it, and nobody is told twice.
+ */
+export declare function noticeReceivers({ kind, approver, roleHolders, requester, actorId }: {
+    kind: ApprovalNoticeKind;
+    approver?: NoticePerson | null;
+    roleHolders?: NoticePerson[] | null;
+    requester?: NoticePerson | null;
+    actorId?: string | null;
+}): NoticePerson[];
+/**
+ * The page the notice opens, relative to the domain - the same pages the worklist lists open.
+ *
+ * A turn opens the approval. An approved case opens the thread's read-only view; a rejected one opens the thread
+ * itself, where the requester revises and raises it again.
+ */
+export declare function noticeAddress(kind: ApprovalNoticeKind, { approvalId, threadId }: {
+    approvalId: string;
+    threadId: string;
+}): string;
+/** Which approval of the line this seat is - references take a place in the line but are not counted. */
+export declare function approvalStep(line: ApprovalLineItem[] | null | undefined, order: number): {
+    step: number;
+    steps: number;
+} | undefined;
+export type NoticeFacts = {
+    kind: ApprovalNoticeKind;
+    /** The case as the worklist names it. */
+    name: string;
+    requester?: string | null;
+    /** Who did the thing - the approver who judged, the person who handed a seat on. */
+    actor?: string | null;
+    step?: number;
+    steps?: number;
+};
+export type Translate = (key: string, options?: {
+    [name: string]: unknown;
+}) => string;
+/**
+ * The sentences, from the worklist translations (`approval-notice.<kind>.*`). Nothing of the request's content goes
+ * in: no input, no amount, no comment. The page behind the link shows those to whoever may see them.
+ */
+export declare function noticeWords(t: Translate, facts: NoticeFacts): NoticeWords;

package/dist-server/service/approval-notice/approval-notice-rules.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APPROVAL_NOTICE_KINDS = void 0;
+exports.isTurnNotice = isTurnNotice;
+exports.noticeReceivers = noticeReceivers;
+exports.noticeAddress = noticeAddress;
+exports.approvalStep = approvalStep;
+exports.noticeWords = noticeWords;
+const approval_line_js_1 = require("../../controllers/activity-approval/approval-line.js");
+exports.APPROVAL_NOTICE_KINDS = ['request', 'delegated', 'reference', 'approved', 'rejected'];
+/** A notice for the person whose turn it is - the other kinds tell the requester of a judgment. */
+function isTurnNotice(kind) {
+    return kind === 'request' || kind === 'delegated' || kind === 'reference';
+}
+/**
+ * Who is told.
+ *
+ * A turn reaches the seat: its person, or - for a seat held by a role - everyone holding the role. A judgment
+ * reaches the requester. Whoever did the thing is not told of it, and nobody is told twice.
+ */
+function noticeReceivers({ kind, approver, roleHolders, requester, actorId }) {
+    const candidates = isTurnNotice(kind) ? (approver ? [approver] : roleHolders || []) : requester ? [requester] : [];
+    const seen = new Set();
+    return candidates.filter(person => {
+        if (!person?.id || person.id === actorId || seen.has(person.id))
+            return false;
+        seen.add(person.id);
+        return true;
+    });
+}
+/**
+ * The page the notice opens, relative to the domain - the same pages the worklist lists open.
+ *
+ * A turn opens the approval. An approved case opens the thread's read-only view; a rejected one opens the thread
+ * itself, where the requester revises and raises it again.
+ */
+function noticeAddress(kind, { approvalId, threadId }) {
+    if (isTurnNotice(kind))
+        return `activity-approval/${approvalId}`;
+    return kind === 'approved' ? `activity-thread-view/${threadId}` : `activity-thread/${threadId}`;
+}
+/** Which approval of the line this seat is - references take a place in the line but are not counted. */
+function approvalStep(line, order) {
+    const orders = (line || []).map((item, index) => ((0, approval_line_js_1.isApprovalStep)(item) ? index + 1 : 0)).filter(Boolean);
+    const step = orders.indexOf(order) + 1;
+    return step ? { step, steps: orders.length } : undefined;
+}
+/**
+ * The sentences, from the worklist translations (`approval-notice.<kind>.*`). Nothing of the request's content goes
+ * in: no input, no amount, no comment. The page behind the link shows those to whoever may see them.
+ */
+function noticeWords(t, facts) {
+    const values = {
+        name: facts.name,
+        requester: facts.requester || '-',
+        actor: facts.actor || '-',
+        step: facts.step ?? '-',
+        steps: facts.steps ?? '-'
+    };
+    return {
+        subject: t(`approval-notice.${facts.kind}.subject`, values),
+        body: t(`approval-notice.${facts.kind}.body`, values),
+        action: t(isTurnNotice(facts.kind) ? 'approval-notice.open-approval' : 'approval-notice.open-request', values),
+        note: t(isTurnNotice(facts.kind) ? 'approval-notice.see-approval-box' : 'approval-notice.see-request-box', values)
+    };
+}
+//# sourceMappingURL=approval-notice-rules.js.map

package/dist-server/service/approval-notice/approval-notice-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-notice-rules.js","sourceRoot":"","sources":["../../../server/service/approval-notice/approval-notice-rules.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The rules of the approval notice (ADR-0164) - who is told and what they read. How it is sent is notification's.\n * Plain functions over plain values: no entity, no request, so a test holds every rule without a database.\n */\nimport type { NoticeWords } from '@things-factory/notification'\nimport type { ApprovalLineItem } from '@things-factory/organization'\n\nimport { isApprovalStep } from '../../controllers/activity-approval/approval-line.js'\n\n/**\n * What happened.\n *\n * - `request`   a seat's turn came - the first one on submit, the next one after an approval\n * - `delegated` a seat was handed to someone\n * - `reference` someone was seated to read along\n * - `approved`  the last approval ended the case\n * - `rejected`  an approver sent it back\n */\nexport type ApprovalNoticeKind = 'request' | 'delegated' | 'reference' | 'approved' | 'rejected'\n\nexport const APPROVAL_NOTICE_KINDS: readonly ApprovalNoticeKind[] = ['request', 'delegated', 'reference', 'approved', 'rejected']\n\n/** A notice for the person whose turn it is - the other kinds tell the requester of a judgment. */\nexport function isTurnNotice(kind: ApprovalNoticeKind): boolean {\n  return kind === 'request' || kind === 'delegated' || kind === 'reference'\n}\n\nexport type NoticePerson = { id: string; name?: string | null; email?: string | null; locale?: string | null }\n\n/**\n * Who is told.\n *\n * A turn reaches the seat: its person, or - for a seat held by a role - everyone holding the role. A judgment\n * reaches the requester. Whoever did the thing is not told of it, and nobody is told twice.\n */\nexport function noticeReceivers({\n  kind,\n  approver,\n  roleHolders,\n  requester,\n  actorId\n}: {\n  kind: ApprovalNoticeKind\n  approver?: NoticePerson | null\n  roleHolders?: NoticePerson[] | null\n  requester?: NoticePerson | null\n  actorId?: string | null\n}): NoticePerson[] {\n  const candidates = isTurnNotice(kind) ? (approver ? [approver] : roleHolders || []) : requester ? [requester] : []\n  const seen = new Set<string>()\n\n  return candidates.filter(person => {\n    if (!person?.id || person.id === actorId || seen.has(person.id)) return false\n    seen.add(person.id)\n    return true\n  })\n}\n\n/**\n * The page the notice opens, relative to the domain - the same pages the worklist lists open.\n *\n * A turn opens the approval. An approved case opens the thread's read-only view; a rejected one opens the thread\n * itself, where the requester revises and raises it again.\n */\nexport function noticeAddress(kind: ApprovalNoticeKind, { approvalId, threadId }: { approvalId: string; threadId: string }): string {\n  if (isTurnNotice(kind)) return `activity-approval/${approvalId}`\n  return kind === 'approved' ? `activity-thread-view/${threadId}` : `activity-thread/${threadId}`\n}\n\n/** Which approval of the line this seat is - references take a place in the line but are not counted. */\nexport function approvalStep(line: ApprovalLineItem[] | null | undefined, order: number): { step: number; steps: number } | undefined {\n  const orders = (line || []).map((item, index) => (isApprovalStep(item) ? index + 1 : 0)).filter(Boolean)\n  const step = orders.indexOf(order) + 1\n  return step ? { step, steps: orders.length } : undefined\n}\n\n\nexport type NoticeFacts = {\n  kind: ApprovalNoticeKind\n  /** The case as the worklist names it. */\n  name: string\n  requester?: string | null\n  /** Who did the thing - the approver who judged, the person who handed a seat on. */\n  actor?: string | null\n  step?: number\n  steps?: number\n}\n\nexport type Translate = (key: string, options?: { [name: string]: unknown }) => string\n\n/**\n * The sentences, from the worklist translations (`approval-notice.<kind>.*`). Nothing of the request's content goes\n * in: no input, no amount, no comment. The page behind the link shows those to whoever may see them.\n */\nexport function noticeWords(t: Translate, facts: NoticeFacts): NoticeWords {\n  const values = {\n    name: facts.name,\n    requester: facts.requester || '-',\n    actor: facts.actor || '-',\n    step: facts.step ?? '-',\n    steps: facts.steps ?? '-'\n  }\n\n  return {\n    subject: t(`approval-notice.${facts.kind}.subject`, values),\n    body: t(`approval-notice.${facts.kind}.body`, values),\n    action: t(isTurnNotice(facts.kind) ? 'approval-notice.open-approval' : 'approval-notice.open-request', values),\n    note: t(isTurnNotice(facts.kind) ? 'approval-notice.see-approval-box' : 'approval-notice.see-request-box', values)\n  }\n}\n"]}

package/dist-server/service/approval-notice/approval-notice.d.ts

@@ -0,0 +1,11 @@
+import { type ApprovalNoticeKind } from './approval-notice-rules.js';
+/**
+ * Tells of what just happened to approval `approvalId`, once the transaction has committed.
+ *
+ * Who and what are settled here, inside the transaction, from rows it can see. Nothing here throws: a notice that
+ * cannot be made is reported and the approval stands.
+ */
+export declare function noticeApproval(context: ResolverContext, { kind, approvalId }: {
+    kind: ApprovalNoticeKind;
+    approvalId: string;
+}): Promise<void>;

package/dist-server/service/approval-notice/approval-notice.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noticeApproval = noticeApproval;
+/*
+ * The approval notice (ADR-0164) - the one place the worklist tells people of an approval's turn and judgment.
+ *
+ * The four places an approval moves call `noticeApproval`: createApproval (a turn or a reference), delegate (a
+ * handed seat), approve with no one after (approved) and reject (rejected). Applications call nothing; a case that
+ * goes through the approval line is told of. Sending is notification's (`sendNoticeWhenCommitted`).
+ */
+const auth_base_1 = require("@things-factory/auth-base");
+const env_1 = require("@things-factory/env");
+const translator_1 = require("@things-factory/i18n-base/translator");
+const notification_1 = require("@things-factory/notification");
+const activity_approval_js_1 = require("../activity-approval/activity-approval.js");
+const assignee_pool_js_1 = require("../activity-instance/assignee-pool.js");
+const approval_notice_rules_js_1 = require("./approval-notice-rules.js");
+/**
+ * Tells of what just happened to approval `approvalId`, once the transaction has committed.
+ *
+ * Who and what are settled here, inside the transaction, from rows it can see. Nothing here throws: a notice that
+ * cannot be made is reported and the approval stands.
+ */
+async function noticeApproval(context, { kind, approvalId }) {
+    try {
+        const { user, tx } = context.state;
+        const approval = await tx.getRepository(activity_approval_js_1.ActivityApproval).findOne({
+            where: { id: approvalId },
+            relations: ['approver', 'approverRole', 'approverRole.users', 'activityThread', 'activityThread.assignee', 'activityThread.activityInstance']
+        });
+        const thread = approval?.activityThread;
+        const instance = thread?.activityInstance;
+        if (!approval || !thread || !instance)
+            return;
+        const receivers = (0, approval_notice_rules_js_1.noticeReceivers)({
+            kind,
+            approver: active(approval.approver),
+            roleHolders: (0, assignee_pool_js_1.poolMembers)(approval.approverRole ? [approval.approverRole] : []).map(active).filter(Boolean),
+            requester: active(thread.assignee),
+            actorId: user?.id
+        });
+        if (!receivers.length)
+            return;
+        const facts = {
+            kind,
+            name: instance.name || '',
+            requester: thread.assignee?.name,
+            actor: user?.name,
+            ...((0, approval_notice_rules_js_1.isTurnNotice)(kind) ? (0, approval_notice_rules_js_1.approvalStep)(instance.approvalLine, approval.order) : {})
+        };
+        const address = (0, approval_notice_rules_js_1.noticeAddress)(kind, { approvalId: approval.id, threadId: thread.id });
+        (0, notification_1.sendNoticeWhenCommitted)(context, {
+            type: 'approval',
+            level: kind === 'rejected' ? 'warn' : 'info',
+            receivers,
+            words: lng => (0, approval_notice_rules_js_1.noticeWords)(translatorOf(lng), facts),
+            address,
+            link: (0, notification_1.noticeLinkOf)(context, address),
+            label: `approval notice ${kind} of ${approval.id}`
+        });
+    }
+    catch (error) {
+        env_1.logger.error(`[worklist] approval notice ${kind} of ${approvalId} could not be made`, error);
+    }
+}
+/** Only a person who can sign in is told. */
+function active(person) {
+    return person && person.status === auth_base_1.UserStatus.ACTIVATED ? { id: person.id, name: person.name, email: person.email, locale: person.locale } : null;
+}
+/** A sentence missing in the person's language is said in English, never as its key. */
+function translatorOf(lng) {
+    const own = (0, translator_1.translatorFor)(lng);
+    const english = (0, translator_1.translatorFor)('en');
+    return (key, options = {}) => own(key, { ...options, defaultValue: english(key, options) });
+}
+//# sourceMappingURL=approval-notice.js.map

package/dist-server/service/approval-notice/approval-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-notice.js","sourceRoot":"","sources":["../../../server/service/approval-notice/approval-notice.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The approval notice (ADR-0164) - the one place the worklist tells people of an approval's turn and judgment.\n *\n * The four places an approval moves call `noticeApproval`: createApproval (a turn or a reference), delegate (a\n * handed seat), approve with no one after (approved) and reject (rejected). Applications call nothing; a case that\n * goes through the approval line is told of. Sending is notification's (`sendNoticeWhenCommitted`).\n */\nimport { User, UserStatus } from '@things-factory/auth-base'\nimport { logger } from '@things-factory/env'\nimport { translatorFor } from '@things-factory/i18n-base/translator'\nimport { noticeLinkOf, sendNoticeWhenCommitted } from '@things-factory/notification'\n\nimport { ActivityApproval } from '../activity-approval/activity-approval.js'\nimport { poolMembers } from '../activity-instance/assignee-pool.js'\nimport {\n  approvalStep,\n  isTurnNotice,\n  noticeAddress,\n  noticeReceivers,\n  noticeWords,\n  type ApprovalNoticeKind,\n  type NoticeFacts,\n  type NoticePerson,\n  type Translate\n} from './approval-notice-rules.js'\n\n/**\n * Tells of what just happened to approval `approvalId`, once the transaction has committed.\n *\n * Who and what are settled here, inside the transaction, from rows it can see. Nothing here throws: a notice that\n * cannot be made is reported and the approval stands.\n */\nexport async function noticeApproval(context: ResolverContext, { kind, approvalId }: { kind: ApprovalNoticeKind; approvalId: string }): Promise<void> {\n  try {\n    const { user, tx } = context.state\n\n    const approval = await tx.getRepository(ActivityApproval).findOne({\n      where: { id: approvalId },\n      relations: ['approver', 'approverRole', 'approverRole.users', 'activityThread', 'activityThread.assignee', 'activityThread.activityInstance']\n    })\n    const thread = approval?.activityThread\n    const instance = thread?.activityInstance\n    if (!approval || !thread || !instance) return\n\n    const receivers = noticeReceivers({\n      kind,\n      approver: active(approval.approver),\n      roleHolders: poolMembers(approval.approverRole ? [approval.approverRole] : []).map(active).filter(Boolean),\n      requester: active(thread.assignee),\n      actorId: user?.id\n    })\n    if (!receivers.length) return\n\n    const facts: NoticeFacts = {\n      kind,\n      name: instance.name || '',\n      requester: thread.assignee?.name,\n      actor: user?.name,\n      ...(isTurnNotice(kind) ? approvalStep(instance.approvalLine, approval.order) : {})\n    }\n    const address = noticeAddress(kind, { approvalId: approval.id, threadId: thread.id })\n\n    sendNoticeWhenCommitted(context, {\n      type: 'approval',\n      level: kind === 'rejected' ? 'warn' : 'info',\n      receivers,\n      words: lng => noticeWords(translatorOf(lng), facts),\n      address,\n      link: noticeLinkOf(context, address),\n      label: `approval notice ${kind} of ${approval.id}`\n    })\n  } catch (error) {\n    logger.error(`[worklist] approval notice ${kind} of ${approvalId} could not be made`, error)\n  }\n}\n\n/** Only a person who can sign in is told. */\nfunction active(person?: User | null): NoticePerson | null {\n  return person && person.status === UserStatus.ACTIVATED ? { id: person.id, name: person.name, email: person.email, locale: person.locale } : null\n}\n\n/** A sentence missing in the person's language is said in English, never as its key. */\nfunction translatorOf(lng: string): Translate {\n  const own = translatorFor(lng)\n  const english = translatorFor('en')\n  return (key, options = {}) => own(key, { ...options, defaultValue: english(key, options) })\n}\n"]}

package/dist-server/service/index.d.ts

@@ -0,0 +1,23 @@
+export * from './activity-approval/activity-approval.js';
+export * from './activity-thread/activity-thread.js';
+export * from './activity-template/activity-template.js';
+export * from './activity-instance/activity-instance.js';
+export * from './activity/activity.js';
+export * from './installable-activity/installable-activity.js';
+export * from './activity-summary/activity-summary.js';
+export * from './work-door/work-door-declaration.js';
+export * from './work-door/work-door-event.js';
+export * from './work-door/pass-work-door.js';
+export * from './work-door/approval-line-standing.js';
+export * from './work-door/activity-lookup.js';
+export * from './work-door/work-door.js';
+export * from './work-door/work-door-type.js';
+export * from './work-door/work-door-not-used.js';
+export * from './work-door/work-door-journal.js';
+export * from './work-door/work-door-journal-service.js';
+export * from './work-door/work-door-service.js';
+export declare const entities: (typeof import("./activity/activity.js").Activity | typeof import("./activity-approval/activity-approval.js").ActivityApproval | typeof import("./activity-thread/activity-thread.js").ActivityThread | typeof import("./activity-instance/activity-instance.js").ActivityInstance | typeof import("./installable-activity/installable-activity.js").InstallableActivity | typeof import("./activity-template/activity-template.js").ActivityTemplate | typeof import("./activity-summary/activity-summary.js").ActivitySummary | typeof import("./activity/activity-history.js").ActivityHistory | typeof import("./activity-instance/activity-instance-history.js").ActivityInstanceHistory | typeof import("./activity-template/activity-template-history.js").ActivityTemplateHistory | typeof import("./activity-thread/activity-thread-history.js").ActivityThreadHistory | typeof import("./work-door/work-door-not-used.js").WorkDoorNotUsed | typeof import("./work-door/work-door-journal.js").WorkDoorJournal)[];
+export declare const subscribers: (typeof import("./activity-approval/event-subscriber.js").ActivityApprovalSubscriber | typeof import("./activity/event-subscriber.js").ActivityHistoryEntitySubscriber | typeof import("./activity/declaration-guard-subscriber.js").ActivityDeclarationGuardSubscriber | typeof import("./activity-instance/event-subscriber.js").ActivityInstanceSubscriber | typeof import("./activity-instance/event-subscriber.js").ActivityInstanceHistoryEntitySubscriber | typeof import("./activity-thread/event-subscriber.js").ActivityThreadSubscriber | typeof import("./activity-thread/event-subscriber.js").ActivityThreadHistoryEntitySubscriber)[];
+export declare const schema: {
+    resolverClasses: (typeof import("./activity-stats/activity-stats-query.js").ActivityStatsQuery | typeof import("./activity-approval/activity-approval-query.js").ActivityApprovalQuery | typeof import("./activity-approval/activity-approval-mutation.js").ActivityApprovalMutation | typeof import("./activity-approval/activity-approval-subscription.js").ActivityApprovalSubscription | typeof import("./activity/activity-mutation.js").ActivityMutation | typeof import("./activity/activity-query.js").ActivityQuery | typeof import("./activity-instance/activity-instance-mutation.js").ActivityInstanceMutation | typeof import("./activity-instance/activity-instance-query.js").ActivityInstanceQuery | typeof import("./activity-instance/activity-instance-subscription.js").ActivityInstanceSubscription | typeof import("./activity-template/activity-template-mutation.js").ActivityTemplateMutation | typeof import("./activity-template/activity-template-query.js").ActivityTemplateQuery | typeof import("./activity-thread/activity-thread-mutation.js").ActivityThreadMutation | typeof import("./activity-thread/activity-thread-query.js").ActivityThreadQuery | typeof import("./activity-thread/activity-thread-history-query.js").ActivityThreadHistoryQuery | typeof import("./activity-thread/activity-thread-subscription.js").ActivityThreadSubscription | typeof import("./installable-activity/installable-activity-query.js").InstallableActivityQuery | typeof import("./installable-activity/installable-activity-mutation.js").InstallableActivityMutation | typeof import("./activity-summary/activity-summary-query.js").ActivitySummaryQuery | typeof import("./activity-summary/person-open-work.js").PersonOpenWorkQuery | typeof import("./work-door/work-door-resolver.js").WorkDoorResolver)[];
+};

package/dist-server/service/index.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schema = exports.subscribers = exports.entities = void 0;
+const tslib_1 = require("tslib");
+/* EXPORT ENTITY TYPES */
+tslib_1.__exportStar(require("./activity-approval/activity-approval.js"), exports);
+tslib_1.__exportStar(require("./activity-thread/activity-thread.js"), exports);
+tslib_1.__exportStar(require("./activity-template/activity-template.js"), exports);
+tslib_1.__exportStar(require("./activity-instance/activity-instance.js"), exports);
+tslib_1.__exportStar(require("./activity/activity.js"), exports);
+tslib_1.__exportStar(require("./installable-activity/installable-activity.js"), exports);
+tslib_1.__exportStar(require("./activity-summary/activity-summary.js"), exports);
+/* IMPORT ENTITIES AND RESOLVERS */
+const index_js_1 = require("./activity-stats/index.js");
+const index_js_2 = require("./activity-approval/index.js");
+const index_js_3 = require("./activity/index.js");
+const index_js_4 = require("./activity-instance/index.js");
+const index_js_5 = require("./activity-template/index.js");
+const index_js_6 = require("./activity-thread/index.js");
+const index_js_7 = require("./installable-activity/index.js");
+const index_js_8 = require("./activity-summary/index.js");
+const index_js_9 = require("./work-door/index.js");
+/*
+ * 업무 문의 판정과 선언은 **앱이 부른다** — 등록(`registerWorkDoors`) · 갈래(`passWorkDoor`) · 결재선
+ * 판정이 여기로 나가야 앱이 그것을 쓸 수 있다. 엔티티와 리졸버만 등록하고 이 줄을 빠뜨리면 모듈은
+ * 멀쩡히 서고 앱만 「그런 export 가 없다」로 멈춘다.
+ *
+ * **묶음의 `index` 를 통째로 내보내지 않는다.** 그 파일은 `entities` · `resolvers` 라는 이름을 갖고
+ * 있고, 이 파일도 같은 이름을 갖는다. `export *` 로 섞으면 그 이름들이 조용히 가려지거나 빠진다 —
+ * 오류는 안 나고 서버가 반쯤 선다. 그래서 낼 것을 파일마다 적는다.
+ */
+tslib_1.__exportStar(require("./work-door/work-door-declaration.js"), exports);
+tslib_1.__exportStar(require("./work-door/work-door-event.js"), exports);
+tslib_1.__exportStar(require("./work-door/pass-work-door.js"), exports);
+tslib_1.__exportStar(require("./work-door/approval-line-standing.js"), exports);
+tslib_1.__exportStar(require("./work-door/activity-lookup.js"), exports);
+tslib_1.__exportStar(require("./work-door/work-door.js"), exports);
+tslib_1.__exportStar(require("./work-door/work-door-type.js"), exports);
+tslib_1.__exportStar(require("./work-door/work-door-not-used.js"), exports);
+tslib_1.__exportStar(require("./work-door/work-door-journal.js"), exports);
+tslib_1.__exportStar(require("./work-door/work-door-journal-service.js"), exports);
+tslib_1.__exportStar(require("./work-door/work-door-service.js"), exports);
+exports.entities = [
+    /* ENTITIES */
+    ...index_js_2.entities,
+    ...index_js_3.entities,
+    ...index_js_4.entities,
+    ...index_js_5.entities,
+    ...index_js_6.entities,
+    ...index_js_7.entities,
+    ...index_js_8.entities,
+    ...index_js_9.entities
+];
+exports.subscribers = [
+    /* SUBSCRIBERS */
+    ...index_js_2.subscribers,
+    ...index_js_4.subscribers,
+    ...index_js_3.subscribers,
+    ...index_js_6.subscribers
+];
+exports.schema = {
+    resolverClasses: [
+        /* RESOLVER CLASSES */
+        ...index_js_1.resolvers,
+        ...index_js_2.resolvers,
+        ...index_js_3.resolvers,
+        ...index_js_4.resolvers,
+        ...index_js_5.resolvers,
+        ...index_js_6.resolvers,
+        ...index_js_7.resolvers,
+        ...index_js_8.resolvers,
+        ...index_js_9.resolvers
+    ]
+};
+//# sourceMappingURL=index.js.map

package/dist-server/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,yBAAyB;AACzB,mFAAwD;AACxD,+EAAoD;AACpD,mFAAwD;AACxD,mFAAwD;AACxD,iEAAsC;AACtC,yFAA8D;AAC9D,iFAAsD;AAEtD,mCAAmC;AACnC,wDAA+E;AAC/E,2DAIqC;AACrC,kDAI4B;AAC5B,2DAIqC;AACrC,2DAGqC;AACrC,yDAImC;AACnC,8DAGwC;AACxC,0DAAwH;AACxH,mDAAmG;AAEnG;;;;;;;;GAQG;AACH,+EAAoD;AACpD,yEAA8C;AAC9C,wEAA6C;AAC7C,gFAAqD;AACrD,yEAA8C;AAC9C,mEAAwC;AACxC,wEAA6C;AAC7C,4EAAiD;AACjD,2EAAgD;AAChD,mFAAwD;AACxD,2EAAgD;AAEnC,QAAA,QAAQ,GAAG;IACtB,cAAc;IACd,GAAG,mBAAwB;IAC3B,GAAG,mBAAgB;IACnB,GAAG,mBAAwB;IAC3B,GAAG,mBAAwB;IAC3B,GAAG,mBAAsB;IACzB,GAAG,mBAA2B;IAC9B,GAAG,mBAAuB;IAC1B,GAAG,mBAAgB;CACpB,CAAA;AAEY,QAAA,WAAW,GAAG;IACzB,iBAAiB;IACjB,GAAG,sBAA2B;IAC9B,GAAG,sBAA2B;IAC9B,GAAG,sBAAmB;IACtB,GAAG,sBAAyB;CAC7B,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,GAAG,oBAAsB;QACzB,GAAG,oBAAyB;QAC5B,GAAG,oBAAiB;QACpB,GAAG,oBAAyB;QAC5B,GAAG,oBAAyB;QAC5B,GAAG,oBAAuB;QAC1B,GAAG,oBAA4B;QAC/B,GAAG,oBAAwB;QAC3B,GAAG,oBAAiB;KACrB;CACF,CAAA","sourcesContent":["/* EXPORT ENTITY TYPES */\nexport * from './activity-approval/activity-approval.js'\nexport * from './activity-thread/activity-thread.js'\nexport * from './activity-template/activity-template.js'\nexport * from './activity-instance/activity-instance.js'\nexport * from './activity/activity.js'\nexport * from './installable-activity/installable-activity.js'\nexport * from './activity-summary/activity-summary.js'\n\n/* IMPORT ENTITIES AND RESOLVERS */\nimport { resolvers as ActivityStatsResolvers } from './activity-stats/index.js'\nimport {\n  entities as ActivityApprovalEntities,\n  resolvers as ActivityApprovalResolvers,\n  subscribers as ActivityApprovalSubscribers\n} from './activity-approval/index.js'\nimport {\n  entities as ActivityEntities,\n  resolvers as ActivityResolvers,\n  subscribers as ActivitySubscribers\n} from './activity/index.js'\nimport {\n  entities as ActivityInstanceEntities,\n  resolvers as ActivityInstanceResolvers,\n  subscribers as ActivityInstanceSubscribers\n} from './activity-instance/index.js'\nimport {\n  entities as ActivityTemplateEntities,\n  resolvers as ActivityTemplateResolvers\n} from './activity-template/index.js'\nimport {\n  entities as ActivityThreadEntities,\n  resolvers as ActivityThreadResolvers,\n  subscribers as ActivityThreadSubscribers\n} from './activity-thread/index.js'\nimport {\n  entities as InstallableActivityEntities,\n  resolvers as InstallableActivityResolvers\n} from './installable-activity/index.js'\nimport { entities as ActivitySummaryEntities, resolvers as ActivitySummaryResolvers } from './activity-summary/index.js'\nimport { entities as WorkDoorEntities, resolvers as WorkDoorResolvers } from './work-door/index.js'\n\n/*\n * 업무 문의 판정과 선언은 **앱이 부른다** — 등록(`registerWorkDoors`) · 갈래(`passWorkDoor`) · 결재선\n * 판정이 여기로 나가야 앱이 그것을 쓸 수 있다. 엔티티와 리졸버만 등록하고 이 줄을 빠뜨리면 모듈은\n * 멀쩡히 서고 앱만 「그런 export 가 없다」로 멈춘다.\n *\n * **묶음의 `index` 를 통째로 내보내지 않는다.** 그 파일은 `entities` · `resolvers` 라는 이름을 갖고\n * 있고, 이 파일도 같은 이름을 갖는다. `export *` 로 섞으면 그 이름들이 조용히 가려지거나 빠진다 —\n * 오류는 안 나고 서버가 반쯤 선다. 그래서 낼 것을 파일마다 적는다.\n */\nexport * from './work-door/work-door-declaration.js'\nexport * from './work-door/work-door-event.js'\nexport * from './work-door/pass-work-door.js'\nexport * from './work-door/approval-line-standing.js'\nexport * from './work-door/activity-lookup.js'\nexport * from './work-door/work-door.js'\nexport * from './work-door/work-door-type.js'\nexport * from './work-door/work-door-not-used.js'\nexport * from './work-door/work-door-journal.js'\nexport * from './work-door/work-door-journal-service.js'\nexport * from './work-door/work-door-service.js'\n\nexport const entities = [\n  /* ENTITIES */\n  ...ActivityApprovalEntities,\n  ...ActivityEntities,\n  ...ActivityInstanceEntities,\n  ...ActivityTemplateEntities,\n  ...ActivityThreadEntities,\n  ...InstallableActivityEntities,\n  ...ActivitySummaryEntities,\n  ...WorkDoorEntities\n]\n\nexport const subscribers = [\n  /* SUBSCRIBERS */\n  ...ActivityApprovalSubscribers,\n  ...ActivityInstanceSubscribers,\n  ...ActivitySubscribers,\n  ...ActivityThreadSubscribers\n]\n\nexport const schema = {\n  resolverClasses: [\n    /* RESOLVER CLASSES */\n    ...ActivityStatsResolvers,\n    ...ActivityApprovalResolvers,\n    ...ActivityResolvers,\n    ...ActivityInstanceResolvers,\n    ...ActivityTemplateResolvers,\n    ...ActivityThreadResolvers,\n    ...InstallableActivityResolvers,\n    ...ActivitySummaryResolvers,\n    ...WorkDoorResolvers\n  ]\n}\n"]}

package/dist-server/service/installable-activity/activity-readiness.d.ts

@@ -0,0 +1,58 @@
+/**
+ * How far along an activity type is, **as declared by the module that registers it.**
+ *
+ * Nobody can compute this at runtime. A module either works end to end or it does not, and only
+ * the people who wrote it know which. So it is declared beside the callback, the way plant declares
+ * its maturity facts — and like those, it can go stale, which is why the declaration also names
+ * the tests that back it up.
+ */
+export declare const ActivityReadinessStage: {
+    /** Registered, and the callback does the real thing. */
+    readonly Working: "working";
+    /** Registered and reachable, but part of the effect is still missing. Say what in `gaps`. */
+    readonly Partial: "partial";
+    /** The type exists so the screen can show it. Issuing one does not accomplish anything yet. */
+    readonly Declared: "declared";
+    /**
+     * Identified as work a person has to decide, and **not built.** Often the model has no place to
+     * put it yet — say what is missing in `gaps`.
+     *
+     * The catalog carries these because it is the plan of record: a reader asking "what is left"
+     * gets the answer on the screen instead of in someone's head.
+     */
+    readonly Planned: "planned";
+    /**
+     * Looked at and **deliberately not a worklist item.** This is a placement decision, not a
+     * backlog entry — the work happens, it just does not reach anyone's inbox. Fact-derived things
+     * live like this: a machine stops and the reason gets filled in at the machine, because nobody
+     * assigned it.
+     *
+     * It sits in the catalog so the next person asking "why is this not here" reads the answer
+     * rather than proposing it again. `notes` says where it does live.
+     *
+     * Kept apart from Planned on purpose. Mixed together, a decision reads as a promise.
+     */
+    readonly NotWorklist: "not-worklist";
+};
+export type ActivityReadinessStage = (typeof ActivityReadinessStage)[keyof typeof ActivityReadinessStage];
+export declare class ActivityTestRecord {
+    passed?: number;
+    total?: number;
+    at?: string;
+    command?: string;
+}
+/**
+ * What a module says about its own activity type — how far along, and what backs that up.
+ *
+ * **Every field is optional and a missing one stays missing.** A module that declares nothing gets
+ * a row saying 「선언 없음」, never a zero and never a green mark. That distinction is the whole
+ * point of the screen: a type nobody has vouched for should look different from one that is
+ * finished, and a count we do not have is not a count of zero.
+ */
+export declare class ActivityReadiness {
+    stage?: ActivityReadinessStage;
+    gaps?: string[];
+    tests?: string[];
+    lastRun?: ActivityTestRecord;
+    notes?: string;
+}

package/dist-server/service/installable-activity/activity-readiness.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActivityReadiness = exports.ActivityTestRecord = exports.ActivityReadinessStage = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+/**
+ * How far along an activity type is, **as declared by the module that registers it.**
+ *
+ * Nobody can compute this at runtime. A module either works end to end or it does not, and only
+ * the people who wrote it know which. So it is declared beside the callback, the way plant declares
+ * its maturity facts — and like those, it can go stale, which is why the declaration also names
+ * the tests that back it up.
+ */
+exports.ActivityReadinessStage = {
+    /** Registered, and the callback does the real thing. */
+    Working: 'working',
+    /** Registered and reachable, but part of the effect is still missing. Say what in `gaps`. */
+    Partial: 'partial',
+    /** The type exists so the screen can show it. Issuing one does not accomplish anything yet. */
+    Declared: 'declared',
+    /**
+     * Identified as work a person has to decide, and **not built.** Often the model has no place to
+     * put it yet — say what is missing in `gaps`.
+     *
+     * The catalog carries these because it is the plan of record: a reader asking "what is left"
+     * gets the answer on the screen instead of in someone's head.
+     */
+    Planned: 'planned',
+    /**
+     * Looked at and **deliberately not a worklist item.** This is a placement decision, not a
+     * backlog entry — the work happens, it just does not reach anyone's inbox. Fact-derived things
+     * live like this: a machine stops and the reason gets filled in at the machine, because nobody
+     * assigned it.
+     *
+     * It sits in the catalog so the next person asking "why is this not here" reads the answer
+     * rather than proposing it again. `notes` says where it does live.
+     *
+     * Kept apart from Planned on purpose. Mixed together, a decision reads as a promise.
+     */
+    NotWorklist: 'not-worklist'
+};
+(0, type_graphql_1.registerEnumType)(exports.ActivityReadinessStage, {
+    name: 'ActivityReadinessStage',
+    description: 'how far along an installable activity is, as declared by the module that registers it'
+});
+let ActivityTestRecord = class ActivityTestRecord {
+};
+exports.ActivityTestRecord = ActivityTestRecord;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'How many of the covering tests passed' }),
+    tslib_1.__metadata("design:type", Number)
+], ActivityTestRecord.prototype, "passed", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'How many covering tests ran' }),
+    tslib_1.__metadata("design:type", Number)
+], ActivityTestRecord.prototype, "total", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When that run happened, ISO 8601' }),
+    tslib_1.__metadata("design:type", String)
+], ActivityTestRecord.prototype, "at", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The command that produced this record' }),
+    tslib_1.__metadata("design:type", String)
+], ActivityTestRecord.prototype, "command", void 0);
+exports.ActivityTestRecord = ActivityTestRecord = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Recorded result of the test run that covers an installable activity' })
+], ActivityTestRecord);
+/**
+ * What a module says about its own activity type — how far along, and what backs that up.
+ *
+ * **Every field is optional and a missing one stays missing.** A module that declares nothing gets
+ * a row saying 「선언 없음」, never a zero and never a green mark. That distinction is the whole
+ * point of the screen: a type nobody has vouched for should look different from one that is
+ * finished, and a count we do not have is not a count of zero.
+ */
+let ActivityReadiness = class ActivityReadiness {
+};
+exports.ActivityReadiness = ActivityReadiness;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => exports.ActivityReadinessStage, { nullable: true, description: 'Working, partial, or declared only' }),
+    tslib_1.__metadata("design:type", String)
+], ActivityReadiness.prototype, "stage", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [String], { nullable: true, description: 'What is still missing, when the stage is partial' }),
+    tslib_1.__metadata("design:type", Array)
+], ActivityReadiness.prototype, "gaps", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [String], {
+        nullable: true,
+        description: 'Repo-relative test files that cover this activity. Named so the claim can be checked.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], ActivityReadiness.prototype, "tests", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => ActivityTestRecord, { nullable: true, description: 'Result of the last recorded run of those tests' }),
+    tslib_1.__metadata("design:type", ActivityTestRecord)
+], ActivityReadiness.prototype, "lastRun", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Anything a reader needs that the fields above do not carry' }),
+    tslib_1.__metadata("design:type", String)
+], ActivityReadiness.prototype, "notes", void 0);
+exports.ActivityReadiness = ActivityReadiness = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'What the registering module declares about an installable activity' })
+], ActivityReadiness);
+//# sourceMappingURL=activity-readiness.js.map

package/dist-server/service/installable-activity/activity-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-readiness.js","sourceRoot":"","sources":["../../../server/service/installable-activity/activity-readiness.ts"],"names":[],"mappings":";;;;AAAA,+CAAkE;AAElE;;;;;;;GAOG;AACU,QAAA,sBAAsB,GAAG;IACpC,wDAAwD;IACxD,OAAO,EAAE,SAAS;IAClB,6FAA6F;IAC7F,OAAO,EAAE,SAAS;IAClB,+FAA+F;IAC/F,QAAQ,EAAE,UAAU;IACpB;;;;;;OAMG;IACH,OAAO,EAAE,SAAS;IAClB;;;;;;;;;;OAUG;IACH,WAAW,EAAE,cAAc;CACnB,CAAA;AAIV,IAAA,+BAAgB,EAAC,8BAAsB,EAAE;IACvC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,uFAAuF;CACrG,CAAC,CAAA;AAGK,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;CAY9B,CAAA;AAZY,gDAAkB;AAE7B;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;;kDACjE;AAGf;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC;;iDACxD;AAGd;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC;;8CAChE;AAGX;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;;mDAChE;6BAXL,kBAAkB;IAD9B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,qEAAqE,EAAE,CAAC;GACtF,kBAAkB,CAY9B;AAED;;;;;;;GAOG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAkB7B,CAAA;AAlBY,8CAAiB;AAE5B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,8BAAsB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;;gDAC/E;AAG9B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;;+CAC9F;AAMf;IAJC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;QACvB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,uFAAuF;KACrG,CAAC;;gDACc;AAGhB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;sCAC3G,kBAAkB;kDAAA;AAG5B;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,4DAA4D,EAAE,CAAC;;gDACvF;4BAjBH,iBAAiB;IAD7B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,oEAAoE,EAAE,CAAC;GACrF,iBAAiB,CAkB7B","sourcesContent":["import { Field, ObjectType, registerEnumType } from 'type-graphql'\n\n/**\n * How far along an activity type is, **as declared by the module that registers it.**\n *\n * Nobody can compute this at runtime. A module either works end to end or it does not, and only\n * the people who wrote it know which. So it is declared beside the callback, the way plant declares\n * its maturity facts — and like those, it can go stale, which is why the declaration also names\n * the tests that back it up.\n */\nexport const ActivityReadinessStage = {\n  /** Registered, and the callback does the real thing. */\n  Working: 'working',\n  /** Registered and reachable, but part of the effect is still missing. Say what in `gaps`. */\n  Partial: 'partial',\n  /** The type exists so the screen can show it. Issuing one does not accomplish anything yet. */\n  Declared: 'declared',\n  /**\n   * Identified as work a person has to decide, and **not built.** Often the model has no place to\n   * put it yet — say what is missing in `gaps`.\n   *\n   * The catalog carries these because it is the plan of record: a reader asking \"what is left\"\n   * gets the answer on the screen instead of in someone's head.\n   */\n  Planned: 'planned',\n  /**\n   * Looked at and **deliberately not a worklist item.** This is a placement decision, not a\n   * backlog entry — the work happens, it just does not reach anyone's inbox. Fact-derived things\n   * live like this: a machine stops and the reason gets filled in at the machine, because nobody\n   * assigned it.\n   *\n   * It sits in the catalog so the next person asking \"why is this not here\" reads the answer\n   * rather than proposing it again. `notes` says where it does live.\n   *\n   * Kept apart from Planned on purpose. Mixed together, a decision reads as a promise.\n   */\n  NotWorklist: 'not-worklist'\n} as const\n\nexport type ActivityReadinessStage = (typeof ActivityReadinessStage)[keyof typeof ActivityReadinessStage]\n\nregisterEnumType(ActivityReadinessStage, {\n  name: 'ActivityReadinessStage',\n  description: 'how far along an installable activity is, as declared by the module that registers it'\n})\n\n@ObjectType({ description: 'Recorded result of the test run that covers an installable activity' })\nexport class ActivityTestRecord {\n  @Field({ nullable: true, description: 'How many of the covering tests passed' })\n  passed?: number\n\n  @Field({ nullable: true, description: 'How many covering tests ran' })\n  total?: number\n\n  @Field({ nullable: true, description: 'When that run happened, ISO 8601' })\n  at?: string\n\n  @Field({ nullable: true, description: 'The command that produced this record' })\n  command?: string\n}\n\n/**\n * What a module says about its own activity type — how far along, and what backs that up.\n *\n * **Every field is optional and a missing one stays missing.** A module that declares nothing gets\n * a row saying 「선언 없음」, never a zero and never a green mark. That distinction is the whole\n * point of the screen: a type nobody has vouched for should look different from one that is\n * finished, and a count we do not have is not a count of zero.\n */\n@ObjectType({ description: 'What the registering module declares about an installable activity' })\nexport class ActivityReadiness {\n  @Field(type => ActivityReadinessStage, { nullable: true, description: 'Working, partial, or declared only' })\n  stage?: ActivityReadinessStage\n\n  @Field(type => [String], { nullable: true, description: 'What is still missing, when the stage is partial' })\n  gaps?: string[]\n\n  @Field(type => [String], {\n    nullable: true,\n    description: 'Repo-relative test files that cover this activity. Named so the claim can be checked.'\n  })\n  tests?: string[]\n\n  @Field(type => ActivityTestRecord, { nullable: true, description: 'Result of the last recorded run of those tests' })\n  lastRun?: ActivityTestRecord\n\n  @Field({ nullable: true, description: 'Anything a reader needs that the fields above do not carry' })\n  notes?: string\n}\n"]}

package/dist-server/service/installable-activity/index.d.ts

@@ -0,0 +1,6 @@
+import { InstallableActivity } from "./installable-activity.js";
+import { InstallableActivityQuery } from "./installable-activity-query.js";
+import { InstallableActivityMutation } from "./installable-activity-mutation.js";
+export declare const entities: (typeof InstallableActivity)[];
+export declare const resolvers: (typeof InstallableActivityQuery | typeof InstallableActivityMutation)[];
+export declare const subscribers: any[];

package/dist-server/service/installable-activity/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscribers = exports.resolvers = exports.entities = void 0;
+const installable_activity_js_1 = require("./installable-activity.js");
+const installable_activity_query_js_1 = require("./installable-activity-query.js");
+const installable_activity_mutation_js_1 = require("./installable-activity-mutation.js");
+exports.entities = [installable_activity_js_1.InstallableActivity];
+exports.resolvers = [installable_activity_query_js_1.InstallableActivityQuery, installable_activity_mutation_js_1.InstallableActivityMutation];
+exports.subscribers = [];
+//# sourceMappingURL=index.js.map

package/dist-server/service/installable-activity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/installable-activity/index.ts"],"names":[],"mappings":";;;AAAA,uEAA+D;AAC/D,mFAA0E;AAC1E,yFAAgF;AAEnE,QAAA,QAAQ,GAAG,CAAC,6CAAmB,CAAC,CAAA;AAChC,QAAA,SAAS,GAAG,CAAC,wDAAwB,EAAE,8DAA2B,CAAC,CAAA;AACnE,QAAA,WAAW,GAAG,EAAE,CAAA","sourcesContent":["import { InstallableActivity } from \"./installable-activity.js\"\nimport { InstallableActivityQuery } from \"./installable-activity-query.js\"\nimport { InstallableActivityMutation } from \"./installable-activity-mutation.js\"\n\nexport const entities = [InstallableActivity]\nexport const resolvers = [InstallableActivityQuery, InstallableActivityMutation]\nexport const subscribers = []\n"]}

package/dist-server/service/installable-activity/installable-activity-mutation.d.ts

@@ -0,0 +1,11 @@
+import { Activity } from '../activity/activity.js';
+export declare class InstallableActivityMutation {
+    /**
+     * 양식을 이 도메인에 세운다.
+     *
+     * 세우는 방법은 `installActivity` 한 벌만 갖는다 — 화면에서 누르는 것과 앱이 기동할 때 세우는 것이
+     * 서로 다른 코드를 타면 언젠가 갈라지고, 그때 「화면으로 세운 것만 되는」 결함이 된다.
+     */
+    activateInstallableActivity(name: string, context: ResolverContext): Promise<Activity>;
+    deactivateInstallableActivity(name: string, context: ResolverContext): Promise<Activity>;
+}