@things-factory/ops-master 10.1.247 → 10.1.248

package/dist-server/service/master-change-approval/master-change-axis.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerMasterChangeAxis = registerMasterChangeAxis;
-exports.masterChangeAxis = masterChangeAxis;
-exports.masterChangeAxes = masterChangeAxes;
-const axes = new Map();
-/** Adds an axis to the approval flow. Called at module import, before the schema is built. */
-function registerMasterChangeAxis(axis) {
-    axes.set(axis.axis, axis);
-}
-function masterChangeAxis(axis) {
-    return axes.get(axis);
-}
-function masterChangeAxes() {
-    return [...axes.values()];
-}
-//# sourceMappingURL=master-change-axis.js.map

package/dist-server/service/master-change-approval/master-change-axis.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"master-change-axis.js","sourceRoot":"","sources":["../../../server/service/master-change-approval/master-change-axis.ts"],"names":[],"mappings":";;AAgDA,4DAEC;AAED,4CAEC;AAED,4CAEC;AAbD,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAA;AAEhD,8FAA8F;AAC9F,SAAgB,wBAAwB,CAAC,IAAsB;IAC7D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AAC3B,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC;AAED,SAAgB,gBAAgB;IAC9B,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;AAC3B,CAAC","sourcesContent":["import type { EntityManager } from 'typeorm'\n\n/**\n * One master axis whose changes pass an approval (ADR-0086 decision 1, amended 2026-10-10).\n *\n * ops-master owns the whole flow: the activity template, what the approval publishes, the submit door, the\n * work-door declaration and the readiness check. An axis brings only what is its own — the revision\n * steps and its words. ops-master registers recipe, material definition and test specification; a module\n * whose axis lives elsewhere (work-shift) registers its own with `registerMasterChangeAxis`.\n *\n * The names stay what plant and warehouse used, so activities already installed at a site, and the\n * approval lines set on them, keep working.\n */\nexport interface MasterChangeAxis {\n  /** The policy axis (`ops_master_change_policy.axis`). */\n  axis: string\n  /** The activity name the approval runs under. */\n  activity: string\n  label: string\n  description: string\n  category: string\n  guide: string[]\n  readiness: { stage: string; tests: string[]; gaps: string[]; notes: string }\n  /** Decision-key names for the before/after columns, in this axis's words. */\n  before: string\n  after: string\n  /** The work item's name, before the headline. */\n  issuedAs: string\n  /** How a signed revision is corrected, for the approver. */\n  caveat: string\n  /** The axis's refusal, so a refused submission speaks the axis's codes. */\n  Refusal: new (code: string, detail?: string) => Error\n\n  freeze(manager: EntityManager, domainId: string, userId: string, revisionId: string, editGeneration: number): Promise<{ id: string; reason?: string; contentHash?: string }>\n  approvalInput(manager: EntityManager, domainId: string, revisionId: string): Promise<any>\n  bind(manager: EntityManager, domainId: string, revisionId: string, activityInstanceId: string): Promise<unknown>\n  assertApprovalInput(manager: EntityManager, domainId: string, input: unknown): Promise<unknown>\n  publish(\n    manager: EntityManager,\n    domainId: string,\n    revisionId: string,\n    signed: { activityInstanceId: string; approverId: string; submissionHash: string }\n  ): Promise<unknown>\n}\n\nconst axes = new Map<string, MasterChangeAxis>()\n\n/** Adds an axis to the approval flow. Called at module import, before the schema is built. */\nexport function registerMasterChangeAxis(axis: MasterChangeAxis): void {\n  axes.set(axis.axis, axis)\n}\n\nexport function masterChangeAxis(axis: string): MasterChangeAxis | undefined {\n  return axes.get(axis)\n}\n\nexport function masterChangeAxes(): MasterChangeAxis[] {\n  return [...axes.values()]\n}\n"]}

package/dist-server/service/master-change-approval/master-change-flow.d.ts

