Function checkSubblockIdStability

apps/sim/scripts/check-block-registry.ts:152–190

()

  | { kind: 'fail'; errors: string[] }

function checkSubblockIdStability(): CheckResult {
  const previous = getPreviousIds()

  if (previous.kind === 'skip') {
    return { kind: 'skip', message: `${previous.reason} — skipping subblock ID stability check` }
  }
  if (previous.kind === 'noop') {
    return {
      kind: 'skip',
      message: 'No block definition changes detected — skipping subblock ID stability check',
    }
  }

  const current = getCurrentIds()
  const errors: string[] = []

  for (const [blockType, prevIds] of Object.entries(previous.map)) {
    const currIds = current[blockType]
    if (!currIds) continue

    const migrations = SUBBLOCK_ID_MIGRATIONS[blockType] ?? {}

    for (const oldId of prevIds) {
      if (currIds.has(oldId)) continue
      if (oldId in migrations) continue

      errors.push(
        `Block "${blockType}": subblock ID "${oldId}" was removed.\n` +
          `  → Add a migration in SUBBLOCK_ID_MIGRATIONS (lib/workflows/migrations/subblock-migrations.ts)\n` +
          `    mapping "${oldId}" to its replacement ID.`
      )
    }
  }

  if (errors.length === 0) {
    return { kind: 'pass', message: 'Subblock ID stability check passed' }
  }
  return { kind: 'fail', errors }
}

function checkCanonicalIdContract(): CheckResult {
  const errors: string[] = []