@validation-os/dashboard 0.16.1 → 0.16.3

package/dist/index.d.ts

@@ -586,6 +586,9 @@ interface PipelineRow {
     nextMove: string;
     /** The assumption's Question Type (DEV-5890) — kind of claim. */
     questionType: string | null;
+    /** The max ceiling for this question type (highest anchor across all
+     * rungs) — the Known meter fills relative to this, not the absolute 100. */
+    questionTypeCeiling: number | null;
     /** The assumption's Stage (DEV-5890) — kind of response / threshold. */
     stage: string | null;
     /** The stage's Risk threshold (DEV-5890) — the stopping bar. */
@@ -1461,11 +1464,11 @@ declare function NextMoveSurface({ basePath, onNavigate }: NextMoveSurfaceProps)
 
 /** The four discovery stages, in their canonical ordinal order (1→4). The
  * stored value is the name; the ordinal is for sort/display only. */
-declare const STAGE_ORDER: readonly ["Discovery", "Validation", "Scale", "Maturity"];
-type StageValue = (typeof STAGE_ORDER)[number];
+declare const STAGE_ORDER$1: readonly ["Discovery", "Validation", "Scale", "Maturity"];
+type StageValue$1 = (typeof STAGE_ORDER$1)[number];
 /** A short, plain-language gloss for each stage — the column header's
  * subtitle and the cell tooltip. Drawn from docs/stage-policy.md. */
-declare const STAGE_GLOSS: Record<StageValue, string>;
+declare const STAGE_GLOSS: Record<StageValue$1, string>;
 /** One cell of the Lens × Stage grid. */
 interface StageGridCell {
     /** The Lens (row) this cell sits under. */
@@ -1473,7 +1476,7 @@ interface StageGridCell {
     /** The Stage (column) this cell sits under — one of the four canonical
      * stages, or the `NO_STAGE` ("—") sentinel for records with no/invalid
      * Stage (the gate-leakage bucket, only emitted when needed). */
-    stage: StageValue | typeof NO_STAGE;
+    stage: StageValue$1 | typeof NO_STAGE$1;
     /** How many assumptions hold this Lens × Stage pair. */
     count: number;
     /** The assumptions in this cell, ranked by Risk (highest first). Empty
@@ -1491,7 +1494,7 @@ interface StageGridView {
      * a trailing "—" row for assumptions with no Lens set. */
     lenses: string[];
     /** The four stages in their canonical ordinal order. */
-    stages: StageValue[];
+    stages: StageValue$1[];
     /** One cell per (lens, stage) pair, in row-major order: lens-first,
      * stage-within-lens. */
     cells: StageGridCell[];
@@ -1504,11 +1507,11 @@ interface StageGridView {
     total: number;
 }
 declare const NO_LENS = "\u2014";
-declare const NO_STAGE = "\u2014";
+declare const NO_STAGE$1 = "\u2014";
 /** A stage value from a record, validated against the fixed vocabulary.
  * Returns null for an empty or unrecognised value — the caller decides
  * whether to bucket those or drop them. */
-declare function stageOf(record: AnyRecord): StageValue | null;
+declare function stageOf(record: AnyRecord): StageValue$1 | null;
 /** Sort a list of assumptions by Risk, highest first. Stable on tie by id —
  * matches the pipeline board's "riskiest first" convention. Pure: returns a
  * new array, leaves the input alone. */
@@ -1540,7 +1543,7 @@ declare function buildStageGrid(assumptions: AnyRecord[]): StageGridView;
 /** The cell at a given (lens, stage) — null if no such cell (e.g. a stage
  * not in the canonical order). The "—" row / "—" column are addressable
  * with the `NO_LENS` / `NO_STAGE` sentinels. */
-declare function cellAt(view: StageGridView, lens: string, stage: StageValue | typeof NO_STAGE): StageGridCell | null;
+declare function cellAt(view: StageGridView, lens: string, stage: StageValue$1 | typeof NO_STAGE$1): StageGridCell | null;
 
 /**
  * The Lens × Stage heatmap surface (docs/stage-policy.md §The dashboard
@@ -1570,6 +1573,60 @@ interface StageGridSurfaceProps {
 }
 declare function StageGridSurface({ basePath, onNavigate }: StageGridSurfaceProps): react.JSX.Element;
 
+/**
+ * The Lens × Stage × Question Type heatmap view-model (DEV-5890) — pure, no
+ * React, no I/O. Extends the 2D Lens × Stage grid with a Question Type
+ * filter axis and Risk-weighted heat.
+ *
+ * The grid is the **filter**, Risk is the **heat**. Each cell's colour
+ * intensity reflects the aggregate Risk (sum of derived.risk) of the
+ * assumptions in that cell, not just the count. A cell with 3 high-Risk
+ * assumptions is hotter than a cell with 10 low-Risk ones.
+ *
+ * The Question Type axis is a filter: selecting a type (e.g. "Existence")
+ * shows only assumptions of that type in the grid. "All" shows everything.
+ */
+
+declare const STAGE_ORDER: readonly ["Discovery", "Validation", "Scale", "Maturity"];
+type StageValue = (typeof STAGE_ORDER)[number];
+/** The 7 question types + "All" for the filter. */
+declare const QUESTION_TYPE_FILTERS: readonly ["All", "Existence", "Prevalence", "CausalEffect", "WillingnessToPay", "ValueUtility", "Regulatory", "Feasibility"];
+type QuestionTypeFilter = (typeof QUESTION_TYPE_FILTERS)[number];
+interface HeatCell {
+    lens: string;
+    stage: StageValue | typeof NO_STAGE;
+    questionType: string | null;
+    count: number;
+    /** The sum of Risk across all assumptions in this cell — the heat value. */
+    totalRisk: number;
+    /** The average Risk per assumption — used for the heat scale. */
+    avgRisk: number;
+    /** The assumptions in this cell, ranked by Risk (highest first). */
+    assumptions: AnyRecord[];
+    /** Heat intensity in [0, 1] — avgRisk / maxAvgRisk across the grid. */
+    heat: number;
+}
+interface HeatGridView {
+    lenses: string[];
+    stages: StageValue[];
+    /** The question types present in the data (for the filter tabs). */
+    questionTypes: string[];
+    cells: HeatCell[];
+    maxAvgRisk: number;
+    maxCellCount: number;
+    total: number;
+}
+declare const NO_STAGE = "\u2014";
+/**
+ * Build the Lens × Stage × Question Type grid. When `questionTypeFilter` is
+ * "All" or null, all assumptions are included. When a specific type is
+ * selected, only assumptions of that type are shown. Heat = avg Risk per cell.
+ */
+declare function buildHeatGrid(assumptions: AnyRecord[], questionTypeFilter?: QuestionTypeFilter): HeatGridView;
+declare function heatCellAt(view: HeatGridView, lens: string, stage: StageValue | typeof NO_STAGE): HeatCell | null;
+/** Map a heat value [0, 1] to a 5-step colour scale. */
+declare function heatLevel(heat: number): 0 | 1 | 2 | 3 | 4;
+
 interface ScoreImpactFormProps {
     /** The assumption being weighted (its version guards the write). */
     assumption: AnyRecord;
@@ -1992,4 +2049,4 @@ declare const REGISTER_GROUPS: {
     registers: Collection[];
 }[];
 
-export { type BacklinkItem, BeliefJourney, type BeliefJourneyProps, type BeliefVerdict, BeliefVerdicts, CONFLICT_MESSAGE, type CellKind, type ColdStart, type ColumnDef, ConfidenceCell, ConnectClaudeCode, type ConnectClaudeCodeProps, type ConnectCommandInput, type Counts, type CycleReadingView, type CycleView, DEFAULT_TOKEN_ENV, DIRECT_CYCLE_KEY, type DashboardConfig, type DetailRelationItem, type DetailRow, type DetailRowKind, type Draft, EditBeliefForm, type EditBeliefFormProps, EditFields, type ExperimentView, FIRST_RUN_LINE, type FieldEditor, FieldInput, type FieldKind, type FormField, type GlossaryTerm, GlossaryText, type GlossaryTextProps, type GroupBucket, type GroupByAxis, type HumanText, type JourneyColdState, type JourneyEventView, type JourneyView, type LinkArgs, type LinkChoice, type LinkifyNode, type LinkifyOptions, Markdown, type Meter, type MeterKind, type MovePresentation, NO_LENS, NO_STAGE, type NeedsHumanByRegister, type NeedsHumanCounts, type NeighbourChip, type NestedGroup, type NextColdStart, type NextMoveRecords, NextMoveSurface, type NextMoveSurfaceProps, type OtherMover, type Pill, type PipelineColdStart, type PipelineRow, PipelineSurface, type PipelineView, REGISTER_GROUPS, REGISTER_ICON, REGISTER_LABEL, REGISTER_ORDER, REGISTER_SINGULAR, REGISTER_SUBTITLE, RISK_CRIT, RISK_WARN, RecordDrawer, type RecordDrawerProps, RecordForm, type RecordFormProps, RecordPage, type RecordPageModel, type RecordPageProps, type RecordTabId, RegisterBrowser, type RegisterBrowserProps, type RegisterContext, RegisterCounts, type RegisterCountsProps, RegisterTable, type RegisterTableProps, type RelatedSet, RelationEditor, type RelationEditorProps, type RelationPanel, type ResolvedBarLine, type ResolvedRow, type RiskBand, RiskBar, type Route, STAGE_GLOSS, STAGE_ORDER, type SaveResult, type SavedView, type ScoreChip, ScoreImpactForm, type ScoreImpactFormProps, type ShapedRegister, SidebarNav, type SidebarNavProps, type SortSpec, Sparkline, type StageGridCell, StageGridSurface, type StageGridSurfaceProps, type StageGridView, type StageMeterInput, type StageMeterView, type StageValue, StatTile, StatusPill, type StepInForm, type StoryStepIn, SurfacePlaceholder, type SurfacePlaceholderProps, type TabDef, type TermPreview, type Tone, type Understanding, UnderstandingPanel, type UseCountsResult, type UseCreateResult, type UseLinkResult, type UseListResult, type UseNeedsHumanResult, type UseRecordResult, type UseSavedViewsResult, type UseUpdateResult, ValidationOSDashboard, type ValidationOSDashboardProps, type ViewDescriptor, WriteDecisionForm, type WriteDecisionFormProps, backlinkPanels, bodyPreview, buildCycles, buildJourney, buildPatch, buildPipeline, buildRecordPage, buildStageGrid, buildUnderstanding, cellAt, cellValue, coldStartFor, columnsFor, composeConnectCommand, confidenceTone, configureRiskBands, defaultTabId, detailRows, dontConfuseWith, draftFrom, editableFields, emptyDraft, eventStepIn, eventTone, filterRecords, formFieldsFor, formatCount, formatRoute, formatSigned, formatValue, groupByAxesFor, groupRecords, hasEdits, headerPills, humanInputFields, interpretSave, journeyColdState, leadingMeters, linkChoicesFrom, linkify, missingRequired, movePresentation, needsHumanCounts, nestReadingsByPlan, ownerNames, parseRoute, primaryLabel, rankByRisk, readingAssumptionChips, readingBeliefVerdicts, resolveBarLines, riskBand, riskFraction, riskLevel, scoreChip, shapeRegister, sortRecords, sparklinePath, stageMeters, stageOf, statusTone, tabsFor, toCreatePayload, toGlossaryTerms, toNextMoveInput, toStageExperimentInput, useCounts, useCreate, useLink, useList, useNeedsHuman, useRecord, useSavedViews, useUpdate, weekOverWeekDelta };
+export { type BacklinkItem, BeliefJourney, type BeliefJourneyProps, type BeliefVerdict, BeliefVerdicts, CONFLICT_MESSAGE, type CellKind, type ColdStart, type ColumnDef, ConfidenceCell, ConnectClaudeCode, type ConnectClaudeCodeProps, type ConnectCommandInput, type Counts, type CycleReadingView, type CycleView, DEFAULT_TOKEN_ENV, DIRECT_CYCLE_KEY, type DashboardConfig, type DetailRelationItem, type DetailRow, type DetailRowKind, type Draft, EditBeliefForm, type EditBeliefFormProps, EditFields, type ExperimentView, FIRST_RUN_LINE, type FieldEditor, FieldInput, type FieldKind, type FormField, type GlossaryTerm, GlossaryText, type GlossaryTextProps, type GroupBucket, type GroupByAxis, type HeatCell, type HeatGridView, type HumanText, type JourneyColdState, type JourneyEventView, type JourneyView, type LinkArgs, type LinkChoice, type LinkifyNode, type LinkifyOptions, Markdown, type Meter, type MeterKind, type MovePresentation, NO_LENS, NO_STAGE$1 as NO_STAGE, type NeedsHumanByRegister, type NeedsHumanCounts, type NeighbourChip, type NestedGroup, type NextColdStart, type NextMoveRecords, NextMoveSurface, type NextMoveSurfaceProps, type OtherMover, type Pill, type PipelineColdStart, type PipelineRow, PipelineSurface, type PipelineView, QUESTION_TYPE_FILTERS, type QuestionTypeFilter, REGISTER_GROUPS, REGISTER_ICON, REGISTER_LABEL, REGISTER_ORDER, REGISTER_SINGULAR, REGISTER_SUBTITLE, RISK_CRIT, RISK_WARN, RecordDrawer, type RecordDrawerProps, RecordForm, type RecordFormProps, RecordPage, type RecordPageModel, type RecordPageProps, type RecordTabId, RegisterBrowser, type RegisterBrowserProps, type RegisterContext, RegisterCounts, type RegisterCountsProps, RegisterTable, type RegisterTableProps, type RelatedSet, RelationEditor, type RelationEditorProps, type RelationPanel, type ResolvedBarLine, type ResolvedRow, type RiskBand, RiskBar, type Route, STAGE_GLOSS, STAGE_ORDER$1 as STAGE_ORDER, type SaveResult, type SavedView, type ScoreChip, ScoreImpactForm, type ScoreImpactFormProps, type ShapedRegister, SidebarNav, type SidebarNavProps, type SortSpec, Sparkline, type StageGridCell, StageGridSurface, type StageGridSurfaceProps, type StageGridView, type StageMeterInput, type StageMeterView, type StageValue$1 as StageValue, StatTile, StatusPill, type StepInForm, type StoryStepIn, SurfacePlaceholder, type SurfacePlaceholderProps, type TabDef, type TermPreview, type Tone, type Understanding, UnderstandingPanel, type UseCountsResult, type UseCreateResult, type UseLinkResult, type UseListResult, type UseNeedsHumanResult, type UseRecordResult, type UseSavedViewsResult, type UseUpdateResult, ValidationOSDashboard, type ValidationOSDashboardProps, type ViewDescriptor, WriteDecisionForm, type WriteDecisionFormProps, backlinkPanels, bodyPreview, buildCycles, buildHeatGrid, buildJourney, buildPatch, buildPipeline, buildRecordPage, buildStageGrid, buildUnderstanding, cellAt, cellValue, coldStartFor, columnsFor, composeConnectCommand, confidenceTone, configureRiskBands, defaultTabId, detailRows, dontConfuseWith, draftFrom, editableFields, emptyDraft, eventStepIn, eventTone, filterRecords, formFieldsFor, formatCount, formatRoute, formatSigned, formatValue, groupByAxesFor, groupRecords, hasEdits, headerPills, heatCellAt, heatLevel, humanInputFields, interpretSave, journeyColdState, leadingMeters, linkChoicesFrom, linkify, missingRequired, movePresentation, needsHumanCounts, nestReadingsByPlan, ownerNames, parseRoute, primaryLabel, rankByRisk, readingAssumptionChips, readingBeliefVerdicts, resolveBarLines, riskBand, riskFraction, riskLevel, scoreChip, shapeRegister, sortRecords, sparklinePath, stageMeters, stageOf, statusTone, tabsFor, toCreatePayload, toGlossaryTerms, toNextMoveInput, toStageExperimentInput, useCounts, useCreate, useLink, useList, useNeedsHuman, useRecord, useSavedViews, useUpdate, weekOverWeekDelta };

package/dist/index.js

@@ -1802,10 +1802,7 @@ function ThresholdBar({
   stage,
   cleared
 }) {
-  const riskTrackMax = Math.max(risk, threshold) * 1.25;
-  const riskPct = Math.min(100, risk / riskTrackMax * 100);
-  const thresholdPct = Math.min(100, threshold / riskTrackMax * 100);
-  const confPct = Math.min(100, Math.abs(confidence2));
+  const confPct = Math.min(100, Math.max(0, Math.abs(confidence2)));
   const confFloorPct = Math.min(100, confFloor);
   const riskBelow = risk <= threshold;
   const confAbove = confidence2 >= confFloor;
@@ -1813,49 +1810,30 @@ function ThresholdBar({
   return /* @__PURE__ */ jsxs4("div", { className: "vos-card vos-threshold-bar-card", children: [
     /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-header", children: [
       /* @__PURE__ */ jsxs4("span", { className: "vos-threshold-bar-title", children: [
-        stage,
-        " evidence bar",
+        "Evidence needed",
         /* @__PURE__ */ jsx4("span", { className: "vos-threshold-bar-stage-tag", children: stage })
       ] }),
       /* @__PURE__ */ jsx4("span", { className: `vos-threshold-bar-status vos-threshold-bar-${tone}`, children: cleared ? "Cleared" : "Needs evidence" })
     ] }),
     /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-section", children: [
       /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-section-label", children: [
-        /* @__PURE__ */ jsx4("span", { children: "Risk" }),
-        /* @__PURE__ */ jsx4("span", { className: "vos-num vos-threshold-bar-section-val", children: Math.round(risk) }),
+        /* @__PURE__ */ jsx4("span", { children: "Confidence" }),
+        /* @__PURE__ */ jsx4("span", { className: "vos-num vos-threshold-bar-section-val", children: formatSigned(confidence2) }),
         /* @__PURE__ */ jsxs4("span", { className: "vos-threshold-bar-section-target", children: [
-          "bar \u2264 ",
-          threshold
+          "need \u2265 ",
+          confFloor,
+          " ",
+          cleared ? "\u2713" : ""
         ] })
       ] }),
-      /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-track", children: [
+      /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-track vos-threshold-bar-track-tall", children: [
         /* @__PURE__ */ jsx4(
           "div",
           {
-            className: `vos-threshold-bar-fill vos-fill-${riskBelow ? "good" : tone}`,
-            style: { width: `${riskPct}%` }
+            className: "vos-threshold-bar-target-zone",
+            style: { left: `${confFloorPct}%` }
           }
         ),
-        /* @__PURE__ */ jsx4(
-          "div",
-          {
-            className: "vos-threshold-bar-marker",
-            style: { left: `${thresholdPct}%` },
-            title: `Risk threshold: ${threshold}`
-          }
-        )
-      ] })
-    ] }),
-    /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-section", children: [
-      /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-section-label", children: [
-        /* @__PURE__ */ jsx4("span", { children: "Confidence" }),
-        /* @__PURE__ */ jsx4("span", { className: "vos-num vos-threshold-bar-section-val", children: formatSigned(confidence2) }),
-        /* @__PURE__ */ jsxs4("span", { className: "vos-threshold-bar-section-target", children: [
-          "floor \u2265 ",
-          confFloor
-        ] })
-      ] }),
-      /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-track vos-threshold-bar-track-conf", children: [
         /* @__PURE__ */ jsx4(
           "div",
           {
@@ -1866,14 +1844,32 @@ function ThresholdBar({
         /* @__PURE__ */ jsx4(
           "div",
           {
-            className: "vos-threshold-bar-marker vos-threshold-bar-marker-conf",
+            className: "vos-threshold-bar-marker",
             style: { left: `${confFloorPct}%` },
-            title: `Confidence floor: ${confFloor}`
+            title: `Need Confidence \u2265 ${confFloor} for ${stage}`,
+            children: /* @__PURE__ */ jsx4("span", { className: "vos-threshold-bar-marker-label vos-num", children: confFloor })
           }
         )
+      ] }),
+      /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-scale", children: [
+        /* @__PURE__ */ jsx4("span", { className: "vos-num", children: "0" }),
+        /* @__PURE__ */ jsx4("span", { className: "vos-num vos-threshold-bar-scale-mid", children: "50" }),
+        /* @__PURE__ */ jsx4("span", { className: "vos-num", children: "100" })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs4("div", { className: "vos-threshold-bar-risk-summary", children: [
+      /* @__PURE__ */ jsxs4("span", { className: `vos-threshold-bar-risk-val vos-text-${riskBelow ? "good" : "crit"}`, children: [
+        "Risk ",
+        Math.round(risk)
+      ] }),
+      /* @__PURE__ */ jsxs4("span", { className: "vos-threshold-bar-risk-cap", children: [
+        "max ",
+        threshold,
+        " for ",
+        stage
       ] })
     ] }),
-    /* @__PURE__ */ jsx4("div", { className: "vos-threshold-bar-hint", children: cleared ? `Risk ${Math.round(risk)} \u2264 ${threshold} and Confidence ${formatSigned(confidence2)} \u2265 ${confFloor} \u2014 cleared for ${stage}.` : `Risk ${Math.round(risk)} ${riskBelow ? "\u2264" : ">"} ${threshold}, Confidence ${formatSigned(confidence2)} ${confAbove ? "\u2265" : "<"} ${confFloor} \u2014 needs ${!riskBelow ? "lower Risk" : ""}${!riskBelow && !confAbove ? " + " : ""}${!confAbove ? "higher Confidence" : ""}.` })
+    /* @__PURE__ */ jsx4("div", { className: "vos-threshold-bar-hint", children: cleared ? `Confidence ${formatSigned(confidence2)} \u2265 ${confFloor} and Risk ${Math.round(risk)} \u2264 ${threshold} \u2014 cleared for ${stage}.` : `Need Confidence \u2265 ${confFloor}${!confAbove ? ` (now ${formatSigned(confidence2)})` : " \u2713"} and Risk \u2264 ${threshold}${!riskBelow ? ` (now ${Math.round(risk)})` : " \u2713"}.` })
   ] });
 }
 function riskTone(risk) {
@@ -2210,7 +2206,11 @@ import {
   assumptionCompleteness,
   readingBeliefInputs
 } from "@validation-os/core";
-import { confidenceFloorForStage as confidenceFloorForStage2, riskThresholdForStage as riskThresholdForStage2 } from "@validation-os/core/derivation";
+import {
+  confidenceFloorForStage as confidenceFloorForStage2,
+  riskThresholdForStage as riskThresholdForStage2,
+  RUNG_ANCHOR as RUNG_ANCHOR3
+} from "@validation-os/core/derivation";
 
 // src/stage-grid-model.ts
 var STAGE_ORDER = [
@@ -2407,6 +2407,13 @@ function buildPipeline(assumptions, experiments) {
     const framed = assumptionCompleteness(a);
     const stage = deriveBeliefStage({ framed, confidence: d.confidence, test });
     const questionType = str3(a["Question Type"]);
+    let questionTypeCeiling = null;
+    if (questionType && questionType in RUNG_ANCHOR3) {
+      const subLadder = RUNG_ANCHOR3[questionType];
+      questionTypeCeiling = Math.max(
+        ...Object.values(subLadder).map((r) => r.High)
+      );
+    }
     const stageName = str3(a.Stage);
     const stageKey = stageName && STAGE_ORDER.includes(stageName) ? stageName : null;
     const riskThreshold = stageKey ? riskThresholdForStage2(stageKey) : null;
@@ -2425,6 +2432,7 @@ function buildPipeline(assumptions, experiments) {
       tested: stage.tested,
       nextMove: nextMove(stage.stage, stage.killZone),
       questionType,
+      questionTypeCeiling,
       stage: stageName,
       riskThreshold,
       clearedThreshold: riskThreshold != null ? d.risk <= riskThreshold && (confFloor == null || stage.confidence >= confFloor) : null
@@ -2672,6 +2680,148 @@ function stageMeters(input) {
   ];
 }
 
+// src/heat-grid-model.ts
+var STAGE_ORDER2 = [
+  "Discovery",
+  "Validation",
+  "Scale",
+  "Maturity"
+];
+var STAGE_GLOSS2 = {
+  Discovery: "Problem-solution fit \u2014 will they engage, care, disclose?",
+  Validation: "Product-market fit \u2014 will they pay, sign, stay?",
+  Scale: "Growth \u2014 can we acquire efficiently, does CAC<LTV hold at volume?",
+  Maturity: "Defense \u2014 will incumbents respond, will regulators accept?"
+};
+var QUESTION_TYPE_FILTERS = [
+  "All",
+  "Existence",
+  "Prevalence",
+  "CausalEffect",
+  "WillingnessToPay",
+  "ValueUtility",
+  "Regulatory",
+  "Feasibility"
+];
+var NO_LENS2 = "\u2014";
+var NO_STAGE2 = "\u2014";
+function stageOf2(record) {
+  const v = str(record.Stage);
+  if (!v) return null;
+  return STAGE_ORDER2.includes(v) ? v : null;
+}
+function questionTypeOf(record) {
+  return str(record["Question Type"]);
+}
+function rankByRisk2(records) {
+  return [...records].map((r) => ({ r, risk: derivedNum(r, "risk") ?? 0 })).sort(
+    (a, b) => a.risk !== b.risk ? b.risk - a.risk : a.r.id.localeCompare(b.r.id)
+  ).map((x) => x.r);
+}
+function buildHeatGrid(assumptions, questionTypeFilter = "All") {
+  const filtered = questionTypeFilter === "All" || !questionTypeFilter ? assumptions : assumptions.filter((a) => questionTypeOf(a) === questionTypeFilter);
+  const lensOrder = [];
+  const seenLens = /* @__PURE__ */ new Set();
+  const pushLens = (lens) => {
+    if (!seenLens.has(lens)) {
+      seenLens.add(lens);
+      lensOrder.push(lens);
+    }
+  };
+  const buckets = /* @__PURE__ */ new Map();
+  const ensureLens = (lens) => {
+    let m = buckets.get(lens);
+    if (!m) {
+      m = /* @__PURE__ */ new Map();
+      buckets.set(lens, m);
+    }
+    return m;
+  };
+  let hasNoLens = false;
+  let hasNoStage = false;
+  for (const a of filtered) {
+    const lens = str(a.Lens) ?? NO_LENS2;
+    const stage = stageOf2(a) ?? NO_STAGE2;
+    if (lens === NO_LENS2) hasNoLens = true;
+    if (stage === NO_STAGE2) hasNoStage = true;
+    pushLens(lens);
+    const byStage = ensureLens(lens);
+    let list = byStage.get(stage);
+    if (!list) {
+      list = [];
+      byStage.set(stage, list);
+    }
+    list.push(a);
+  }
+  if (hasNoLens) {
+    lensOrder.splice(lensOrder.indexOf(NO_LENS2), 1);
+    lensOrder.push(NO_LENS2);
+  } else {
+    const idx = lensOrder.indexOf(NO_LENS2);
+    if (idx >= 0) lensOrder.splice(idx, 1);
+  }
+  const stageOrder = [...STAGE_ORDER2];
+  if (hasNoStage) stageOrder.push(NO_STAGE2);
+  const cells = [];
+  let maxAvgRisk = 0;
+  let maxCellCount = 0;
+  let total = 0;
+  for (const lens of lensOrder) {
+    const byStage = buckets.get(lens) ?? /* @__PURE__ */ new Map();
+    for (const stage of stageOrder) {
+      const records = byStage.get(stage) ?? [];
+      const ranked = rankByRisk2(records);
+      const count = ranked.length;
+      const totalRisk = ranked.reduce(
+        (sum, r) => sum + (derivedNum(r, "risk") ?? 0),
+        0
+      );
+      const avgRisk = count > 0 ? totalRisk / count : 0;
+      maxAvgRisk = Math.max(maxAvgRisk, avgRisk);
+      maxCellCount = Math.max(maxCellCount, count);
+      total += count;
+      cells.push({
+        lens,
+        stage,
+        questionType: questionTypeFilter === "All" ? null : questionTypeFilter,
+        count,
+        totalRisk,
+        avgRisk,
+        assumptions: ranked,
+        heat: 0
+      });
+    }
+  }
+  const norm2 = maxAvgRisk > 0 ? 1 / maxAvgRisk : 0;
+  for (const cell of cells) {
+    cell.heat = cell.avgRisk * norm2;
+  }
+  const qtSet = /* @__PURE__ */ new Set();
+  for (const a of assumptions) {
+    const qt = questionTypeOf(a);
+    if (qt) qtSet.add(qt);
+  }
+  return {
+    lenses: lensOrder,
+    stages: [...STAGE_ORDER2],
+    questionTypes: [...qtSet].sort(),
+    cells,
+    maxAvgRisk,
+    maxCellCount,
+    total
+  };
+}
+function heatCellAt(view, lens, stage) {
+  return view.cells.find((c) => c.lens === lens && c.stage === stage) ?? null;
+}
+function heatLevel(heat) {
+  if (heat <= 0) return 0;
+  if (heat < 0.2) return 1;
+  if (heat < 0.4) return 2;
+  if (heat < 0.7) return 3;
+  return 4;
+}
+
 // src/assumptions-surface.tsx
 import { Fragment as Fragment4, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function AssumptionsSurface({
@@ -2746,7 +2896,11 @@ function GridPane({
   readings,
   onNavigate
 }) {
-  const view = useMemo2(() => buildStageGrid(assumptions), [assumptions]);
+  const [qtFilter, setQtFilter] = useState3("All");
+  const view = useMemo2(
+    () => buildHeatGrid(assumptions, qtFilter),
+    [assumptions, qtFilter]
+  );
   const recs = useMemo2(
     () => buildRecommendedExperiments(assumptions, experiments),
     [assumptions, experiments]
@@ -2787,40 +2941,67 @@ function GridPane({
     } else {
       onNavigate({
         name: "assumptions",
-        lens: cell.lens === NO_LENS ? void 0 : cell.lens,
-        stage: cell.stage === NO_STAGE ? void 0 : cell.stage
+        lens: cell.lens === NO_LENS2 ? void 0 : cell.lens,
+        stage: cell.stage === NO_STAGE2 ? void 0 : cell.stage
       });
     }
   }
+  const qtTabs = QUESTION_TYPE_FILTERS.filter(
+    (qt) => qt === "All" || view.questionTypes.includes(qt)
+  );
   return /* @__PURE__ */ jsxs5(Fragment4, { children: [
     /* @__PURE__ */ jsxs5("div", { className: "vos-card vos-stage-grid-card", children: [
-      /* @__PURE__ */ jsx5("div", { className: "vos-stage-grid-scroll", children: /* @__PURE__ */ jsxs5("table", { className: "vos-stage-grid", role: "grid", "aria-label": "Lens \xD7 Stage heatmap", children: [
+      /* @__PURE__ */ jsx5("div", { className: "vos-qt-filter-bar", children: qtTabs.map((qt) => /* @__PURE__ */ jsx5(
+        "button",
+        {
+          type: "button",
+          className: `vos-qt-tab ${qtFilter === qt ? "vos-qt-tab-active" : ""}`,
+          onClick: () => setQtFilter(qt),
+          children: qt
+        },
+        qt
+      )) }),
+      /* @__PURE__ */ jsx5("div", { className: "vos-stage-grid-scroll", children: /* @__PURE__ */ jsxs5("table", { className: "vos-stage-grid", role: "grid", "aria-label": "Lens \xD7 Stage heatmap (heat = Risk)", children: [
         /* @__PURE__ */ jsx5("thead", { children: /* @__PURE__ */ jsxs5("tr", { children: [
           /* @__PURE__ */ jsx5("th", { scope: "col", className: "vos-stage-grid-corner", children: "Lens \u2193 / Stage \u2192" }),
           view.stages.map((s) => /* @__PURE__ */ jsxs5("th", { scope: "col", className: "vos-stage-grid-col", children: [
             /* @__PURE__ */ jsx5("span", { className: "vos-stage-grid-stagename", children: s }),
-            /* @__PURE__ */ jsx5("span", { className: "vos-stage-grid-stagegloss", children: STAGE_GLOSS[s] })
+            /* @__PURE__ */ jsx5("span", { className: "vos-stage-grid-stagegloss", children: STAGE_GLOSS2[s] })
           ] }, s))
         ] }) }),
         /* @__PURE__ */ jsx5("tbody", { children: view.lenses.map((lens) => /* @__PURE__ */ jsxs5("tr", { children: [
           /* @__PURE__ */ jsx5("th", { scope: "row", className: "vos-stage-grid-rowhead", children: lens }),
           view.stages.map((s) => {
-            const cell = cellAt(view, lens, s);
+            const cell = heatCellAt(view, lens, s);
             return /* @__PURE__ */ jsx5("td", { className: "vos-stage-grid-cell", children: /* @__PURE__ */ jsx5(
               "button",
               {
                 type: "button",
-                className: `vos-stage-grid-btn vos-heat-${heatLevel(cell.density)}`,
+                className: `vos-stage-grid-btn vos-heat-${heatLevel(cell.heat)}`,
                 disabled: cell.count === 0,
                 onClick: () => cellClick(cell),
-                "aria-label": `${cell.count} assumptions in ${lens} \xD7 ${s}`,
+                title: `${cell.count} assumptions \xB7 avg Risk ${Math.round(cell.avgRisk)} \xB7 total Risk ${Math.round(cell.totalRisk)}`,
+                "aria-label": `${cell.count} assumptions in ${lens} \xD7 ${s}, average risk ${Math.round(cell.avgRisk)}`,
                 children: cell.count === 0 ? "\xB7" : cell.count === 1 ? "1" : String(cell.count)
               }
             ) }, s);
           })
         ] }, lens)) })
       ] }) }),
-      /* @__PURE__ */ jsx5("p", { className: "vos-hint vos-stage-grid-foot", children: "The densest cell per row is where that part of the business is. Click a cell to drill into its assumptions, ranked by Risk; a single-assumption cell opens the detail directly." })
+      /* @__PURE__ */ jsxs5("div", { className: "vos-heat-legend", children: [
+        /* @__PURE__ */ jsx5("span", { className: "vos-heat-legend-label", children: "Risk heat:" }),
+        /* @__PURE__ */ jsx5("span", { className: "vos-heat-swatch vos-heat-0" }),
+        " low",
+        /* @__PURE__ */ jsx5("span", { className: "vos-heat-swatch vos-heat-1" }),
+        /* @__PURE__ */ jsx5("span", { className: "vos-heat-swatch vos-heat-2" }),
+        /* @__PURE__ */ jsx5("span", { className: "vos-heat-swatch vos-heat-3" }),
+        /* @__PURE__ */ jsx5("span", { className: "vos-heat-swatch vos-heat-4" }),
+        " high"
+      ] }),
+      /* @__PURE__ */ jsxs5("p", { className: "vos-hint vos-stage-grid-foot", children: [
+        "Heat = average Risk per cell. Click a cell to drill into its assumptions, ranked by Risk. Filter by Question Type above.",
+        qtFilter !== "All" ? ` Showing ${qtFilter} claims only.` : ""
+      ] })
     ] }),
     needsFraming.length > 0 || recs.length > 0 ? /* @__PURE__ */ jsx5(
       NextMovesSection,
@@ -2832,13 +3013,6 @@ function GridPane({
     ) : null
   ] });
 }
-function heatLevel(density) {
-  if (density <= 0) return 0;
-  if (density < 0.25) return 1;
-  if (density < 0.5) return 2;
-  if (density < 0.75) return 3;
-  return 4;
-}
 function PipelineBoard({
   assumptions,
   experiments,
@@ -2850,8 +3024,8 @@ function PipelineBoard({
   const filtered = useMemo2(() => {
     if (filterLens === void 0 && filterStage === void 0) return assumptions;
     return assumptions.filter((a) => {
-      const l = String(a.Lens ?? NO_LENS);
-      const s = String(a.Stage ?? NO_STAGE);
+      const l = String(a.Lens ?? NO_LENS2);
+      const s = String(a.Stage ?? NO_STAGE2);
       return (filterLens === void 0 || l === filterLens) && (filterStage === void 0 || s === filterStage);
     });
   }, [assumptions, filterLens, filterStage]);
@@ -2919,7 +3093,8 @@ function PipelineBoard({
 }
 function PipelineRowView({ row, onOpen }) {
   const stripeTone = row.riskTone;
-  const knownPct = Math.max(0, Math.min(100, Math.abs(row.confidence)));
+  const ceiling = row.questionTypeCeiling ?? 99;
+  const knownPct = Math.max(0, Math.min(100, Math.abs(row.confidence) / ceiling * 100));
   const knownSign = row.confSign;
   return /* @__PURE__ */ jsxs5("div", { className: "vos-pipe-row vos-pipe-row-2seg", children: [
     /* @__PURE__ */ jsx5("div", { className: `vos-pipe-stripe vos-fill-${stripeTone}` }),
@@ -8498,6 +8673,7 @@ export {
   NO_STAGE,
   NextMoveSurface,
   PipelineSurface,
+  QUESTION_TYPE_FILTERS,
   REGISTER_GROUPS,
   REGISTER_ICON,
   REGISTER_LABEL,
@@ -8529,6 +8705,7 @@ export {
   backlinkPanels,
   bodyPreview,
   buildCycles,
+  buildHeatGrid,
   buildJourney,
   buildPatch,
   buildPipeline,
@@ -8560,6 +8737,8 @@ export {
   groupRecords,
   hasEdits,
   headerPills,
+  heatCellAt,
+  heatLevel,
   humanInputFields,
   interpretSave,
   journeyColdState,