@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/workflow/patch-file-scope-policy.schema.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Deterministic file-scope contract for patch_realisation (OpenAI Patch / packet engines).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatchScopePreflightResultSchema = exports.PatchScopePreflightCodeSchema = exports.PATCH_SCOPE_PREFLIGHT_CODES = exports.PatchFileScopePolicySchema = void 0;
+const zod_1 = require("zod");
+exports.PatchFileScopePolicySchema = zod_1.z
+    .object({
+    targetFiles: zod_1.z.array(zod_1.z.string().min(1)),
+    expectedFiles: zod_1.z.array(zod_1.z.string().min(1)),
+    allowedFiles: zod_1.z.array(zod_1.z.string().min(1)),
+    allowAdditionalFiles: zod_1.z.boolean(),
+    maxAdditionalFiles: zod_1.z.number().int().nonnegative(),
+    forbiddenPrefixes: zod_1.z.array(zod_1.z.string().min(1)),
+    packetId: zod_1.z.string().uuid().optional(),
+    taskIds: zod_1.z.array(zod_1.z.string().uuid()),
+})
+    .strict();
+exports.PATCH_SCOPE_PREFLIGHT_CODES = [
+    'PATCH_OUTSIDE_PACKET_SCOPE',
+    'PATCH_EMPTY',
+    'PATCH_DID_NOT_TOUCH_PACKET_FILES',
+    'PATCH_SCOPE_INSUFFICIENT',
+    'PATCH_NO_VALID_TARGET_FILES',
+];
+exports.PatchScopePreflightCodeSchema = zod_1.z.enum(exports.PATCH_SCOPE_PREFLIGHT_CODES);
+exports.PatchScopePreflightResultSchema = zod_1.z
+    .object({
+    ok: zod_1.z.boolean(),
+    code: exports.PatchScopePreflightCodeSchema.optional(),
+    message: zod_1.z.string(),
+    outsideScope: zod_1.z.array(zod_1.z.string()),
+    missedRequired: zod_1.z.array(zod_1.z.string()),
+    generatedPaths: zod_1.z.array(zod_1.z.string()),
+    allowedFiles: zod_1.z.array(zod_1.z.string()),
+})
+    .strict();

package/dist/schemas/workflow/patch-review-result.schema.d.ts

