@things-factory/worklist 10.1.248 → 10.1.250

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>;
+}

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

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallableActivityMutation = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const activity_installation_controller_js_1 = require("../../controllers/activity-installation/activity-installation-controller.js");
+const activity_js_1 = require("../activity/activity.js");
+const installable_activity_js_1 = require("./installable-activity.js");
+let InstallableActivityMutation = class InstallableActivityMutation {
+    /**
+     * 양식을 이 도메인에 세운다.
+     *
+     * 세우는 방법은 `installActivity` 한 벌만 갖는다 — 화면에서 누르는 것과 앱이 기동할 때 세우는 것이
+     * 서로 다른 코드를 타면 언젠가 갈라지고, 그때 「화면으로 세운 것만 되는」 결함이 된다.
+     */
+    /*
+     * Authorization (2026-09-11)
+     *
+     * Both mutations here had no `@privilege` directive and no `checkAuthority` call inside, so any
+     * signed-in user of the domain could deactivate an activity. Deactivating one blocks the work it
+     * carries: with `OOC Review` (dataset) deactivated, that domain can no longer raise or process an
+     * out-of-control review.
+     *
+     * The pair is `activity:mutation`. These calls write this module's own `Activity` rows and grant
+     * no capability outside it, so one pair covers both. Seven existing declarations in this package
+     * already use that pair for creating, deleting and enabling the same entity, and both mutations
+     * return `Activity` rather than `Boolean`, which matches those seven rather than a light switch.
+     *
+     * `domainOwnerGranted: true` matches those seven as well. The people who actually call this are
+     * domain owners, and they pass without an explicit grant.
+     *
+     * This closes the door for the first time; it is not a rename, so there is no `legacy` alias to
+     * carry and no record of who was passing through while it was undeclared. If someone is blocked
+     * after this deploys, an administrator grants `activity:mutation` (the privilege row is created
+     * at boot).
+     */
+    async activateInstallableActivity(name, context) {
+        const { domain, user, tx } = context.state;
+        return await (0, activity_installation_controller_js_1.installActivity)(name, domain, { manager: tx, user });
+    }
+    /* Same privilege pair as activating. Deactivating is the heavier of the two: it stops submissions. */
+    async deactivateInstallableActivity(name, context) {
+        const { domain, user, tx } = context.state;
+        const repository = tx.getRepository(activity_js_1.Activity);
+        const activity = await repository.findOneBy({
+            domain: { id: domain.id },
+            name
+        });
+        if (!activity) {
+            return;
+        }
+        return await repository.save({
+            ...activity,
+            state: activity_js_1.ActivityStatus.Deprecated,
+            updater: user
+        });
+    }
+};
+exports.InstallableActivityMutation = InstallableActivityMutation;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "activity", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => activity_js_1.Activity, { description: 'To activate installable activity to Activity on given domain' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('name')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstallableActivityMutation.prototype, "activateInstallableActivity", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "activity", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => activity_js_1.Activity, { description: 'To deactivate installable activity to Activity on given domain' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('name')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstallableActivityMutation.prototype, "deactivateInstallableActivity", null);
+exports.InstallableActivityMutation = InstallableActivityMutation = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(installable_activity_js_1.InstallableActivity)
+], InstallableActivityMutation);
+//# sourceMappingURL=installable-activity-mutation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installable-activity-mutation.js","sourceRoot":"","sources":["../../../server/service/installable-activity/installable-activity-mutation.ts"],"names":[],"mappings":";;;;AAAA,+CAAsE;AAEtE,qIAA6G;AAC7G,yDAAkE;AAClE,uEAA+D;AAGxD,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACtC;;;;;OAKG;IACH;;;;;;;;;;;;;;;;;;;;OAoBG;IAIG,AAAN,KAAK,CAAC,2BAA2B,CAAc,IAAY,EAAS,OAAwB;QAC1F,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAE1C,OAAO,MAAM,IAAA,qDAAe,EAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,sGAAsG;IAIhG,AAAN,KAAK,CAAC,6BAA6B,CAAc,IAAY,EAAS,OAAwB;QAC5F,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,sBAAQ,CAAC,CAAA;QAE7C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC;YAC1C,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;YACzB,IAAI;SACL,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAM;QACR,CAAC;QAED,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC;YAC3B,GAAG,QAAQ;YACX,KAAK,EAAE,4BAAc,CAAC,UAAU;YAChC,OAAO,EAAE,IAAI;SACd,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AA5DY,kEAA2B;AA+BhC;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,mFAAmF,CAAC;IAC9F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,sBAAQ,EAAE,EAAE,WAAW,EAAE,8DAA8D,EAAE,CAAC;IAC5E,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IAAgB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;8EAIlE;AAMK;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,mFAAmF,CAAC;IAC9F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,sBAAQ,EAAE,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC;IAC5E,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IAAgB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;gFAkBpE;sCA3DU,2BAA2B;IADvC,IAAA,uBAAQ,EAAC,6CAAmB,CAAC;GACjB,2BAA2B,CA4DvC","sourcesContent":["import { Arg, Ctx, Directive, Mutation, Resolver } from 'type-graphql'\n\nimport { installActivity } from '../../controllers/activity-installation/activity-installation-controller.js'\nimport { Activity, ActivityStatus } from '../activity/activity.js'\nimport { InstallableActivity } from './installable-activity.js'\n\n@Resolver(InstallableActivity)\nexport class InstallableActivityMutation {\n  /**\n   * 양식을 이 도메인에 세운다.\n   *\n   * 세우는 방법은 `installActivity` 한 벌만 갖는다 — 화면에서 누르는 것과 앱이 기동할 때 세우는 것이\n   * 서로 다른 코드를 타면 언젠가 갈라지고, 그때 「화면으로 세운 것만 되는」 결함이 된다.\n   */\n  /*\n   * Authorization (2026-09-11)\n   *\n   * Both mutations here had no `@privilege` directive and no `checkAuthority` call inside, so any\n   * signed-in user of the domain could deactivate an activity. Deactivating one blocks the work it\n   * carries: with `OOC Review` (dataset) deactivated, that domain can no longer raise or process an\n   * out-of-control review.\n   *\n   * The pair is `activity:mutation`. These calls write this module's own `Activity` rows and grant\n   * no capability outside it, so one pair covers both. Seven existing declarations in this package\n   * already use that pair for creating, deleting and enabling the same entity, and both mutations\n   * return `Activity` rather than `Boolean`, which matches those seven rather than a light switch.\n   *\n   * `domainOwnerGranted: true` matches those seven as well. The people who actually call this are\n   * domain owners, and they pass without an explicit grant.\n   *\n   * This closes the door for the first time; it is not a rename, so there is no `legacy` alias to\n   * carry and no record of who was passing through while it was undeclared. If someone is blocked\n   * after this deploys, an administrator grants `activity:mutation` (the privilege row is created\n   * at boot).\n   */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"activity\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Activity, { description: 'To activate installable activity to Activity on given domain' })\n  async activateInstallableActivity(@Arg('name') name: string, @Ctx() context: ResolverContext): Promise<Activity> {\n    const { domain, user, tx } = context.state\n\n    return await installActivity(name, domain, { manager: tx, user })\n  }\n\n  /* Same privilege pair as activating. Deactivating is the heavier of the two: it stops submissions. */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"activity\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Activity, { description: 'To deactivate installable activity to Activity on given domain' })\n  async deactivateInstallableActivity(@Arg('name') name: string, @Ctx() context: ResolverContext): Promise<Activity> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Activity)\n\n    const activity = await repository.findOneBy({\n      domain: { id: domain.id },\n      name\n    })\n\n    if (!activity) {\n      return\n    }\n\n    return await repository.save({\n      ...activity,\n      state: ActivityStatus.Deprecated,\n      updater: user\n    })\n  }\n}\n"]}

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

