@things-factory/ops-master 10.1.31 → 10.1.34

package/dist-server/service/test-spec/test-spec-revision-service.js

@@ -0,0 +1,519 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestSpecificationRefusal = void 0;
+exports.testSpecificationSubmissionHash = testSpecificationSubmissionHash;
+exports.testSpecificationApprovalInput = testSpecificationApprovalInput;
+exports.assertTestSpecificationApprovalInput = assertTestSpecificationApprovalInput;
+exports.createTestSpecificationDraft = createTestSpecificationDraft;
+exports.editTestSpecificationDraft = editTestSpecificationDraft;
+exports.freezeTestSpecificationDraft = freezeTestSpecificationDraft;
+exports.bindTestSpecificationApproval = bindTestSpecificationApproval;
+exports.publishTestSpecificationRevision = publishTestSpecificationRevision;
+exports.publishUnregulatedTestSpecification = publishUnregulatedTestSpecification;
+exports.resolveTestSpecification = resolveTestSpecification;
+exports.testSpecificationRevisionForBasis = testSpecificationRevisionForBasis;
+exports.captureTestSpecificationBasis = captureTestSpecificationBasis;
+exports.testSpecificationRevisionOverview = testSpecificationRevisionOverview;
+exports.effectiveTestSpecification = effectiveTestSpecification;
+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 criteria_check_1 = require("./criteria-check");
+const test_specification_1 = require("./test-specification");
+const test_spec_revision_1 = require("./test-spec-revision");
+class TestSpecificationRefusal extends shell_1.Refusal {
+    constructor(code, detail) {
+        super(code, {}, detail ?? TEST_SPECIFICATION_REFUSALS[code] ?? 'The test specification change could not be applied.');
+    }
+}
+exports.TestSpecificationRefusal = TestSpecificationRefusal;
+const TEST_SPECIFICATION_REFUSALS = {
+    TRANSACTION_REQUIRED: 'This change requires a transaction.',
+    INVALID_INSTANT: 'Enter a valid date and time including its time zone.',
+    INVALID_CONTENT: 'The proposed specification content is invalid.',
+    INVALID_CRITERIA: 'The proposed inspection criteria are invalid.',
+    SPECIFICATION_NOT_FOUND: 'The specification 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 criteria already used by recorded inspections.',
+    FUTURE_PLAN_CONFLICT: 'This change conflicts with an approved future schedule.',
+    NO_EFFECTIVE_REVISION: 'There is no published revision effective at the inspection time.',
+    AMBIGUOUS_EFFECTIVITY: 'More than one revision is effective at the inspection time.',
+    REVISION_INTEGRITY_FAILURE: 'The stored revision does not match its signed content.',
+    BASIS_CONFLICT: 'This inspection already has a different specification or inspection time.',
+    APPROVAL_LINE_REQUIRED: 'Configure an approval line before submitting this change.',
+    REVISION_REQUIRED: 'Change the specification through a revision draft.'
+};
+function refuse(code, detail) {
+    throw new TestSpecificationRefusal(code, detail);
+}
+function transaction(manager) {
+    if (!manager.queryRunner?.isTransactionActive)
+        refuse('TRANSACTION_REQUIRED');
+}
+/** Current reads are required after waiting for the subject lock, including MySQL REPEATABLE READ. */
+function currentLock(manager) {
+    const driver = manager.connection.options.type;
+    return manager.queryRunner?.isTransactionActive && !['sqlite', 'better-sqlite3', 'sqljs'].includes(driver)
+        ? { lock: { mode: 'pessimistic_write' } }
+        : {};
+}
+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 testSpecificationSubmissionHash(revision) {
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(canonical({
+        schemaVersion: 1,
+        policyId: revision.policyId,
+        domainId: revision.domainId,
+        specId: revision.specId,
+        baseRevisionId: revision.baseRevisionId,
+        baseGeneration: revision.baseGeneration,
+        version: revision.version,
+        description: revision.description,
+        criteria: revision.criteria,
+        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 testSpecificationApprovalInput(manager, domainId, revisionId) {
+    const draft = await revision(manager, domainId, revisionId);
+    if (!draft.frozenAt || draft.contentHash !== testSpecificationSubmissionHash(draft))
+        refuse('INVALID_SUBMISSION');
+    const spec = await subject(manager, domainId, draft.specId);
+    const base = draft.baseRevisionId ? await revision(manager, domainId, draft.baseRevisionId) : null;
+    const values = (row) => ({
+        version: row.version,
+        description: row.description,
+        criteria: row.criteria
+    });
+    return {
+        headline: spec.name,
+        reason: draft.reason,
+        effectiveFrom: draft.effectiveFrom.toISOString(),
+        before: base ? values(base) : null,
+        after: values(draft),
+        revision: {
+            revisionId: draft.id,
+            hash: draft.contentHash,
+            specId: draft.specId,
+            baseGeneration: draft.baseGeneration
+        }
+    };
+}
+async function assertTestSpecificationApprovalInput(manager, domainId, input) {
+    const reference = input?.revision;
+    if (typeof reference?.revisionId !== 'string')
+        refuse('INVALID_SUBMISSION');
+    const expected = await testSpecificationApprovalInput(manager, domainId, reference.revisionId);
+    for (const key of Object.keys(expected)) {
+        if (canonical(input[key]) !== canonical(expected[key]))
+            refuse('INVALID_SUBMISSION');
+    }
+}
+function content(input) {
+    const read = (0, criteria_check_1.readCriteria)(input.criteria);
+    if (read.read === 'failed')
+        refuse('INVALID_CRITERIA', read.detail);
+    const judged = (0, criteria_check_1.judgeCriteria)(read.criteria);
+    if (!judged.ok)
+        refuse('INVALID_CRITERIA', judged.problems.join('\n'));
+    // A JSON round trip makes the accepted value exactly the persisted value, not a caller-owned object.
+    const criteria = JSON.parse(JSON.stringify(read.criteria));
+    if (input.description != null && typeof input.description !== 'string')
+        refuse('INVALID_CONTENT', 'description');
+    return {
+        version: text(input.version, 'version'),
+        description: input.description ?? null,
+        criteria,
+        effectiveFrom: instant(input.effectiveFrom),
+        reason: text(input.reason, 'reason')
+    };
+}
+async function subject(manager, domainId, specId) {
+    const spec = await manager.findOne(test_specification_1.TestSpecification, {
+        where: { id: specId, domain: { id: domainId } },
+        ...currentLock(manager)
+    });
+    if (!spec)
+        refuse('SPECIFICATION_NOT_FOUND');
+    return spec;
+}
+async function revision(manager, domainId, revisionId, locked = true) {
+    const found = await manager.findOne(test_spec_revision_1.TestSpecificationRevision, {
+        where: { id: revisionId, domain: { id: domainId } },
+        ...(locked ? currentLock(manager) : {})
+    });
+    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, specId) {
+    transaction(manager);
+    const locked = await manager
+        .createQueryBuilder()
+        .update(test_specification_1.TestSpecification)
+        .set({ revisionLock: () => 'revision_lock + 1' })
+        .where({ id: specId, domain: { id: domainId } })
+        .execute();
+    if (locked.affected !== 1)
+        refuse('SPECIFICATION_NOT_FOUND');
+    return subject(manager, domainId, specId);
+}
+async function createTestSpecificationDraft(manager, domainId, creatorId, asked) {
+    transaction(manager);
+    const accepted = content(asked.content);
+    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'testSpecification');
+    let spec;
+    if (asked.specId) {
+        spec = await lockSubject(manager, domainId, asked.specId);
+    }
+    else {
+        spec = await manager.save(test_specification_1.TestSpecification, manager.create(test_specification_1.TestSpecification, {
+            domain: { id: domainId },
+            name: text(asked.name, 'name'),
+            planGeneration: 0,
+            revisionLock: 0,
+            creator: { id: creatorId },
+            updater: { id: creatorId }
+        }));
+    }
+    let baseRevisionId = null;
+    if (spec.planGeneration > 0) {
+        baseRevisionId = (await resolveTestSpecification(manager, domainId, spec.id, accepted.effectiveFrom)).revision.id;
+    }
+    if (asked.baseRevisionId && asked.baseRevisionId !== baseRevisionId)
+        refuse('INVALID_BASE_REVISION');
+    const saved = await manager.save(test_spec_revision_1.TestSpecificationRevision, manager.create(test_spec_revision_1.TestSpecificationRevision, {
+        ...accepted,
+        policy: { id: policy.id },
+        domain: { id: domainId },
+        spec: { id: spec.id },
+        baseRevision: baseRevisionId ? { id: baseRevisionId } : null,
+        baseGeneration: spec.planGeneration,
+        editGeneration: 0,
+        creator: { id: creatorId },
+        createdAt: new Date(),
+        frozenAt: null,
+        contentHash: null,
+        activityInstanceId: null
+    }));
+    return revision(manager, domainId, saved.id);
+}
+async function editTestSpecificationDraft(manager, domainId, actorId, revisionId, expectedEditGeneration, input) {
+    transaction(manager);
+    const accepted = content(input);
+    const initial = await revision(manager, domainId, revisionId, false);
+    const spec = await lockSubject(manager, domainId, initial.specId);
+    const draft = await revision(manager, domainId, revisionId);
+    if (draft.creatorId !== actorId)
+        refuse('DRAFT_NOT_OWNED');
+    if (draft.frozenAt)
+        refuse('REVISION_FROZEN');
+    if (draft.baseGeneration !== spec.planGeneration)
+        refuse('PLAN_CONFLICT');
+    // Moving the effective date across a scheduled boundary changes the before-image.
+    const baseRevisionId = spec.planGeneration > 0
+        ? (await resolveTestSpecification(manager, domainId, spec.id, accepted.effectiveFrom)).revision.id
+        : null;
+    const updated = await manager
+        .createQueryBuilder()
+        .update(test_spec_revision_1.TestSpecificationRevision)
+        .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 freezeTestSpecificationDraft(manager, domainId, actorId, revisionId, expectedEditGeneration) {
+    const initial = await revision(manager, domainId, revisionId, false);
+    const spec = await lockSubject(manager, domainId, initial.specId);
+    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 !== spec.planGeneration)
+        refuse('PLAN_CONFLICT');
+    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'testSpecification');
+    if (draft.policyId !== policy.id)
+        refuse('PLAN_CONFLICT');
+    content(draft);
+    const contentHash = testSpecificationSubmissionHash(draft);
+    await manager.update(test_spec_revision_1.TestSpecificationRevision, { id: revisionId, domain: { id: domainId } }, { frozenAt: new Date(), contentHash });
+    return revision(manager, domainId, revisionId);
+}
+async function bindTestSpecificationApproval(manager, domainId, revisionId, activityInstanceId) {
+    transaction(manager);
+    const initial = await revision(manager, domainId, revisionId, false);
+    await lockSubject(manager, domainId, initial.specId);
+    const draft = await revision(manager, domainId, revisionId);
+    if (!draft.frozenAt || draft.activityInstanceId)
+        refuse('INVALID_SUBMISSION');
+    await manager.update(test_spec_revision_1.TestSpecificationRevision, { id: revisionId, domain: { id: domainId } }, { activityInstanceId: text(activityInstanceId, 'activityInstanceId') });
+}
+/** Internal completion callback only. Never expose this as an approved=true mutation. */
+async function publishTestSpecificationRevision(manager, domainId, revisionId, decision) {
+    return publishRevision(manager, domainId, revisionId, {
+        kind: 'approved',
+        activityInstanceId: decision.activityInstanceId,
+        actorId: decision.approverId,
+        submissionHash: decision.submissionHash
+    });
+}
+async function publishUnregulatedTestSpecification(manager, domainId, actorId, revisionId, editGeneration) {
+    transaction(manager);
+    const initial = await revision(manager, domainId, revisionId, false);
+    await lockSubject(manager, domainId, initial.specId);
+    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'testSpecification');
+    if (policy.approvalRequired)
+        throw new shell_1.Refusal('MASTER_APPROVAL_REQUIRED', {}, 'This change requires product approval.');
+    const prior = await manager.findOneBy(test_spec_revision_1.TestSpecificationPlan, {
+        domain: { id: domainId },
+        publishedRevision: { id: revisionId },
+        releaseKind: 'policy'
+    });
+    if (prior) {
+        if (prior.publisherId !== actorId)
+            refuse('DRAFT_NOT_OWNED');
+        return prior;
+    }
+    const frozen = await freezeTestSpecificationDraft(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 spec = await lockSubject(manager, domainId, initial.specId);
+    const draft = await revision(manager, domainId, revisionId);
+    if (!draft.frozenAt ||
+        (decision.kind === 'approved'
+            ? draft.activityInstanceId !== decision.activityInstanceId
+            : !!draft.activityInstanceId) ||
+        draft.contentHash !== decision.submissionHash ||
+        testSpecificationSubmissionHash(draft) !== decision.submissionHash)
+        refuse('INVALID_SUBMISSION');
+    const policy = await (0, master_change_policy_1.masterChangePolicy)(manager, domainId, 'testSpecification');
+    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(test_spec_revision_1.TestSpecificationPlan, {
+        where: { domain: { id: domainId }, publishedRevision: { id: revisionId } },
+        ...currentLock(manager)
+    });
+    if (previousDecision)
+        return previousDecision;
+    if (draft.baseGeneration !== spec.planGeneration)
+        refuse('PLAN_CONFLICT');
+    // Only replacement from effectiveFrom onward is supported in this slice, not arbitrary rescheduling.
+    if (await manager.findOne(test_spec_revision_1.TestSpecificationBasis, {
+        where: { domain: { id: domainId }, spec: { id: spec.id }, businessTime: (0, typeorm_1.MoreThanOrEqual)(draft.effectiveFrom) },
+        ...currentLock(manager)
+    }))
+        refuse('RETROACTIVE_IMPACT');
+    const oldPlan = await manager.findOne(test_spec_revision_1.TestSpecificationPlan, {
+        where: { domain: { id: domainId }, spec: { id: spec.id }, generation: spec.planGeneration },
+        ...currentLock(manager)
+    });
+    if (spec.planGeneration > 0 && !oldPlan)
+        refuse('PLAN_CONFLICT');
+    const oldSegments = oldPlan
+        ? await manager.find(test_spec_revision_1.TestSpecificationSegment, {
+            where: { domain: { id: domainId }, spec: { id: spec.id }, plan: { id: oldPlan.id } },
+            order: { validFrom: 'ASC' },
+            ...currentLock(manager)
+        })
+        : [];
+    // 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(test_spec_revision_1.TestSpecificationPlan, manager.create(test_spec_revision_1.TestSpecificationPlan, {
+        domain: { id: domainId },
+        spec: { id: spec.id },
+        generation: spec.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(test_spec_revision_1.TestSpecificationSegment, manager.create(test_spec_revision_1.TestSpecificationSegment, {
+            domain: { id: domainId },
+            spec: { id: spec.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(test_spec_revision_1.TestSpecificationSegment, manager.create(test_spec_revision_1.TestSpecificationSegment, {
+        domain: { id: domainId },
+        spec: { id: spec.id },
+        plan: { id: plan.id },
+        revision: { id: revisionId },
+        validFrom: draft.effectiveFrom,
+        validTo: null
+    }));
+    const advanced = await manager.update(test_specification_1.TestSpecification, { id: spec.id, domain: { id: domainId }, planGeneration: spec.planGeneration }, { planGeneration: plan.generation });
+    if (advanced.affected !== 1)
+        refuse('PLAN_CONFLICT');
+    return plan;
+}
+async function resolveTestSpecification(manager, domainId, specId, businessTime, knownAt = new Date()) {
+    const at = instant(businessTime);
+    const known = instant(knownAt);
+    const plan = await manager.findOne(test_spec_revision_1.TestSpecificationPlan, {
+        where: { domain: { id: domainId }, spec: { id: specId }, recordedAt: (0, typeorm_1.LessThanOrEqual)(known) },
+        order: { generation: 'DESC' },
+        ...currentLock(manager)
+    });
+    if (!plan)
+        refuse('NO_EFFECTIVE_REVISION');
+    const query = manager
+        .createQueryBuilder(test_spec_revision_1.TestSpecificationSegment, 'segment')
+        .where({ domain: { id: domainId }, spec: { id: specId }, plan: { id: plan.id } })
+        .andWhere('segment.validFrom <= :at', { at })
+        .andWhere('(segment.validTo IS NULL OR segment.validTo > :at)', { at });
+    if (currentLock(manager).lock)
+        query.setLock('pessimistic_write');
+    const segments = await query.getMany();
+    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 !== testSpecificationSubmissionHash(selected))
+        refuse('REVISION_INTEGRITY_FAILURE');
+    return { revision: selected, plan, segment: segments[0] };
+}
+/** Replay reads verify the captured digest too, not only the currently effective schedule. */
+async function testSpecificationRevisionForBasis(manager, domainId, basis) {
+    if (basis.domainId !== domainId)
+        refuse('BASIS_CONFLICT');
+    const selected = await revision(manager, domainId, basis.revisionId);
+    if (selected.specId !== basis.specId || !selected.frozenAt || selected.contentHash !== basis.contentHash || testSpecificationSubmissionHash(selected) !== basis.contentHash) {
+        refuse('REVISION_INTEGRITY_FAILURE');
+    }
+    return selected;
+}
+/** Must run inside the transaction that writes the inspection result. */
+async function captureTestSpecificationBasis(manager, domainId, specId, recordKey, businessTime) {
+    const at = instant(businessTime);
+    await lockSubject(manager, domainId, specId);
+    const existing = await manager.findOne(test_spec_revision_1.TestSpecificationBasis, {
+        where: { domain: { id: domainId }, recordKey },
+        ...currentLock(manager)
+    });
+    if (existing) {
+        if (existing.specId !== specId || existing.businessTime.getTime() !== at.getTime())
+            refuse('BASIS_CONFLICT');
+        await testSpecificationRevisionForBasis(manager, domainId, existing);
+        return existing;
+    }
+    const resolvedAt = new Date();
+    const selected = await resolveTestSpecification(manager, domainId, specId, at, resolvedAt);
+    const saved = await manager.save(test_spec_revision_1.TestSpecificationBasis, manager.create(test_spec_revision_1.TestSpecificationBasis, {
+        domain: { id: domainId },
+        spec: { id: specId },
+        recordKey: text(recordKey, 'recordKey'),
+        businessTime: at,
+        resolvedAt,
+        revision: { id: selected.revision.id },
+        contentHash: selected.revision.contentHash,
+        plan: { id: selected.plan.id }
+    }));
+    return manager.findOneByOrFail(test_spec_revision_1.TestSpecificationBasis, { id: saved.id, domain: { id: domainId } });
+}
+async function testSpecificationRevisionOverview(manager, domainId, specId, at = new Date()) {
+    const spec = await subject(manager, domainId, specId);
+    const revisions = await manager.find(test_spec_revision_1.TestSpecificationRevision, {
+        where: { domain: { id: domainId }, spec: { id: specId } },
+        order: { createdAt: 'ASC', id: 'ASC' }
+    });
+    const plan = await manager.findOne(test_spec_revision_1.TestSpecificationPlan, {
+        where: { domain: { id: domainId }, spec: { id: specId }, generation: spec.planGeneration }
+    });
+    const schedule = plan
+        ? await manager.find(test_spec_revision_1.TestSpecificationSegment, {
+            where: { domain: { id: domainId }, spec: { id: specId }, plan: { id: plan.id } },
+            order: { validFrom: 'ASC' }
+        })
+        : [];
+    return {
+        specId,
+        name: spec.name,
+        generation: spec.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' }))
+    };
+}
+/** Read-time projection, never a clock-driven rewrite of the identity row. */
+async function effectiveTestSpecification(manager, domainId, spec, at = new Date()) {
+    const selected = await resolveTestSpecification(manager, domainId, spec.id, at);
+    return Object.assign(new test_specification_1.TestSpecification(), spec, {
+        version: selected.revision.version,
+        description: selected.revision.description,
+        criteria: selected.revision.criteria,
+        effectiveStart: selected.segment.validFrom,
+        effectiveEnd: selected.segment.validTo ?? undefined
+    });
+}
+//# sourceMappingURL=test-spec-revision-service.js.map

package/dist-server/service/test-spec/test-spec-revision-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-spec-revision-service.js","sourceRoot":"","sources":["../../../server/service/test-spec/test-spec-revision-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto'\nimport { EntityManager, LessThanOrEqual, MoreThanOrEqual } from 'typeorm'\nimport { Refusal } from '@things-factory/shell'\nimport { masterChangePolicy } from '../master-change-policy'\nimport { judgeCriteria, readCriteria } from './criteria-check'\nimport { TestSpecification } from './test-specification'\nimport {\n  TestSpecificationBasis,\n  TestSpecificationPlan,\n  TestSpecificationRevision,\n  TestSpecificationSegment\n} from './test-spec-revision'\n\nexport class TestSpecificationRefusal extends Refusal {\n  constructor(code: string, detail?: string) {\n    super(\n      code,\n      {},\n      detail ?? TEST_SPECIFICATION_REFUSALS[code] ?? 'The test specification change could not be applied.'\n    )\n  }\n}\nconst TEST_SPECIFICATION_REFUSALS: Record<string, string> = {\n  TRANSACTION_REQUIRED: 'This change requires a transaction.',\n  INVALID_INSTANT: 'Enter a valid date and time including its time zone.',\n  INVALID_CONTENT: 'The proposed specification content is invalid.',\n  INVALID_CRITERIA: 'The proposed inspection criteria are invalid.',\n  SPECIFICATION_NOT_FOUND: 'The specification does not exist in this domain.',\n  REVISION_NOT_FOUND: 'The revision does not exist in this domain.',\n  INVALID_BASE_REVISION: 'The proposed change is based on a different revision.',\n  DRAFT_NOT_OWNED: 'Only the draft author can edit or submit it.',\n  REVISION_FROZEN: 'This submitted revision cannot be edited. Create another draft.',\n  DRAFT_CONFLICT: 'The draft changed. Reload it before saving.',\n  PLAN_CONFLICT: 'The approved schedule changed. Review and submit a new draft.',\n  INVALID_SUBMISSION: 'The submitted content does not match the frozen revision.',\n  AUTHOR_CANNOT_APPROVE: 'The author cannot approve their own change.',\n  RETROACTIVE_IMPACT: 'This change would alter criteria already used by recorded inspections.',\n  FUTURE_PLAN_CONFLICT: 'This change conflicts with an approved future schedule.',\n  NO_EFFECTIVE_REVISION: 'There is no published revision effective at the inspection time.',\n  AMBIGUOUS_EFFECTIVITY: 'More than one revision is effective at the inspection time.',\n  REVISION_INTEGRITY_FAILURE: 'The stored revision does not match its signed content.',\n  BASIS_CONFLICT: 'This inspection already has a different specification or inspection time.',\n  APPROVAL_LINE_REQUIRED: 'Configure an approval line before submitting this change.',\n  REVISION_REQUIRED: 'Change the specification through a revision draft.'\n}\nfunction refuse(code: string, detail?: string): never {\n  throw new TestSpecificationRefusal(code, detail)\n}\nfunction transaction(manager: EntityManager) {\n  if (!manager.queryRunner?.isTransactionActive) refuse('TRANSACTION_REQUIRED')\n}\n/** Current reads are required after waiting for the subject lock, including MySQL REPEATABLE READ. */\nfunction currentLock(manager: EntityManager) {\n  const driver = manager.connection.options.type\n  return manager.queryRunner?.isTransactionActive && !['sqlite', 'better-sqlite3', 'sqljs'].includes(driver)\n    ? { lock: { mode: 'pessimistic_write' as const } }\n    : {}\n}\nfunction instant(value: Date | string): Date {\n  if (!(value instanceof Date) && (typeof value !== 'string' || !/(Z|[+-]\\d{2}:\\d{2})$/.test(value)))\n    refuse('INVALID_INSTANT')\n  const result = new Date(value)\n  if (!Number.isFinite(result.getTime())) refuse('INVALID_INSTANT')\n  return result\n}\nfunction text(value: unknown, field: string): string {\n  if (typeof value !== 'string' || !value.trim()) refuse('INVALID_CONTENT', field)\n  return value.trim()\n}\n/** Sorted object keys, ordered arrays, ISO instants. This is the v1 submission encoding. */\nfunction canonical(value: any): string {\n  if (value === null || typeof value !== 'object') return JSON.stringify(value)\n  if (Array.isArray(value)) return '[' + value.map(canonical).join(',') + ']'\n  return (\n    '{' +\n    Object.keys(value)\n      .sort()\n      .map(key => JSON.stringify(key) + ':' + canonical(value[key]))\n      .join(',') +\n    '}'\n  )\n}\nexport function testSpecificationSubmissionHash(revision: TestSpecificationRevision): string {\n  return createHash('sha256')\n    .update(\n      canonical({\n        schemaVersion: 1,\n        policyId: revision.policyId,\n        domainId: revision.domainId,\n        specId: revision.specId,\n        baseRevisionId: revision.baseRevisionId,\n        baseGeneration: revision.baseGeneration,\n        version: revision.version,\n        description: revision.description,\n        criteria: revision.criteria,\n        effectiveFrom: revision.effectiveFrom.toISOString(),\n        reason: revision.reason\n      })\n    )\n    .digest('hex')\n}\n\n/** Display values are a checked projection of the frozen revision, never a second editable source. */\nexport async function testSpecificationApprovalInput(manager: EntityManager, domainId: string, revisionId: string) {\n  const draft = await revision(manager, domainId, revisionId)\n  if (!draft.frozenAt || draft.contentHash !== testSpecificationSubmissionHash(draft)) refuse('INVALID_SUBMISSION')\n  const spec = await subject(manager, domainId, draft.specId)\n  const base = draft.baseRevisionId ? await revision(manager, domainId, draft.baseRevisionId) : null\n  const values = (row: TestSpecificationRevision) => ({\n    version: row.version,\n    description: row.description,\n    criteria: row.criteria\n  })\n  return {\n    headline: spec.name,\n    reason: draft.reason,\n    effectiveFrom: draft.effectiveFrom.toISOString(),\n    before: base ? values(base) : null,\n    after: values(draft),\n    revision: {\n      revisionId: draft.id,\n      hash: draft.contentHash,\n      specId: draft.specId,\n      baseGeneration: draft.baseGeneration\n    }\n  }\n}\n\nexport async function assertTestSpecificationApprovalInput(\n  manager: EntityManager,\n  domainId: string,\n  input: Record<string, unknown>\n) {\n  const reference = input?.revision as { revisionId?: string }\n  if (typeof reference?.revisionId !== 'string') refuse('INVALID_SUBMISSION')\n  const expected = await testSpecificationApprovalInput(manager, domainId, reference.revisionId)\n  for (const key of Object.keys(expected)) {\n    if (canonical(input[key]) !== canonical(expected[key])) refuse('INVALID_SUBMISSION')\n  }\n}\n\nexport interface TestSpecificationDraftContent {\n  version: string\n  description?: string\n  criteria: unknown\n  effectiveFrom: Date | string\n  reason: string\n}\nfunction content(input: TestSpecificationDraftContent) {\n  const read = readCriteria(input.criteria)\n  if (read.read === 'failed') refuse('INVALID_CRITERIA', read.detail)\n  const judged = judgeCriteria(read.criteria)\n  if (!judged.ok) refuse('INVALID_CRITERIA', judged.problems.join('\\n'))\n  // A JSON round trip makes the accepted value exactly the persisted value, not a caller-owned object.\n  const criteria = JSON.parse(JSON.stringify(read.criteria))\n  if (input.description != null && typeof input.description !== 'string') refuse('INVALID_CONTENT', 'description')\n  return {\n    version: text(input.version, 'version'),\n    description: input.description ?? null,\n    criteria,\n    effectiveFrom: instant(input.effectiveFrom),\n    reason: text(input.reason, 'reason')\n  }\n}\nasync function subject(manager: EntityManager, domainId: string, specId: string) {\n  const spec = await manager.findOne(TestSpecification, {\n    where: { id: specId, domain: { id: domainId } },\n    ...currentLock(manager)\n  })\n  if (!spec) refuse('SPECIFICATION_NOT_FOUND')\n  return spec\n}\nasync function revision(manager: EntityManager, domainId: string, revisionId: string, locked = true) {\n  const found = await manager.findOne(TestSpecificationRevision, {\n    where: { id: revisionId, domain: { id: domainId } },\n    ...(locked ? currentLock(manager) : {})\n  })\n  if (!found) refuse('REVISION_NOT_FOUND')\n  return found\n}\n/** A write lock valid on every supported SQL backend, including SQLite (no SELECT FOR UPDATE). */\nasync function lockSubject(manager: EntityManager, domainId: string, specId: string) {\n  transaction(manager)\n  const locked = await manager\n    .createQueryBuilder()\n    .update(TestSpecification)\n    .set({ revisionLock: () => 'revision_lock + 1' })\n    .where({ id: specId, domain: { id: domainId } })\n    .execute()\n  if (locked.affected !== 1) refuse('SPECIFICATION_NOT_FOUND')\n  return subject(manager, domainId, specId)\n}\n\nexport async function createTestSpecificationDraft(\n  manager: EntityManager,\n  domainId: string,\n  creatorId: string,\n  asked: { specId?: string; name?: string; baseRevisionId?: string; content: TestSpecificationDraftContent }\n) {\n  transaction(manager)\n  const accepted = content(asked.content)\n  const policy = await masterChangePolicy(manager, domainId, 'testSpecification')\n  let spec: TestSpecification\n  if (asked.specId) {\n    spec = await lockSubject(manager, domainId, asked.specId)\n  } else {\n    spec = await manager.save(\n      TestSpecification,\n      manager.create(TestSpecification, {\n        domain: { id: domainId },\n        name: text(asked.name, 'name'),\n        planGeneration: 0,\n        revisionLock: 0,\n        creator: { id: creatorId },\n        updater: { id: creatorId }\n      })\n    )\n  }\n  let baseRevisionId: string | null = null\n  if (spec.planGeneration > 0) {\n    baseRevisionId = (await resolveTestSpecification(manager, domainId, spec.id, accepted.effectiveFrom)).revision.id\n  }\n  if (asked.baseRevisionId && asked.baseRevisionId !== baseRevisionId) refuse('INVALID_BASE_REVISION')\n  const saved = await manager.save(\n    TestSpecificationRevision,\n    manager.create(TestSpecificationRevision, {\n      ...accepted,\n      policy: { id: policy.id },\n      domain: { id: domainId },\n      spec: { id: spec.id },\n      baseRevision: baseRevisionId ? { id: baseRevisionId } : null,\n      baseGeneration: spec.planGeneration,\n      editGeneration: 0,\n      creator: { id: creatorId },\n      createdAt: new Date(),\n      frozenAt: null,\n      contentHash: null,\n      activityInstanceId: null\n    })\n  )\n  return revision(manager, domainId, saved.id)\n}\n\nexport async function editTestSpecificationDraft(\n  manager: EntityManager,\n  domainId: string,\n  actorId: string,\n  revisionId: string,\n  expectedEditGeneration: number,\n  input: TestSpecificationDraftContent\n) {\n  transaction(manager)\n  const accepted = content(input)\n  const initial = await revision(manager, domainId, revisionId, false)\n  const spec = await lockSubject(manager, domainId, initial.specId)\n  const draft = await revision(manager, domainId, revisionId)\n  if (draft.creatorId !== actorId) refuse('DRAFT_NOT_OWNED')\n  if (draft.frozenAt) refuse('REVISION_FROZEN')\n  if (draft.baseGeneration !== spec.planGeneration) refuse('PLAN_CONFLICT')\n  // Moving the effective date across a scheduled boundary changes the before-image.\n  const baseRevisionId =\n    spec.planGeneration > 0\n      ? (await resolveTestSpecification(manager, domainId, spec.id, accepted.effectiveFrom)).revision.id\n      : null\n  const updated = await manager\n    .createQueryBuilder()\n    .update(TestSpecificationRevision)\n    .set({\n      ...accepted,\n      baseRevision: baseRevisionId ? { id: baseRevisionId } : null,\n      editGeneration: expectedEditGeneration + 1\n    })\n    .where({\n      id: revisionId,\n      domain: { id: domainId },\n      creator: { id: actorId },\n      editGeneration: expectedEditGeneration\n    })\n    .andWhere('frozen_at IS NULL')\n    .execute()\n  if (updated.affected !== 1) refuse('DRAFT_CONFLICT')\n  return revision(manager, domainId, revisionId)\n}\n\n/** Product calls this in the same transaction as issuing its worklist approval. */\nexport async function freezeTestSpecificationDraft(\n  manager: EntityManager,\n  domainId: string,\n  actorId: string,\n  revisionId: string,\n  expectedEditGeneration: number\n) {\n  const initial = await revision(manager, domainId, revisionId, false)\n  const spec = await lockSubject(manager, domainId, initial.specId)\n  const draft = await revision(manager, domainId, revisionId)\n  if (draft.creatorId !== actorId) refuse('DRAFT_NOT_OWNED')\n  if (draft.frozenAt) refuse('REVISION_FROZEN')\n  if (draft.editGeneration !== expectedEditGeneration) refuse('DRAFT_CONFLICT')\n  if (draft.baseGeneration !== spec.planGeneration) refuse('PLAN_CONFLICT')\n  const policy = await masterChangePolicy(manager, domainId, 'testSpecification')\n  if (draft.policyId !== policy.id) refuse('PLAN_CONFLICT')\n  content(draft)\n  const contentHash = testSpecificationSubmissionHash(draft)\n  await manager.update(\n    TestSpecificationRevision,\n    { id: revisionId, domain: { id: domainId } },\n    { frozenAt: new Date(), contentHash }\n  )\n  return revision(manager, domainId, revisionId)\n}\n\nexport async function bindTestSpecificationApproval(\n  manager: EntityManager,\n  domainId: string,\n  revisionId: string,\n  activityInstanceId: string\n) {\n  transaction(manager)\n  const initial = await revision(manager, domainId, revisionId, false)\n  await lockSubject(manager, domainId, initial.specId)\n  const draft = await revision(manager, domainId, revisionId)\n  if (!draft.frozenAt || draft.activityInstanceId) refuse('INVALID_SUBMISSION')\n  await manager.update(\n    TestSpecificationRevision,\n    { id: revisionId, domain: { id: domainId } },\n    { activityInstanceId: text(activityInstanceId, 'activityInstanceId') }\n  )\n}\n\n/** Internal completion callback only. Never expose this as an approved=true mutation. */\nexport async function publishTestSpecificationRevision(\n  manager: EntityManager,\n  domainId: string,\n  revisionId: string,\n  decision: { activityInstanceId: string; approverId: string; submissionHash: string }\n) {\n  return publishRevision(manager, domainId, revisionId, {\n    kind: 'approved',\n    activityInstanceId: decision.activityInstanceId,\n    actorId: decision.approverId,\n    submissionHash: decision.submissionHash\n  })\n}\n\nexport async function publishUnregulatedTestSpecification(\n  manager: EntityManager,\n  domainId: string,\n  actorId: string,\n  revisionId: string,\n  editGeneration: number\n) {\n  transaction(manager)\n  const initial = await revision(manager, domainId, revisionId, false)\n  await lockSubject(manager, domainId, initial.specId)\n  const policy = await masterChangePolicy(manager, domainId, 'testSpecification')\n  if (policy.approvalRequired)\n    throw new Refusal('MASTER_APPROVAL_REQUIRED', {}, 'This change requires product approval.')\n  const prior = await manager.findOneBy(TestSpecificationPlan, {\n    domain: { id: domainId },\n    publishedRevision: { id: revisionId },\n    releaseKind: 'policy'\n  })\n  if (prior) {\n    if (prior.publisherId !== actorId) refuse('DRAFT_NOT_OWNED')\n    return prior\n  }\n  const frozen = await freezeTestSpecificationDraft(manager, domainId, actorId, revisionId, editGeneration)\n  return publishRevision(manager, domainId, revisionId, { kind: 'policy', actorId, submissionHash: frozen.contentHash })\n}\n\nasync function publishRevision(\n  manager: EntityManager,\n  domainId: string,\n  revisionId: string,\n  decision: { kind: 'approved' | 'policy'; activityInstanceId?: string; actorId: string; submissionHash: string }\n) {\n  const initial = await revision(manager, domainId, revisionId, false)\n  const spec = await lockSubject(manager, domainId, initial.specId)\n  const draft = await revision(manager, domainId, revisionId)\n  if (\n    !draft.frozenAt ||\n    (decision.kind === 'approved'\n      ? draft.activityInstanceId !== decision.activityInstanceId\n      : !!draft.activityInstanceId) ||\n    draft.contentHash !== decision.submissionHash ||\n    testSpecificationSubmissionHash(draft) !== decision.submissionHash\n  )\n    refuse('INVALID_SUBMISSION')\n  const policy = await masterChangePolicy(manager, domainId, 'testSpecification')\n  if (draft.policyId !== policy.id) refuse('PLAN_CONFLICT')\n  if (policy.approvalRequired !== (decision.kind === 'approved'))\n    throw new Refusal('MASTER_APPROVAL_POLICY_MISMATCH', {}, 'Use the publication path required by the domain policy.')\n  if (decision.kind === 'approved' && draft.creatorId === decision.actorId) refuse('AUTHOR_CANNOT_APPROVE')\n  text(decision.actorId, 'publisher')\n  const previousDecision = await manager.findOne(TestSpecificationPlan, {\n    where: { domain: { id: domainId }, publishedRevision: { id: revisionId } },\n    ...currentLock(manager)\n  })\n  if (previousDecision) return previousDecision\n  if (draft.baseGeneration !== spec.planGeneration) refuse('PLAN_CONFLICT')\n  // Only replacement from effectiveFrom onward is supported in this slice, not arbitrary rescheduling.\n  if (\n    await manager.findOne(TestSpecificationBasis, {\n      where: { domain: { id: domainId }, spec: { id: spec.id }, businessTime: MoreThanOrEqual(draft.effectiveFrom) },\n      ...currentLock(manager)\n    })\n  )\n    refuse('RETROACTIVE_IMPACT')\n  const oldPlan = await manager.findOne(TestSpecificationPlan, {\n    where: { domain: { id: domainId }, spec: { id: spec.id }, generation: spec.planGeneration },\n    ...currentLock(manager)\n  })\n  if (spec.planGeneration > 0 && !oldPlan) refuse('PLAN_CONFLICT')\n  const oldSegments = oldPlan\n    ? await manager.find(TestSpecificationSegment, {\n        where: { domain: { id: domainId }, spec: { id: spec.id }, plan: { id: oldPlan.id } },\n        order: { validFrom: 'ASC' },\n        ...currentLock(manager)\n      })\n    : []\n  // Do not silently erase an already approved future appointment.\n  if (oldSegments.some(segment => segment.validFrom >= draft.effectiveFrom)) refuse('FUTURE_PLAN_CONFLICT')\n  const recordedAt = new Date()\n  const plan = await manager.save(\n    TestSpecificationPlan,\n    manager.create(TestSpecificationPlan, {\n      domain: { id: domainId },\n      spec: { id: spec.id },\n      generation: spec.planGeneration + 1,\n      recordedAt,\n      activityInstanceId: decision.activityInstanceId ?? null,\n      submissionHash: decision.submissionHash,\n      approver: decision.kind === 'approved' ? { id: decision.actorId } : null,\n      publisher: { id: decision.actorId },\n      releaseKind: decision.kind,\n      publishedRevision: { id: revisionId },\n      policy: { id: policy.id }\n    })\n  )\n  for (const old of oldSegments) {\n    await manager.save(\n      TestSpecificationSegment,\n      manager.create(TestSpecificationSegment, {\n        domain: { id: domainId },\n        spec: { id: spec.id },\n        plan: { id: plan.id },\n        revision: { id: old.revisionId },\n        validFrom: old.validFrom,\n        validTo: !old.validTo || old.validTo > draft.effectiveFrom ? draft.effectiveFrom : old.validTo\n      })\n    )\n  }\n  await manager.save(\n    TestSpecificationSegment,\n    manager.create(TestSpecificationSegment, {\n      domain: { id: domainId },\n      spec: { id: spec.id },\n      plan: { id: plan.id },\n      revision: { id: revisionId },\n      validFrom: draft.effectiveFrom,\n      validTo: null\n    })\n  )\n  const advanced = await manager.update(\n    TestSpecification,\n    { id: spec.id, domain: { id: domainId }, planGeneration: spec.planGeneration },\n    { planGeneration: plan.generation }\n  )\n  if (advanced.affected !== 1) refuse('PLAN_CONFLICT')\n  return plan\n}\n\nexport async function resolveTestSpecification(\n  manager: EntityManager,\n  domainId: string,\n  specId: string,\n  businessTime: Date | string,\n  knownAt: Date | string = new Date()\n) {\n  const at = instant(businessTime)\n  const known = instant(knownAt)\n  const plan = await manager.findOne(TestSpecificationPlan, {\n    where: { domain: { id: domainId }, spec: { id: specId }, recordedAt: LessThanOrEqual(known) },\n    order: { generation: 'DESC' },\n    ...currentLock(manager)\n  })\n  if (!plan) refuse('NO_EFFECTIVE_REVISION')\n  const query = manager\n    .createQueryBuilder(TestSpecificationSegment, 'segment')\n    .where({ domain: { id: domainId }, spec: { id: specId }, plan: { id: plan.id } })\n    .andWhere('segment.validFrom <= :at', { at })\n    .andWhere('(segment.validTo IS NULL OR segment.validTo > :at)', { at })\n  if (currentLock(manager).lock) query.setLock('pessimistic_write')\n  const segments = await query.getMany()\n  if (segments.length !== 1) refuse(segments.length ? 'AMBIGUOUS_EFFECTIVITY' : 'NO_EFFECTIVE_REVISION')\n  const selected = await revision(manager, domainId, segments[0].revisionId)\n  if (!selected.frozenAt || selected.contentHash !== testSpecificationSubmissionHash(selected))\n    refuse('REVISION_INTEGRITY_FAILURE')\n  return { revision: selected, plan, segment: segments[0] }\n}\n\n/** Replay reads verify the captured digest too, not only the currently effective schedule. */\nexport async function testSpecificationRevisionForBasis(manager: EntityManager, domainId: string, basis: TestSpecificationBasis) {\n  if (basis.domainId !== domainId) refuse('BASIS_CONFLICT')\n  const selected = await revision(manager, domainId, basis.revisionId)\n  if (selected.specId !== basis.specId || !selected.frozenAt || selected.contentHash !== basis.contentHash || testSpecificationSubmissionHash(selected) !== basis.contentHash) {\n    refuse('REVISION_INTEGRITY_FAILURE')\n  }\n  return selected\n}\n\n/** Must run inside the transaction that writes the inspection result. */\nexport async function captureTestSpecificationBasis(\n  manager: EntityManager,\n  domainId: string,\n  specId: string,\n  recordKey: string,\n  businessTime: Date | string\n) {\n  const at = instant(businessTime)\n  await lockSubject(manager, domainId, specId)\n  const existing = await manager.findOne(TestSpecificationBasis, {\n    where: { domain: { id: domainId }, recordKey },\n    ...currentLock(manager)\n  })\n  if (existing) {\n    if (existing.specId !== specId || existing.businessTime.getTime() !== at.getTime()) refuse('BASIS_CONFLICT')\n    await testSpecificationRevisionForBasis(manager, domainId, existing)\n    return existing\n  }\n  const resolvedAt = new Date()\n  const selected = await resolveTestSpecification(manager, domainId, specId, at, resolvedAt)\n  const saved = await manager.save(\n    TestSpecificationBasis,\n    manager.create(TestSpecificationBasis, {\n      domain: { id: domainId },\n      spec: { id: specId },\n      recordKey: text(recordKey, 'recordKey'),\n      businessTime: at,\n      resolvedAt,\n      revision: { id: selected.revision.id },\n      contentHash: selected.revision.contentHash,\n      plan: { id: selected.plan.id }\n    })\n  )\n  return manager.findOneByOrFail(TestSpecificationBasis, { id: saved.id, domain: { id: domainId } })\n}\n\nexport async function testSpecificationRevisionOverview(\n  manager: EntityManager,\n  domainId: string,\n  specId: string,\n  at = new Date()\n) {\n  const spec = await subject(manager, domainId, specId)\n  const revisions = await manager.find(TestSpecificationRevision, {\n    where: { domain: { id: domainId }, spec: { id: specId } },\n    order: { createdAt: 'ASC', id: 'ASC' }\n  })\n  const plan = await manager.findOne(TestSpecificationPlan, {\n    where: { domain: { id: domainId }, spec: { id: specId }, generation: spec.planGeneration }\n  })\n  const schedule = plan\n    ? await manager.find(TestSpecificationSegment, {\n        where: { domain: { id: domainId }, spec: { id: specId }, plan: { id: plan.id } },\n        order: { validFrom: 'ASC' }\n      })\n    : []\n  return {\n    specId,\n    name: spec.name,\n    generation: spec.planGeneration,\n    at: at.toISOString(),\n    schedule: schedule.map(segment => ({\n      ...segment,\n      state: segment.validFrom > at ? 'scheduled' : segment.validTo && segment.validTo <= at ? 'expired' : 'current'\n    })),\n    revisions: revisions.map(item => ({ ...item, state: item.frozenAt ? 'frozen' : 'draft' }))\n  }\n}\n\n/** Read-time projection, never a clock-driven rewrite of the identity row. */\nexport async function effectiveTestSpecification(\n  manager: EntityManager,\n  domainId: string,\n  spec: TestSpecification,\n  at = new Date()\n) {\n  const selected = await resolveTestSpecification(manager, domainId, spec.id, at)\n  return Object.assign(new TestSpecification(), spec, {\n    version: selected.revision.version,\n    description: selected.revision.description,\n    criteria: selected.revision.criteria,\n    effectiveStart: selected.segment.validFrom,\n    effectiveEnd: selected.segment.validTo ?? undefined\n  })\n}\n"]}