type DatasetLogIdentity = {
  path: string;
  tableNamespace: string;
};

/**
 * Dataset paths identify runtime state. They are not CLI export selectors: a
 * returned result field (for example `result.rows`) is the supported export
 * handle. Keep this distinction explicit in operator logs.
 */
export function formatDatasetRegistrationLog(input: {
  dataset: DatasetLogIdentity;
  rows: number;
}): string {
  if (input.rows === 0) {
    return `Dataset ${input.dataset.path} registered (0 rows); export unavailable: empty dataset`;
  }
  return `Dataset ${input.dataset.path} registered (${input.rows} rows); awaiting terminal persistence`;
}

export function formatDatasetAvailabilityLog(input: {
  runId: string;
  dataset: DatasetLogIdentity;
  persistedRows: number;
}): string {
  if (input.persistedRows === 0) {
    return `Dataset ${input.dataset.path} available: 0 persisted rows; export unavailable: empty dataset`;
  }
  return `Dataset ${input.dataset.path} available: ${input.persistedRows} persisted rows; inspect deepline runs get ${input.runId} --full --json for the verified export action`;
}