@@ -0,0 +1,139 @@
+/**
+ * PatchReviewResult — payload schema for workflow_artifacts rows with
+ * artifact_type='patchReviewResult'.
+ *
+ * Produced by the Patch Review step (adversarial drift reviewer).
+ * A `status: 'pass'` is required before PR creation can proceed.
+ */
+import { z } from 'zod';
+export declare const PatchReviewStatusSchema: z.ZodEnum<["pass", "fail", "warning"]>;
+export type PatchReviewStatus = z.infer<typeof PatchReviewStatusSchema>;
+export declare const PatchReviewFindingSchema: z.ZodObject<{
+    findingId: z.ZodString;
+    category: z.ZodEnum<["drift", "scope_violation", "forbidden_pattern", "duplicate_owner", "tombstone_resurrection", "generated_file_edit", "out_of_capsule_scope", "budget_exceeded", "missing_evidence", "missing_test_obligation", "other"]>;
+    severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+    message: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    line: z.ZodOptional<z.ZodNumber>;
+    evidence: z.ZodOptional<z.ZodString>;
+    requiredAction: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    severity: "critical" | "low" | "medium" | "high";
+    category: "budget_exceeded" | "other" | "drift" | "scope_violation" | "forbidden_pattern" | "duplicate_owner" | "tombstone_resurrection" | "generated_file_edit" | "out_of_capsule_scope" | "missing_evidence" | "missing_test_obligation";
+    findingId: string;
+    file?: string | undefined;
+    evidence?: string | undefined;
+    line?: number | undefined;
+    requiredAction?: string | undefined;
+}, {
+    message: string;
+    severity: "critical" | "low" | "medium" | "high";
+    category: "budget_exceeded" | "other" | "drift" | "scope_violation" | "forbidden_pattern" | "duplicate_owner" | "tombstone_resurrection" | "generated_file_edit" | "out_of_capsule_scope" | "missing_evidence" | "missing_test_obligation";
+    findingId: string;
+    file?: string | undefined;
+    evidence?: string | undefined;
+    line?: number | undefined;
+    requiredAction?: string | undefined;
+}>;
+export type PatchReviewFinding = z.infer<typeof PatchReviewFindingSchema>;
+export declare const PatchReviewResultPayloadSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    reviewedAt: z.ZodString;
+    status: z.ZodEnum<["pass", "fail", "warning"]>;
+    /** UUID of the taskCapsule artifact this review was run against. */
+    capsuleArtifactId: z.ZodOptional<z.ZodString>;
+    /** UUID of the implementFinal artifact reviewed. */
+    implementArtifactId: z.ZodOptional<z.ZodString>;
+    /** Parity check result artifact ID. */
+    parityCheckResultId: z.ZodOptional<z.ZodString>;
+    /** Policy result artifact ID. */
+    policyResultId: z.ZodOptional<z.ZodString>;
+    criticalCount: z.ZodNumber;
+    highCount: z.ZodNumber;
+    findings: z.ZodArray<z.ZodObject<{
+        findingId: z.ZodString;
+        category: z.ZodEnum<["drift", "scope_violation", "forbidden_pattern", "duplicate_owner", "tombstone_resurrection", "generated_file_edit", "out_of_capsule_scope", "budget_exceeded", "missing_evidence", "missing_test_obligation", "other"]>;
+        severity: z.ZodEnum<["critical", "high", "medium", "low"]>;
+        message: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        evidence: z.ZodOptional<z.ZodString>;
+        requiredAction: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        severity: "critical" | "low" | "medium" | "high";
+        category: "budget_exceeded" | "other" | "drift" | "scope_violation" | "forbidden_pattern" | "duplicate_owner" | "tombstone_resurrection" | "generated_file_edit" | "out_of_capsule_scope" | "missing_evidence" | "missing_test_obligation";
+        findingId: string;
+        file?: string | undefined;
+        evidence?: string | undefined;
+        line?: number | undefined;
+        requiredAction?: string | undefined;
+    }, {
+        message: string;
+        severity: "critical" | "low" | "medium" | "high";
+        category: "budget_exceeded" | "other" | "drift" | "scope_violation" | "forbidden_pattern" | "duplicate_owner" | "tombstone_resurrection" | "generated_file_edit" | "out_of_capsule_scope" | "missing_evidence" | "missing_test_obligation";
+        findingId: string;
+        file?: string | undefined;
+        evidence?: string | undefined;
+        line?: number | undefined;
+        requiredAction?: string | undefined;
+    }>, "many">;
+    /** Files changed in the patch. */
+    filesChanged: z.ZodArray<z.ZodString, "many">;
+    /** Whether the patch stayed within the capsule's change budget. */
+    budgetCompliant: z.ZodOptional<z.ZodBoolean>;
+    /** Whether all files changed are within the capsule's allowedFiles. */
+    scopeCompliant: z.ZodOptional<z.ZodBoolean>;
+    /** Summary message for PR body. */
+    summary: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "warning" | "fail" | "pass";
+    schemaVersion: "1.0.0";
+    findings: {
+        message: string;
+        severity: "critical" | "low" | "medium" | "high";
+        category: "budget_exceeded" | "other" | "drift" | "scope_violation" | "forbidden_pattern" | "duplicate_owner" | "tombstone_resurrection" | "generated_file_edit" | "out_of_capsule_scope" | "missing_evidence" | "missing_test_obligation";
+        findingId: string;
+        file?: string | undefined;
+        evidence?: string | undefined;
+        line?: number | undefined;
+        requiredAction?: string | undefined;
+    }[];
+    filesChanged: string[];
+    criticalCount: number;
+    reviewedAt: string;
+    highCount: number;
+    summary?: string | undefined;
+    capsuleArtifactId?: string | undefined;
+    budgetCompliant?: boolean | undefined;
+    implementArtifactId?: string | undefined;
+    parityCheckResultId?: string | undefined;
+    policyResultId?: string | undefined;
+    scopeCompliant?: boolean | undefined;
+}, {
+    status: "warning" | "fail" | "pass";
+    schemaVersion: "1.0.0";
+    findings: {
+        message: string;
+        severity: "critical" | "low" | "medium" | "high";
+        category: "budget_exceeded" | "other" | "drift" | "scope_violation" | "forbidden_pattern" | "duplicate_owner" | "tombstone_resurrection" | "generated_file_edit" | "out_of_capsule_scope" | "missing_evidence" | "missing_test_obligation";
+        findingId: string;
+        file?: string | undefined;
+        evidence?: string | undefined;
+        line?: number | undefined;
+        requiredAction?: string | undefined;
+    }[];
+    filesChanged: string[];
+    criticalCount: number;
+    reviewedAt: string;
+    highCount: number;
+    summary?: string | undefined;
+    capsuleArtifactId?: string | undefined;
+    budgetCompliant?: boolean | undefined;
+    implementArtifactId?: string | undefined;
+    parityCheckResultId?: string | undefined;
+    policyResultId?: string | undefined;
+    scopeCompliant?: boolean | undefined;
+}>;
+export type PatchReviewResultPayload = z.infer<typeof PatchReviewResultPayloadSchema>;