@@ -0,0 +1,22 @@
+import { ListParam } from '@things-factory/shell';
+import { InstallableActivity } from './installable-activity.js';
+import { InstallableActivityList } from './installable-activity-type.js';
+export declare class InstallableActivityQuery {
+    installableActivity(name: string, context: ResolverContext): Promise<InstallableActivity>;
+    installableActivities(params: ListParam, context: ResolverContext): Promise<InstallableActivityList>;
+    /** The key `label` is translated from. Computed from `name`, never stored — see activityTKey. */
+    labelTKey(one: InstallableActivity): string;
+    /** One key per `guide` line, in the same order and always the same length. */
+    guideTKeys(one: InstallableActivity): string[];
+    /**
+     * The keys `readiness.notes` and `readiness.gaps` are translated from.
+     *
+     * The catalog is built at boot, before any request names a locale, so the module keeps declaring
+     * sentences and the screen reads a translation of them - the same arrangement as label and guide
+     * (ADR-0054). A module that declares nothing gets no keys to look up, and the screen shows
+     * nothing, which is what it did before.
+     */
+    readinessNotesTKey(one: InstallableActivity): string;
+    /** One key per `readiness.gaps` line, in the same order and always the same length. */
+    readinessGapTKeys(one: InstallableActivity): string[];
+}

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

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallableActivityQuery = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const activity_installation_controller_js_1 = require("../../controllers/activity-installation/activity-installation-controller.js");
+const activity_js_1 = require("../activity/activity.js");
+const installable_activity_js_1 = require("./installable-activity.js");
+const approval_line_js_1 = require("../../controllers/activity-approval/approval-line.js");
+const installable_activity_type_js_1 = require("./installable-activity-type.js");
+const decision_key_declaration_js_1 = require("../activity/decision-key-declaration.js");
+let InstallableActivityQuery = class InstallableActivityQuery {
+    async installableActivity(name, context) {
+        return await activity_installation_controller_js_1.ActivityInstallations.get(name);
+    }
+    async installableActivities(params, context) {
+        const { domain } = context.state;
+        const items = activity_installation_controller_js_1.ActivityInstallations.list();
+        for (var item of items) {
+            item.activity = await (0, shell_1.getRepository)(activity_js_1.Activity).findOneBy({
+                domain: { id: domain.id },
+                name: item.name
+            });
+            /*
+             * 「이 도메인이 이 단계를 쓰나」를 값으로 낸다 — 판단은 여기서 다시 짜지 않는다.
+             *
+             * `isApprovalStep` 이 참조를 걸러 내는 그 자리다. 화면이 길이를 세면 참조만 있는 결재선을
+             * 「결재자 있음」으로 그리고, 실제로는 그냥 지나간다.
+             */
+            item.approvalSteps = (item.activity?.approvalLine || []).filter(approval_line_js_1.isApprovalStep).length;
+        }
+        /*
+         * Identified-but-unbuilt work comes out of this query too, because the catalog is the plan of
+         * record — "what is left" has to be answerable on the screen.
+         *
+         * Shaped to look like an installable activity so the screen has one list to draw, but it
+         * carries no `activity` (nothing is installed) and no callback. Its stage says planned or
+         * not-worklist, and the screen keeps those apart from the built ones: a decision must not read
+         * as a promise.
+         */
+        const intended = activity_installation_controller_js_1.ActivityInstallations.listIntended().map(one => ({
+            name: one.key,
+            label: one.label,
+            description: undefined,
+            guide: one.guide,
+            category: one.category,
+            readiness: one.readiness
+        }));
+        const merged = [...items, ...intended];
+        return { items: merged, total: merged.length };
+    }
+    /** The key `label` is translated from. Computed from `name`, never stored — see activityTKey. */
+    labelTKey(one) {
+        return (0, decision_key_declaration_js_1.activityTKey)(one.name, 'label');
+    }
+    /** One key per `guide` line, in the same order and always the same length. */
+    guideTKeys(one) {
+        return (0, decision_key_declaration_js_1.activityGuideTKeys)(one.name, one.guide);
+    }
+    /**
+     * The keys `readiness.notes` and `readiness.gaps` are translated from.
+     *
+     * The catalog is built at boot, before any request names a locale, so the module keeps declaring
+     * sentences and the screen reads a translation of them - the same arrangement as label and guide
+     * (ADR-0054). A module that declares nothing gets no keys to look up, and the screen shows
+     * nothing, which is what it did before.
+     */
+    readinessNotesTKey(one) {
+        return (0, decision_key_declaration_js_1.activityTKey)(one.name, 'readiness-notes');
+    }
+    /** One key per `readiness.gaps` line, in the same order and always the same length. */
+    readinessGapTKeys(one) {
+        return (0, decision_key_declaration_js_1.activityReadinessGapTKeys)(one.name, one.readiness?.gaps);
+    }
+};
+exports.InstallableActivityQuery = InstallableActivityQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => installable_activity_js_1.InstallableActivity, { nullable: true, description: 'To fetch a InstallableActivity' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('name')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstallableActivityQuery.prototype, "installableActivity", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => installable_activity_type_js_1.InstallableActivityList, { description: 'To fetch multiple InstallableActivitys' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InstallableActivityQuery.prototype, "installableActivities", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => String, { description: 'i18n key the label is translated from, computed from name' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:returntype", String)
+], InstallableActivityQuery.prototype, "labelTKey", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [String], { description: 'One i18n key per guide line, in order, computed from name' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:returntype", Array)
+], InstallableActivityQuery.prototype, "guideTKeys", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => String, { description: 'i18n key readiness.notes is translated from, computed from name' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:returntype", String)
+], InstallableActivityQuery.prototype, "readinessNotesTKey", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [String], {
+        description: 'One i18n key per readiness.gaps line, in order, computed from name'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:returntype", Array)
+], InstallableActivityQuery.prototype, "readinessGapTKeys", null);
+exports.InstallableActivityQuery = InstallableActivityQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(installable_activity_js_1.InstallableActivity)
+], InstallableActivityQuery);
+//# sourceMappingURL=installable-activity-query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installable-activity-query.js","sourceRoot":"","sources":["../../../server/service/installable-activity/installable-activity-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Args, Ctx, Query, Resolver, FieldResolver, Root } from 'type-graphql'\nimport { Domain, getRepository, ListParam } from '@things-factory/shell'\n\nimport { ActivityInstallations } from '../../controllers/activity-installation/activity-installation-controller.js'\nimport { Activity } from '../activity/activity.js'\nimport { InstallableActivity } from './installable-activity.js'\nimport { isApprovalStep } from '../../controllers/activity-approval/approval-line.js'\nimport { InstallableActivityList } from './installable-activity-type.js'\nimport { activityGuideTKeys, activityReadinessGapTKeys, activityTKey } from '../activity/decision-key-declaration.js'\n\n@Resolver(InstallableActivity)\nexport class InstallableActivityQuery {\n  @Query(returns => InstallableActivity!, { nullable: true, description: 'To fetch a InstallableActivity' })\n  async installableActivity(@Arg('name') name: string, @Ctx() context: ResolverContext): Promise<InstallableActivity> {\n    return await ActivityInstallations.get(name)\n  }\n\n  @Query(returns => InstallableActivityList, { description: 'To fetch multiple InstallableActivitys' })\n  async installableActivities(\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<InstallableActivityList> {\n    const { domain } = context.state\n\n    const items = ActivityInstallations.list()\n\n    for (var item of items) {\n      item.activity = await getRepository(Activity).findOneBy({\n        domain: { id: domain.id },\n        name: item.name\n      })\n\n      /*\n       * 「이 도메인이 이 단계를 쓰나」를 값으로 낸다 — 판단은 여기서 다시 짜지 않는다.\n       *\n       * `isApprovalStep` 이 참조를 걸러 내는 그 자리다. 화면이 길이를 세면 참조만 있는 결재선을\n       * 「결재자 있음」으로 그리고, 실제로는 그냥 지나간다.\n       */\n      item.approvalSteps = (item.activity?.approvalLine || []).filter(isApprovalStep).length\n    }\n\n    /*\n     * Identified-but-unbuilt work comes out of this query too, because the catalog is the plan of\n     * record — \"what is left\" has to be answerable on the screen.\n     *\n     * Shaped to look like an installable activity so the screen has one list to draw, but it\n     * carries no `activity` (nothing is installed) and no callback. Its stage says planned or\n     * not-worklist, and the screen keeps those apart from the built ones: a decision must not read\n     * as a promise.\n     */\n    const intended: InstallableActivity[] = ActivityInstallations.listIntended().map(one => ({\n      name: one.key,\n      label: one.label,\n      description: undefined,\n      guide: one.guide,\n      category: one.category,\n      readiness: one.readiness\n    }))\n\n    const merged = [...items, ...intended]\n\n    return { items: merged, total: merged.length }\n  }\n\n  /** The key `label` is translated from. Computed from `name`, never stored — see activityTKey. */\n  @FieldResolver(type => String, { description: 'i18n key the label is translated from, computed from name' })\n  labelTKey(@Root() one: InstallableActivity): string {\n    return activityTKey(one.name, 'label')\n  }\n\n  /** One key per `guide` line, in the same order and always the same length. */\n  @FieldResolver(type => [String], { description: 'One i18n key per guide line, in order, computed from name' })\n  guideTKeys(@Root() one: InstallableActivity): string[] {\n    return activityGuideTKeys(one.name, one.guide)\n  }\n\n  /**\n   * The keys `readiness.notes` and `readiness.gaps` are translated from.\n   *\n   * The catalog is built at boot, before any request names a locale, so the module keeps declaring\n   * sentences and the screen reads a translation of them - the same arrangement as label and guide\n   * (ADR-0054). A module that declares nothing gets no keys to look up, and the screen shows\n   * nothing, which is what it did before.\n   */\n  @FieldResolver(type => String, { description: 'i18n key readiness.notes is translated from, computed from name' })\n  readinessNotesTKey(@Root() one: InstallableActivity): string {\n    return activityTKey(one.name, 'readiness-notes')\n  }\n\n  /** One key per `readiness.gaps` line, in the same order and always the same length. */\n  @FieldResolver(type => [String], {\n    description: 'One i18n key per readiness.gaps line, in order, computed from name'\n  })\n  readinessGapTKeys(@Root() one: InstallableActivity): string[] {\n    return activityReadinessGapTKeys(one.name, one.readiness?.gaps)\n  }\n}\n"]}

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