@@ -1,65 +0,0 @@
-import { type MasterChangeAxis } from './master-change-axis';
-/**
- * The activity template for an axis, with the callback that publishes the signed revision when the
- * approval ends. The approver reviews in `ops-master-revision-review`.
- */
-export declare function masterChangeActivity(axis: MasterChangeAxis): {
-    name: string;
-    label: string;
-    description: string;
-    guide: string[];
-    release: string;
-    provider: string;
-    category: string;
-    activityType: string;
-    priority: number;
-    readiness: {
-        stage: string;
-        tests: string[];
-        gaps: string[];
-        notes: string;
-    };
-    startingType: string;
-    multiple: string;
-    viewType: string;
-    viewSource: string;
-    decisionKeys: {
-        role: string;
-        inputPath: string;
-        name: string;
-    }[];
-    model: {
-        name: string;
-        tag: string;
-        description: string;
-        hidden: boolean;
-        mandatory: boolean;
-        inout: string;
-        type: string;
-        options: {};
-        unit: any;
-        quantifier: number[];
-        spec: {};
-    }[];
-    standardTime: number;
-    callback: (instance: any, addendum: any, context: any) => Promise<void>;
-};
-/**
- * Submits a draft for approval: the axis must be regulated here and its approval line must stand, then
- * the draft is frozen, the work item issued with what the approver sees, and the two bound.
- */
-export declare function submitMasterChangeDraft(axisName: string, revisionId: string, editGeneration: number, context: ResolverContext): Promise<{
-    revisionId: string;
-    activityInstanceId: string;
-    contentHash?: string;
-}>;
-/**
- * Whether an axis can be made regulated: its activity must have someone who approves. Counted with
- * `isApprovalStep`, because a reference-only line approves nothing and would read as ready by length.
- * An axis with no registered flow gets no report and is not blocked here — `declareMasterChangePolicy`
- * refuses axes without revisions on its own.
- */
-export declare function inspectMasterChangeRoute(manager: any, domainId: string, axisName: string): Promise<{
-    ready: boolean;
-    activity: string;
-}>;

package/dist-server/service/master-change-approval/master-change-flow.js

