@sonnechasser/ntrp 1.4.5 → 1.4.6

package/dist/index.js

@@ -10134,7 +10134,7 @@ function buildSlideContent(explainer, opts = {}) {
       lines.push(...visLines);
       lines.push("");
     }
-    lines.push(sectionHeading("What it means"));
+    lines.push(sectionHeading("How we think about it"));
     pushWrapped(lines, explainer.meaning, inner, "  ");
     lines.push("");
     if (!opts.skipFormula) {
@@ -10146,7 +10146,7 @@ function buildSlideContent(explainer, opts = {}) {
       lines.push("");
     }
     if (opts.deepdive) {
-      lines.push(sectionHeading("Deep dive"));
+      lines.push(sectionHeading("How to read it"));
       pushWrapped(lines, explainer.expert_read, inner, "  ");
       lines.push("");
       for (const bullet of explainer.deepdive) {
@@ -11415,15 +11415,15 @@ var init_metric_definitions = __esm({
         kind: "vital",
         label: "Freshness",
         group: "Vital Signs",
-        tagline: "Does the CRM report which records are still active?",
+        tagline: "Is the CRM still talking about live work \u2014 or a museum of old deals?",
         how_computed: "NTRP computes a weighted average of people, organizations, and opportunities with recent activity. Open opportunities must also not be past-due. Default windows: people and organizations 90 days, opportunities 30 days. Weights are 35 / 30 / 35.",
         formula_lines: [
           "freshness = people%\xD70.35 + orgs%\xD70.30 + opps%\xD70.35",
           "people/orgs fresh if activity within 90d",
           "opps fresh if activity within 30d AND not past-due"
         ],
-        meaning: "Board question: how much of this pipeline is real versus fiction? Dollar value equals the sum of amount on stale opportunities: pipeline at risk.",
-        expert_read: "Cut by owner and by stage first. Freshness reds concentrate on people or process. They rarely spread evenly. In a long-cycle enterprise motion, 30 quiet days can be normal cadence. In a velocity motion, 30 quiet days is a dead deal. A sudden cliff usually means a broken integration or a departed rep. It is not gradual decay. Check this false positive: bulk-imported records that nobody has touched yet.",
+        meaning: 'We treat Freshness as a truth check on the pipeline number. Quiet days mean different things by motion: in enterprise, 30 quiet days can be normal cadence; in a velocity book, that same silence often means the deal is already dead. Stale open amount is why we show "pipeline at risk."',
+        expert_read: `A useful first cut is by owner and by stage \u2014 reds tend to clump on people or process, not sprinkle evenly. A sudden cliff is usually a broken integration or a departed rep, not gradual decay. Watch for the false positive too: bulk-imported records nobody has touched yet can look "stale" when they're just new.`,
         deepdive: [
           "Status bands: green 80 or more, yellow 60 or more, red below 60. Motion presets can change the windows.",
           'Dollar translation: sum of amount on stale open opportunities \u2192 "pipeline at risk".',
@@ -11453,15 +11453,15 @@ var init_metric_definitions = __esm({
         kind: "vital",
         label: "Flow Rate",
         group: "Vital Signs",
-        tagline: "How fast do deals move, and where do they stop?",
+        tagline: "Where does deal motion slow \u2014 and what's stuck behind that bottleneck?",
         how_computed: "NTRP sets a base score from average open-deal age versus max_days. It then applies a penalty of up to 20 for the share of stuck deals. A deal is stuck when it has no update beyond stuck_days, or a past-due close. Status uses average open age, not the score alone.",
         formula_lines: [
           "base = 100 \xD7 (1 \u2212 avgOpenAge / max_days)",
           "score = base \u2212 stuckSharePenalty (\u226420)",
           "stuck = no update > stuck_days OR past-due close"
         ],
-        meaning: "Board question: is next quarter slipping because deals are stuck? Dollar value equals the amount stuck in pipeline.",
-        expert_read: "Cut by stage age, not only deal age. Find the stage where deals stop. That is usually one stage. Compare stuck-deal age to this company's own median cycle. Do not use a generic norm. Stuck deals plus past-due close dates signal optimistic forecasting. That is a credibility problem before it is a revenue problem.",
+        meaning: 'We think of Flow Rate as velocity risk with a dollar tag. When deals stop advancing \u2014 and especially when close dates slip past due \u2014 next quarter starts to feel optimistic on paper. The dollar line is the amount still "stuck in pipeline."',
+        expert_read: "We prefer stage age over deal age alone: find the stage where advancement collapses \u2014 it's usually one stage, not everywhere. Compare stuck age to this company's own median cycle rather than a generic norm. Stuck deals plus past-due closes are often a forecast-credibility problem before they're a revenue miss.",
         deepdive: [
           "Status uses average open age. Green is 45 days or less. Yellow is 90 days or less. Else red. Defaults: max_days 120, stuck_days 60.",
           'Dollar translation: sum of amount on stuck deals \u2192 "stuck in pipeline".',
@@ -11493,15 +11493,15 @@ var init_metric_definitions = __esm({
         kind: "vital",
         label: "Drop Rate",
         group: "Vital Signs",
-        tagline: "Where do leads drop between systems?",
+        tagline: "Where does paid demand fall between systems before anyone works it?",
         how_computed: "NTRP blends cross-system retention and opportunity retention. Cross-system retention is marketing people also present in sales. Opportunity retention is open opportunities that are not abandoned. Default weights: cross-system 60 percent, opportunity retention 40 percent. Abandoned means open opportunities with no activity in 30 days.",
         formula_lines: [
           "score = crossSystemRetention\xD70.6 + oppRetention\xD70.4",
           "cross-system = marketing people also in sales CRM",
           "abandoned = open opps with no activity in 30d"
         ],
-        meaning: "Board question: how much pipeline did we pay for and never work? Dollar value = droppedCount \xD7 conversionRate \xD7 avgDealSize \u2014 est. lost at handoff.",
-        expert_read: "This is almost always a systems failure. Causes include routing rules, unassigned territories, dead rep queues, or a sync gap between marketing and CRM. It is not lazy reps. First cut by lead source. The leak usually concentrates in one or two sources. The cheapest pipeline this business can buy is the leads it already paid for.",
+        meaning: 'We read Drop Rate as the price of the handoff leak \u2014 budget already spent on leads that never reach a working rep. The dollar estimate is droppedCount \xD7 conversion \xD7 avg deal size: "est. lost at handoff."',
+        expert_read: 'In practice this usually looks like a systems story: routing rules, unassigned territories, dead rep queues, or a sync gap between marketing and CRM \u2014 more often than "lazy reps." A useful first cut is by lead source; the leak tends to concentrate in one or two sources. The cheapest pipeline a business can buy is often the leads it already paid for.',
         deepdive: [
           "Status bands: green 80 or more, yellow 60 or more, red below 60.",
           'Dollar translation: dropped \xD7 conversion \xD7 avg deal (fallback: drop% \xD7 open pipeline) \u2192 "est. lost at handoff".',
@@ -11532,15 +11532,15 @@ var init_metric_definitions = __esm({
         kind: "vital",
         label: "Signal:Noise",
         group: "Vital Signs",
-        tagline: "How much activity is aimed at deals that can still close?",
+        tagline: "How much of the team's effort still aims at deals that can close?",
         how_computed: "Over a 90-day lookback, NTRP computes (signal activities / all activities) \xD7 100. Signal is activity linked to an open opportunity, a pipeline person, or a pipeline organization.",
         formula_lines: [
           "score = (signalCount / activityCount) \xD7 100",
           "signal = linked to open opp / pipeline person / pipeline org",
           "lookback = trailing 90 days"
         ],
-        meaning: "Board question: are we burning capacity on dead accounts? Dollar value = noiseCount \xD7 hours_per_activity \xD7 rep_hourly_cost \u2014 misdirected effort.",
-        expert_read: "Cut by rep and by account status. Noise usually means reps work dead accounts they already know. Targeting and account lists are stale. Persistent noise is a coverage-model problem, not a coaching problem. Check whether activity is logged against closed or unlinked records. That is often a hygiene artifact.",
+        meaning: `We treat Signal:Noise as activity efficiency with a capacity price. Noise hours \xD7 hours_per_activity \xD7 rep_hourly_cost becomes "misdirected effort" \u2014 energy aimed at accounts that can't still close.`,
+        expert_read: "A useful cut is by rep and by account status. Persistent noise often means reps keep working dead accounts they already know \u2014 stale targeting or coverage models more than a coaching gap. Also check whether activity is logged against closed or unlinked records; that can be a hygiene artifact pretending to be effort.",
         deepdive: [
           "Status bands: green 65 or more, yellow 40 or more, red below 40.",
           "Dollar defaults: 0.25 hours/activity \xD7 $75/hr (config: hours_per_activity, rep_hourly_cost).",
@@ -11569,15 +11569,15 @@ var init_metric_definitions = __esm({
         kind: "vital",
         label: "Thread Depth",
         group: "Vital Signs",
-        tagline: "How fragile is the pipeline if one champion stops?",
+        tagline: "How fragile is revenue if one champion changes jobs?",
         how_computed: "Percent of open deals with at least multi_thread_threshold distinct people active in the last 90 days. The default threshold is 2. People include opportunity-direct contacts and same-organization activity.",
         formula_lines: [
           "score = % open deals with \u22652 active people (90d)",
           "people counted via opp contacts + same-org activity",
           "threshold configurable (default 2)"
         ],
-        meaning: "Board question: how much revenue is lost if one contact changes jobs? Dollar value equals the sum of amount on single-threaded deals.",
-        expert_read: "Weight by deal size. One single-threaded mega-deal outweighs ten small ones. Single-threading late in the cycle is far more dangerous than early. In enterprise motions, Thread Depth is a leading indicator of slipped quarters. Champions change jobs. There is no second contact.",
+        meaning: "We read Thread Depth as resilience risk. One single-threaded mega-deal can outweigh ten small ones \u2014 and late-cycle single-threading is especially scary because champions change jobs. The dollar line sums amount on single-threaded deals.",
+        expert_read: "Weight by deal size when you triage. Single-threading late in the cycle tends to matter more than early. In enterprise motions, thin threads are often a leading indicator of slipped quarters: the champion leaves and there's no second contact warm enough to carry the deal.",
         deepdive: [
           "Status bands: green 65 or more, yellow 40 or more, red below 40.",
           'Dollar translation: sum of amount on single-threaded deals \u2192 "single-threaded".',
@@ -11609,14 +11609,14 @@ var init_metric_definitions = __esm({
         kind: "saas",
         label: "ARR",
         group: "Revenue",
-        tagline: "How big is the revenue engine, and from where?",
+        tagline: "How big is the engine \u2014 and what's the mix that got it there?",
         how_computed: "Sum of amount on closed-won opportunities in the dataset. This is pipeline-inferred ARR when a pure subscription ledger is not available.",
         formula_lines: [
           "ARR \u2248 \u03A3 amount on closed-won opportunities",
           "New + Expansion = growth \xB7 Churned + Contraction = leakage"
         ],
-        meaning: "Board question: how fast are we growing, and from where? Always decompose growth into new versus expansion. The mix is the story.",
-        expert_read: "Always decompose growth into new versus expansion. The mix is the story. Prefer this company's own trailing history over any external prior. A number below its reliability_gate is a hypothesis, not a fact.",
+        meaning: "We treat ARR as the size of the revenue engine \u2014 but the interesting story is the mix. New versus expansion growth, and how much leakage (churn + contraction) ate into it. From CRM exports we often infer this from closed-won amounts when a pure subscription ledger isn't available.",
+        expert_read: "Always decompose growth into new versus expansion before you brief anyone \u2014 the mix is the story. Prefer this company's own trailing history over an external prior. When a number sits below its reliability_gate, we treat it as a hypothesis, not a fact.",
         deepdive: [
           "Companion metrics: New ARR, Expansion ARR, Churned ARR, Contraction ARR.",
           "Estimation method may be ledger, pipeline_inferred, or snapshot. Read confidence and reliability_gate.",
@@ -11769,15 +11769,15 @@ var init_metric_definitions = __esm({
         kind: "saas",
         label: "Net Revenue Retention",
         group: "Retention",
-        tagline: "Would this business grow if sales stopped selling?",
+        tagline: "Would the base still grow if new logo sales paused?",
         how_computed: "startingArr = ARR + Churned + Contraction \u2212 Expansion. NRR = ((starting \u2212 Churned \u2212 Contraction + Expansion) / starting) \xD7 100.",
         formula_lines: [
           "starting = ARR + churned + contraction \u2212 expansion",
           "NRR = (starting \u2212 churned \u2212 contraction + expansion) / starting \xD7 100",
           "NRR = 100% + expansion% \u2212 contraction% \u2212 churn%"
         ],
-        meaning: "Board question: would this business grow if sales stopped selling? A value above 100% means growth from existing customers.",
-        expert_read: "Decompose before you judge. The same 95% can be a churn problem (product/PMF) or a no-expansion problem (packaging/motion). Those have different owners. Priors by segment: about 97% SMB, about 108% mid-market, about 118% enterprise medians. 110% or more is a strong signal at any stage.",
+        meaning: "We love NRR because it answers a sharp question: would this business still grow if sales stopped selling new logos? Above 100% means the installed base compounds. From CRM we reconstruct the walk (+expansion \u2212contraction \u2212churn) and stay humble when the data is pipeline-inferred.",
+        expert_read: "Decompose before you judge \u2014 the same 95% can be a churn/PMF problem or a no-expansion/packaging problem, and those have different owners. Rough priors by segment sit around 97% SMB, 108% mid-market, 118% enterprise medians; 110%+ is a strong signal at any stage.",
         deepdive: [
           "Always show the waterfall: +expansion \u2212contraction \u2212churn.",
           "GRR is the floor. NRR adds expansion on top.",
@@ -11805,14 +11805,14 @@ var init_metric_definitions = __esm({
         kind: "saas",
         label: "Gross Revenue Retention",
         group: "Retention",
-        tagline: "How leaky is the bucket before expansion hides it?",
+        tagline: "How leaky is the bucket before expansion can hide it?",
         how_computed: "GRR = ((startingArr \u2212 Churned \u2212 Contraction) / startingArr) \xD7 100. Expansion is excluded on purpose.",
         formula_lines: [
           "starting = ARR + churned + contraction \u2212 expansion",
           "GRR = (starting \u2212 churned \u2212 contraction) / starting \xD7 100"
         ],
-        meaning: "Board question: how leaky is the bucket before expansion hides it? Prior: above 90% is healthy. Above 95% is strong for enterprise.",
-        expert_read: "GRR is the honesty metric. Expansion can make NRR look fine while GRR erodes. Always read both.",
+        meaning: "We treat GRR as the honesty metric \u2014 churn plus contraction only, with expansion deliberately left out. That way a shiny NRR can't paper over a leaky bucket. Rough priors: above 90% feels healthy; above 95% is strong for enterprise.",
+        expert_read: "Always read GRR next to NRR. Expansion can make net retention look fine while the floor erodes. Owners tend to split: product/CS for logo churn, packaging for contraction.",
         deepdive: [
           "GRR never includes Expansion. That is the point.",
           "Owners: product and CS for churn. Packaging for contraction."
@@ -11835,14 +11835,14 @@ var init_metric_definitions = __esm({
         kind: "saas",
         label: "Pipeline Coverage",
         group: "Pipeline",
-        tagline: "Is next quarter already at risk?",
+        tagline: "Does next quarter already have enough real pipeline?",
         how_computed: "Open pipeline amount divided by trailing-90-day closed-won amount.",
         formula_lines: [
           "Coverage = openPipeline / trailing_90d_won",
           "required \u2248 1 / win_rate (discount for time left)"
         ],
-        meaning: "Board question: is next quarter already at risk? Priors scale with cycle length: about 3x for velocity/SMB, 4 to 5x for enterprise.",
-        expert_read: "Coverage has no meaning without win rate. Required coverage is about 1 / win rate, discounted for time left in the period. Inflated stages and zombie deals fake coverage. Cross-check with Freshness before you trust it.",
+        meaning: `We read coverage as an early "is next quarter already thin?" check. Priors scale with cycle length \u2014 roughly 3x for velocity/SMB, 4\u20135x for enterprise \u2014 but coverage without win rate is half a story. We also cross-check Freshness so zombies don't fake a healthy multiple.`,
+        expert_read: "Required coverage is roughly 1 / win rate, discounted for time left in the period. Inflated stages and stale deals can manufacture coverage that isn't there. Pair with Win Rate and Freshness before you trust the brief.",
         deepdive: [
           "Always pair with Win Rate and Freshness.",
           "Weighted Pipeline is the credibility-adjusted companion."
@@ -11927,14 +11927,14 @@ var init_metric_definitions = __esm({
         kind: "saas",
         label: "Pipeline Velocity",
         group: "Pipeline",
-        tagline: "Revenue throughput per day. Four levers, one number.",
+        tagline: "Four levers, one throughput number \u2014 which lever moved?",
         how_computed: "(openOpps \xD7 avgDeal \xD7 winRate) / avgCycleDays. Requires 3 or more dated closed-won deals. Unit: $/day.",
         formula_lines: [
           "Velocity = (openOpps \xD7 avgDeal \xD7 winRate) / avgCycleDays",
           "four levers: #opps \xB7 deal size \xB7 win rate \xB7 cycle days"
         ],
-        meaning: "Board question: which lever moved when throughput changed? This is the most decision-ready pipeline metric.",
-        expert_read: "When velocity changes, name which lever moved. A win-rate rise on falling opportunity volume is qualification tightening, not improvement.",
+        meaning: "We like velocity because it's decision-ready: revenue throughput per day with four named levers (volume, size, win rate, cycle). When throughput changes, the interesting question is which lever moved \u2014 not just whether the number went up.",
+        expert_read: 'Name the lever. A win-rate rise on falling opportunity volume often means qualification tightened, not that selling got "better." Needs a handful of dated wins; otherwise we leave it unavailable rather than invent a story.',
         deepdive: [
           "Needs 3 or more dated wins. Otherwise this metric is unavailable.",
           "Pairs with Flow Rate (cycle) and Win Rate (conversion)."
@@ -11956,11 +11956,11 @@ var init_metric_definitions = __esm({
         kind: "saas",
         label: "Win Rate",
         group: "Sales Efficiency",
-        tagline: "Of decided deals, how often do we win?",
+        tagline: "Of the deals we decide, how often do we win?",
         how_computed: "closed-won / (won + lost) \xD7 100.",
         formula_lines: ["Win Rate = won / (won + lost) \xD7 100"],
-        meaning: "Board question: are we converting the pipeline we create? Priors: 25\u201335% SMB, 18\u201325% mid-market, 12\u201318% enterprise on qualified opportunities.",
-        expert_read: "A rising win rate on falling opportunity volume is qualification tightening, not improvement. Check the denominator.",
+        meaning: "We read win rate as conversion of decided deals \u2014 are we winning the pipeline we create? Rough priors: ~25\u201335% SMB, ~18\u201325% mid-market, ~12\u201318% enterprise on qualified opportunities. It also sets how much coverage you need (~1 / win rate).",
+        expert_read: "Watch the denominator. A rising win rate on falling opportunity volume often means qualification tightened, not that the team suddenly sells better. Cut by segment or source before company-wide coaching.",
         deepdive: [
           "Required coverage is about 1 / win rate.",
           "Cut by segment or source before company-wide coaching."
@@ -12300,10 +12300,10 @@ var init_guide_slides = __esm({
     TALK = {
       id: "talk",
       label: "Talk to NTRP",
-      tagline: "Type English. Confirm the scope. Load data. Then listen.",
+      tagline: "Start with the question you care about \u2014 we'll mirror it back before we compute.",
       visual: {
         kind: "funnel",
-        caption: "Bare Enter submits the dim \u23CE hint at these gates. If nothing is armed, Enter does nothing.",
+        caption: "When a dim \u23CE hint shows, bare Enter submits it. No hint means Enter does nothing.",
         funnel: [
           { label: "Type a question", widthPct: 100 },
           { label: "\u23CE yes  (scope)", widthPct: 78 },
@@ -12312,25 +12312,23 @@ var init_guide_slides = __esm({
         ]
       },
       lines: [
-        'You do not need a slash. Type the question you need. Examples: "is our retention real for the board?" or "pipeline health".',
+        `We designed the conversation so you don't need a slash to start. Type the question you actually need \u2014 "is our retention real for the board?" or "pipeline health" \u2014 and NTRP restates it as a scope card so you can confirm we're answering the right thing.`,
         "",
-        "NTRP restates the question as a scope card. Confirm with \u23CE yes, or type yes. NTRP listens. NTRP does not invent a different question.",
+        "Empty dataset? Load a sample with \u23CE use demo data, paste a CSV path, or /ingest. When the gap card says the formulas can compute, \u23CE go ahead runs the local math.",
         "",
-        "When the dataset is empty, type \u23CE use demo data. Or paste a CSV path. Or type /ingest. When the gap card shows that the formulas can compute, type \u23CE go ahead.",
-        "",
-        "Vital signs and SaaS metrics compute without an AI key. Every score that has a dollar translation shows it."
+        "Vital signs and SaaS metrics compute without an AI key. Every score that has a dollar translation shows it \u2014 that's the point of the stethoscope."
       ],
       deepdive: [
         "Power-user slash commands still work. They stay hidden from /help: /new, /diagnose, /metrics, /ingest, /session.",
-        'Type "use demo data" to load the hidden_crisis scenario. Company profile is optional. In scripts, type /demo --no-profile.',
-        'After compute, the prompt becomes ask \u203A. Brief is the default depth. Type "go deep" when you want the long read.',
-        "Type /home to show phase status. Type /help to list conversation shortcuts. /help does not list every command."
+        '"use demo data" loads a fitted sample book. Company profile is optional. In scripts, /demo --no-profile.',
+        'After compute, the prompt returns to \u203A. Brief is the default depth; type "go deep" for the long read.',
+        "/home shows phase status. /help lists conversation shortcuts \u2014 not every command."
       ]
     };
     ASK = {
       id: "ask",
       label: "After the numbers",
-      tagline: 'Glossary is free. "Our ARR" is compute. Narrative needs /connect.',
+      tagline: 'Two kinds of questions: glossary (free) versus "our" numbers (needs data \u2014 and often a key).',
       visual: {
         kind: "split",
         caption: "Possessives such as our, my, and the team's skip the glossary. They go to compute or scope.",
@@ -12340,25 +12338,23 @@ var init_guide_slides = __esm({
         ]
       },
       lines: [
-        '"what is ARR?" and "how is freshness calculated?" answer from the built-in glossary. No key. No data.',
-        "",
-        '"what is our ARR?" and "why is this red?" need a loaded dataset. AI findings and /ask need a stored key. Type /connect and paste any provider key. NTRP detects it.',
+        `After compute, we think in two lanes. "what is ARR?" / "how is freshness calculated?" answer from the built-in glossary \u2014 no key, no data. That's so you can learn the lens without wiring anything up.`,
         "",
-        "Type /deepdive to replay this tour. Type /deepdive freshness for one slide. You can also type nrr, arr, or another id. Type /deepdive list for the catalog. Type /deepdive guide for this how-to section.",
+        '"what is our ARR?" or "why is this red?" need a loaded dataset. Narrative findings and /ask need a stored key \u2014 /connect pastes any provider key and we detect it.',
         "",
-        "When the prompt shows a dim \u23CE hint, bare Enter submits that action. Examples: \u23CE yes, \u23CE use demo data, \u23CE go ahead, \u23CE /connect. If there is no hint, Enter does nothing."
+        "Replay this tour with /deepdive, jump to one slide with /deepdive freshness (or nrr, arr, \u2026), or /deepdive guide for this how-to section. When the prompt shows a dim \u23CE hint (yes, use demo data, go ahead, /connect), bare Enter submits it."
       ],
       deepdive: [
-        "Type /connect ollama for a keyless local model. Type /connect --base-url <url> --id <name> for any OpenAI-compatible endpoint.",
-        "Type /model refresh to re-discover models. A retired model self-heals on the first 404.",
-        "First-run skip of this tour does not complete it. A home \u2691 chip can bring you back after the first analysis.",
+        "/connect ollama for a keyless local model. /connect --base-url <url> --id <name> for any OpenAI-compatible endpoint.",
+        "/model refresh re-discovers models. A retired model self-heals on the first 404.",
+        "Skipping this tour on first-run does not complete it \u2014 a home \u2691 chip can bring you back after the first analysis.",
         "Tab completes /deepdive <metric>. Finding cards and playbook triggers also link here."
       ]
     };
     HANDOFF = {
       id: "handoff",
       label: "Ship work to your AI",
-      tagline: "Teach the inbox once. Later, tell your AI to pick it up.",
+      tagline: "Teach the inbox once \u2014 then your desktop AI can pick up what we write.",
       visual: {
         kind: "layer_stack",
         caption: "You and your AI find and open the file. NTRP only writes.",
@@ -12370,28 +12366,26 @@ var init_guide_slides = __esm({
         ]
       },
       lines: [
-        'Type "ship a board deck" or type /handoff. Files land in ~/Documents/ntrp-inbox by default. Type /inbox set to change the folder.',
-        "",
-        "During demo or company setup, or any time, type /inbox skill. Paste a standing finder into Claude, ChatGPT, Cursor, or another desktop AI once. That skill tells the tool to follow latest-handoff.md and INDEX.md.",
+        'We think of handoff as a quiet bridge: NTRP writes a board deck or brief into a folder you choose; your desktop AI (Claude, ChatGPT, Cursor, \u2026) opens it. You teach that AI a standing finder once \u2014 then later you just say "pick up the latest NTRP handoff."',
         "",
-        'After that, each /handoff prints "Handoff ready". You will not get a paste block every write. Tell your AI: pick up the latest NTRP handoff.',
+        '"ship a board deck" or /handoff lands files in ~/Documents/ntrp-inbox by default (/inbox set to change). During demo or company setup \u2014 or anytime \u2014 /inbox skill prints the finder to paste once. After that, each /handoff prints "Handoff ready" without a paste block every write.',
         "",
-        "If you skipped this step, NTRP asks once when you load your own data. Skip then, and type /inbox set ~/Documents/ntrp-inbox. Then type /inbox skill. Type /handoff skill to reprint the same finder."
+        "Skipped earlier? We ask once when you load your own data. Or /inbox set ~/Documents/ntrp-inbox, then /inbox skill. /handoff skill reprints the same finder."
       ],
       deepdive: [
         "Inbox copies: latest-handoff.md, latest-pickup.md, SKILL.md, INDEX.md. Dated files also live under ~/.ntrp/exports/.",
-        "Type /exports to list writes. Type /inbox show to print the folder and the latest pointer. Type /handoff --print to show the prompt body in the terminal.",
-        "Audience-framed Metric definitions append to decks and reports. Your AI then has the same glossary you walked.",
-        "Type /end to close a session. NTRP writes a transcript plus a 1-page context brief under ~/.ntrp/sessions/."
+        "/exports lists writes. /inbox show prints the folder and latest pointer. /handoff --print shows the prompt body in the terminal.",
+        "Audience-framed Metric definitions append to decks and reports \u2014 your AI gets the same glossary you walked.",
+        "/end closes a session and writes a transcript plus a 1-page context brief under ~/.ntrp/sessions/."
       ]
     };
     LOOP = {
       id: "loop",
       label: "Stay in the loop",
-      tagline: "Diagnose \u2192 plan \u2192 review \u2192 remember. NTRP learns your business.",
+      tagline: "Listen \u2192 plan \u2192 review \u2192 remember. We learn your business over time.",
       visual: {
         kind: "layer_stack",
-        caption: "Stethoscope, not hospital. Observe and recommend. Never prescribe surgery.",
+        caption: "Stethoscope, not hospital \u2014 we observe and recommend; you decide the surgery.",
         layers: [
           { label: "Listen  (/diagnose, /metrics)" },
           { label: 'Plan  ("how should we fix this?" / /strategy)', highlight: true },
@@ -12400,18 +12394,16 @@ var init_guide_slides = __esm({
         ]
       },
       lines: [
-        'Type "how should we fix this?" or type /strategy. NTRP builds a measurable plan with milestones and dollar-anchored ranges. Type /strategy review to check those against later vital signs.',
+        'The learning loop is how we stay useful after the first diagnose. "how should we fix this?" or /strategy builds a measurable plan with milestones and dollar-anchored ranges; /strategy review checks those against later vital signs.',
         "",
-        "When a vital sign is red, type /playbook. NTRP names the matching play. Outcomes from reviews annotate the catalog with what hit here.",
+        "When a vital is red, /playbook names a matching play \u2014 and outcomes from reviews annotate the catalog with what actually hit here. /remember stores a durable fact; /rate bad <reason> writes a calibration. Optional ~/.ntrp/ANALYST.md is standing voice and priorities (it never overrides safety rules).",
         "",
-        "Type /remember to store a durable fact. Type /rate bad <reason> to write a calibration. Optional ~/.ntrp/ANALYST.md is standing voice and priorities. It never overrides safety rules.",
-        "",
-        "Commands: /sessions show, /session <id> pickup, /end (transcript plus brief), /home, /progress, /help."
+        "Handy later: /sessions show, /session <id> pickup, /end (transcript + brief), /home, /progress, /help."
       ],
       deepdive: [
-        'Type "build me a game plan" before analysis. NTRP queues the strategist and resumes after compute.',
+        '"build me a game plan" before analysis queues the strategist and resumes after compute.',
         "Interactive sessions distill 5 or fewer durable facts on close when an LLM key is stored. One-shot commands do not bank hours or distill.",
-        "Type /scratch to factory-reset data and config. progress.json and install.json survive unless you pass --include-progress.",
+        "/scratch factory-resets data and config. progress.json and install.json survive unless you pass --include-progress.",
         "Credits in /progress accrue in interactive ntrp only."
       ]
     };
@@ -12428,6 +12420,11 @@ var init_guide_slides = __esm({
 var metric_tour_exports = {};
 __export(metric_tour_exports, {
   METRICS_TOUR_MILESTONE_ID: () => METRICS_TOUR_MILESTONE_ID,
+  TOUR_CLOSE_LINES: () => TOUR_CLOSE_LINES,
+  TOUR_CLOSE_TITLE: () => TOUR_CLOSE_TITLE,
+  TOUR_INTRO_LINES: () => TOUR_INTRO_LINES,
+  TOUR_INTRO_TITLE: () => TOUR_INTRO_TITLE,
+  TOUR_OFFER_BLURB: () => TOUR_OFFER_BLURB,
   describeTourDeck: () => describeTourDeck,
   firstRunTourDefaultChoice: () => firstRunTourDefaultChoice,
   getDeepdiveNudge: () => getDeepdiveNudge,
@@ -12481,7 +12478,7 @@ function getDeepdiveNudge(ctx) {
   if (hasCompletedMetricsTour() || hasSeenDeepdiveHomeNudge()) return null;
   if (!hasAnalysisForDeepdiveNudge(ctx)) return null;
   return {
-    text: "Tour \u2014 what the numbers mean, and how to use NTRP",
+    text: "Tour \u2014 how we think about the numbers, and how to use NTRP",
     command: "/deepdive"
   };
 }
@@ -12567,19 +12564,13 @@ function paintIntro(opts) {
     index: opts.index,
     total: opts.total,
     motion: opts.motion,
-    titleOverride: "How NTRP reads a pipeline",
+    titleOverride: TOUR_INTRO_TITLE,
     visualOverride: GATING_LAYER_VISUAL,
     skipFormula: true,
     extraLines: [
-      "Two lenses, then how to drive the tool. Same stethoscope.",
-      "",
-      "SaaS metrics (next) \u2014 ARR, NRR, coverage, win rate, velocity \u2014 the board already knows these. Quick refresher on how NTRP computes them from CRM exports.",
+      ...TOUR_INTRO_LINES,
       "",
-      "Vital signs (after) \u2014 Freshness, Flow Rate, Drop Rate, Signal:Noise, Thread Depth \u2014 NTRP's own ontology. Each has a dollar translation. Scores gate in layer order: first red wins.",
-      "",
-      "How to use NTRP (after vitals) \u2014 talk in English, ask without a key, ship a handoff to your AI once, stay in the diagnose \u2192 plan loop.",
-      "",
-      chalk10.dim("No AI key needed for this tour. Press Enter to advance; type /deepdive (or d) on any slide for more.")
+      chalk10.dim("No AI key needed for this tour. Enter advances; /deepdive (or d) opens more on any slide.")
     ],
     footer: `${progressDots(opts.index, opts.total)}  \u23CE next \xB7 q skip`
   });
@@ -12590,19 +12581,19 @@ function paintClose(opts) {
     index: opts.index,
     total: opts.total,
     motion: opts.motion,
-    titleOverride: "You are set. Listen first",
+    titleOverride: TOUR_CLOSE_TITLE,
     skipFormula: true,
     extraLines: [
-      "Ask a question \u2192 confirm scope \u2192 load data \u2192 compute. Then:",
-      `  ${paint("accent", "/diagnose")}  \u2014 five vital signs + dollars at risk`,
+      TOUR_CLOSE_LINES[0],
+      `  ${paint("accent", "/diagnose")}  \u2014 five vital signs with dollars attached`,
       `  ${paint("accent", "/metrics")}   \u2014 SaaS scorecard (ARR, NRR, coverage\u2026)`,
       `  ${paint("accent", "/deepdive")}  \u2014 replay this tour  \xB7  ${paint("accent", "/deepdive guide")}  how-to only`,
       `  ${paint("accent", "/handoff")}   \u2014 ship a file; teach the inbox once (/inbox skill)`,
       `  ${paint("accent", "/strategy")}  \u2014 measurable plan  \xB7  ${paint("accent", "/help")}  shortcuts`,
       "",
-      "Fourteen more SaaS metrics live behind /deepdive list \u2014 including unit economics that unlock when spend data lands.",
+      TOUR_CLOSE_LINES[7],
       "",
-      "Philosophy: stethoscope, not hospital. Observe and recommend \u2014 never prescribe surgery."
+      TOUR_CLOSE_LINES[9]
     ],
     footer: `${progressDots(opts.index, opts.total)}  \u23CE done \xB7 q quit`
   });
@@ -12628,7 +12619,7 @@ function guideExtraLines(slide, deepdive) {
   ];
   if (deepdive && slide.deepdive.length > 0) {
     lines.push("");
-    lines.push(sectionHeading("Deep dive"));
+    lines.push(sectionHeading("How to read it"));
     for (const bullet of slide.deepdive) {
       lines.push(`\xB7 ${bullet}`);
     }
@@ -12763,10 +12754,8 @@ function firstRunTourDefaultChoice() {
 async function offerFirstRunTour(ctx) {
   if (hasCompletedMetricsTour()) return false;
   console.log();
-  console.log("  " + bold("Onboarding tour") + chalk10.dim(" \u2014 ~3 minutes, no AI key required"));
-  console.log(
-    "  " + chalk10.dim("SaaS numbers, five vitals, then how to talk to NTRP and ship work to your AI.")
-  );
+  console.log("  " + bold("A short tour") + chalk10.dim(" \u2014 ~3 minutes, no AI key required"));
+  console.log("  " + chalk10.dim(TOUR_OFFER_BLURB));
   const tourDefault = firstRunTourDefaultChoice();
   if (tourDefault === "skip") {
     console.log("  " + chalk10.dim("You have taken this tour before."));
@@ -12805,7 +12794,7 @@ async function offerFirstRunTour(ctx) {
   await runMetricTour(ctx, { live: false });
   return true;
 }
-var TOUR_COMPLETED_KEY, TOUR_SKIPPED_KEY, HOME_NUDGE_SEEN_KEY, METRICS_TOUR_MILESTONE_ID;
+var TOUR_COMPLETED_KEY, TOUR_SKIPPED_KEY, HOME_NUDGE_SEEN_KEY, METRICS_TOUR_MILESTONE_ID, TOUR_INTRO_TITLE, TOUR_CLOSE_TITLE, TOUR_INTRO_LINES, TOUR_CLOSE_LINES, TOUR_OFFER_BLURB;
 var init_metric_tour = __esm({
   "src/conversation/metric-tour.ts"() {
     "use strict";
@@ -12823,6 +12812,30 @@ var init_metric_tour = __esm({
     TOUR_SKIPPED_KEY = "metrics-tour-skipped";
     HOME_NUDGE_SEEN_KEY = "metrics-tour-home-nudge-seen";
     METRICS_TOUR_MILESTONE_ID = "metrics_tour";
+    TOUR_INTRO_TITLE = "How we listen to a pipeline";
+    TOUR_CLOSE_TITLE = "Curious? Start listening";
+    TOUR_INTRO_LINES = [
+      "We think about GTM health through two lenses \u2014 then we'll show how to talk to NTRP.",
+      "",
+      "SaaS metrics (next) \u2014 ARR, NRR, coverage, win rate, velocity. Boards already know these names; we'll walk how we derive them from CRM exports, and what we trust (or don't) when the data is messy.",
+      "",
+      "Vital signs (after) \u2014 Freshness, Flow Rate, Drop Rate, Signal:Noise, Thread Depth. These are our stethoscope: each score has a dollar translation, and we read them in layer order so an upstream red doesn't get papered over by a prettier downstream number.",
+      "",
+      "How to use NTRP (after vitals) \u2014 ask in English, peek at the glossary without a key, teach your desktop AI an inbox once, then stay in diagnose \u2192 plan \u2192 review."
+    ];
+    TOUR_CLOSE_LINES = [
+      "A good first loop: ask something you actually care about \u2192 confirm the scope \u2192 load data (demo is fine) \u2192 let the formulas run. Then poke around:",
+      "/diagnose  \u2014 five vital signs with dollars attached",
+      "/metrics   \u2014 SaaS scorecard (ARR, NRR, coverage\u2026)",
+      "/deepdive  \u2014 replay this tour  \xB7  /deepdive guide  how-to only",
+      "/handoff   \u2014 ship a file; teach the inbox once (/inbox skill)",
+      "/strategy  \u2014 measurable plan  \xB7  /help  shortcuts",
+      "",
+      "Fourteen more SaaS metrics sit behind /deepdive list \u2014 including unit economics that unlock when spend data lands.",
+      "",
+      "We're a stethoscope, not a hospital: we listen hard, translate scores into dollars, and point at plays \u2014 you decide the surgery."
+    ];
+    TOUR_OFFER_BLURB = "How we think about SaaS numbers and five vitals \u2014 then how to talk to NTRP and ship work to your AI.";
   }
 });
 
@@ -15472,7 +15485,6 @@ __export(phase_exports, {
   buildConversationPrompt: () => buildConversationPrompt,
   consumeOrientEmptyEnterCoach: () => consumeOrientEmptyEnterCoach,
   formatPhaseLabel: () => formatPhaseLabel,
-  getConversationPhaseBlock: () => getConversationPhaseBlock,
   resolveConversationPhase: () => resolveConversationPhase,
   sessionHasData: () => sessionHasData
 });
@@ -15512,6 +15524,8 @@ function formatPhaseLabel(phase) {
   switch (phase) {
     case "orient":
       return "setup";
+    case "awaiting_data":
+      return "data loading";
     case "explore":
       return "ready to ask";
     case "think":
@@ -15520,15 +15534,24 @@ function formatPhaseLabel(phase) {
       return phase.replace(/_/g, " ");
   }
 }
+function accentPromptHead(phase, sessionName) {
+  const scope = sessionName ? ` ${sessionName}` : "";
+  if (phase === "orient" || phase === "awaiting_data" || phase === "explore") {
+    if (phase === "explore" && sessionName) {
+      return paint("accent", `\u203A`) + chalk11.dim(`${scope} `);
+    }
+    return paint("accent", `\u203A `);
+  }
+  if (phase === "compute") {
+    return paint("accent", `\u2026 `);
+  }
+  const word = PROMPT_LABELS[phase].replace(" \u203A", "");
+  return paint("accent", `${word}${scope} \u203A `);
+}
 function buildConversationPrompt(ctx) {
   const phase = resolveConversationPhase(ctx);
-  const label = PROMPT_LABELS[phase];
-  const scope = ctx.sessionName ? ` ${ctx.sessionName}` : "";
+  const sessionName = ctx.sessionName ?? "";
   const action = resolveRecommendedAction(ctx);
-  if (phase === "orient") {
-    const enterHint2 = action ? chalk11.dim(`\u23CE ${action.hint} `) : "";
-    return paint("accent", `${label} `) + enterHint2;
-  }
   if (phase === "explore") {
     const mode = defaultExploreResponseMode(ctx, Math.floor(ctx.messages.length / 2));
     const modeTag = mode === "brief" ? "brief" : "deep";
@@ -15536,34 +15559,15 @@ function buildConversationPrompt(ctx) {
     const strategyWait = ctx.strategistState?.step === "awaiting_connect" ? chalk11.dim(" \xB7 strategy after /connect") : "";
     const thinkWait = ctx.thinkState?.step === "awaiting_connect" ? chalk11.dim(" \xB7 think after /connect") : "";
     const enterHint2 = action ? chalk11.dim(` \xB7 \u23CE ${action.hint}`) : "";
-    return paint("accent", `ask${scope} \u203A `) + chalk11.dim(`${modeTag} \xB7 ${stack}`) + strategyWait + thinkWait + enterHint2 + " ";
+    return accentPromptHead(phase, sessionName) + chalk11.dim(`${modeTag} \xB7 ${stack}`) + strategyWait + thinkWait + enterHint2 + " ";
   }
   if (phase === "think") {
     const stack = canUseReplAi(ctx) ? formatActiveStackShort(ctx) : "no engine";
     const enterHint2 = action ? chalk11.dim(` \xB7 \u23CE ${action.hint}`) : "";
-    return paint("accent", `think${scope} \u203A `) + chalk11.dim(stack) + enterHint2 + " ";
+    return accentPromptHead(phase, sessionName) + chalk11.dim(stack) + enterHint2 + " ";
   }
   const enterHint = action ? chalk11.dim(`\u23CE ${action.hint} `) : "";
-  return paint("accent", `${label.replace(" \u203A", "")}${scope} \u203A `) + enterHint;
-}
-function getConversationPhaseBlock(ctx) {
-  const phase = resolveConversationPhase(ctx);
-  const lines = [`Conversation phase: ${formatPhaseLabel(phase)}`];
-  if (ctx.scope) {
-    lines.push(`Intent: ${ctx.scope.intent_summary}`);
-    lines.push(`Primary lens: ${ctx.scope.primary_lens}`);
-    if (ctx.scope.audience) lines.push(`Audience: ${ctx.scope.audience}`);
-    if (ctx.scope.time_horizon) lines.push(`Time horizon: ${ctx.scope.time_horizon}`);
-    if (ctx.scope.confirmed_at) lines.push(`Scope confirmed: ${ctx.scope.confirmed_at}`);
-  }
-  if (ctx.dataset?.label) lines.push(`Dataset: ${ctx.dataset.label}`);
-  if (ctx.gapAudit) {
-    lines.push(`Can compute: ${ctx.gapAudit.can_compute}`);
-    if (ctx.gapAudit.missing.length > 0) {
-      lines.push(`Data gaps: ${ctx.gapAudit.missing.map((m) => m.label).join(", ")}`);
-    }
-  }
-  return lines.join("\n");
+  return accentPromptHead(phase, sessionName) + enterHint;
 }
 var PROMPT_LABELS;
 var init_phase = __esm({
@@ -15579,9 +15583,9 @@ var init_phase = __esm({
     PROMPT_LABELS = {
       orient: "\u203A",
       scope: "scope \u203A",
-      awaiting_data: "data \u203A",
+      awaiting_data: "\u203A",
       compute: "\u2026",
-      explore: "ask \u203A",
+      explore: "\u203A",
       think: "think \u203A",
       strategize: "strategy \u203A",
       deliver: "ship \u203A"
@@ -21107,8 +21111,11 @@ function buildInvestigationTools() {
   if (isWebRetrievalEnabled()) tools.push(WEB_SEARCH_TOOL);
   return tools;
 }
-function buildFreshNlTools() {
-  const tools = [...AGENTIC_TOOLS, ...CONVERSATION_TOOLS];
+function buildFreshNlTools(opts = {}) {
+  const conversationTools = opts.analysisReady ? CONVERSATION_TOOLS.filter(
+    (t) => t.name !== "propose_scope" && t.name !== "confirm_scope" && t.name !== "run_compute"
+  ) : CONVERSATION_TOOLS;
+  const tools = [...AGENTIC_TOOLS, ...conversationTools];
   if (isWebRetrievalEnabled()) tools.push(WEB_SEARCH_TOOL);
   return tools;
 }
@@ -22811,12 +22818,12 @@ Cite numbers from here; call tools when you need a new cut or to pressure-test a
 
 ` : "";
   const conversationSection = opts.conversationBlock ? `
-CONVERSATION STATE:
 ${opts.conversationBlock}
 
 ` : "";
   const scratchSection = buildScratchBlock(opts.thinkState);
   const socraticCraft = `HOW YOU THINK WITH THE USER (socratic partner \u2014 not a search box, not a strategist):
+- Pre-explore funnel gates are handled by the CLI; you speak in the think channel after analysis.
 - You are a thinking partner. Prefer sharp questions that unlock the user's idea over dumping answers.
 - Protect imagination: give "what if" space before the smell-test \u2014 do not kill creativity in the first sentence.
 - Steelman the user's position before you attack it; then deliver one hard pushback grounded in evidence when possible.
@@ -22850,7 +22857,7 @@ ${buildCommandCatalogBlock()}
 COMMAND SUGGESTION RULES:
 - Suggest at most ONE command when it adds capability beyond your answer (e.g. \`/strategy\`, \`/handoff\`).
 - Never claim a command was run. Never invent flags.
-- Type \`done\` or \`cancel\` leaves the think channel back to ask \u203A.`;
+- Type \`done\` or \`cancel\` leaves the think channel back to \u203A.`;
   const stable = `You are a world-class GTM operating partner in a dedicated THINK WITH ME channel. The user wants collaborative exploration \u2014 imagination, pressure-testing, and evidence \u2014 not a slide deck and not a finished strategy plan.
 
 ${companyContextSection2()}${operatorSection2()}${socraticCraft}
@@ -22900,7 +22907,7 @@ ${SAFETY_BLOCK}`;
   const dynamic = [
     "SESSION STATE (current \u2014 changes as the session progresses):",
     ...dynamicSections,
-    buildRuntimeBlock()
+    buildRuntimeBlock(opts.runtimeFacts ?? {})
   ].join("\n\n");
   return { stable, dynamic };
 }
@@ -22912,6 +22919,170 @@ var init_think_prompt = __esm({
   }
 });
 
+// src/conversation/ghost-hints.ts
+function ghostExamplesForPhase(phase, limit = 2) {
+  const hints = PHASE_GHOST_HINTS[phase] ?? [];
+  return hints.slice(0, limit).map((h) => h.replace(/^try\s+/i, ""));
+}
+var PHASE_GHOST_HINTS;
+var init_ghost_hints = __esm({
+  "src/conversation/ghost-hints.ts"() {
+    "use strict";
+    PHASE_GHOST_HINTS = {
+      orient: [
+        'try "pipeline health"',
+        "try /deepdive",
+        "try /deepdive guide",
+        'try "is our retention real for the board?"',
+        'try "what is the most expensive problem to solve?"',
+        'try "board deck on Q3"'
+      ],
+      awaiting_data: [
+        'try "use demo data"',
+        "try a CSV path",
+        "try /ingest",
+        'try "go ahead"'
+      ],
+      explore: [
+        'try "what is the most expensive problem?"',
+        'try "how should we fix this?"',
+        'try "which segment is weakest?"',
+        'try "what is ARR?"',
+        "try /deepdive freshness",
+        'try "ship a board deck"'
+      ]
+    };
+  }
+});
+
+// src/conversation/situation.ts
+function buildSituationalAwarenessBlock(ctx, opts = {}) {
+  const phase = resolveConversationPhase(ctx);
+  const channel = opts.channel ?? (phase === "think" ? "think" : "explore");
+  const responseMode = opts.responseMode ?? (channel === "think" ? "deep" : defaultExploreResponseMode(ctx, Math.floor(ctx.messages.length / 2)));
+  const analysisReady = isAnalysisReady(ctx);
+  const action = resolveRecommendedAction(ctx);
+  const examples = ghostExamplesForPhase(
+    phase === "think" || phase === "strategize" || phase === "deliver" ? "explore" : phase,
+    2
+  );
+  const lines = [
+    "WHERE YOU ARE IN NTRP:",
+    FUNNEL_SPINE,
+    `Phase: ${phase} (${formatPhaseLabel(phase)}) \u2014 ${PHASE_MEANING[phase]}`
+  ];
+  if (channel === "think") {
+    lines.push("Channel: think \u2014 socratic partner; type done/cancel returns to \u203A");
+    lines.push("Response mode: deep (tools on)");
+  } else if (channel === "strategist") {
+    lines.push("Channel: strategist \u2014 measurable plan engine owns sequencing");
+  } else {
+    lines.push(
+      responseMode === "brief" ? "Response mode: brief (tools off; cite COMPLETED SESSION ANALYSIS; ~40\u201390 words)" : "Response mode: deep (tools on; new cuts and drill-downs)"
+    );
+  }
+  if (ctx.scope) {
+    const bits = [`Scope: ${ctx.scope.intent_summary}`, `lens=${ctx.scope.primary_lens}`];
+    if (ctx.scope.audience) bits.push(`audience=${ctx.scope.audience}`);
+    if (ctx.scope.time_horizon) bits.push(`horizon=${ctx.scope.time_horizon}`);
+    lines.push(bits.join(" \xB7 "));
+    if (ctx.scope.confirmed_at) lines.push(`Scope confirmed: ${ctx.scope.confirmed_at}`);
+  }
+  if (ctx.dataset?.label) {
+    lines.push(`Dataset: ${ctx.dataset.label} \xB7 stage=${ctx.stage}`);
+  } else if (sessionHasData(ctx)) {
+    lines.push(`Dataset: loaded \xB7 stage=${ctx.stage}`);
+  } else {
+    lines.push(`Dataset: empty \xB7 stage=${ctx.stage}`);
+  }
+  if (ctx.gapAudit) {
+    lines.push(`Can compute: ${ctx.gapAudit.can_compute}`);
+    if (ctx.gapAudit.missing.length > 0) {
+      lines.push(`Data gaps: ${ctx.gapAudit.missing.map((m) => m.label).join(", ")}`);
+    }
+  }
+  if (analysisReady) {
+    lines.push(
+      "Already done: scope confirmed; compute ran; do not re-propose scope or re-run compute unless the user asks to restart"
+    );
+    lines.push(
+      "Available now: answer from the artifact; suggest at most one of /strategy, /handoff, /deepdive <metric>, /thinkwithme, /playbook"
+    );
+    if (channel === "explore" && responseMode === "deep") {
+      lines.push(
+        "Tools: diagnostics + draft_strategy + draft_handoff (+ audit_data_gaps for re-check). Scope/compute orchestration is off."
+      );
+    }
+  } else if (phase === "awaiting_data") {
+    lines.push("Already done: scope confirmed; analysis not ready");
+    lines.push(
+      'Available now: tell the user to paste a CSV path, type "use demo data", or \u23CE go ahead when can_compute \u2014 you cannot open files'
+    );
+  } else if (phase === "scope") {
+    lines.push("Already done: intent proposed; waiting on confirm");
+    lines.push("Available now: wait for CLI confirm (\u23CE yes) \u2014 do not invent a different question");
+  } else if (phase === "orient") {
+    lines.push("Already done: nothing locked yet");
+    lines.push("Available now: help the user name a focus; CLI will propose scope from their words");
+  } else if (phase === "think") {
+    lines.push("Already done: analysis complete; think channel open");
+    lines.push("Available now: socratic exploration; draft_strategy / draft_handoff when ready to graduate");
+  }
+  lines.push(
+    `Armed user next step: ${action ? `${action.hint} (\u23CE submits "${action.submit}")` : "none"}`
+  );
+  lines.push(`Engine connected: ${canUseReplAi(ctx) ? "yes" : "no"}`);
+  if (examples.length > 0) {
+    lines.push(`User may try: ${examples.join(" \xB7 ")}`);
+  }
+  lines.push(
+    "Your job in this harness: fill the judgment gap after formula compute \u2014 connect dollars, name the expensive problem, do not restate scorecards the user already saw"
+  );
+  lines.push(
+    "Pre-explore funnel gates are handled by the CLI; you speak in explore/think/strategist unless tools explicitly allow a restart"
+  );
+  return lines.join("\n");
+}
+function buildSituationalRuntimeFacts(ctx, opts = {}) {
+  const phase = resolveConversationPhase(ctx);
+  const channel = opts.channel ?? (phase === "think" ? "think" : "explore");
+  const responseMode = opts.responseMode ?? (channel === "think" ? "deep" : defaultExploreResponseMode(ctx, Math.floor(ctx.messages.length / 2)));
+  return {
+    phase,
+    mode: responseMode,
+    lens: ctx.scope?.primary_lens,
+    stage: ctx.stage,
+    can_compute: ctx.gapAudit?.can_compute === void 0 ? void 0 : String(ctx.gapAudit.can_compute),
+    engine: canUseReplAi(ctx) ? "connected" : "none"
+  };
+}
+function getConversationPhaseBlock(ctx, opts = {}) {
+  return buildSituationalAwarenessBlock(ctx, opts);
+}
+var FUNNEL_SPINE, PHASE_MEANING;
+var init_situation = __esm({
+  "src/conversation/situation.ts"() {
+    "use strict";
+    init_context2();
+    init_explore_mode();
+    init_repl_api();
+    init_ghost_hints();
+    init_recommended_action();
+    init_phase();
+    FUNNEL_SPINE = "Funnel: orient \u2192 scope \u2192 data \u2192 compute \u2192 explore | side doors: think, strategy, ship";
+    PHASE_MEANING = {
+      orient: "setup \u2014 open chat; user has not locked a scope yet",
+      scope: "scope confirm \u2014 CLI owns yes/adjust; do not re-propose unless asked",
+      awaiting_data: "data gate \u2014 load CSV/demo or compute; CLI owns the gate",
+      compute: "compute in progress \u2014 wait",
+      explore: "analysis complete \u2014 free-form Q&A on this session's artifact",
+      think: "socratic think channel \u2014 return to \u203A via done/cancel",
+      strategize: "strategist flow \u2014 objective confirm or plan drafting",
+      deliver: "ship/handoff wizard \u2014 CLI owns write confirms"
+    };
+  }
+});
+
 // src/ai/agentic-loop.ts
 function findingsJsonSchemaNudge() {
   return `Respond with ONLY a JSON array of finding objects \u2014 no prose, no markdown fences. Each object needs: severity, segment, finding, vital_signs, entity_count, recommended_focus, dollar_value, recommended_plays. Shape:
@@ -23017,12 +23188,11 @@ The user already received the full report in the terminal. Answer follow-ups by
 
 ` : "";
   const conversationSection = conversationBlock ? `
-CONVERSATION STATE:
 ${conversationBlock}
-Do not run compute until audit_data_gaps reports can_compute. If the user needs to load data, tell them to paste a CSV path or type "use demo data". You cannot open files.
 
 ` : "";
   const conversationRules = `HOW A GREAT ANALYST CARRIES A CONVERSATION (read carefully \u2014 this is what separates you from a search box):
+- Pre-explore funnel gates (orient \u2192 scope \u2192 data \u2192 compute) are handled by the CLI. You speak after compute unless tools explicitly allow a restart.
 - You have continuity. The conversation so far is provided to you as prior messages. Read it before answering. You remember every angle you have already explored, every number you have already surfaced, and every recommendation you have already made.
 - Never repeat or re-recommend an analysis you have already presented in this conversation unless the user explicitly asks you to revisit, recall, or connect it. Repetition reads as forgetfulness and destroys trust.
 - Each answer should ADVANCE the discussion: go deeper, introduce a genuinely new angle, challenge an assumption, or synthesize across what you have already found. Move the thinking forward.
@@ -23031,6 +23201,9 @@ Do not run compute until audit_data_gaps reports can_compute. If the user needs
 - If you genuinely have nothing new to add on a topic, say so briefly and offer a different, higher-value direction \u2014 never pad with a recycled recommendation.`;
   const briefJob = `YOUR JOB (BRIEF MODE \u2014 default after analysis is complete):
 - Stay concise \u2014 roughly 40\u201390 words total, not a mini-report. Verdict first: your opening sentence is the headline the user should be able to repeat an hour later.
+- Lead with the single most expensive or most actionable implication from the completed session analysis \u2014 not a scorecard restatement.
+- Do not re-list all five vital signs unless the user asked for that inventory.
+- Prefer naming one playbook play or one next cut over a generic "want me to dig deeper?" close.
 - You are at 30,000 ft by default. If they ask for detail or a new data cut, that routes to deep mode automatically \u2014 don't cram the weeds in here.
 - Do NOT call tools unless the user explicitly asks for a new data cut (by rep, stage, list of deals, etc.). The completed analysis above is your source of truth.
 - Name a playbook play only when the user asks what to do or which action to take.
@@ -23150,7 +23323,7 @@ ${briefCommandSection}` : "";
   const dynamic = [
     "SESSION STATE (current \u2014 changes as the session progresses):",
     ...dynamicSections,
-    buildRuntimeBlock()
+    buildRuntimeBlock(promptOptions.runtimeFacts ?? {})
   ].join("\n\n");
   return { stable, dynamic };
 }
@@ -23182,15 +23355,27 @@ async function* agenticFindings(computeResult, divergences, options) {
     analysisBlock: options.analysisBlock,
     conversationBlock: options.conversationBlock,
     sessionArtifact: options.sessionArtifact,
-    thinkState: options.ctx.thinkState
+    thinkState: options.ctx.thinkState,
+    runtimeFacts: buildSituationalRuntimeFacts(options.ctx, {
+      channel: "think",
+      responseMode: "deep"
+    })
   }) : mode === "fresh" ? buildFreshNlSystemPrompt(
     options.sessionContext,
     options.memoryBlock,
     options.analysisBlock,
     options.conversationBlock,
-    { responseMode, sessionArtifact: options.sessionArtifact, experiment }
+    {
+      responseMode,
+      sessionArtifact: options.sessionArtifact,
+      experiment,
+      runtimeFacts: buildSituationalRuntimeFacts(options.ctx, {
+        responseMode
+      })
+    }
   ) : buildSystemPrompt();
-  const tools = useTools ? mode === "think" ? buildThinkTools() : mode === "fresh" ? buildFreshNlTools() : buildInvestigationTools() : [];
+  const analysisReady = isAnalysisReady(options.ctx);
+  const tools = useTools ? mode === "think" ? buildThinkTools() : mode === "fresh" ? buildFreshNlTools({ analysisReady }) : buildInvestigationTools() : [];
   const toolCtx = { computeResult, divergences };
   if (options.includeMetrics) {
     try {
@@ -23359,6 +23544,8 @@ var init_agentic_loop = __esm({
     init_prompt_parts();
     init_think_prompt();
     init_prompt();
+    init_context2();
+    init_situation();
     MAX_ITERATIONS = 10;
     INVESTIGATION_EVIDENCE_NUDGE_AFTER = 5;
     BRIEF_MAX_TOKENS = 768;
@@ -32396,10 +32583,10 @@ async function runNaturalLanguage(input, ctx) {
   setAgentContext(ctx);
   try {
     const analysisBlock = buildAnalysisBlock(ctx);
-    const conversationBlock = getConversationPhaseBlock(ctx);
+    const responseMode = resolveExploreResponseMode(input, ctx, ctx.conversation.length);
+    const conversationBlock = getConversationPhaseBlock(ctx, { responseMode });
     const bundle = await loadSessionAnalysisBundle();
     const sessionArtifact = hasAnyAnalysis(bundle) ? buildExploreContextBlock(bundle, ctx) : "";
-    const responseMode = resolveExploreResponseMode(input, ctx, ctx.conversation.length);
     for await (const event of agenticFindings(snapshot, ctx.snapshot.divergences, {
       mode: "fresh",
       userQuestion: input,
@@ -32497,6 +32684,7 @@ var init_nl = __esm({
     "use strict";
     init_spinner();
     init_context2();
+    init_situation();
     init_phase();
     init_agent_context();
     init_orchestrator();
@@ -32562,7 +32750,7 @@ async function* streamAsk(question, ctx) {
     sessionContext: ctx.resumedSessionSummary,
     includeMetrics: true,
     analysisBlock: buildAnalysisBlock(ctx),
-    conversationBlock: getConversationPhaseBlock(ctx),
+    conversationBlock: getConversationPhaseBlock(ctx, { responseMode }),
     sessionArtifact,
     responseMode,
     priorMessages: ctx.conversation,
@@ -32607,7 +32795,7 @@ var init_ask = __esm({
     init_divergence();
     init_repl_api();
     init_context2();
-    init_phase();
+    init_situation();
     init_session_analysis();
     init_smoke_protocol();
   }
@@ -33800,7 +33988,7 @@ async function runThinkTurn(input, ctx) {
   setAgentContext(ctx);
   try {
     const analysisBlock = buildAnalysisBlock(ctx);
-    const conversationBlock = getConversationPhaseBlock(ctx);
+    const conversationBlock = getConversationPhaseBlock(ctx, { channel: "think", responseMode: "deep" });
     const bundle = await loadSessionAnalysisBundle();
     const sessionArtifact = hasAnyAnalysis(bundle) ? buildExploreContextBlock(bundle, ctx) : "";
     for await (const event of agenticFindings(snapshot, ctx.snapshot.divergences, {
@@ -33887,7 +34075,7 @@ var init_think = __esm({
     "use strict";
     init_spinner();
     init_context2();
-    init_phase();
+    init_situation();
     init_agent_context();
     init_agentic_loop();
     init_thread();
@@ -33951,7 +34139,7 @@ function printChannelIntro(seed) {
   console.log(
     "  " + chalk67.dim(
       "Socratic channel \u2014 explore, challenge assumptions, pull evidence. Type "
-    ) + chalk67.cyan("done") + chalk67.dim(" or ") + chalk67.cyan("cancel") + chalk67.dim(" to return to ask \u203A.")
+    ) + chalk67.cyan("done") + chalk67.dim(" or ") + chalk67.cyan("cancel") + chalk67.dim(" to return to \u203A.")
   );
   if (seed) {
     console.log("  " + chalk67.dim("Seed: ") + seed);
@@ -34037,7 +34225,7 @@ function clearThinkFlow(ctx, reason) {
   console.log();
   console.log(
     "  " + chalk67.dim(
-      reason === "done" ? "Think channel closed. Back to ask \u203A." : "Think session cancelled. Continue exploration."
+      reason === "done" ? "Think channel closed. Back to \u203A." : "Think session cancelled. Continue exploration."
     )
   );
   console.log();
@@ -36457,7 +36645,7 @@ handler: ../commands/thinkwithme.ts
 
 Open a dedicated \`think \u203A\` channel to explore ideas, challenge assumptions, and pull evidence from your data.
 Bare \`/thinkwithme\` enters the channel. Type \`/thinkwithme <topic>\` to seed the first turn.
-Requires an analysis and an AI key (\`/connect\`). Type \`done\` or \`cancel\` to return to ask \u203A.
+Requires an analysis and an AI key (\`/connect\`). Type \`done\` or \`cancel\` to return to \u203A.
 When you are ready to commit to a plan, say so or the partner can hand off to \`/strategy\`.`
       },
       {
@@ -39468,7 +39656,7 @@ function printHelp() {
   console.log("  " + chalk88.dim("After analysis, type questions in English."));
   console.log("  " + chalk88.dim("Type ") + paint("accent", '"how should we fix this?"') + chalk88.dim(" to make a strategy."));
   console.log("  " + chalk88.dim("Type ") + paint("accent", '"ship a board deck"') + chalk88.dim(" to write a handoff."));
-  console.log("  " + chalk88.dim("The ") + paint("accent", "ask \u203A") + chalk88.dim(" prompt shows brief or deep. Brief is the default after analysis."));
+  console.log("  " + chalk88.dim("The ") + paint("accent", "\u203A") + chalk88.dim(" prompt shows brief or deep after analysis. Brief is the default."));
   console.log();
   console.log("  " + sectionHeading("Shortcuts"));
   const shortcuts = [
@@ -39527,6 +39715,7 @@ var init_repl = __esm({
     init_prompt_parts();
     init_store();
     init_phase();
+    init_ghost_hints();
     init_recommended_action();
     init_inline_suggestion();
     init_loop_guard2();
@@ -39587,23 +39776,7 @@ var init_repl = __esm({
       "May your pipeline stay hydrated.",
       "Don't let the zombie deals bite."
     ];
-    GHOST_HINTS = {
-      orient: [
-        'try "pipeline health"',
-        "try /deepdive",
-        "try /deepdive guide",
-        'try "is our retention real for the board?"',
-        'try "what is the most expensive problem to solve?"',
-        'try "board deck on Q3"'
-      ],
-      explore: [
-        'try "what is ARR?"',
-        "try /deepdive freshness",
-        'try "how should we fix this?"',
-        'try "which segment is weakest?"',
-        'try "ship a board deck"'
-      ]
-    };
+    GHOST_HINTS = PHASE_GHOST_HINTS;
     ghostHintTurn = 0;
     activeGhostHint = null;
     suggestionPainted = false;