Class ProductionModelPromotionGate

Protected Static ReadonlyALLOWED_TRANSITIONS

ProtecteddetectLeakage

• detectLeakage(
      model: MJMLModelEntity,
      contextUser?: UserInfo,
      provider?: IMetadataProvider,
  ): Promise<{ flagged: boolean; topFeature?: string; topShare?: number }>

  Determine whether the model was leakage-flagged by re-running the single-feature-dominance check over its frozen FeatureImportance against the producing pipeline's threshold.

  Parameters

  • model: MJMLModelEntity
  • OptionalcontextUser: UserInfo
  • Optionalprovider: IMetadataProvider

  Returns Promise<{ flagged: boolean; topFeature?: string; topShare?: number }>

ProtectedloadModel

• loadModel(
      modelId: string,
      contextUser?: UserInfo,
      provider?: IMetadataProvider,
  ): Promise<MJMLModelEntity>

  Load the model as an entity_object (it is mutated to set Status).

  Parameters

  • modelId: string
  • OptionalcontextUser: UserInfo
  • Optionalprovider: IMetadataProvider

  Returns Promise<MJMLModelEntity>

ProtectedrecordSignOff

• recordSignOff(
      model: MJMLModelEntity,
      request: PromoteModelRequest,
      leakage: { topFeature?: string; topShare?: number },
      reason: string,
  ): string

  Persist an auditable sign-off note for a leakage override. The model is immutable (no free-text column to write), so the override is recorded via the platform log (an operator-visible audit line) and returned in the outcome so the calling Action surfaces it. The note captures who/when/what-was-overridden and the supplied reason.

  Parameters

  • model: MJMLModelEntity
  • request: PromoteModelRequest
  • leakage: { topFeature?: string; topShare?: number }
  • reason: string

  Returns string

ProtectedresolveThreshold

• resolveThreshold(
      pipelineId: string,
      contextUser?: UserInfo,
      provider?: IMetadataProvider,
  ): Promise<number>

  Resolve the dominance threshold from the producing pipeline's LeakageGuard.

  Parameters

  • pipelineId: string
  • OptionalcontextUser: UserInfo
  • Optionalprovider: IMetadataProvider

  Returns Promise<number>

ProtectedsyncScoringAction

• syncScoringAction(
      model: MJMLModelEntity,
      targetStatus: PromotableStatus,
      contextUser?: UserInfo,
      provider?: IMetadataProvider,
  ): Promise<void>

  Keep the per-model scoring Action (PS2-2) in step with the model's new lifecycle status — generate/refresh it on Published (the status that makes a model usable for scoring) and disable it on Archived. This is a pure enhancement, NOT part of the promotion contract: any failure is logged and swallowed so it can never fail an otherwise-successful promotion.

  Parameters

  • model: MJMLModelEntity
  • targetStatus: PromotableStatus
  • OptionalcontextUser: UserInfo
  • Optionalprovider: IMetadataProvider

  Returns Promise<void>

Protectedtransition

• transition(
      model: MJMLModelEntity,
      targetStatus: PromotableStatus,
      signOffNote?: string,
      contextUser?: UserInfo,
      provider?: IMetadataProvider,
  ): Promise<PromoteModelOutcome>

  Set ONLY the lifecycle status and save; never touches metrics/artifact. Enforces the ALLOWED_TRANSITIONS state machine first — an illegal jump (e.g. Draft → Published) is refused before any mutation/save.

  Parameters

  • model: MJMLModelEntity
  • targetStatus: PromotableStatus
  • OptionalsignOffNote: string
  • OptionalcontextUser: UserInfo
  • Optionalprovider: IMetadataProvider

  Returns Promise<PromoteModelOutcome>