@@ -0,0 +1,5 @@
+import { InstallableActivity } from './installable-activity.js';
+export declare class InstallableActivityList {
+    items: InstallableActivity[];
+    total: number;
+}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallableActivityList = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const installable_activity_js_1 = require("./installable-activity.js");
+let InstallableActivityList = class InstallableActivityList {
+};
+exports.InstallableActivityList = InstallableActivityList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [installable_activity_js_1.InstallableActivity]),
+    tslib_1.__metadata("design:type", Array)
+], InstallableActivityList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], InstallableActivityList.prototype, "total", void 0);
+exports.InstallableActivityList = InstallableActivityList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], InstallableActivityList);
+//# sourceMappingURL=installable-activity-type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installable-activity-type.js","sourceRoot":"","sources":["../../../server/service/installable-activity/installable-activity-type.ts"],"names":[],"mappings":";;;;AAAA,+CAAqD;AAErD,uEAA+D;AAGxD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAMnC,CAAA;AANY,0DAAuB;AAElC;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,6CAAmB,CAAC,CAAC;;sDACT;AAG5B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,CAAC;;sDACN;kCALF,uBAAuB;IADnC,IAAA,yBAAU,GAAE;GACA,uBAAuB,CAMnC","sourcesContent":["import { Field, Int, ObjectType } from 'type-graphql'\n\nimport { InstallableActivity } from './installable-activity.js'\n\n@ObjectType()\nexport class InstallableActivityList {\n  @Field(type => [InstallableActivity])\n  items: InstallableActivity[]\n\n  @Field(type => Int)\n  total: number\n}\n"]}

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