package/dist/schemas/workflow/patch-review-result.schema.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * PatchReviewResult — payload schema for workflow_artifacts rows with
+ * artifact_type='patchReviewResult'.
+ *
+ * Produced by the Patch Review step (adversarial drift reviewer).
+ * A `status: 'pass'` is required before PR creation can proceed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatchReviewResultPayloadSchema = exports.PatchReviewFindingSchema = exports.PatchReviewStatusSchema = void 0;
+const zod_1 = require("zod");
+exports.PatchReviewStatusSchema = zod_1.z.enum(['pass', 'fail', 'warning']);
+exports.PatchReviewFindingSchema = zod_1.z.object({
+    findingId: zod_1.z.string(),
+    category: zod_1.z.enum([
+        'drift',
+        'scope_violation',
+        'forbidden_pattern',
+        'duplicate_owner',
+        'tombstone_resurrection',
+        'generated_file_edit',
+        'out_of_capsule_scope',
+        'budget_exceeded',
+        'missing_evidence',
+        'missing_test_obligation',
+        'other',
+    ]),
+    severity: zod_1.z.enum(['critical', 'high', 'medium', 'low']),
+    message: zod_1.z.string(),
+    file: zod_1.z.string().optional(),
+    line: zod_1.z.number().int().min(0).optional(),
+    evidence: zod_1.z.string().optional(),
+    requiredAction: zod_1.z.string().optional(),
+});
+exports.PatchReviewResultPayloadSchema = zod_1.z.object({
+    schemaVersion: zod_1.z.literal('1.0.0'),
+    reviewedAt: zod_1.z.string().datetime(),
+    status: exports.PatchReviewStatusSchema,
+    /** UUID of the taskCapsule artifact this review was run against. */
+    capsuleArtifactId: zod_1.z.string().uuid().optional(),
+    /** UUID of the implementFinal artifact reviewed. */
+    implementArtifactId: zod_1.z.string().uuid().optional(),
+    /** Parity check result artifact ID. */
+    parityCheckResultId: zod_1.z.string().uuid().optional(),
+    /** Policy result artifact ID. */
+    policyResultId: zod_1.z.string().uuid().optional(),
+    criticalCount: zod_1.z.number().int().min(0),
+    highCount: zod_1.z.number().int().min(0),
+    findings: zod_1.z.array(exports.PatchReviewFindingSchema),
+    /** Files changed in the patch. */
+    filesChanged: zod_1.z.array(zod_1.z.string()),
+    /** Whether the patch stayed within the capsule's change budget. */
+    budgetCompliant: zod_1.z.boolean().optional(),
+    /** Whether all files changed are within the capsule's allowedFiles. */
+    scopeCompliant: zod_1.z.boolean().optional(),
+    /** Summary message for PR body. */
+    summary: zod_1.z.string().optional(),
+});

