{
  "version": "1.3.0",
  "releasedAt": "2026-05-20",
  "kpi": {
    "rogueId": "sales.deals_summary",
    "slug": "deals_summary",
    "domain": "sales",
    "defaultLabel": "Deals Summary (Won / Lost)",
    "description": "Container handle for the period's notable deals split into WON and LOST arrays — each deal carries name, account, amount, owner, deal type, source, and competitor, plus a win reason + close date (won) or a loss reason (lost). The bespoke sales feed card renders this as the \"Notable Deals\" won/lost breakdown the demo design shows. This is RICHER than the flat `sales.pipeline_key_deals` editor gallery (which has no won/lost split, reason, or close date). Common pitfall: carrying the same list forward each quarter — refresh to the actual period's closes.",
    "fieldType": "text",
    "unit": null,
    "maturity": "general",
    "suggestedForStages": [
      "seriesA",
      "seriesB",
      "seriesC",
      "public"
    ],
    "defaultOwningFunctions": [
      "Sales"
    ],
    "stageRelevance": {
      "seriesA": "recommended",
      "seriesB": "recommended",
      "seriesC": "recommended",
      "public": "recommended"
    },
    "definitionSource": {
      "tier": "editorial",
      "sourceName": "imboard Editorial",
      "sourceUrl": null,
      "sectionRef": null,
      "publicationDate": "2026-04-01",
      "attributionNotice": null
    },
    "formula": "Container — { wonDeals: IWonDeal[], lostDeals: ILostDeal[] }. Won deals carry winReason + closeDate; lost deals carry lossReason. No aggregate calculation; the surface makes specific outcomes visible at the board level.",
    "whyItMatters": "Turns the quarter's win/loss outcomes into board-readable narrative — why deals were won (superior product / service) and lost (features / price / competitor) is the qualitative signal raw pipeline numbers miss.",
    "interpretationGuidance": "Cluster the loss reasons: repeated `features` losses signal a product gap; repeated `price` losses signal a packaging/positioning gap. Pair with `sales.pipeline_key_deals` for the still-open top deals.",
    "relatedKpiIds": [
      "sales.pipeline_key_deals",
      "sales.closed_won_value",
      "sales.closed_lost_value"
    ]
  }
}
