@things-factory/ops-master 10.1.246 → 10.1.248

package/dist-server/service/material/material-revision-service.js

@@ -1,687 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MaterialDefinitionRefusal = void 0;
-exports.materialDefinitionSubmissionHash = materialDefinitionSubmissionHash;
-exports.materialDefinitionApprovalInput = materialDefinitionApprovalInput;
-exports.assertMaterialDefinitionApprovalInput = assertMaterialDefinitionApprovalInput;
-exports.createMaterialDefinitionDraft = createMaterialDefinitionDraft;
-exports.editMaterialDefinitionDraft = editMaterialDefinitionDraft;
-exports.freezeMaterialDefinitionDraft = freezeMaterialDefinitionDraft;
-exports.bindMaterialDefinitionApproval = bindMaterialDefinitionApproval;
-exports.publishMaterialDefinitionRevision = publishMaterialDefinitionRevision;
-exports.publishUnregulatedMaterialDefinition = publishUnregulatedMaterialDefinition;
-exports.resolveMaterialDefinition = resolveMaterialDefinition;
-exports.standMaterialDefinitionBaselines = standMaterialDefinitionBaselines;
-exports.materialDefinitionRevisionForBasis = materialDefinitionRevisionForBasis;
-exports.captureMaterialDefinitionBasis = captureMaterialDefinitionBasis;
-exports.materialDefinitionRevisionOverview = materialDefinitionRevisionOverview;
-exports.effectiveMaterialDefinition = effectiveMaterialDefinition;
-exports.saveAndPublishMaterialDefinition = saveAndPublishMaterialDefinition;
-const node_crypto_1 = require("node:crypto");
-const typeorm_1 = require("typeorm");
-const shell_1 = require("@things-factory/shell");
-const master_change_policy_1 = require("../master-change-policy");
-const material_revision_content_1 = require("./material-revision-content");
-const material_definition_1 = require("./material-definition");
-const material_class_1 = require("./material-class");
-const test_specification_1 = require("../test-spec/test-specification");
-const material_revision_1 = require("./material-revision");
-const approval_input_1 = require("../master-change-approval/approval-input");
-const row_lock_1 = require("../row-lock");
-class MaterialDefinitionRefusal extends shell_1.Refusal {
-    constructor(code, detail) {
-        super(code, {}, detail ?? MATERIAL_DEFINITION_REFUSALS[code] ?? 'The material definition change could not be applied.');
-    }
-}
-exports.MaterialDefinitionRefusal = MaterialDefinitionRefusal;
-const MATERIAL_DEFINITION_REFUSALS = {
-    TRANSACTION_REQUIRED: 'This change requires a transaction.',
-    INVALID_INSTANT: 'Enter a valid date and time including its time zone.',
-    INVALID_CONTENT: 'The proposed material content is invalid.',
-    MATERIAL_NOT_FOUND: 'The material does not exist in this domain.',
-    REVISION_NOT_FOUND: 'The revision does not exist in this domain.',
-    INVALID_BASE_REVISION: 'The proposed change is based on a different revision.',
-    DRAFT_NOT_OWNED: 'Only the draft author can edit or submit it.',
-    REVISION_FROZEN: 'This submitted revision cannot be edited. Create another draft.',
-    DRAFT_CONFLICT: 'The draft changed. Reload it before saving.',
-    PLAN_CONFLICT: 'The approved schedule changed. Review and submit a new draft.',
-    INVALID_SUBMISSION: 'The submitted content does not match the frozen revision.',
-    AUTHOR_CANNOT_APPROVE: 'The author cannot approve their own change.',
-    RETROACTIVE_IMPACT: 'This change would alter material definitions already used by recorded transactions.',
-    FUTURE_PLAN_CONFLICT: 'This change conflicts with an approved future schedule.',
-    NO_EFFECTIVE_REVISION: 'There is no published revision effective at the business time.',
-    AMBIGUOUS_EFFECTIVITY: 'More than one revision is effective at the business time.',
-    REVISION_INTEGRITY_FAILURE: 'The stored revision does not match its signed content.',
-    BASIS_CONFLICT: 'This transaction already has a different material or business time.',
-    APPROVAL_LINE_REQUIRED: 'Configure an approval line before submitting this change.',
-    REVISION_REQUIRED: 'Change the material through a revision draft.'
-};
-function refuse(code, detail) {
-    throw new MaterialDefinitionRefusal(code, detail);
-}
-function transaction(manager) {
-    if (!manager.queryRunner?.isTransactionActive)
-        refuse('TRANSACTION_REQUIRED');
-}
-function instant(value) {
-    if (!(value instanceof Date) && (typeof value !== 'string' || !/(Z|[+-]\d{2}:\d{2})$/.test(value)))
-        refuse('INVALID_INSTANT');
-    const result = new Date(value);
-    if (!Number.isFinite(result.getTime()))
-        refuse('INVALID_INSTANT');
-    return result;
-}
-function text(value, field) {
-    if (typeof value !== 'string' || !value.trim())
-        refuse('INVALID_CONTENT', field);
-    return value.trim();
-}
-/** Sorted object keys, ordered arrays, ISO instants. This is the v1 submission encoding. */
-function canonical(value) {
-    if (value === null || typeof value !== 'object')
-        return JSON.stringify(value);
-    if (Array.isArray(value))
-        return '[' + value.map(canonical).join(',') + ']';
-    return ('{' +
-        Object.keys(value)
-            .sort()
-            .map(key => JSON.stringify(key) + ':' + canonical(value[key]))
-            .join(',') +
-        '}');
-}
-function materialDefinitionSubmissionHash(revision) {
-    return (0, node_crypto_1.createHash)('sha256')
-        .update(canonical({
-        schemaVersion: 1,
-        revisionNumber: revision.revisionNumber,
-        policyId: revision.policyId,
-        domainId: revision.domainId,
-        materialId: revision.materialId,
-        baseRevisionId: revision.baseRevisionId,
-        baseGeneration: revision.baseGeneration,
-        description: revision.description,
-        materialClassIds: revision.materialClassIds,
-        properties: revision.properties,
-        testSpecificationIds: revision.testSpecificationIds,
-        effectiveFrom: revision.effectiveFrom.toISOString(),
-        reason: revision.reason
-    }))
-        .digest('hex');
-}
-/** Display values are a checked projection of the frozen revision, never a second editable source. */
-async function materialDefinitionApprovalInput(manager, domainId, revisionId) {
-    const draft = await revision(manager, domainId, revisionId);
-    if (!draft.frozenAt || draft.contentHash !== materialDefinitionSubmissionHash(draft))
-        refuse('INVALID_SUBMISSION');
-    const material = await subject(manager, domainId, draft.materialId);
-    const base = draft.baseRevisionId ? await revision(manager, domainId, draft.baseRevisionId) : null;
-    const plan = base ? await manager.findOneBy(material_revision_1.MaterialDefinitionPlan, {
-        domain: { id: domainId }, material: { id: draft.materialId }, generation: draft.baseGeneration
-    }) : null;
-    const segment = plan && base ? await manager.findOneBy(material_revision_1.MaterialDefinitionSegment, {
-        domain: { id: domainId }, plan: { id: plan.id }, revision: { id: base.id }
-    }) : null;
-    /*
-     * How the base was published (2026-10-20) — the approval screen names a baseline base in plain words. Only the
-     * base carries it: it was published before this draft existed and never changes, so the snapshot stays pinned.
-     * The proposal is unpublished here and would read differently once published.
-     */
-    const basePlan = base ? await manager.findOneBy(material_revision_1.MaterialDefinitionPlan, { domain: { id: domainId }, publishedRevision: { id: base.id } }) : null;
-    const values = (row) => ({
-        revisionNumber: row.revisionNumber,
-        detail: {
-            revisionId: row.id, createdAt: row.createdAt.toISOString(), frozenAt: row.frozenAt?.toISOString(),
-            effectiveFrom: row.effectiveFrom.toISOString(), reason: row.reason,
-            ...(row.id === base?.id ? { releaseKind: basePlan?.releaseKind ?? null } : {}),
-            ...(row.id === base?.id && segment ? { validFrom: segment.validFrom.toISOString(), validTo: segment.validTo?.toISOString() ?? null } : {})
-        },
-        description: row.description,
-        materialClassIds: row.materialClassIds,
-        properties: row.properties,
-        testSpecificationIds: row.testSpecificationIds
-    });
-    return {
-        headline: material.name,
-        reason: draft.reason,
-        effectiveFrom: draft.effectiveFrom.toISOString(),
-        before: base ? values(base) : null,
-        after: values(draft),
-        revision: {
-            revisionId: draft.id,
-            hash: draft.contentHash,
-            materialId: draft.materialId,
-            baseGeneration: draft.baseGeneration
-        }
-    };
-}
-async function assertMaterialDefinitionApprovalInput(manager, domainId, input) {
-    const reference = input?.revision;
-    if (typeof reference?.revisionId !== 'string')
-        refuse('INVALID_SUBMISSION');
-    const expected = await materialDefinitionApprovalInput(manager, domainId, reference.revisionId);
-    if (!(0, approval_input_1.approvalInputMatches)(input, expected))
-        refuse('INVALID_SUBMISSION');
-}
-function content(input) {
-    return { ...(0, material_revision_content_1.materialDraftContent)(input), effectiveFrom: instant(input.effectiveFrom), reason: text(input.reason, 'reason') };
-}
-async function subject(manager, domainId, materialId) {
-    const material = await manager.findOne(material_definition_1.MaterialDefinition, {
-        where: { id: materialId, domain: { id: domainId } },
-        ...(0, row_lock_1.writeLockOn)(manager, material_definition_1.MaterialDefinition)
-    });
-    if (!material)
-        refuse('MATERIAL_NOT_FOUND');
-    // Compare the current head and latest persisted plan in one SQL snapshot. A historical
-    // knownAt query must not compare its selected old plan with the current head.
-    const head = await manager.createQueryBuilder(material_definition_1.MaterialDefinition, 'head')
-        .leftJoin(material_revision_1.MaterialDefinitionPlan, 'plan', 'plan.material = head.id AND plan.domain = head.domain')
-        .select('head.planGeneration', 'generation')
-        .addSelect('MAX(plan.generation)', 'latest')
-        .where({ id: materialId, domain: { id: domainId } })
-        .groupBy('head.id').addGroupBy('head.planGeneration')
-        .getRawOne();
-    if (!head || Number(head.generation) !== Number(head.latest ?? 0)) {
-        throw new shell_1.Refusal('PLAN_INTEGRITY_FAILURE', {}, 'The current plan generation does not match the latest published plan. Contact an administrator.');
-    }
-    return material;
-}
-async function revision(manager, domainId, revisionId, locked = true) {
-    const found = await manager.findOne(material_revision_1.MaterialDefinitionRevision, {
-        where: { id: revisionId, domain: { id: domainId } },
-        ...(locked ? (0, row_lock_1.writeLockOn)(manager, material_revision_1.MaterialDefinitionRevision) : {})
-    });
-    if (!found)
-        refuse('REVISION_NOT_FOUND');
-    return found;
-}
-/** A write lock valid on every supported SQL backend, including SQLite (no SELECT FOR UPDATE). */
-async function lockSubject(manager, domainId, materialId) {
-    transaction(manager);
-    const locked = await manager
-        .createQueryBuilder()
-        .update(material_definition_1.MaterialDefinition)
-        .set({ revisionLock: () => 'revision_lock + 1' })
-        .where({ id: materialId, domain: { id: domainId } })
-        .execute();
-    if (locked.affected !== 1)
-        refuse('MATERIAL_NOT_FOUND');
-    return subject(manager, domainId, materialId);
-}
-async function createMaterialDefinitionDraft(manager, domainId, creatorId, asked) {
-    transaction(manager);
-    const accepted = content(asked.content);
-    await (0, material_revision_content_1.validateMaterialReferences)(manager, domainId, accepted);
-    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'materialDefinition');
-    let material;
-    if (asked.materialId) {
-        material = await lockSubject(manager, domainId, asked.materialId);
-    }
-    else {
-        material = await manager.save(material_definition_1.MaterialDefinition, manager.create(material_definition_1.MaterialDefinition, {
-            domain: { id: domainId },
-            name: text(asked.name, 'name'),
-            planGeneration: 0,
-            revisionLock: 0,
-            creator: { id: creatorId },
-            updater: { id: creatorId }
-        }));
-    }
-    const previous = await manager.findOne(material_revision_1.MaterialDefinitionRevision, {
-        where: { domain: { id: domainId }, material: { id: material.id } }, order: { revisionNumber: 'DESC' },
-        ...(0, row_lock_1.writeLockOn)(manager, material_revision_1.MaterialDefinitionRevision)
-    });
-    const revisionNumber = (previous?.revisionNumber ?? 0) + 1;
-    let baseRevisionId = null;
-    if (material.planGeneration > 0) {
-        baseRevisionId = (await resolveMaterialDefinition(manager, domainId, material.id, accepted.effectiveFrom)).revision.id;
-    }
-    if (asked.baseRevisionId && asked.baseRevisionId !== baseRevisionId)
-        refuse('INVALID_BASE_REVISION');
-    const saved = await manager.save(material_revision_1.MaterialDefinitionRevision, manager.create(material_revision_1.MaterialDefinitionRevision, {
-        ...accepted,
-        policy: { id: policy.id },
-        domain: { id: domainId },
-        material: { id: material.id },
-        baseRevision: baseRevisionId ? { id: baseRevisionId } : null,
-        baseGeneration: material.planGeneration,
-        revisionNumber,
-        editGeneration: 0,
-        creator: { id: creatorId },
-        createdAt: new Date(),
-        frozenAt: null,
-        contentHash: null,
-        activityInstanceId: null
-    }));
-    return revision(manager, domainId, saved.id);
-}
-async function editMaterialDefinitionDraft(manager, domainId, actorId, revisionId, expectedEditGeneration, input) {
-    transaction(manager);
-    const accepted = content(input);
-    await (0, material_revision_content_1.validateMaterialReferences)(manager, domainId, accepted);
-    const initial = await revision(manager, domainId, revisionId, false);
-    const material = await lockSubject(manager, domainId, initial.materialId);
-    const draft = await revision(manager, domainId, revisionId);
-    if (draft.creatorId !== actorId)
-        refuse('DRAFT_NOT_OWNED');
-    if (draft.frozenAt)
-        refuse('REVISION_FROZEN');
-    if (draft.baseGeneration !== material.planGeneration)
-        refuse('PLAN_CONFLICT');
-    // Moving the effective date across a scheduled boundary changes the before-image.
-    const baseRevisionId = material.planGeneration > 0
-        ? (await resolveMaterialDefinition(manager, domainId, material.id, accepted.effectiveFrom)).revision.id
-        : null;
-    const updated = await manager
-        .createQueryBuilder()
-        .update(material_revision_1.MaterialDefinitionRevision)
-        .set({
-        ...accepted,
-        baseRevision: baseRevisionId ? { id: baseRevisionId } : null,
-        editGeneration: expectedEditGeneration + 1
-    })
-        .where({
-        id: revisionId,
-        domain: { id: domainId },
-        creator: { id: actorId },
-        editGeneration: expectedEditGeneration
-    })
-        .andWhere('frozen_at IS NULL')
-        .execute();
-    if (updated.affected !== 1)
-        refuse('DRAFT_CONFLICT');
-    return revision(manager, domainId, revisionId);
-}
-/** Product calls this in the same transaction as issuing its worklist approval. */
-async function freezeMaterialDefinitionDraft(manager, domainId, actorId, revisionId, expectedEditGeneration) {
-    const initial = await revision(manager, domainId, revisionId, false);
-    const material = await lockSubject(manager, domainId, initial.materialId);
-    const draft = await revision(manager, domainId, revisionId);
-    if (draft.creatorId !== actorId)
-        refuse('DRAFT_NOT_OWNED');
-    if (draft.frozenAt)
-        refuse('REVISION_FROZEN');
-    if (draft.editGeneration !== expectedEditGeneration)
-        refuse('DRAFT_CONFLICT');
-    if (draft.baseGeneration !== material.planGeneration)
-        refuse('PLAN_CONFLICT');
-    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'materialDefinition');
-    if (draft.policyId !== policy.id)
-        refuse('PLAN_CONFLICT');
-    (0, material_revision_content_1.materialDraftContent)(draft, true);
-    await (0, material_revision_content_1.validateMaterialReferences)(manager, domainId, draft);
-    const contentHash = materialDefinitionSubmissionHash(draft);
-    await manager.update(material_revision_1.MaterialDefinitionRevision, { id: revisionId, domain: { id: domainId } }, { frozenAt: new Date(), contentHash });
-    return revision(manager, domainId, revisionId);
-}
-async function bindMaterialDefinitionApproval(manager, domainId, revisionId, activityInstanceId) {
-    transaction(manager);
-    const initial = await revision(manager, domainId, revisionId, false);
-    await lockSubject(manager, domainId, initial.materialId);
-    const draft = await revision(manager, domainId, revisionId);
-    if (!draft.frozenAt || draft.activityInstanceId)
-        refuse('INVALID_SUBMISSION');
-    await manager.update(material_revision_1.MaterialDefinitionRevision, { id: revisionId, domain: { id: domainId } }, { activityInstanceId: text(activityInstanceId, 'activityInstanceId') });
-}
-/** Internal completion callback only. Never expose this as an approved=true mutation. */
-async function publishMaterialDefinitionRevision(manager, domainId, revisionId, decision) {
-    return publishRevision(manager, domainId, revisionId, {
-        kind: 'approved',
-        activityInstanceId: decision.activityInstanceId,
-        actorId: decision.approverId,
-        submissionHash: decision.submissionHash
-    });
-}
-async function publishUnregulatedMaterialDefinition(manager, domainId, actorId, revisionId, editGeneration) {
-    transaction(manager);
-    const initial = await revision(manager, domainId, revisionId, false);
-    await lockSubject(manager, domainId, initial.materialId);
-    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'materialDefinition');
-    if (policy.approvalRequired)
-        throw new shell_1.Refusal('MASTER_APPROVAL_REQUIRED', {}, 'This change requires product approval.');
-    const prior = await manager.findOneBy(material_revision_1.MaterialDefinitionPlan, {
-        domain: { id: domainId },
-        publishedRevision: { id: revisionId },
-        releaseKind: 'policy'
-    });
-    if (prior) {
-        if (prior.publisherId !== actorId)
-            refuse('DRAFT_NOT_OWNED');
-        return prior;
-    }
-    const frozen = await freezeMaterialDefinitionDraft(manager, domainId, actorId, revisionId, editGeneration);
-    return publishRevision(manager, domainId, revisionId, { kind: 'policy', actorId, submissionHash: frozen.contentHash });
-}
-async function publishRevision(manager, domainId, revisionId, decision) {
-    const initial = await revision(manager, domainId, revisionId, false);
-    const material = await lockSubject(manager, domainId, initial.materialId);
-    const draft = await revision(manager, domainId, revisionId);
-    if (!draft.frozenAt ||
-        (decision.kind === 'approved'
-            ? draft.activityInstanceId !== decision.activityInstanceId
-            : !!draft.activityInstanceId) ||
-        draft.contentHash !== decision.submissionHash ||
-        materialDefinitionSubmissionHash(draft) !== decision.submissionHash)
-        refuse('INVALID_SUBMISSION');
-    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'materialDefinition');
-    if (draft.policyId !== policy.id)
-        refuse('PLAN_CONFLICT');
-    if (policy.approvalRequired !== (decision.kind === 'approved'))
-        throw new shell_1.Refusal('MASTER_APPROVAL_POLICY_MISMATCH', {}, 'Use the publication path required by the domain policy.');
-    if (decision.kind === 'approved' && draft.creatorId === decision.actorId)
-        refuse('AUTHOR_CANNOT_APPROVE');
-    text(decision.actorId, 'publisher');
-    const previousDecision = await manager.findOne(material_revision_1.MaterialDefinitionPlan, {
-        where: { domain: { id: domainId }, publishedRevision: { id: revisionId } },
-        ...(0, row_lock_1.writeLockOn)(manager, material_revision_1.MaterialDefinitionPlan)
-    });
-    if (previousDecision)
-        return previousDecision;
-    if (draft.baseGeneration !== material.planGeneration)
-        refuse('PLAN_CONFLICT');
-    // Only replacement from effectiveFrom onward is supported in this slice, not arbitrary rescheduling.
-    await (0, material_revision_content_1.validateMaterialReferences)(manager, domainId, draft);
-    if (await manager.findOne(material_revision_1.MaterialDefinitionBasis, {
-        where: { domain: { id: domainId }, material: { id: material.id }, businessTime: (0, typeorm_1.MoreThanOrEqual)(draft.effectiveFrom) },
-        ...(0, row_lock_1.writeLockOn)(manager, material_revision_1.MaterialDefinitionBasis)
-    }))
-        refuse('RETROACTIVE_IMPACT');
-    const oldPlan = await manager.findOne(material_revision_1.MaterialDefinitionPlan, {
-        where: { domain: { id: domainId }, material: { id: material.id }, generation: material.planGeneration },
-        ...(0, row_lock_1.writeLockOn)(manager, material_revision_1.MaterialDefinitionPlan)
-    });
-    if (material.planGeneration > 0 && !oldPlan)
-        refuse('PLAN_CONFLICT');
-    const oldSegments = oldPlan
-        ? await manager.find(material_revision_1.MaterialDefinitionSegment, {
-            where: { domain: { id: domainId }, material: { id: material.id }, plan: { id: oldPlan.id } },
-            order: { validFrom: 'ASC' },
-            ...(0, row_lock_1.writeLockOn)(manager, material_revision_1.MaterialDefinitionSegment)
-        })
-        : [];
-    // Do not silently erase an already approved future appointment.
-    if (oldSegments.some(segment => segment.validFrom >= draft.effectiveFrom))
-        refuse('FUTURE_PLAN_CONFLICT');
-    const recordedAt = new Date();
-    const plan = await manager.save(material_revision_1.MaterialDefinitionPlan, manager.create(material_revision_1.MaterialDefinitionPlan, {
-        domain: { id: domainId },
-        material: { id: material.id },
-        generation: material.planGeneration + 1,
-        recordedAt,
-        activityInstanceId: decision.activityInstanceId ?? null,
-        submissionHash: decision.submissionHash,
-        approver: decision.kind === 'approved' ? { id: decision.actorId } : null,
-        publisher: { id: decision.actorId },
-        releaseKind: decision.kind,
-        publishedRevision: { id: revisionId },
-        policy: { id: policy.id }
-    }));
-    for (const old of oldSegments) {
-        await manager.save(material_revision_1.MaterialDefinitionSegment, manager.create(material_revision_1.MaterialDefinitionSegment, {
-            domain: { id: domainId },
-            material: { id: material.id },
-            plan: { id: plan.id },
-            revision: { id: old.revisionId },
-            validFrom: old.validFrom,
-            validTo: !old.validTo || old.validTo > draft.effectiveFrom ? draft.effectiveFrom : old.validTo
-        }));
-    }
-    await manager.save(material_revision_1.MaterialDefinitionSegment, manager.create(material_revision_1.MaterialDefinitionSegment, {
-        domain: { id: domainId },
-        material: { id: material.id },
-        plan: { id: plan.id },
-        revision: { id: revisionId },
-        validFrom: draft.effectiveFrom,
-        validTo: null
-    }));
-    const advanced = await manager.update(material_definition_1.MaterialDefinition, { id: material.id, domain: { id: domainId }, planGeneration: material.planGeneration }, { planGeneration: plan.generation });
-    if (advanced.affected !== 1)
-        refuse('PLAN_CONFLICT');
-    return plan;
-}
-async function resolveMaterialDefinition(manager, domainId, materialId, businessTime, knownAt = new Date()) {
-    const at = instant(businessTime);
-    const known = instant(knownAt);
-    const plan = await manager.findOne(material_revision_1.MaterialDefinitionPlan, {
-        where: { domain: { id: domainId }, material: { id: materialId }, recordedAt: (0, typeorm_1.LessThanOrEqual)(known) },
-        order: { generation: 'DESC' },
-        ...(0, row_lock_1.writeLockOn)(manager, material_revision_1.MaterialDefinitionPlan)
-    });
-    if (!plan)
-        refuse('NO_EFFECTIVE_REVISION');
-    await subject(manager, domainId, materialId);
-    const query = manager
-        .createQueryBuilder(material_revision_1.MaterialDefinitionSegment, 'segment')
-        .where({ domain: { id: domainId }, material: { id: materialId }, plan: { id: plan.id } })
-        .andWhere('segment.validFrom <= :at', { at })
-        .andWhere('(segment.validTo IS NULL OR segment.validTo > :at)', { at });
-    (0, row_lock_1.lockRowsOf)(manager, query);
-    const segments = await query.getMany();
-    if (!segments.length)
-        await refuseBeforeBaseline(manager, domainId, materialId, at);
-    if (segments.length !== 1)
-        refuse(segments.length ? 'AMBIGUOUS_EFFECTIVITY' : 'NO_EFFECTIVE_REVISION');
-    const selected = await revision(manager, domainId, segments[0].revisionId);
-    if (!selected.frozenAt || selected.contentHash !== materialDefinitionSubmissionHash(selected))
-        refuse('REVISION_INTEGRITY_FAILURE');
-    return { revision: selected, plan, segment: segments[0] };
-}
-/** 기준선보다 앞선 시각은 모른다고 말한다 — 검사 명세의 같은 자리를 보라(2026-09-24). */
-async function refuseBeforeBaseline(manager, domainId, materialId, at) {
-    const first = await manager.findOneBy(material_revision_1.MaterialDefinitionPlan, {
-        domain: { id: domainId }, material: { id: materialId }, generation: 1, releaseKind: 'baseline'
-    });
-    if (!first)
-        return;
-    const recorded = await manager.findOneBy(material_revision_1.MaterialDefinitionRevision, { domain: { id: domainId }, id: first.publishedRevisionId });
-    if (recorded && at < recorded.effectiveFrom)
-        throw new shell_1.Refusal('BEFORE_BASELINE', { baselineAt: recorded.effectiveFrom.toISOString() }, `This master was first recorded at ${recorded.effectiveFrom.toISOString()}; nothing is known about it before then.`);
-}
-/**
- * **개정본이 하나도 없는 품목**마다 지금 서 있는 행을 첫 개정본으로 적는다 — 기준선(2026-09-24).
- * 규칙은 검사 명세의 `standTestSpecificationBaselines` 와 같다. 품목만의 것 둘:
- *
- * - 등급 · 검사 명세는 **이름으로** 가리킨다. 그 이름이 이 사업장에 없으면 세우지 않고 까닭을 남긴다 —
- *   없는 것을 가리키는 개정본은 새 지시가 쓰는 순간 거절된다. 이름은 사업장마다 한 번 읽어 대조한다.
- * - 행의 `testResults` 는 개정본 내용이 아니다. 루트에 그대로 남는다.
- */
-async function standMaterialDefinitionBaselines(manager, domainId, at, edition) {
-    transaction(manager);
-    const roots = await manager
-        .createQueryBuilder(material_definition_1.MaterialDefinition, 'material')
-        .leftJoin(material_revision_1.MaterialDefinitionRevision, 'rev', 'rev.material_id = material.id AND rev.domain_id = material.domain_id')
-        .where('material.domain_id = :domainId', { domainId })
-        .andWhere('rev.id IS NULL')
-        .getMany();
-    const outcome = { stood: 0, unreadable: [] };
-    if (!roots.length)
-        return outcome;
-    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'materialDefinition');
-    const namesOf = async (entity) => new Set((await manager.getRepository(entity).find({ where: { domain: { id: domainId } }, select: ['name'] })).map((one) => one.name));
-    const classNames = await namesOf(material_class_1.MaterialClass);
-    const specNames = await namesOf(test_specification_1.TestSpecification);
-    for (const root of roots) {
-        if (root.planGeneration !== 0) {
-            outcome.unreadable.push({ name: root.name, problem: 'plan without revision' });
-            continue;
-        }
-        let read;
-        try {
-            read = (0, material_revision_content_1.materialDraftContent)({
-                description: root.description ?? null,
-                materialClassIds: root.materialClassIds ?? [],
-                properties: root.properties ?? [],
-                testSpecificationIds: root.testSpecificationIds ?? []
-            }, true);
-        }
-        catch (error) {
-            outcome.unreadable.push({ name: root.name, problem: error?.message ?? String(error) });
-            continue;
-        }
-        const missing = [
-            ...read.materialClassIds.filter(name => !classNames.has(name)).map(name => `material class ${name}`),
-            ...read.testSpecificationIds.filter(name => !specNames.has(name)).map(name => `test specification ${name}`)
-        ];
-        if (missing.length) {
-            outcome.unreadable.push({ name: root.name, problem: 'points at what this domain does not have: ' + missing.join(', ') });
-            continue;
-        }
-        const validFrom = root.effectiveStart && root.effectiveStart > at ? root.effectiveStart : at;
-        const validTo = root.effectiveEnd ?? null;
-        const saved = await manager.save(material_revision_1.MaterialDefinitionRevision, manager.create(material_revision_1.MaterialDefinitionRevision, {
-            ...read,
-            effectiveFrom: validFrom,
-            reason: `baseline: the row as it stood, recorded by ${edition}`,
-            policy: { id: policy.id },
-            domain: { id: domainId },
-            material: { id: root.id },
-            baseRevision: null,
-            baseGeneration: 0,
-            revisionNumber: 1,
-            editGeneration: 0,
-            creator: null,
-            createdAt: at,
-            frozenAt: at,
-            contentHash: null,
-            activityInstanceId: null
-        }));
-        const stood = await revision(manager, domainId, saved.id);
-        const contentHash = materialDefinitionSubmissionHash(stood);
-        await manager.update(material_revision_1.MaterialDefinitionRevision, { id: stood.id, domain: { id: domainId } }, { contentHash });
-        const plan = await manager.save(material_revision_1.MaterialDefinitionPlan, manager.create(material_revision_1.MaterialDefinitionPlan, {
-            domain: { id: domainId },
-            material: { id: root.id },
-            generation: 1,
-            recordedAt: at,
-            activityInstanceId: null,
-            submissionHash: contentHash,
-            approver: null,
-            publisher: null,
-            releaseKind: 'baseline',
-            publishedRevision: { id: stood.id },
-            policy: { id: policy.id }
-        }));
-        if (!validTo || validTo > validFrom) {
-            await manager.save(material_revision_1.MaterialDefinitionSegment, manager.create(material_revision_1.MaterialDefinitionSegment, {
-                domain: { id: domainId },
-                material: { id: root.id },
-                plan: { id: plan.id },
-                revision: { id: stood.id },
-                validFrom,
-                validTo
-            }));
-        }
-        const advanced = await manager.update(material_definition_1.MaterialDefinition, { id: root.id, domain: { id: domainId }, planGeneration: 0 }, { planGeneration: 1 });
-        if (advanced.affected !== 1)
-            refuse('PLAN_CONFLICT');
-        outcome.stood++;
-    }
-    return outcome;
-}
-/** Replay reads verify the captured digest too, not only the currently effective schedule. */
-async function materialDefinitionRevisionForBasis(manager, domainId, basis) {
-    if (basis.domainId !== domainId)
-        refuse('BASIS_CONFLICT');
-    const selected = await revision(manager, domainId, basis.revisionId);
-    if (selected.materialId !== basis.materialId || !selected.frozenAt || selected.contentHash !== basis.contentHash || materialDefinitionSubmissionHash(selected) !== basis.contentHash) {
-        refuse('REVISION_INTEGRITY_FAILURE');
-    }
-    const plan = await manager.findOneBy(material_revision_1.MaterialDefinitionPlan, { id: basis.planId, domain: { id: domainId }, material: { id: basis.materialId } });
-    const segments = await manager.findBy(material_revision_1.MaterialDefinitionSegment, { domain: { id: domainId }, material: { id: basis.materialId }, plan: { id: basis.planId } });
-    const matching = segments.filter(s => s.validFrom <= basis.businessTime && (!s.validTo || s.validTo > basis.businessTime));
-    if (!plan || plan.recordedAt > basis.resolvedAt || matching.length !== 1 || matching[0].revisionId !== basis.revisionId)
-        refuse('BASIS_CONFLICT');
-    return selected;
-}
-/** Must run inside the transaction that writes the business record. */
-async function captureMaterialDefinitionBasis(manager, domainId, materialId, recordKey, businessTime) {
-    const at = instant(businessTime);
-    await lockSubject(manager, domainId, materialId);
-    const existing = await manager.findOne(material_revision_1.MaterialDefinitionBasis, {
-        where: { domain: { id: domainId }, recordKey },
-        ...(0, row_lock_1.writeLockOn)(manager, material_revision_1.MaterialDefinitionBasis)
-    });
-    if (existing) {
-        if (existing.materialId !== materialId || existing.businessTime.getTime() !== at.getTime())
-            refuse('BASIS_CONFLICT');
-        await materialDefinitionRevisionForBasis(manager, domainId, existing);
-        return existing;
-    }
-    const resolvedAt = new Date();
-    const selected = await resolveMaterialDefinition(manager, domainId, materialId, at, resolvedAt);
-    const saved = await manager.save(material_revision_1.MaterialDefinitionBasis, manager.create(material_revision_1.MaterialDefinitionBasis, {
-        domain: { id: domainId },
-        material: { id: materialId },
-        recordKey: text(recordKey, 'recordKey'),
-        businessTime: at,
-        resolvedAt,
-        revision: { id: selected.revision.id },
-        contentHash: selected.revision.contentHash,
-        plan: { id: selected.plan.id }
-    }));
-    return manager.findOneByOrFail(material_revision_1.MaterialDefinitionBasis, { id: saved.id, domain: { id: domainId } });
-}
-async function materialDefinitionRevisionOverview(manager, domainId, materialId, at = new Date()) {
-    const material = await subject(manager, domainId, materialId);
-    const revisions = await manager.find(material_revision_1.MaterialDefinitionRevision, {
-        where: { domain: { id: domainId }, material: { id: materialId } },
-        order: { createdAt: 'ASC', id: 'ASC' }
-    });
-    const plan = await manager.findOne(material_revision_1.MaterialDefinitionPlan, {
-        where: { domain: { id: domainId }, material: { id: materialId }, generation: material.planGeneration }
-    });
-    const schedule = plan
-        ? await manager.find(material_revision_1.MaterialDefinitionSegment, {
-            where: { domain: { id: domainId }, material: { id: materialId }, plan: { id: plan.id } },
-            order: { validFrom: 'ASC' }
-        })
-        : [];
-    /*
-     * 개정본마다 **어떻게 발행됐는지**(`releaseKind`)를 함께 싣는다 — 발행한 적용계획의 값 그대로(2026-10-20).
-     * 화면은 이것으로 기준선을 알아보고 사람의 말(「최초 기록」)로 적는다. 기준선의 사유는 서버가 쓴 기록
-     * 문장인데 해시에 들어가 바꿀 수 없고, 문구로 알아보면 깨지기 쉽다. 발행 전 개정본은 null.
-     */
-    const kindOf = (0, approval_input_1.releaseKinds)(await manager.findBy(material_revision_1.MaterialDefinitionPlan, { domain: { id: domainId }, material: { id: materialId } }));
-    return {
-        materialId,
-        name: material.name,
-        generation: material.planGeneration,
-        at: at.toISOString(),
-        schedule: schedule.map(segment => ({
-            ...segment,
-            state: segment.validFrom > at ? 'scheduled' : segment.validTo && segment.validTo <= at ? 'expired' : 'current'
-        })),
-        revisions: revisions.map(item => ({ ...item, state: item.frozenAt ? 'frozen' : 'draft',
-            releaseKind: kindOf(item.id) }))
-    };
-}
-/** Read-time projection, never a clock-driven rewrite of the identity row. */
-async function effectiveMaterialDefinition(manager, domainId, material, at = new Date()) {
-    const selected = await resolveMaterialDefinition(manager, domainId, material.id, at);
-    return Object.assign(new material_definition_1.MaterialDefinition(), material, {
-        revisionNumber: selected.revision.revisionNumber,
-        description: selected.revision.description,
-        materialClassIds: selected.revision.materialClassIds,
-        properties: selected.revision.properties,
-        testSpecificationIds: selected.revision.testSpecificationIds,
-        effectiveStart: selected.segment.validFrom,
-        effectiveEnd: selected.segment.validTo ?? undefined
-    });
-}
-/**
- * **비규제 사업장의 「저장」 한 번** — 초안을 만들고 바로 발행한다, 한 트랜잭션에서(ADR-0086 09-22 보탬).
- * 비규제면 사람이 누를 것은 저장 하나다. 두 걸음(초안 저장 → 발행)이 구조상 필연인 것처럼 보이게 하지 않는다.
- * 이 축이 승인제면 발행이 `MASTER_APPROVAL_REQUIRED` 로 거절되고, 같은 트랜잭션이라 초안도 함께 물러난다 —
- * 반쯤 저장된 것이 남지 않는다. 개정본 · 적용계획 · 구간은 두 걸음 때와 똑같이 선다.
- */
-async function saveAndPublishMaterialDefinition(manager, domainId, actorId, asked) {
-    // Reuse the owned draft and its concurrency guard; publishing failure rolls back the edit too.
-    if (asked.revisionId && !Number.isInteger(asked.editGeneration))
-        refuse('DRAFT_CONFLICT');
-    const draft = asked.revisionId
-        ? await editMaterialDefinitionDraft(manager, domainId, actorId, asked.revisionId, asked.editGeneration, asked.content)
-        : await createMaterialDefinitionDraft(manager, domainId, actorId, asked);
-    const plan = await publishUnregulatedMaterialDefinition(manager, domainId, actorId, draft.id, draft.editGeneration);
-    return { revision: await revision(manager, domainId, draft.id, false), plan };
-}
-//# sourceMappingURL=material-revision-service.js.map