package/dist/schemas/workflow/plan-approval.schema.d.ts

@@ -0,0 +1,184 @@
+import { z } from "zod";
+/** Status of the plan workflow gate row */
+export declare const PlanGateStatusSchema: z.ZodEnum<["pending_approval", "approved", "rejected"]>;
+export type PlanGateStatus = z.infer<typeof PlanGateStatusSchema>;
+export declare const PlanGateRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<["pending_approval", "approved", "rejected"]>;
+    approved_by: z.ZodNullable<z.ZodString>;
+    approved_at: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodEffects<z.ZodNullable<z.ZodUnknown>, Record<string, unknown> | null, unknown>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status: "rejected" | "pending_approval" | "approved";
+    metadata: Record<string, unknown> | null;
+    approved_by: string | null;
+    approved_at: string | null;
+}, {
+    id: string;
+    status: "rejected" | "pending_approval" | "approved";
+    approved_by: string | null;
+    approved_at: string | null;
+    metadata?: unknown;
+}>;
+export type PlanGateRow = z.infer<typeof PlanGateRowSchema>;
+export declare const PlanFinalRowSchema: z.ZodObject<{
+    status: z.ZodString;
+    guardian_score: z.ZodNullable<z.ZodNumber>;
+    payload: z.ZodEffects<z.ZodNullable<z.ZodUnknown>, Record<string, unknown> | null, unknown>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    created_at: string;
+    guardian_score: number | null;
+    payload: Record<string, unknown> | null;
+}, {
+    status: string;
+    created_at: string;
+    guardian_score: number | null;
+    payload?: unknown;
+}>;
+export type PlanFinalRow = z.infer<typeof PlanFinalRowSchema>;
+export declare const PlanDriftLevelSchema: z.ZodEnum<["none", "low", "medium", "high", "critical"]>;
+export declare const PlanDriftSummarySchema: z.ZodObject<{
+    level: z.ZodEnum<["none", "low", "medium", "high", "critical"]>;
+    message: z.ZodString;
+    details: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    details: string[];
+    level: "critical" | "low" | "medium" | "high" | "none";
+}, {
+    message: string;
+    details: string[];
+    level: "critical" | "low" | "medium" | "high" | "none";
+}>;
+export type PlanDriftSummary = z.infer<typeof PlanDriftSummarySchema>;
+/** Effective project role for plan gate status (owner from `projects.owner_id` wins over team row). */
+export declare const PlanProjectRoleSchema: z.ZodEnum<["owner", "admin", "member", "viewer"]>;
+export type PlanProjectRole = z.infer<typeof PlanProjectRoleSchema>;
+export declare const PlanApprovalPermissionSchema: z.ZodObject<{
+    canApprove: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    reason: string | null;
+    canApprove: boolean;
+}, {
+    reason: string | null;
+    canApprove: boolean;
+}>;
+export type PlanApprovalPermission = z.infer<typeof PlanApprovalPermissionSchema>;
+/** GET /api/projects/:id/plan/gate-status */
+export declare const PlanGateStatusResponseSchema: z.ZodObject<{
+    gate: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<["pending_approval", "approved", "rejected"]>;
+        approved_by: z.ZodNullable<z.ZodString>;
+        approved_at: z.ZodNullable<z.ZodString>;
+        metadata: z.ZodEffects<z.ZodNullable<z.ZodUnknown>, Record<string, unknown> | null, unknown>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        status: "rejected" | "pending_approval" | "approved";
+        metadata: Record<string, unknown> | null;
+        approved_by: string | null;
+        approved_at: string | null;
+    }, {
+        id: string;
+        status: "rejected" | "pending_approval" | "approved";
+        approved_by: string | null;
+        approved_at: string | null;
+        metadata?: unknown;
+    }>>;
+    planFinal: z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        guardian_score: z.ZodNullable<z.ZodNumber>;
+        payload: z.ZodEffects<z.ZodNullable<z.ZodUnknown>, Record<string, unknown> | null, unknown>;
+        created_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        created_at: string;
+        guardian_score: number | null;
+        payload: Record<string, unknown> | null;
+    }, {
+        status: string;
+        created_at: string;
+        guardian_score: number | null;
+        payload?: unknown;
+    }>>;
+    drift: z.ZodNullable<z.ZodObject<{
+        level: z.ZodEnum<["none", "low", "medium", "high", "critical"]>;
+        message: z.ZodString;
+        details: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        details: string[];
+        level: "critical" | "low" | "medium" | "high" | "none";
+    }, {
+        message: string;
+        details: string[];
+        level: "critical" | "low" | "medium" | "high" | "none";
+    }>>;
+    role: z.ZodEnum<["owner", "admin", "member", "viewer"]>;
+    canApprove: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    role: "admin" | "viewer" | "member" | "owner";
+    drift: {
+        message: string;
+        details: string[];
+        level: "critical" | "low" | "medium" | "high" | "none";
+    } | null;
+    canApprove: boolean;
+    gate: {
+        id: string;
+        status: "rejected" | "pending_approval" | "approved";
+        metadata: Record<string, unknown> | null;
+        approved_by: string | null;
+        approved_at: string | null;
+    } | null;
+    planFinal: {
+        status: string;
+        created_at: string;
+        guardian_score: number | null;
+        payload: Record<string, unknown> | null;
+    } | null;
+}, {
+    role: "admin" | "viewer" | "member" | "owner";
+    drift: {
+        message: string;
+        details: string[];
+        level: "critical" | "low" | "medium" | "high" | "none";
+    } | null;
+    canApprove: boolean;
+    gate: {
+        id: string;
+        status: "rejected" | "pending_approval" | "approved";
+        approved_by: string | null;
+        approved_at: string | null;
+        metadata?: unknown;
+    } | null;
+    planFinal: {
+        status: string;
+        created_at: string;
+        guardian_score: number | null;
+        payload?: unknown;
+    } | null;
+}>;
+export type PlanGateStatusResponse = z.infer<typeof PlanGateStatusResponseSchema>;
+export type UsePlanApprovalResult = {
+    gate: PlanGateRow | null;
+    gateLoading: boolean;
+    planFinalAccepted: boolean;
+    planFinalLoading: boolean;
+    drift: PlanDriftSummary | null;
+    permission: PlanApprovalPermission;
+    permissionLoading: boolean;
+    approve: () => Promise<void>;
+    approving: boolean;
+    approveError: string | null;
+    refresh: () => Promise<void>;
+};
+/**
+ * Reads a permissive drift summary from gate metadata or planFinal payload `drift` key.
+ */
+export declare function readPlanDriftFromMetadata(meta: Record<string, unknown> | null): PlanDriftSummary | null;
+export declare function mergePlanDriftFromSources(gateMetadata: Record<string, unknown> | null, planFinalPayload: Record<string, unknown> | null): PlanDriftSummary | null;

