Function workItemToDocument

apps/sim/connectors/azure-devops/azure-devops.ts:445–499

* Builds a work item document. Work items are returned inline (not deferred) * because the batch fetch already includes all field content. The contentHash * uses the work item revision, which increments on every change. HTML-bearing * fields (description, repro steps, acceptance criteria) are str

(
  organization: string,
  project: string,
  raw: RawWorkItem
)

 * fields (description, repro steps, acceptance criteria) are stripped to text.
 */
function workItemToDocument(
  organization: string,
  project: string,
  raw: RawWorkItem
): ExternalDocument {
  const fields = raw.fields ?? {}
  const title = (fields['System.Title'] as string | undefined) ?? `Work Item ${raw.id}`
  const workItemType = (fields['System.WorkItemType'] as string | undefined) ?? ''
  const state = (fields['System.State'] as string | undefined) ?? ''
  const rev = resolveWorkItemRev(raw, fields)
  const changedDate = (fields['System.ChangedDate'] as string | undefined) ?? ''
  const areaPath = (fields['System.AreaPath'] as string | undefined) ?? ''
  const iterationPath = (fields['System.IterationPath'] as string | undefined) ?? ''
  const rawTags = (fields['System.Tags'] as string | undefined) ?? ''
  const tags = rawTags
    .split(';')
    .map((t) => t.trim())
    .filter(Boolean)
  const description = htmlToPlainText((fields['System.Description'] as string | undefined) ?? '')
  const reproSteps = htmlToPlainText(
    (fields['Microsoft.VSTS.TCM.ReproSteps'] as string | undefined) ?? ''
  )
  const acceptanceCriteria = htmlToPlainText(
    (fields['Microsoft.VSTS.Common.AcceptanceCriteria'] as string | undefined) ?? ''
  )

  const contentParts: string[] = [`Title: ${title}`, `Type: ${workItemType}`, `State: ${state}`]
  if (tags.length > 0) contentParts.push(`Tags: ${tags.join(', ')}`)
  if (description) contentParts.push('', 'Description:', description)
  if (reproSteps) contentParts.push('', 'Repro Steps:', reproSteps)
  if (acceptanceCriteria) contentParts.push('', 'Acceptance Criteria:', acceptanceCriteria)

  return {
    externalId: workItemExternalId(raw.id),
    title: `#${raw.id}: ${title}`,
    content: contentParts.join('\n'),
    contentDeferred: false,
    mimeType: 'text/plain',
    sourceUrl: `${ADO_BASE_URL}/${encodeURIComponent(organization)}/${encodeURIComponent(project)}/_workitems/edit/${raw.id}`,
    contentHash: `ado:wi:${raw.id}:${rev}`,
    metadata: {
      kind: 'workitem',
      organization,
      project,
      workItemId: raw.id,
      workItemType,
      state,
      areaPath,
      iterationPath,
      tags,
      changedDate,
      rev,
    },
  }
}

/**
 * Reads the work-item filter configuration from sourceConfig.