{
  name         = "Backlog Item",
  description  = "Add a new item to reflection/backlog.ncl. Captures intent, priority, and graduation path.",
  display_mode = "complete",

  elements = [

    { type = "section_header", name = "identity_header",
      title = "Item", border_top = true, border_bottom = true },

    { type = "text", name = "title",
      prompt      = "Title",
      required    = true,
      placeholder = "Migrate examples/ to reflection/forms/",
      help        = "Imperative present tense. What needs to happen.",
      nickel_path = ["title"] },

    { type = "select", name = "kind",
      prompt  = "Kind",
      default = "Todo",
      options = [
        { value = "Todo",  label = "Todo  — concrete task with clear done state" },
        { value = "Wish",  label = "Wish  — desirable but not yet decided" },
        { value = "Idea",  label = "Idea  — worth exploring, not committed" },
        { value = "Bug",   label = "Bug   — known defect to fix" },
        { value = "Debt",  label = "Debt  — technical debt to address" },
      ],
      nickel_path = ["kind"] },

    { type = "select", name = "priority",
      prompt  = "Priority",
      default = "Medium",
      options = [
        { value = "Critical", label = "Critical — blocks other work" },
        { value = "High",     label = "High     — important, do soon" },
        { value = "Medium",   label = "Medium   — normal queue" },
        { value = "Low",      label = "Low      — nice to have" },
      ],
      nickel_path = ["priority"] },

    { type = "editor", name = "detail",
      prompt         = "Detail",
      required       = false,
      file_extension = "md",
      prefix_text    = "# What needs to happen and why?\n# How will done be verified?\n\n",
      nickel_path    = ["detail"] },

    { type = "section_header", name = "links_header",
      title = "Links to existing artifacts", border_top = true, border_bottom = true },

    { type = "text", name = "related_adrs",
      prompt      = "Related ADRs (comma-separated)",
      required    = false,
      placeholder = "adr-001,adr-005",
      nickel_path = ["related_adrs"] },

    { type = "text", name = "related_dim",
      prompt      = "Related ontology dimension ID",
      required    = false,
      placeholder = "reflection-modes-coverage",
      help        = "Query: nickel export .ontology/state.ncl | jq '.dimensions[].id'",
      nickel_path = ["related_dim"] },

    { type = "text", name = "related_config",
      prompt      = "Related config seal ID (if this item tracks a config state)",
      required    = false,
      placeholder = "cfg-001",
      help        = "The cfg-NNN seal this item is linked to. Query: ontoref config history <profile>",
      nickel_path = ["related_config"] },

    { type = "section_header", name = "graduation_header",
      title = "Graduation path", border_top = true, border_bottom = true },

    { type = "section", name = "graduation_note",
      content = "When this item is ready, what does it become? This determines what 'ontoref backlog promote' will do." },

    { type = "select", name = "graduates_to",
      prompt  = "Graduates to",
      options = [
        { value = "Adr",             label = "ADR — becomes an architectural decision record" },
        { value = "Mode",            label = "Mode — becomes a reflection mode with verifiable steps" },
        { value = "StateTransition", label = "StateTransition — moves an ontology dimension forward" },
        { value = "PrItem",          label = "PrItem — becomes a PR checklist entry" },
      ],
      nickel_path = ["graduates_to"] },

    { type = "confirm", name = "ready",
      prompt  = "Add this item to backlog.ncl?",
      default = true,
      nickel_path = ["ready"] },
  ],
}