@@ -1,125 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.masterChangeActivity = masterChangeActivity;
-exports.submitMasterChangeDraft = submitMasterChangeDraft;
-exports.inspectMasterChangeRoute = inspectMasterChangeRoute;
-const shell_1 = require("@things-factory/shell");
-const worklist_1 = require("@things-factory/worklist");
-const master_change_policy_1 = require("../master-change-policy");
-const master_change_axis_1 = require("./master-change-axis");
-const REVISION_MODEL = [
-    {
-        name: 'revision',
-        tag: 'revision',
-        description: 'Frozen revision identity and digest',
-        hidden: true,
-        mandatory: true,
-        inout: 'in',
-        type: 'object',
-        options: {},
-        unit: null,
-        quantifier: [1],
-        spec: {}
-    }
-];
-/**
- * The activity template for an axis, with the callback that publishes the signed revision when the
- * approval ends. The approver reviews in `ops-master-revision-review`.
- */
-function masterChangeActivity(axis) {
-    return {
-        name: axis.activity,
-        label: axis.label,
-        description: axis.description,
-        guide: axis.guide,
-        release: '1.0.0',
-        provider: 'hatiolab.com',
-        category: axis.category,
-        activityType: 'user',
-        priority: 1,
-        readiness: axis.readiness,
-        startingType: 'post',
-        multiple: 'single',
-        viewType: 'custom-element',
-        viewSource: 'ops-master-revision-review',
-        decisionKeys: [
-            { role: 'headline', inputPath: 'headline', name: 'specification' },
-            { role: 'reason', inputPath: 'reason', name: 'reason for change' },
-            { role: 'currentState', inputPath: 'before', name: axis.before },
-            { role: 'consequence', inputPath: 'after', name: axis.after },
-            { role: 'reversibility', inputPath: 'reversibility', name: 'how a signed revision is corrected' },
-            { role: 'consequence', inputPath: 'effectiveFrom', name: 'effective from' }
-        ],
-        model: REVISION_MODEL,
-        standardTime: 24 * 60 * 60,
-        callback: (0, shell_1.speaksRefusals)(async (instance, _addendum, context) => {
-            if (instance.state !== worklist_1.ActivityInstanceStatus.Ended)
-                return;
-            const carried = instance.input?.revision;
-            if (typeof carried?.revisionId !== 'string' || typeof carried?.hash !== 'string') {
-                throw new axis.Refusal('INVALID_SUBMISSION');
-            }
-            const { tx, domain, user } = context.state;
-            await axis.assertApprovalInput(tx, domain.id, instance.input);
-            await axis.publish(tx, domain.id, carried.revisionId, {
-                activityInstanceId: instance.id,
-                approverId: user.id,
-                submissionHash: carried.hash
-            });
-        })
-    };
-}
-/**
- * Submits a draft for approval: the axis must be regulated here and its approval line must stand, then
- * the draft is frozen, the work item issued with what the approver sees, and the two bound.
- */
-async function submitMasterChangeDraft(axisName, revisionId, editGeneration, context) {
-    const axis = (0, master_change_axis_1.masterChangeAxis)(axisName);
-    if (!axis)
-        throw new Error(`submitMasterChangeDraft: no approval flow is registered for the axis "${axisName}"`);
-    const { tx, domain, user } = context.state;
-    const policy = await (0, master_change_policy_1.masterChangePolicy)(tx, domain.id, axis.axis);
-    if (!policy.approvalRequired) {
-        throw new axis.Refusal('APPROVAL_NOT_REQUIRED', 'Publish this draft under the declared non-regulated policy.');
-    }
-    const activity = await (0, worklist_1.activityNamed)(axis.activity, context);
-    if ((await (0, worklist_1.approvalLineStanding)(activity, context)).refusal)
-        throw new axis.Refusal('APPROVAL_LINE_REQUIRED');
-    const draft = await axis.freeze(tx, domain.id, user.id, revisionId, editGeneration);
-    const snapshot = await axis.approvalInput(tx, domain.id, draft.id);
-    const instance = await (0, worklist_1.issue)({
-        name: `${axis.issuedAs} ${snapshot.headline}`,
-        description: draft.reason,
-        activityId: activity.id,
-        approvalLine: activity.approvalLine,
-        input: {
-            headline: snapshot.headline,
-            reason: snapshot.reason,
-            before: snapshot.before,
-            after: snapshot.after,
-            effectiveFrom: snapshot.effectiveFrom,
-            revision: snapshot.revision,
-            reversibility: { reversible: false, kind: 'compensable', caveat: axis.caveat }
-        },
-        threadsMin: 1,
-        threadsMax: 1,
-        requireApproval: true
-    }, context);
-    await axis.bind(tx, domain.id, draft.id, instance.id);
-    return { revisionId: draft.id, activityInstanceId: instance.id, contentHash: draft.contentHash };
-}
-/**
- * Whether an axis can be made regulated: its activity must have someone who approves. Counted with
- * `isApprovalStep`, because a reference-only line approves nothing and would read as ready by length.
- * An axis with no registered flow gets no report and is not blocked here — `declareMasterChangePolicy`
- * refuses axes without revisions on its own.
- */
-async function inspectMasterChangeRoute(manager, domainId, axisName) {
-    const axis = (0, master_change_axis_1.masterChangeAxis)(axisName);
-    if (!axis)
-        return undefined;
-    const activity = await manager.findOneBy(worklist_1.Activity, { domain: { id: domainId }, name: axis.activity });
-    const steps = (activity?.approvalLine || []).filter(worklist_1.isApprovalStep).length;
-    return { ready: steps > 0, activity: axis.activity };
-}
-//# sourceMappingURL=master-change-flow.js.map

