coaia-visualizer 1.6.0 → 1.6.2

package/lib/github-provenance.ts

@@ -1,316 +0,0 @@
-import type { EntityRecord, RelationRecord } from "./types"
-
-export const GITHUB_SYNC_STATES = ["synced", "diverged", "conflict", "project-only", "chart-only"] as const
-
-export type GithubSyncState = (typeof GITHUB_SYNC_STATES)[number]
-
-export interface GithubIssueRef {
-  owner: string
-  repo: string
-  number: number
-  nodeId?: string
-  url?: string
-}
-
-export interface GithubProjectItemRef {
-  projectOwner?: string
-  projectNumber?: number
-  projectTitle?: string
-  itemId?: string
-  projectId?: string
-  url?: string
-  fields?: Record<string, unknown>
-  fieldValues?: Record<string, unknown>
-  projectFields?: Record<string, unknown>
-  [key: string]: unknown
-}
-
-export interface GithubSourceProvenance {
-  system?: string
-  toolName?: string
-  sessionId?: string
-  createdAt?: string
-  version?: string
-  [key: string]: unknown
-}
-
-export interface GithubEntityProvenance {
-  issue?: GithubIssueRef
-  projectItems: GithubProjectItemRef[]
-  syncState?: GithubSyncState
-  lastSyncedAt?: string
-  source?: GithubSourceProvenance
-  hasGithubMetadata: boolean
-}
-
-export interface GithubProjectFieldEntry {
-  key: string
-  label: string
-  value: string
-}
-
-export const GITHUB_PROJECT_FIELD_KEYS = [
-  "goal",
-  "current_reality",
-  "observations",
-  "question",
-  "Status",
-  "phase",
-  "session_id",
-  "four_dir_east",
-  "four_dir_south",
-  "four_dir_west",
-  "four_dir_north",
-  "relational_assessed",
-  "relational_principles",
-] as const
-
-export const GITHUB_BRIDGE_RELATION_TYPES = ["synced_to_github", "linked_to_issue", "project_lens_of"] as const
-
-export type GithubBridgeRelationType = (typeof GITHUB_BRIDGE_RELATION_TYPES)[number]
-
-const PROJECT_FIELD_LABELS: Record<string, string> = {
-  goal: "goal",
-  current_reality: "current reality",
-  observations: "observations",
-  question: "question",
-  Status: "Status",
-  phase: "phase",
-  session_id: "session",
-  four_dir_east: "East",
-  four_dir_south: "South",
-  four_dir_west: "West",
-  four_dir_north: "North",
-  relational_assessed: "relational assessed",
-  relational_principles: "relational principles",
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value)
-}
-
-function firstString(...values: unknown[]): string | undefined {
-  for (const value of values) {
-    if (typeof value === "string" && value.trim()) {
-      return value.trim()
-    }
-  }
-}
-
-function firstNumber(...values: unknown[]): number | undefined {
-  for (const value of values) {
-    if (typeof value === "number" && Number.isFinite(value)) {
-      return value
-    }
-    if (typeof value === "string" && value.trim()) {
-      const parsed = Number(value)
-      if (Number.isFinite(parsed)) {
-        return parsed
-      }
-    }
-  }
-}
-
-function normalizeIssueCandidate(candidate: unknown): GithubIssueRef | undefined {
-  if (!isRecord(candidate)) return undefined
-
-  const owner = firstString(candidate.owner, candidate.ownerLogin, candidate.repositoryOwner)
-  const repo = firstString(candidate.repo, candidate.repository, candidate.repositoryName)
-  const number = firstNumber(candidate.number, candidate.issue_number, candidate.issueNumber, candidate.issue)
-
-  if (!owner || !repo || !number) return undefined
-
-  return {
-    owner,
-    repo,
-    number,
-    nodeId: firstString(candidate.nodeId, candidate.node_id),
-    url: firstString(candidate.url, candidate.html_url) ?? `https://github.com/${owner}/${repo}/issues/${number}`,
-  }
-}
-
-function normalizeProjectItemCandidate(candidate: unknown, fallbackOwner?: string): GithubProjectItemRef | undefined {
-  if (!isRecord(candidate)) return undefined
-
-  const projectOwner = firstString(candidate.projectOwner, candidate.owner, candidate.ownerLogin, fallbackOwner)
-  const projectNumber = firstNumber(candidate.projectNumber, candidate.project_number, candidate.number)
-  const itemId = firstString(candidate.itemId, candidate.item_id, candidate.projectItemId, candidate.project_id)
-  const projectId = firstString(candidate.projectId, candidate.project_id)
-  const projectTitle = firstString(candidate.projectTitle, candidate.title, candidate.project)
-  const url = firstString(candidate.url)
-
-  if (!projectOwner && !projectNumber && !itemId && !projectId && !projectTitle && !url) {
-    return undefined
-  }
-
-  return {
-    ...candidate,
-    projectOwner,
-    projectNumber,
-    projectTitle,
-    itemId,
-    projectId,
-    url,
-  }
-}
-
-export function getGithubIssueRef(entity?: EntityRecord): GithubIssueRef | undefined {
-  if (!entity) return undefined
-
-  const metadata = entity.metadata ?? {}
-  const github = isRecord(metadata.github) ? metadata.github : undefined
-  const syncTarget = isRecord(metadata.sync_target) ? metadata.sync_target : undefined
-  const githubRef = isRecord(metadata.github_ref) ? metadata.github_ref : undefined
-
-  return normalizeIssueCandidate(github?.issue) ?? normalizeIssueCandidate(syncTarget) ?? normalizeIssueCandidate(githubRef)
-}
-
-export function getGithubProjectItems(entity?: EntityRecord): GithubProjectItemRef[] {
-  if (!entity) return []
-
-  const metadata = entity.metadata ?? {}
-  const github = isRecord(metadata.github) ? metadata.github : undefined
-  const syncTarget = isRecord(metadata.sync_target) ? metadata.sync_target : undefined
-  const fallbackOwner = getGithubIssueRef(entity)?.owner
-
-  if (Array.isArray(github?.projectItems)) {
-    return github.projectItems
-      .map((item) => normalizeProjectItemCandidate(item, fallbackOwner))
-      .filter((item): item is GithubProjectItemRef => Boolean(item))
-  }
-
-  const canonicalProjectItem = normalizeProjectItemCandidate(github?.projectItem, fallbackOwner)
-  if (canonicalProjectItem) {
-    return [canonicalProjectItem]
-  }
-
-  const legacyProjectItem = normalizeProjectItemCandidate(syncTarget, fallbackOwner)
-  return legacyProjectItem ? [legacyProjectItem] : []
-}
-
-export function getGithubSyncState(entityOrMetadata?: EntityRecord | Record<string, unknown>): GithubSyncState | undefined {
-  const metadata =
-    entityOrMetadata && "metadata" in entityOrMetadata && isRecord(entityOrMetadata.metadata)
-      ? entityOrMetadata.metadata
-      : entityOrMetadata
-
-  if (!isRecord(metadata)) return undefined
-
-  const github = isRecord(metadata.github) ? metadata.github : undefined
-  const syncState = github?.syncState ?? metadata.syncState
-
-  return typeof syncState === "string" && GITHUB_SYNC_STATES.includes(syncState as GithubSyncState)
-    ? (syncState as GithubSyncState)
-    : undefined
-}
-
-export function getGithubSource(entity?: EntityRecord): GithubSourceProvenance | undefined {
-  if (!entity) return undefined
-
-  const source = entity.metadata?.source
-  return isRecord(source) ? (source as GithubSourceProvenance) : undefined
-}
-
-export function getGithubEntityProvenance(entity?: EntityRecord): GithubEntityProvenance {
-  const metadata = entity?.metadata ?? {}
-  const github = isRecord(metadata.github) ? metadata.github : undefined
-  const issue = getGithubIssueRef(entity)
-  const projectItems = getGithubProjectItems(entity)
-  const syncTarget = isRecord(metadata.sync_target) ? metadata.sync_target : undefined
-  const githubRef = isRecord(metadata.github_ref) ? metadata.github_ref : undefined
-  const source = getGithubSource(entity)
-
-  return {
-    issue,
-    projectItems,
-    syncState: getGithubSyncState(entity),
-    lastSyncedAt: firstString(github?.lastSyncedAt, metadata.lastSyncedAt),
-    source,
-    hasGithubMetadata:
-      Boolean(github) ||
-      Boolean(syncTarget) ||
-      Boolean(githubRef) ||
-      source?.system === "coaia-github" ||
-      Boolean(issue) ||
-      projectItems.length > 0,
-  }
-}
-
-export function formatGithubIssueRef(issue?: GithubIssueRef): string | undefined {
-  if (!issue) return undefined
-  return `${issue.owner}/${issue.repo}#${issue.number}`
-}
-
-export function formatProjectItemRef(projectItem?: GithubProjectItemRef): string | undefined {
-  if (!projectItem) return undefined
-
-  if (projectItem.projectOwner && projectItem.projectNumber) {
-    return `${projectItem.projectOwner}/${projectItem.projectNumber}`
-  }
-
-  return projectItem.projectTitle || projectItem.itemId || projectItem.projectId || projectItem.url
-}
-
-export function getProjectFieldEntries(
-  entity: EntityRecord | undefined,
-  projectItem?: GithubProjectItemRef,
-): GithubProjectFieldEntry[] {
-  const metadata = entity?.metadata ?? {}
-  const github = isRecord(metadata.github) ? metadata.github : undefined
-  const sources = [
-    projectItem?.fields,
-    projectItem?.fieldValues,
-    projectItem?.projectFields,
-    github?.fields,
-    github?.fieldValues,
-    github?.projectFields,
-    metadata,
-    github,
-  ].filter(isRecord)
-
-  return GITHUB_PROJECT_FIELD_KEYS.flatMap((key) => {
-    for (const source of sources) {
-      if (!(key in source)) continue
-      const value = stringifyFieldValue(source[key])
-      if (value) {
-        return [{ key, label: PROJECT_FIELD_LABELS[key], value }]
-      }
-    }
-    return []
-  })
-}
-
-export function getGithubBridgeRelationType(relation: RelationRecord): GithubBridgeRelationType | undefined {
-  const relationType = relation.relationType
-  if (GITHUB_BRIDGE_RELATION_TYPES.includes(relationType as GithubBridgeRelationType)) {
-    return relationType as GithubBridgeRelationType
-  }
-
-  const metadata = relation.metadata ?? {}
-  const github = isRecord(metadata.github) ? metadata.github : undefined
-  const context = firstString(
-    metadata.context,
-    metadata.relation,
-    metadata.relationName,
-    metadata.semanticType,
-    github?.context,
-    github?.relation,
-  )
-
-  return GITHUB_BRIDGE_RELATION_TYPES.includes(context as GithubBridgeRelationType)
-    ? (context as GithubBridgeRelationType)
-    : undefined
-}
-
-function stringifyFieldValue(value: unknown): string | undefined {
-  if (value === null || value === undefined) return undefined
-  if (typeof value === "string") return value.trim() || undefined
-  if (typeof value === "number" || typeof value === "boolean") return String(value)
-  if (Array.isArray(value)) {
-    const rendered = value.map(stringifyFieldValue).filter(Boolean).join(", ")
-    return rendered || undefined
-  }
-  if (isRecord(value)) {
-    return firstString(value.name, value.text, value.value, value.title, value.label) ?? JSON.stringify(value)
-  }
-}