@@ -0,0 +1,92 @@
+import { Activity, ActivityStartingType, ActivityType, ActivityUIType, MultipleInstanceType } from '../activity/activity.js';
+import { ActivityModelItem } from '../activity/activity-model-type.js';
+import { ActivityDecisionKeyItem } from '../activity/activity-decision-key-item-type.js';
+import { ActivityReadiness } from './activity-readiness.js';
+import { UpdateActivityInstanceStateAddendum } from '../../controllers/common.js';
+export declare class InstallableActivity {
+    /**
+     * The key. **Not a name to show anyone.**
+     *
+     * The callback is found by this value (`activityInstance.activity.name`), so renaming it stops
+     * the callback from running — an approval completes and the effect never happens, with nothing
+     * on screen to say so. plant hit exactly that on 2026-09-01.
+     */
+    name?: string;
+    /**
+     * What to call this work on screen, when the key is not something a person reads.
+     *
+     * The catalog showed 「MES Disposition Approval」 among twenty-three Korean cards because the key
+     * was the only name it had. Declared work already carried a `label` for this; built work had
+     * nowhere to put one, so the identifier leaked into the screen.
+     *
+     * Optional. Without it the catalog falls back to the key, which is right for activities whose
+     * key already reads as a name.
+     */
+    label?: string;
+    release?: string;
+    provider?: string;
+    /** One line for developers, in English, like every other GraphQL description in this repo. */
+    description?: string;
+    /**
+     * What this work is, **in the words of the person who receives it.**
+     *
+     * `description` is written for us and it is English by convention, so a Korean screen showing it
+     * to an approver says nothing useful. This field is the sentence that person actually needs:
+     * when the item reaches them, and what happens once they approve it.
+     *
+     * Plain sentences, never keys. A translation is read from `guideTKeys` — one key per line,
+     * computed from `name` — with the sentence here as its default. A value that could be either a key
+     * or a sentence leaves no way to count which keys a locale is missing.
+     */
+    guide?: string[];
+    category?: string;
+    activityType?: ActivityType;
+    priority?: number;
+    startingType?: ActivityStartingType;
+    multiple?: MultipleInstanceType;
+    model?: ActivityModelItem[];
+    /**
+     * Which input values an approver judges by. See Activity.decisionKeys.
+     *
+     * A field declared here reaches the Activity row only if it is named in ACTIVITY_ROW_FIELDS and
+     * the entity has a column for it. It used to be a spread, which dropped what it did not recognise
+     * and reported success; naming the fields means a new one has to be wired over on purpose.
+     */
+    decisionKeys?: ActivityDecisionKeyItem[];
+    uiType?: ActivityUIType;
+    uiSource?: string;
+    viewType?: ActivityUIType;
+    viewSource?: string;
+    reportType?: ActivityUIType;
+    reportSource?: string;
+    thumbnail?: string;
+    activity?: Activity;
+    /**
+     * **이 도메인이 이 단계를 쓰나** — 세워진 양식의 결재선에 결재자가 있나.
+     *
+     * 결재선은 양식이 아니라 **그 현장이 정하는 것**이다(installActivity 머리말). 그래서 같은 업무가
+     * 어느 공장에서는 결재를 받고 어느 공장에서는 그냥 지나간다.
+     *
+     * 그 사실이 지금까지 **기동 로그 한 줄**에만 있었다 — 「결재선 비어 있음 miratek, system」. 로그는
+     * 기동할 때 한 번 지나가고 그 뒤로 아무 데도 없다. 사람이 조치해야 하는 사실의 집이 아니다.
+     *
+     * 세지 않는 것 둘을 적어 둔다.
+     *
+     * - **사람 수가 아니라 단계 수다.** 역할로 걸린 한 단계는 그 역할을 가진 여러 사람이 본다. 「3명」
+     *   이라고 적으면 틀린 수를 말하게 된다.
+     * - **참조는 세지 않는다.** 참조는 결재를 막지 않으므로, 참조만 있는 결재선은 결재자가 없는 것과
+     *   같다(needsApproval). 세면 「이 단계를 쓴다」로 읽히는데 실제로는 그냥 지나간다.
+     *
+     * 비어 있다는 것이 무슨 일을 뜻하는지는 **업무마다 다르다** — 부적합 처분은 상신이 막히고, 정비
+     * 완료 확인은 확인 없이 닫힌다. 그 결과는 각 업무의 guide 가 말할 자리다. 이 칸은 사실만 낸다.
+     */
+    approvalSteps?: number;
+    /**
+     * What the registering module says about how far along this type is.
+     *
+     * Declared, not computed — see ActivityReadiness. Missing means nobody has said, which the
+     * screen shows as 「선언 없음」 rather than as a zero.
+     */
+    readiness?: ActivityReadiness;
+    callback?: (content: any, addendum: UpdateActivityInstanceStateAddendum, context: ResolverContext) => void;
+}