package/dist-server/service/master-change-approval/master-change-flow.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"master-change-flow.js","sourceRoot":"","sources":["../../../server/service/master-change-approval/master-change-flow.ts"],"names":[],"mappings":"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","sourcesContent":["import { speaksRefusals } from '@things-factory/shell'\nimport {\n  Activity,\n  ActivityInstanceStatus,\n  activityNamed,\n  approvalLineStanding,\n  isApprovalStep,\n  issue\n} from '@things-factory/worklist'\n\nimport { masterChangePolicy } from '../master-change-policy'\nimport { masterChangeAxis, type MasterChangeAxis } from './master-change-axis'\n\nconst REVISION_MODEL = [\n  {\n    name: 'revision',\n    tag: 'revision',\n    description: 'Frozen revision identity and digest',\n    hidden: true,\n    mandatory: true,\n    inout: 'in',\n    type: 'object',\n    options: {},\n    unit: null,\n    quantifier: [1],\n    spec: {}\n  }\n]\n\n/**\n * The activity template for an axis, with the callback that publishes the signed revision when the\n * approval ends. The approver reviews in `ops-master-revision-review`.\n */\nexport function masterChangeActivity(axis: MasterChangeAxis) {\n  return {\n    name: axis.activity,\n    label: axis.label,\n    description: axis.description,\n    guide: axis.guide,\n    release: '1.0.0',\n    provider: 'hatiolab.com',\n    category: axis.category,\n    activityType: 'user',\n    priority: 1,\n    readiness: axis.readiness,\n    startingType: 'post',\n    multiple: 'single',\n    viewType: 'custom-element',\n    viewSource: 'ops-master-revision-review',\n    decisionKeys: [\n      { role: 'headline', inputPath: 'headline', name: 'specification' },\n      { role: 'reason', inputPath: 'reason', name: 'reason for change' },\n      { role: 'currentState', inputPath: 'before', name: axis.before },\n      { role: 'consequence', inputPath: 'after', name: axis.after },\n      { role: 'reversibility', inputPath: 'reversibility', name: 'how a signed revision is corrected' },\n      { role: 'consequence', inputPath: 'effectiveFrom', name: 'effective from' }\n    ],\n    model: REVISION_MODEL,\n    standardTime: 24 * 60 * 60,\n    callback: speaksRefusals(async (instance: any, _addendum: any, context: ResolverContext) => {\n      if (instance.state !== ActivityInstanceStatus.Ended) return\n\n      const carried = instance.input?.revision\n      if (typeof carried?.revisionId !== 'string' || typeof carried?.hash !== 'string') {\n        throw new axis.Refusal('INVALID_SUBMISSION')\n      }\n\n      const { tx, domain, user } = context.state\n      await axis.assertApprovalInput(tx, domain.id, instance.input)\n      await axis.publish(tx, domain.id, carried.revisionId, {\n        activityInstanceId: instance.id,\n        approverId: user.id,\n        submissionHash: carried.hash\n      })\n    })\n  }\n}\n\n/**\n * Submits a draft for approval: the axis must be regulated here and its approval line must stand, then\n * the draft is frozen, the work item issued with what the approver sees, and the two bound.\n */\nexport async function submitMasterChangeDraft(\n  axisName: string,\n  revisionId: string,\n  editGeneration: number,\n  context: ResolverContext\n): Promise<{ revisionId: string; activityInstanceId: string; contentHash?: string }> {\n  const axis = masterChangeAxis(axisName)\n  if (!axis) throw new Error(`submitMasterChangeDraft: no approval flow is registered for the axis \"${axisName}\"`)\n\n  const { tx, domain, user } = context.state\n\n  const policy = await masterChangePolicy(tx, domain.id, axis.axis as any)\n  if (!policy.approvalRequired) {\n    throw new axis.Refusal('APPROVAL_NOT_REQUIRED', 'Publish this draft under the declared non-regulated policy.')\n  }\n\n  const activity = await activityNamed(axis.activity, context)\n  if ((await approvalLineStanding(activity, context)).refusal) throw new axis.Refusal('APPROVAL_LINE_REQUIRED')\n\n  const draft = await axis.freeze(tx, domain.id, user.id, revisionId, editGeneration)\n  const snapshot = await axis.approvalInput(tx, domain.id, draft.id)\n\n  const instance = await issue(\n    {\n      name: `${axis.issuedAs} ${snapshot.headline}`,\n      description: draft.reason,\n      activityId: activity.id,\n      approvalLine: activity.approvalLine,\n      input: {\n        headline: snapshot.headline,\n        reason: snapshot.reason,\n        before: snapshot.before,\n        after: snapshot.after,\n        effectiveFrom: snapshot.effectiveFrom,\n        revision: snapshot.revision,\n        reversibility: { reversible: false, kind: 'compensable', caveat: axis.caveat }\n      },\n      threadsMin: 1,\n      threadsMax: 1,\n      requireApproval: true\n    } as any,\n    context\n  )\n\n  await axis.bind(tx, domain.id, draft.id, instance.id)\n  return { revisionId: draft.id, activityInstanceId: instance.id, contentHash: draft.contentHash }\n}\n\n/**\n * Whether an axis can be made regulated: its activity must have someone who approves. Counted with\n * `isApprovalStep`, because a reference-only line approves nothing and would read as ready by length.\n * An axis with no registered flow gets no report and is not blocked here — `declareMasterChangePolicy`\n * refuses axes without revisions on its own.\n */\nexport async function inspectMasterChangeRoute(manager: any, domainId: string, axisName: string) {\n  const axis = masterChangeAxis(axisName)\n  if (!axis) return undefined\n\n  const activity = await manager.findOneBy(Activity, { domain: { id: domainId }, name: axis.activity })\n  const steps = ((activity?.approvalLine as any[]) || []).filter(isApprovalStep).length\n\n  return { ready: steps > 0, activity: axis.activity }\n}\n"]}