package/dist/schemas/workflow/plan-approval.schema.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanGateStatusResponseSchema = exports.PlanApprovalPermissionSchema = exports.PlanProjectRoleSchema = exports.PlanDriftSummarySchema = exports.PlanDriftLevelSchema = exports.PlanFinalRowSchema = exports.PlanGateRowSchema = exports.PlanGateStatusSchema = void 0;
+exports.readPlanDriftFromMetadata = readPlanDriftFromMetadata;
+exports.mergePlanDriftFromSources = mergePlanDriftFromSources;
+const zod_1 = require("zod");
+/** Status of the plan workflow gate row */
+exports.PlanGateStatusSchema = zod_1.z.enum([
+    "pending_approval",
+    "approved",
+    "rejected",
+]);
+const metadataFieldSchema = zod_1.z
+    .unknown()
+    .nullable()
+    .transform((v) => {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === "object" && !Array.isArray(v))
+        return v;
+    return null;
+});
+const payloadFieldSchema = zod_1.z
+    .unknown()
+    .nullable()
+    .transform((v) => {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === "object" && !Array.isArray(v))
+        return v;
+    return null;
+});
+exports.PlanGateRowSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    status: exports.PlanGateStatusSchema,
+    approved_by: zod_1.z.string().nullable(),
+    approved_at: zod_1.z.string().nullable(),
+    metadata: metadataFieldSchema,
+});
+exports.PlanFinalRowSchema = zod_1.z.object({
+    status: zod_1.z.string(),
+    guardian_score: zod_1.z.coerce.number().nullable(),
+    payload: payloadFieldSchema,
+    created_at: zod_1.z.string(),
+});
+exports.PlanDriftLevelSchema = zod_1.z.enum([
+    "none",
+    "low",
+    "medium",
+    "high",
+    "critical",
+]);
+exports.PlanDriftSummarySchema = zod_1.z.object({
+    level: exports.PlanDriftLevelSchema,
+    message: zod_1.z.string(),
+    details: zod_1.z.array(zod_1.z.string()),
+});
+/** Effective project role for plan gate status (owner from `projects.owner_id` wins over team row). */
+exports.PlanProjectRoleSchema = zod_1.z.enum(["owner", "admin", "member", "viewer"]);
+exports.PlanApprovalPermissionSchema = zod_1.z.object({
+    canApprove: zod_1.z.boolean(),
+    reason: zod_1.z.string().nullable(),
+});
+/** GET /api/projects/:id/plan/gate-status */
+exports.PlanGateStatusResponseSchema = zod_1.z.object({
+    gate: exports.PlanGateRowSchema.nullable(),
+    planFinal: exports.PlanFinalRowSchema.nullable(),
+    drift: exports.PlanDriftSummarySchema.nullable(),
+    role: exports.PlanProjectRoleSchema,
+    canApprove: zod_1.z.boolean(),
+});
+/**
+ * Reads a permissive drift summary from gate metadata or planFinal payload `drift` key.
+ */
+function readPlanDriftFromMetadata(meta) {
+    if (meta === null)
+        return null;
+    const drift = meta.drift;
+    if (drift === null || drift === undefined || typeof drift !== "object")
+        return null;
+    const d = drift;
+    const rawLevel = typeof d.level === "string" ? d.level : "medium";
+    const level = rawLevel === "none" ||
+        rawLevel === "low" ||
+        rawLevel === "medium" ||
+        rawLevel === "high" ||
+        rawLevel === "critical"
+        ? rawLevel
+        : "medium";
+    const message = typeof d.message === "string"
+        ? d.message
+        : "Drift detected against the prior plan revision.";
+    const detailsRaw = Array.isArray(d.details) ? d.details : [];
+    const details = detailsRaw.filter((x) => typeof x === "string");
+    return { level, message, details };
+}
+function mergePlanDriftFromSources(gateMetadata, planFinalPayload) {
+    const fromGate = readPlanDriftFromMetadata(gateMetadata);
+    if (fromGate !== null)
+        return fromGate;
+    return readPlanDriftFromMetadata(planFinalPayload);
+}