Function createIssue

src/workspaces/issues/mutate.ts:216–252

(wsDir: string, input: CreateIssueInput)

 * record on success.
 */
export async function createIssue(wsDir: string, input: CreateIssueInput): Promise<CreateResult> {
  const title = input.title?.trim()
  if (!title) return { ok: false, reason: 'invalid', error: 'title is required' }

  const id = (input.id?.trim() || slugify(title))
  if (!id || !ID_RE.test(id)) {
    return { ok: false, reason: 'invalid', error: `cannot derive a valid id from title "${title}" (pass an explicit id)` }
  }

  const existing = await readWorkspaceFile(wsDir, relFor(id))
  if (existing !== null) return { ok: false, reason: 'conflict', id }

  // Assemble frontmatter from only the provided keys (so we don't write default
  // noise), then validate the whole thing against the issue schema.
  const data: Record<string, unknown> = { title }
  if (input.status !== undefined) data.status = input.status
  if (input.priority !== undefined) data.priority = input.priority
  if (input.assignee !== undefined) data.assignee = input.assignee
  if (input.when !== undefined) data.when = input.when
  if (input.what !== undefined) data.what = input.what
  if (input.agent !== undefined) data.agent = input.agent

  const parsed = issueFrontmatterSchema.safeParse(data)
  if (!parsed.success) {
    return {
      ok: false,
      reason: 'invalid',
      error: parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; '),
    }
  }

  const content = serializeIssue(data, input.body ?? '')
  const reparsed = parseIssueContent(id, content)
  if (!reparsed.ok) return { ok: false, reason: 'invalid', error: reparsed.error }
  await writeWorkspaceFile(wsDir, relFor(id), content)
  return { ok: true, issue: reparsed.issue }
}

/** Parse a YAML frontmatter block into a plain object, or null when it isn't a
 *  mapping. Yields the RAW object for in-place merge — the record from