package/dist-server/service/master-change-approval/master-change-resolver.d.ts

@@ -1,18 +0,0 @@
-/** Submits a frozen master revision for approval, one door per axis whose revisions live here. */
-export declare class MasterChangeApprovalResolver {
-    submitTestSpecificationDraft(revisionId: string, editGeneration: number, context: ResolverContext): Promise<{
-        revisionId: string;
-        activityInstanceId: string;
-        contentHash?: string;
-    }>;
-    submitRecipeDraft(revisionId: string, editGeneration: number, context: ResolverContext): Promise<{
-        revisionId: string;
-        activityInstanceId: string;
-        contentHash?: string;
-    }>;
-    submitMaterialDefinitionDraft(revisionId: string, editGeneration: number, context: ResolverContext): Promise<{
-        revisionId: string;
-        activityInstanceId: string;
-        contentHash?: string;
-    }>;
-}

package/dist-server/service/master-change-approval/master-change-resolver.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MasterChangeApprovalResolver = void 0;
-const tslib_1 = require("tslib");
-const type_graphql_1 = require("type-graphql");
-const shell_1 = require("@things-factory/shell");
-const master_change_flow_1 = require("./master-change-flow");
-/** Submits a frozen master revision for approval, one door per axis whose revisions live here. */
-let MasterChangeApprovalResolver = class MasterChangeApprovalResolver {
-    async submitTestSpecificationDraft(revisionId, editGeneration, context) {
-        return (0, master_change_flow_1.submitMasterChangeDraft)('testSpecification', revisionId, editGeneration, context);
-    }
-    async submitRecipeDraft(revisionId, editGeneration, context) {
-        return (0, master_change_flow_1.submitMasterChangeDraft)('recipeDefinition', revisionId, editGeneration, context);
-    }
-    async submitMaterialDefinitionDraft(revisionId, editGeneration, context) {
-        return (0, master_change_flow_1.submitMasterChangeDraft)('materialDefinition', revisionId, editGeneration, context);
-    }
-};
-exports.MasterChangeApprovalResolver = MasterChangeApprovalResolver;
-tslib_1.__decorate([
-    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
-    (0, type_graphql_1.Directive)('@transaction'),
-    (0, type_graphql_1.Mutation)(() => shell_1.ScalarObject, { description: 'Submit a test specification draft for approval' }),
-    tslib_1.__param(0, (0, type_graphql_1.Arg)('revisionId')),
-    tslib_1.__param(1, (0, type_graphql_1.Arg)('editGeneration', () => type_graphql_1.Int)),
-    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [String, Number, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], MasterChangeApprovalResolver.prototype, "submitTestSpecificationDraft", null);
-tslib_1.__decorate([
-    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
-    (0, type_graphql_1.Directive)('@transaction'),
-    (0, type_graphql_1.Mutation)(() => shell_1.ScalarObject, { description: 'Submit a recipe draft for approval' }),
-    tslib_1.__param(0, (0, type_graphql_1.Arg)('revisionId')),
-    tslib_1.__param(1, (0, type_graphql_1.Arg)('editGeneration', () => type_graphql_1.Int)),
-    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [String, Number, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], MasterChangeApprovalResolver.prototype, "submitRecipeDraft", null);
-tslib_1.__decorate([
-    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
-    (0, type_graphql_1.Directive)('@transaction'),
-    (0, type_graphql_1.Mutation)(() => shell_1.ScalarObject, { description: 'Submit a material definition draft for approval' }),
-    tslib_1.__param(0, (0, type_graphql_1.Arg)('revisionId')),
-    tslib_1.__param(1, (0, type_graphql_1.Arg)('editGeneration', () => type_graphql_1.Int)),
-    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [String, Number, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], MasterChangeApprovalResolver.prototype, "submitMaterialDefinitionDraft", null);
-exports.MasterChangeApprovalResolver = MasterChangeApprovalResolver = tslib_1.__decorate([
-    (0, type_graphql_1.Resolver)(),
-    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
-], MasterChangeApprovalResolver);
-//# sourceMappingURL=master-change-resolver.js.map

package/dist-server/service/master-change-approval/master-change-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"master-change-resolver.js","sourceRoot":"","sources":["../../../server/service/master-change-approval/master-change-resolver.ts"],"names":[],"mappings":";;;;AAAA,+CAA0F;AAE1F,iDAAmE;AAEnE,6DAA8D;AAE9D,kGAAkG;AAG3F,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IAIjC,AAAN,KAAK,CAAC,4BAA4B,CACb,UAAkB,EACH,cAAsB,EACjD,OAAwB;QAE/B,OAAO,IAAA,4CAAuB,EAAC,mBAAmB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IAC1F,CAAC;IAKK,AAAN,KAAK,CAAC,iBAAiB,CACF,UAAkB,EACH,cAAsB,EACjD,OAAwB;QAE/B,OAAO,IAAA,4CAAuB,EAAC,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IACzF,CAAC;IAKK,AAAN,KAAK,CAAC,6BAA6B,CACd,UAAkB,EACH,cAAsB,EACjD,OAAwB;QAE/B,OAAO,IAAA,4CAAuB,EAAC,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IAC3F,CAAC;CACF,CAAA;AAjCY,oEAA4B;AAIjC;IAHL,IAAA,wBAAS,EAAC,qFAAqF,CAAC;IAChG,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,GAAG,EAAE,CAAC,oBAAY,EAAE,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;IAE7F,mBAAA,IAAA,kBAAG,EAAC,YAAY,CAAC,CAAA;IACjB,mBAAA,IAAA,kBAAG,EAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,kBAAG,CAAC,CAAA;IAChC,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;gFAGP;AAKK;IAHL,IAAA,wBAAS,EAAC,qFAAqF,CAAC;IAChG,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,GAAG,EAAE,CAAC,oBAAY,EAAE,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;IAEjF,mBAAA,IAAA,kBAAG,EAAC,YAAY,CAAC,CAAA;IACjB,mBAAA,IAAA,kBAAG,EAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,kBAAG,CAAC,CAAA;IAChC,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;qEAGP;AAKK;IAHL,IAAA,wBAAS,EAAC,qFAAqF,CAAC;IAChG,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,GAAG,EAAE,CAAC,oBAAY,EAAE,EAAE,WAAW,EAAE,iDAAiD,EAAE,CAAC;IAE9F,mBAAA,IAAA,kBAAG,EAAC,YAAY,CAAC,CAAA;IACjB,mBAAA,IAAA,kBAAG,EAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,kBAAG,CAAC,CAAA;IAChC,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;iFAGP;uCAhCU,4BAA4B;IAFxC,IAAA,uBAAQ,GAAE;IACV,IAAA,4BAAa,EAAC,qBAAa,CAAC;GAChB,4BAA4B,CAiCxC","sourcesContent":["import { Arg, Ctx, Directive, Int, Mutation, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { ScalarObject, SpeakRefusals } from '@things-factory/shell'\n\nimport { submitMasterChangeDraft } from './master-change-flow'\n\n/** Submits a frozen master revision for approval, one door per axis whose revisions live here. */\n@Resolver()\n@UseMiddleware(SpeakRefusals)\nexport class MasterChangeApprovalResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(() => ScalarObject, { description: 'Submit a test specification draft for approval' })\n  async submitTestSpecificationDraft(\n    @Arg('revisionId') revisionId: string,\n    @Arg('editGeneration', () => Int) editGeneration: number,\n    @Ctx() context: ResolverContext\n  ) {\n    return submitMasterChangeDraft('testSpecification', revisionId, editGeneration, context)\n  }\n\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(() => ScalarObject, { description: 'Submit a recipe draft for approval' })\n  async submitRecipeDraft(\n    @Arg('revisionId') revisionId: string,\n    @Arg('editGeneration', () => Int) editGeneration: number,\n    @Ctx() context: ResolverContext\n  ) {\n    return submitMasterChangeDraft('recipeDefinition', revisionId, editGeneration, context)\n  }\n\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(() => ScalarObject, { description: 'Submit a material definition draft for approval' })\n  async submitMaterialDefinitionDraft(\n    @Arg('revisionId') revisionId: string,\n    @Arg('editGeneration', () => Int) editGeneration: number,\n    @Ctx() context: ResolverContext\n  ) {\n    return submitMasterChangeDraft('materialDefinition', revisionId, editGeneration, context)\n  }\n}\n"]}

package/dist-server/service/master-change-policy.d.ts

@@ -1,122 +0,0 @@
-import { EntityManager } from 'typeorm';
-import { Domain } from '@things-factory/shell';
-import { User } from '@things-factory/auth-base';
-/**
- * 정책을 정할 수 있는 축들 — 마스터 축 열다섯에 `workShift` 를 더한다.
- *
- * `workShift` 는 별도 모듈이라 `MASTER_AXES` 에 없는데 정책은 받는다(§`policyAxis`).
- */
-export declare const POLICY_AXES: string[];
-/**
- * 이 축의 바뀜을 **개정본으로 결재에 보낼 수 있나** — 승인으로 켤 수 있는 축인가.
- *
- * 마스터 축은 자기 선언(`MasterAxis.revisable`)이 답한다. `workShift` 는 그 표 밖에서 자기 패키지가
- * 개정 체계를 지었으므로 참이다(`work-shift-revision-service`). 앱이 답하지 않는다 — 문이 없으면
- * 어느 앱에서도 보낼 곳이 없다.
- */
-export declare function axisHasRevision(axis: string): boolean;
-/** 도메인 × 축의 기준정보 변경 정책 — 정하는 것도 바꾸는 것도 사업장 소유자의 몫이다. */
-export declare class MasterChangePolicy {
-    id: string;
-    domain: Domain;
-    domainId: string;
-    axis: string;
-    approvalRequired: boolean;
-    reason: string;
-    /**
-     * 이 줄이 물러난 시각 — 비어 있는 줄이 **지금 정책**이다.
-     *
-     * 차례를 `createdAt` 으로 세우지 않는다. sqlite 의 `datetime('now')` 는 초까지라, 한 사람이 같은
-     * 초에 두 번 바꾸면 어느 줄이 나중인지 저장소가 못 가린다. 물러난 줄에 표를 하면 그 물음이 사라진다.
-     */
-    supersededAt: Date;
-    /**
-     * 누가 정했나 — **비어 있으면 아무도 안 정한 것**이고, 그 줄은 기본값으로 선 줄이다.
-     *
-     * 사람이 안 정한 줄에 사람을 적으면 그 사람이 정한 것이 된다. 사업장을 만든 사람도 이 축을 보고
-     * 고른 적이 없다.
-     */
-    creator: User;
-    creatorId: string;
-    createdAt: Date;
-}
-/** 아무도 안 정한 축이 도는 방식 — 바꾸려면 여기 하나만 고치면 된다. */
-export declare const DEFAULT_APPROVAL_REQUIRED = false;
-/**
- * 이 축이 지금 어떻게 도는가. **아무도 안 정했으면 기본값으로 한 줄을 세우고 그것을 답한다.**
- *
- * 전에는 거절했다(`MASTER_POLICY_REQUIRED`). 그래서 새 사업장은 축 열여섯이 전부 막힌 채로 시작했고,
- * 기준정보를 만들려던 사람이 「정책을 먼저 정하라」는 말만 받았다 — 어디서 정하는지는 안 적혀 있었다.
- *
- * 값을 그때그때 지어내지 않고 **줄을 세우는** 까닭은, 개정본이 자기가 어느 정책 아래 만들어졌는지를
- * 그 줄로 가리키기 때문이다(ADR-0090). 가리킬 줄이 없으면 그 물음에 나중에 답할 수 없다.
- *
- * 그 줄의 `creator` 는 비어 있다. 아무도 고른 적이 없다는 것이 사실이고, 사업장을 만든 사람을 적으면
- * 그 사람이 정한 것이 된다.
- */
-export declare function masterChangePolicy(manager: EntityManager, domainId: string, axis: string): Promise<MasterChangePolicy>;
-/**
- * 지금 서 있는 줄.
- *
- * 둘 이상이 서 있으면 **가장 늦게 만들어진 것**을 답한다. 그 상태는 이 코드가 못 만들지만, 물러남
- * 표를 두기 전에 쌓인 줄들이 그렇게 남아 있다. 다음 선언이 전부 물러나게 하고 하나로 정리한다.
- */
-export declare function standingPolicy(manager: EntityManager, domainId: string, axis: string): Promise<MasterChangePolicy>;
-/** 이 도메인에서 지금 서 있는 줄 전부 — 축을 열쇠로. */
-export declare function standingPolicies(manager: EntityManager, domainId: string): Promise<Map<string, MasterChangePolicy>>;
-export declare function declareMasterChangePolicy(manager: EntityManager, domainId: string, actorId: string, axis: string, approvalRequired: boolean, reason: string): Promise<MasterChangePolicy>;
-export declare function assertDirectMasterChange(manager: EntityManager, domainId: string, axis: string): Promise<void>;
-export declare class MasterChangePolicyResolver {
-    masterChangePolicy(axis: string, context: ResolverContext): Promise<{
-        declared: boolean;
-        id: string;
-        domain: Domain;
-        domainId: string;
-        axis: string;
-        approvalRequired: boolean;
-        reason: string;
-        /**
-         * 이 줄이 물러난 시각 — 비어 있는 줄이 **지금 정책**이다.
-         *
-         * 차례를 `createdAt` 으로 세우지 않는다. sqlite 의 `datetime('now')` 는 초까지라, 한 사람이 같은
-         * 초에 두 번 바꾸면 어느 줄이 나중인지 저장소가 못 가린다. 물러난 줄에 표를 하면 그 물음이 사라진다.
-         */
-        supersededAt: Date;
-        /**
-         * 누가 정했나 — **비어 있으면 아무도 안 정한 것**이고, 그 줄은 기본값으로 선 줄이다.
-         *
-         * 사람이 안 정한 줄에 사람을 적으면 그 사람이 정한 것이 된다. 사업장을 만든 사람도 이 축을 보고
-         * 고른 적이 없다.
-         */
-        creator: User;
-        creatorId: string;
-        createdAt: Date;
-    } | {
-        axis: string;
-        declared: boolean;
-        approvalRequired: boolean;
-    }>;
-    /**
-     * 축 전부의 정책 상태 — **안 정한 것도 답한다.**
-     *
-     * 단일 조회처럼 안 정한 축은 기본값과 미선언 상태를 답한다. 목록에는 관리 권한과 결재 경로 상태도 담는다.
-     *
-     * `canDeclare` 는 **이 사람이 소유자인가**다. 화면이 스스로 판단하지 않게 서버가 말한다 —
-     * 눌러 보고 거절당하는 화면이 되지 않도록.
-     */
-    masterChangePolicies(context: ResolverContext): Promise<{
-        canDeclare: boolean;
-        axes: {
-            axis: string;
-            declared: boolean;
-            byDefault: boolean;
-            approvalRequired: boolean;
-            reason: string;
-            declaredAt: Date;
-            revisable: boolean;
-            approvalReady: boolean;
-            approvalActivity: string;
-        }[];
-    }>;
-    declareMasterChangePolicy(axis: string, approvalRequired: boolean, reason: string, context: ResolverContext): Promise<MasterChangePolicy>;
-}