@sonnechasser/ntrp 0.2.0 → 0.2.2

package/dist/investigation/verbosity-cli.js

@@ -8279,6 +8279,736 @@ var init_playbook = __esm({
   }
 });
 
+// src/workflows/registry.ts
+function parseFrontmatter(raw) {
+  if (!raw.startsWith("---")) return { meta: {}, body: raw };
+  const end = raw.indexOf("\n---", 3);
+  if (end === -1) return { meta: {}, body: raw };
+  const fm = raw.slice(3, end).trim();
+  const body = raw.slice(end + 4).replace(/^\r?\n/, "");
+  const meta = {};
+  for (const line of fm.split("\n")) {
+    const match = line.match(/^(\w+):\s*(.*)$/);
+    if (!match) continue;
+    let value = match[2].trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    meta[match[1]] = value;
+  }
+  return { meta, body: body.trim() };
+}
+function loadRegistry() {
+  if (registry) return registry;
+  registry = /* @__PURE__ */ new Map();
+  for (const entry of EMBEDDED_WORKFLOWS) {
+    const { meta: fm, body } = parseFrontmatter(entry.raw);
+    const meta = {
+      name: fm.name ?? entry.name,
+      description: fm.description ?? "",
+      section: fm.section ?? "Other",
+      args: fm.args,
+      handler: fm.handler ?? "",
+      body,
+      hidden: fm.hidden === "true"
+    };
+    registry.set(meta.name, { meta, handler: null });
+  }
+  return registry;
+}
+function listWorkflows(includeHidden = false) {
+  const all2 = Array.from(loadRegistry().values()).map((e) => e.meta);
+  return includeHidden ? all2 : all2.filter((m) => !m.hidden);
+}
+var registry, EMBEDDED_WORKFLOWS;
+var init_registry = __esm({
+  "src/workflows/registry.ts"() {
+    "use strict";
+    registry = null;
+    EMBEDDED_WORKFLOWS = [
+      {
+        name: "new",
+        raw: `---
+name: new
+description: Start a new analysis \u2014 one menu picks data + first report
+section: Hidden
+hidden: true
+args: [<file.csv>] | --demo [--scenario <name>] | --empty [--lens health|metrics]
+handler: ../commands/new.ts
+---
+
+Start a fresh point-in-time analysis. Interactive mode uses **one menu**: demo \u2192
+health, demo \u2192 metrics, your CSV, or empty. Loads data and runs the first report
+(formulas only \u2014 no AI unless you add \`--findings\` later). Demo metrics works
+without \`/onboard\`; your own CSV needs a profile for metrics calibration.
+After the report, **ask questions in plain English** \u2014 no slash needed.`
+      },
+      {
+        name: "end",
+        raw: `---
+name: end
+description: Close the current analysis without a handoff
+section: Start
+args: 
+handler: ../commands/end.ts
+---
+
+Mark the current session as finished even when you didn't produce a report or
+other output. It drops off the "in progress" list, saves your transcript and
+dataset anchor for later, and rotates you to a fresh empty session. Use
+\`/handoff\` instead when you want to ship something.`
+      },
+      {
+        name: "session",
+        raw: `---
+name: session
+description: Pick up or browse your analyses
+section: Hidden
+hidden: true
+args: [<id|name>] | new
+handler: ../commands/session.ts
+---
+
+Move between your point-in-time analyses. With no arguments, lists your
+sessions with unfinished work (reached insight, never delivered) surfaced
+first. Pass a session id (or type the 4-char suffix after listing) to pick it
+back up \u2014 this rebinds its dataset and conversation so you continue exactly
+where you left off. \`new\` starts a fresh analysis.`
+      },
+      {
+        name: "handoff",
+        raw: `---
+name: handoff
+description: Turn the analysis into an output
+section: Start
+args: [report|notes|csv|publish|prompt] [deck|asana|clay|plan]
+handler: ../commands/handoff.ts
+---
+
+Close the loop to action. Produce a markdown report, a notes export, CSV
+receipts, or a repository package \u2014 or generate a ready-to-paste prompt for
+another agent to build a review deck, an Asana project, a Clay table, or an
+action plan from this diagnosis. Producing an output marks the session
+delivered so it stops showing up as unfinished work.`
+      },
+      {
+        name: "onboard",
+        raw: `---
+name: onboard
+description: Set up your company profile
+section: Settings
+handler: ../commands/onboard.ts
+---
+
+Run the first-run wizard to build a rich company profile. Configures one or
+two LLM engines (Anthropic and/or OpenAI), then asks
+a few seed questions and uses AI to draft industry, ICP, deal size, and stack
+guesses. Profile is stored at \`~/.ntrp/profile.json\` and flows into every
+AI surface (findings, NL answers, demo generation).`
+      },
+      {
+        name: "sessions",
+        raw: `---
+name: sessions
+description: Browse past session history
+section: More
+args: [list|show <id>]
+handler: ../commands/sessions.ts
+hidden: true
+---
+
+List and inspect past REPL sessions. Shows session dates, AI-generated
+summaries, and exchange counts. Use \`show <id>\` to view the full
+conversation from a specific session.`
+      },
+      {
+        name: "setup",
+        raw: `---
+name: setup
+description: Configure NTRP for headless and agent use
+section: Settings
+args: check | agent [--profile <file|->]
+handler: ../commands/setup.ts
+---
+
+Validate local readiness or configure NTRP non-interactively for automation.
+\`setup check --json\` reports license, profile, API key, database, and writable
+directory state. \`setup agent\` accepts a profile JSON file or direct flags \u2014
+\`--llm-key <key>\` auto-detects the provider from any pasted key
+(\`--llm-provider <id>\` to force one).`
+      },
+      {
+        name: "update",
+        raw: `---
+name: update
+description: Update NTRP to the latest version
+section: Settings
+handler: ../commands/update.ts
+---
+
+Update the globally installed NTRP package via npm.`
+      },
+      {
+        name: "resume",
+        raw: `---
+name: resume
+description: Continue a previous session
+section: More
+args: [id]
+handler: ../commands/resume.ts
+hidden: true
+---
+
+Load a previous session's context so the AI can reference what was
+discussed before. Without an ID, resumes the most recent session.
+Use a full session ID or 4-char suffix.`
+      },
+      {
+        name: "name",
+        raw: `---
+name: name
+description: Tag this session with a label
+section: More
+args: [label]
+handler: ../commands/name.ts
+---
+
+Give the current session a human-readable name so you can find it
+later. The name appears in the REPL prompt, session list, and
+welcome dashboard. Max 40 characters.`
+      },
+      {
+        name: "switch",
+        raw: `---
+name: switch
+description: Jump to a named session
+section: More
+args: [name]
+handler: ../commands/switch.ts
+hidden: true
+---
+
+Save the current session and switch to a named one. If the name
+exists, loads its context and messages. If new, creates a fresh
+session with that name. Without arguments, lists all named sessions.`
+      },
+      {
+        name: "actions",
+        raw: `---
+name: actions
+description: Propose, approve, and execute actions
+section: More
+args: [list|test|show|approve|reject|execute|continue] [id]
+handler: ../commands/actions.ts
+---
+
+Create and manage action proposals. \`/actions test\` creates a local manual
+dry-run proposal that exercises the approval and execution lifecycle without
+touching external tools. Execute-class actions require local approval before
+they can run. Use \`/actions continue\` to advance the newest pending or
+approved proposal without copying a handle during the active workflow.`
+      },
+      {
+        name: "diagnose",
+        raw: `---
+name: diagnose
+description: Compute vital signs and generate findings
+section: Hidden
+hidden: true
+args: [--deep] [--segment <name>]
+handler: ../commands/diagnose.ts
+---
+
+Compute the 5 vital signs (freshness, flow rate, drop rate, signal-to-noise,
+thread depth) for either the full dataset or a segment. Companion to \`/metrics\`
+when your session primary is SaaS metrics. Use \`--deep\` to run the agentic
+investigation loop instead of the single-shot findings path.`
+      },
+      {
+        name: "metrics",
+        raw: `---
+name: metrics
+description: SaaS metrics \u2014 refresh or add the revenue view
+section: Hidden
+hidden: true
+args: [--findings] [--segment <name>]
+handler: ../commands/metrics.ts
+---
+
+Compute SaaS revenue metrics from pipeline or revenue-ledger data: ARR, NRR/GRR,
+Win Rate, Pipeline Coverage, and more. Each metric includes a confidence score
+and reliability gate showing what data unlocks the next tier. Use \`--findings\`
+for AI analysis calibrated to your company profile. Revenue ledger CSV format:
+account, period, mrr, event_type.`
+      },
+      {
+        name: "ask",
+        raw: `---
+name: ask
+description: Chat with your pipeline data
+section: Hidden
+hidden: true
+args: <question>
+handler: ../commands/ask.ts
+---
+
+Ask a plain-English question about your GTM health and SaaS metrics. Free-form
+text at the REPL prompt routes to the same agent. Respects your session primary
+lens; can cross-reference vital signs and revenue metrics via tools.`
+      },
+      {
+        name: "recap",
+        raw: `---
+name: recap
+description: Summarize the current session
+section: More
+handler: ../commands/recap.ts
+---
+
+Summarize the current REPL session using AI. Reads all natural-language
+exchanges from the session and produces a structured overview: key findings,
+dollar impacts, and recommended next steps.`
+      },
+      {
+        name: "remember",
+        raw: `---
+name: remember
+description: Teach the analyst a durable fact
+section: More
+args: <fact> | decision: <text> | preference: <text>
+handler: ../commands/remember.ts
+---
+
+Store a durable fact, decision, or preference about your business. Stored
+memory flows into every future analysis so the agent gets to know your
+business better over time \u2014 like a consultant building up a client file.`
+      },
+      {
+        name: "recall",
+        raw: `---
+name: recall
+description: See what the analyst remembers
+section: More
+args: [topic]
+handler: ../commands/recall.ts
+---
+
+Jog the analyst's memory. With no arguments, lists the durable facts it knows
+and the analyses it has already run. Pass a topic to see what it remembers
+about that subject \u2014 pulled from facts, strategies, wins, and ingested
+knowledge.`
+      },
+      {
+        name: "rate",
+        raw: `---
+name: rate
+description: Give feedback on the last answer
+section: More
+args: good [note] | bad <note>
+handler: ../commands/rate.ts
+---
+
+Tell the analyst how its last answer landed. \`/rate good\` reinforces the
+approach; \`/rate bad <what was off>\` records a correction. Feedback becomes a
+durable preference so the analyst gets better at working with you over time.`
+      },
+      {
+        name: "knowledge",
+        raw: `---
+name: knowledge
+description: Ingest external case studies & frameworks
+section: More
+args: [add <file> | list]
+handler: ../commands/knowledge.ts
+---
+
+Teach the analyst from work done outside the platform. \`/knowledge add <file>\`
+ingests a markdown, text, or PDF case study, framework, or benchmark report and
+indexes it for retrieval during analysis. \`/knowledge list\` shows what's
+indexed. Drop files into ~/.ntrp/knowledge to stage them.`
+      },
+      {
+        name: "ingest",
+        raw: `---
+name: ingest
+description: Import CRM CSV exports (or --demo)
+section: Hidden
+hidden: true
+args: <file> | --demo [--scenario <name>]
+handler: ../commands/ingest.ts
+---
+
+Import a CSV file from your CRM (Salesforce, HubSpot, Outreach). The command
+auto-detects the entity type based on column headers and runs identity
+resolution after import.
+
+Pass \`--demo\` instead of a file to generate a synthetic dataset shaped by
+your company profile. Accepts \`--scenario <name>\` to pick a scenario (else
+random) and \`--regen-taxonomy\` to rebuild the profile-derived market
+taxonomy. Rep names draw from a curated music / sports / film roster for a
+little demo delight; pass \`--no-whimsy\` to use generic names instead.`
+      },
+      {
+        name: "demo",
+        raw: `---
+name: demo
+description: Generate demo scenario data
+section: Getting Started
+args: [--scenario <name>] [--regen-taxonomy] [--no-whimsy]
+handler: ../commands/generate.ts
+hidden: true
+---
+
+Generate a complete dataset for one of 5 demo scenarios: hidden_crisis,
+leaky_bucket, stale_pipeline, lone_wolf, busy_bees. Without \`--scenario\`,
+picks one at random each run. Use \`--list-scenarios\` to see descriptions.
+Use \`--regen-taxonomy\` to force a fresh AI-built market taxonomy.
+By default, sales rep names are drawn from a curated music / sports / film
+roster; pass \`--no-whimsy\` for generic placeholder names.
+
+This command is hidden \u2014 prefer \`/ingest --demo\` which delegates here.`
+      },
+      {
+        name: "strategy",
+        raw: `---
+name: strategy
+description: Ingest and manage GTM strategies
+section: More
+args: [list|ingest|add|show|sync|sources] [file|text|id|folder]
+handler: ../commands/strategy.ts
+---
+
+Add user-authored or agent-authored GTM strategies to NTRP's strategy library.
+\`/strategy ingest <file>\` accepts markdown, YAML, PDF, or plain text files.
+\`/strategy ingest -\` reads strategy text from stdin, and \`/strategy add "..."\`
+creates a strategy from a short pasted description.
+\`/strategy sync --path <folder>\` scans an Obsidian-style local library and
+imports supported strategy documents. Use \`/strategy sources\` to see available
+library connector types.`
+      },
+      {
+        name: "segment",
+        raw: `---
+name: segment
+description: Browse and inspect segments
+section: More
+args: [list|show|compare|create|delete] [args]
+handler: ../commands/segment.ts
+---
+
+Browse, inspect, and manage data segments. With no arguments, lists all
+segments sorted worst-first. Subcommands: \`show <name>\`, \`compare <a> <b>\`,
+\`create <name> --entity <type> --filter <expr>\`, \`delete <name>\`.`
+      },
+      {
+        name: "report",
+        raw: `---
+name: report
+description: Export latest diagnosis
+section: More
+args: [--format terminal|md|json] [--output <file>]
+handler: ../commands/report.ts
+---
+
+Export the most recent diagnosis as terminal output, markdown, or JSON. Use
+\`--output <file>\` to write to disk instead of stdout.`
+      },
+      {
+        name: "progress",
+        raw: `---
+name: progress
+description: Usage stats and milestone ladder
+section: Navigation
+args: [reset] [--confirm]
+handler: ../commands/progress.ts
+---
+
+Hours saved, weekly activity trend, session counts, AI token usage, and the
+full milestone ladder with progress bars. Use reset (type "reset" to confirm)
+to clear hours and milestones while keeping this install's identity.`
+      },
+      {
+        name: "status",
+        raw: `---
+name: status
+description: Show last diagnosis and entity counts
+section: More
+handler: ../commands/status.ts
+---
+
+Show what data you currently have loaded and the result of your last
+diagnosis, if any.`
+      },
+      {
+        name: "scratch",
+        raw: `---
+name: scratch
+description: Wipe config, profile, and all datasets
+section: Admin
+args: [--confirm] [--include-progress]
+handler: ../commands/scratch.ts
+hidden: true
+---
+
+Minimal factory reset: removes API key, config, company profile, all sessions,
+per-session datasets, and demo taxonomy cache. Preserves progress (hours saved)
+by default. Pass \`--include-progress\` to also wipe install identity and hours.
+Also preserves memory, strategies, wins, knowledge, exports, and audit. Requires
+typing \`scratch\` in the REPL or passing \`--confirm\` one-shot. Triggers
+onboarding on next interactive use.`
+      },
+      {
+        name: "cleanup",
+        raw: `---
+name: cleanup
+description: Close all active sessions
+section: Admin
+args: [--confirm]
+handler: ../commands/cleanup.ts
+hidden: true
+---
+
+Mark every in-progress session as ended without deleting transcripts or dataset
+files. Interactive REPL only. Confirm with y/N or \`--confirm\` one-shot.`
+      },
+      {
+        name: "deactivate-demo",
+        raw: `---
+name: deactivate-demo
+description: Disable demo data generators
+section: Admin
+args: [--confirm]
+handler: ../commands/deactivate-demo.ts
+hidden: true
+---
+
+Persistently disable demo generators (\`/ingest --demo\`, \`/new --demo\`, NL
+"use demo data"). Re-enable with \`/config set demo-enabled true\`.`
+      },
+      {
+        name: "reset",
+        raw: `---
+name: reset
+description: Clear all data and start fresh
+section: More
+args: [--force]
+handler: ../commands/reset.ts
+---
+
+Drop all rows from every table in the local DuckDB database. Requires
+\`--force\` to proceed.`
+      },
+      {
+        name: "playbook",
+        raw: `---
+name: playbook
+description: Show or extend recommended plays
+section: More
+args: [--vital-sign <name>] [play-id] | add
+handler: ../commands/playbook.ts
+---
+
+Show the playbook of recommended plays keyed to each vital sign. Pass a
+play-id to drill into a single play's steps and expected outcome. Run
+\`/playbook add\` and the analyst walks you through capturing a new play, step by
+step \u2014 no flags or quoting needed. Learned plays become recommendable during
+analysis. (Power users can still pass everything as flags in one shot.)`
+      },
+      {
+        name: "export",
+        raw: `---
+name: export
+description: Save diagnosis to Obsidian notes
+section: More
+args: [--dir <path>] [--segment <name>]
+handler: ../commands/export.ts
+---
+
+Write the most recent diagnosis to your configured notes directory as
+markdown, ready for Obsidian, Logseq, or any other note tool.`
+      },
+      {
+        name: "publish",
+        raw: `---
+name: publish
+description: Preview and propose repository exports
+section: More
+args: [preview|propose|targets] [--target markdown] [--dir <path>]
+handler: ../commands/publish.ts
+---
+
+Build a full repository export package from the latest diagnosis, findings,
+strategies, evidence, and action receipts. \`preview\` shows the write plan;
+\`propose\` creates an approval-gated action proposal. The first executable
+target is local markdown for Obsidian-compatible repositories. Notion,
+Airtable, and GitHub mappings are documented via \`/publish targets\`.`
+      },
+      {
+        name: "backmeup",
+        raw: `---
+name: backmeup
+description: Export diagnosis receipts as CSV
+section: More
+args: [--output <dir>]
+handler: ../commands/backmeup.ts
+---
+
+Export your latest diagnosis as a folder of CSV files you can attach to a
+Slack thread, email, or slide deck. Creates a timestamped folder under
+~/.ntrp/exports/ containing a cover sheet with headline numbers, a findings
+file, and per-vital-sign evidence CSVs showing exactly which deals, contacts,
+or orgs drove each score. Use --output <dir> to write somewhere else.`
+      },
+      {
+        name: "profile",
+        raw: `---
+name: profile
+description: Set sales motion
+section: Settings
+args: [list|set|show] [preset]
+handler: ../commands/profile.ts
+---
+
+Choose a sales motion preset (PLG, SMB Velocity, Mid-Market, Enterprise). Each
+preset adjusts the vital-sign thresholds to match your deal cycle.`
+      },
+      {
+        name: "connect",
+        raw: `---
+name: connect
+description: Connect an AI provider (paste any key)
+section: Settings
+args: [provider] [--key <key>] [--base-url <url> --id <name>]
+handler: ../commands/connect.ts
+---
+
+Paste any provider's API key \u2014 NTRP identifies the provider from the key
+format (probing ambiguous ones), validates it, discovers which models the key
+can use, and builds the HIGH/MEDIUM/LOW tier stack automatically.
+
+Works with Anthropic, OpenAI, Google Gemini, Groq, Mistral, DeepSeek, xAI,
+OpenRouter, Together, and Fireworks out of the box. \`/connect ollama\` wires a
+local Ollama; \`/connect --base-url <url> --id <name>\` registers any other
+OpenAI-compatible endpoint.`
+      },
+      {
+        name: "config",
+        raw: `---
+name: config
+description: Get/set config values
+section: Settings
+args: [get|set|list|delete] <key> [value]
+handler: ../commands/config.ts
+---
+
+Manage CLI configuration stored at \`~/.ntrp/config.json\`. Useful keys:
+\`api-key\` (Anthropic), \`openai-api-key\` (and \`groq-api-key\`, \`google-api-key\`, ...),
+\`llm-primary\` (default engine), \`llm-tier\`, \`llm-auto-failover\`,
+\`default-format\`, \`export-dir\`.
+
+Setting a provider key opens a hidden prompt and auto-discovers that
+provider's models. Prefer \`/connect\` \u2014 it detects the provider for you.`
+      },
+      {
+        name: "provider",
+        raw: `---
+name: provider
+description: Switch active LLM engine
+section: Settings
+args: [<id>|list|reset|save|failover on|off]
+handler: ../commands/provider.ts
+---
+
+Choose which connected engine answers this session \u2014 any provider added via
+\`/connect\` (anthropic, openai, groq, google, ollama, custom endpoints, ...).
+Session-scoped by default; \`/provider save\` writes the default to config.
+\`/provider failover on\` enables rate-limit auto-failover.`
+      },
+      {
+        name: "tier",
+        raw: `---
+name: tier
+description: Set inference tier (HIGH/MEDIUM/LOW)
+section: Settings
+args: [high|medium|low|list] [--default]
+handler: ../commands/tier.ts
+---
+
+Set quality/cost tier for this REPL session. Agentic surfaces respect your tier;
+some single-shot surfaces keep fixed defaults. \`/tier list\` highlights the
+active stack. Add \`--default\` to persist to config.`
+      },
+      {
+        name: "model",
+        raw: `---
+name: model
+description: Override the active LLM model
+section: Settings
+args: [list|set <id>|refresh|clear] [--default]
+handler: ../commands/model.ts
+---
+
+\`/model list\` shows the models discovered for the active engine with their
+tier assignments. \`/model refresh\` re-discovers the live list. \`/model set <id>\`
+pins a model on the **active engine**; cross-provider IDs are rejected \u2014
+switch with \`/provider\` first.`
+      },
+      {
+        name: "activate",
+        raw: `---
+name: activate
+description: Enter license key
+section: Settings
+args: <license>
+handler: ../commands/activate.ts
+---
+
+Activate NTRP with your license key (format: NTRP-XXXX-XXXX-XXXX). Most
+commands require a valid license.`
+      },
+      {
+        name: "upgrade",
+        raw: `---
+name: upgrade
+description: Upgrade trial to Pro \u2014 checkout + paste key
+section: Settings
+handler: ../commands/upgrade.ts
+---
+
+Open the Pro checkout page and paste your new license key without leaving
+the REPL. Use during trial grace or after cutoff. Flags: --url (print checkout URL only).`
+      },
+      {
+        name: "checkout",
+        raw: `---
+name: checkout
+description: Open signup checkout in your browser
+section: Settings
+handler: ../commands/checkout.ts
+---
+
+Opens the Lemon Squeezy checkout page in your default browser. Use anytime
+you need a trial or Pro license key.`
+      },
+      {
+        name: "feedback",
+        raw: `---
+name: feedback
+description: Correct your profile in plain English
+section: Settings
+args: <correction>
+handler: ../commands/feedback.ts
+---
+
+Apply natural-language corrections to your company profile. Maps structured
+fields when possible (e.g. "our sales cycle is 6 months" updates
+sales_cycle_days) and merges remaining nuances into a custom_context
+paragraph that flows into all AI surfaces.`
+      }
+    ];
+  }
+});
+
 // src/ai/prompt-parts.ts
 function buildCompanyProfileBlock() {
   const p = loadProfile();
@@ -8305,12 +9035,41 @@ function buildPlaybookBlock() {
 Learned plays (added from this team's experience and ingested case studies \u2014 recommend these when they fit):
 ${learned}`;
 }
-var ANALYST_INSTINCT_BLOCK, VITAL_SIGNS_BLOCK, PLAYBOOK_BLOCK, METRICS_BLOCK, FINDINGS_SCHEMA_BLOCK;
+function buildCommandCatalogBlock() {
+  const GROUP_ANALYSIS = "Analysis & data";
+  const GROUP_SESSION = "Session, memory & outputs";
+  const GROUP_SETTINGS = "Settings & providers";
+  const groupOrder = [GROUP_ANALYSIS, GROUP_SESSION, GROUP_SETTINGS];
+  const groupFor = (section) => {
+    if (section === "Hidden" || section === "Getting Started") return GROUP_ANALYSIS;
+    if (section === "Settings") return GROUP_SETTINGS;
+    return GROUP_SESSION;
+  };
+  const groups = new Map(groupOrder.map((label) => [label, []]));
+  for (const meta of listWorkflows(true)) {
+    if (meta.name === "ask") continue;
+    if (meta.section === "Admin") continue;
+    groups.get(groupFor(meta.section)).push(formatCatalogLine(meta));
+  }
+  groups.get(GROUP_SESSION).push(
+    "- /help \u2014 Show the shortcut list",
+    "- /home \u2014 Show the welcome dashboard and current session status"
+  );
+  return groupOrder.filter((label) => groups.get(label).length > 0).map((label) => `${label}:
+${groups.get(label).join("\n")}`).join("\n\n");
+}
+function formatCatalogLine(meta) {
+  const args = meta.args?.trim() ? ` ${meta.args.trim()}` : "";
+  const note = DESTRUCTIVE_COMMAND_NOTES[meta.name] ? ` (${DESTRUCTIVE_COMMAND_NOTES[meta.name]})` : "";
+  return `- /${meta.name}${args} \u2014 ${meta.description}${note}`;
+}
+var ANALYST_INSTINCT_BLOCK, VITAL_SIGNS_BLOCK, PLAYBOOK_BLOCK, DESTRUCTIVE_COMMAND_NOTES, METRICS_BLOCK, FINDINGS_SCHEMA_BLOCK;
 var init_prompt_parts = __esm({
   "src/ai/prompt-parts.ts"() {
     "use strict";
     init_profile();
     init_playbook();
+    init_registry();
     ANALYST_INSTINCT_BLOCK = `A search box returns numbers; a world-class analyst returns insight. The instincts below are what separate the two. Bring them PROACTIVELY \u2014 surface the connection, the chain, and the priority without waiting to be asked, because the user often doesn't know to ask.
 
 - ROOT CAUSE OVER SYMPTOM LIST. GTM problems are rarely independent \u2014 they're usually one failure wearing several masks. When two or more vital signs are red or yellow, your first instinct is to ask "is this the same underlying problem showing up in different places?" and, when it is, name the single cause. (Classic shape: a broken lead handoff starves reps of new pipeline \u2192 they work only what they can already see \u2192 everything else ages into stale, zombie deals \u2192 the forecast inflates with deals nobody is touching \u2192 the quarter is quietly at risk. One cause, four symptoms.)
@@ -8333,6 +9092,9 @@ Restraint matters: NTRP is a stethoscope, not a surgeon. Observe, connect, and r
 - "Fix the Handoff Gap" (id: fix-handoff-gap) \u2014 when drop_rate is high
 - "Retarget Misdirected Effort" (id: retarget-effort) \u2014 when signal_to_noise is low
 - "Unstick the Pipeline" (id: unstick-pipeline) \u2014 when flow_rate is low`;
+    DESTRUCTIVE_COMMAND_NOTES = {
+      reset: "destructive \u2014 wipes all data, requires --force"
+    };
     METRICS_BLOCK = `Revenue metrics measure GTM output \u2014 the standard SaaS metrics:
 - ARR: Total closed-won revenue. New ARR + Expansion ARR = growth; Churned + Contraction = leakage.
 - NRR (Net Revenue Retention): >100% means growing from existing customers. Best-in-class: 110%+.
@@ -13889,15 +14651,18 @@ function inferHandoffTarget(input) {
   return "plan";
 }
 function isShipIntent(input) {
-  return /\b(handoff|ship|deliver|board memo|export|turn this into|write.?up|action plan)\b/i.test(
-    input.trim()
-  );
+  const line = input.trim();
+  if (/\?\s*$/.test(line) || QUESTION_LEAD_RE.test(line)) return false;
+  return SHIP_INTENT_RE.test(line);
 }
+var QUESTION_LEAD_RE, SHIP_INTENT_RE;
 var init_handoff_draft = __esm({
   "src/conversation/handoff-draft.ts"() {
     "use strict";
     init_profile();
     init_session_analysis();
+    QUESTION_LEAD_RE = /^\s*(what|why|how|when|where|who|which|is|are|was|were|do|does|did|explain|tell me|help me understand)\b/i;
+    SHIP_INTENT_RE = /\b(ship|export|deliver|write[- ]?up|board memo|action plan|turn (this|it|that) into|(draft|create|make|build|prepare|generate|send)\s+(me\s+)?(a\s+|the\s+)?hand[- ]?off|hand[- ]?off\s+(prompt|doc|document|plan))\b/i;
   }
 });
 
@@ -14459,6 +15224,16 @@ FORMATTING (brief mode \u2014 scannable, not chunky):
 - No ### headings, no tables, no --- footer, no closing "want me to dig deeper?" question.
 - Single-point answers can stay one sentence \u2014 don't force bullets when one line is enough.
 `;
+  const commandStyleRule = responseMode === "brief" ? '- Style in brief mode: a suggestion is at most ONE short trailing line after your answer (e.g. "`/segment compare enterprise smb` gives the full side-by-side.") \u2014 no heading, no footer.' : "- Style: weave the suggestion naturally into your close \u2014 one sentence with the exact invocation in `inline code`.";
+  const commandSection = `PRESET COMMANDS (slash commands the user can type at the prompt \u2014 you may SUGGEST these; you have no ability to run them):
+${buildCommandCatalogBlock()}
+
+COMMAND SUGGESTION RULES (suggest-only):
+- Evaluate whether the user's question overlaps a preset command's capability. Answer the question yourself first, from tools and context; suggest a command only when it adds capability beyond your answer \u2014 writing files, opening a wizard, running a heavier analysis, or changing settings.
+- If the message is primarily a request to DO what a command does (e.g. "export this to my notes"), say plainly that you don't execute commands and give the exact invocation to type, e.g. \`/handoff notes\`.
+- Never claim a command was run. Never invent flags \u2014 use only the documented arguments above. At most ONE command suggestion per answer; most answers need none.
+- Only suggest a command that can work right now given the session state you know (e.g. no \`/diagnose\` or \`/export\` before data or a diagnosis exists).
+${commandStyleRule}`;
   const outputRules = responseMode === "brief" ? `OUTPUT RULES:
 - Respond in plain text markdown (not JSON). Lead sentence + bullets when helpful \u2014 never a dense paragraph wall.
 - Pull numbers from the completed session analysis or conversation history \u2014 never guess.
@@ -14482,6 +15257,8 @@ ${VITAL_SIGNS_BLOCK}
 
 PLAYBOOK \u2014 recommend these plays when appropriate:
 ${buildPlaybookBlock()}
+
+${commandSection}
 ${formattingSection}
 ${outputRules}`;
 }
@@ -14742,6 +15519,136 @@ var init_embeddings = __esm({
   }
 });
 
+// src/memory/retrieval.ts
+function tokenize(text) {
+  return text.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length >= 3 && !STOPWORDS.has(t));
+}
+function keywordRank(query, items, topK) {
+  const queryTokens = new Set(tokenize(query));
+  if (queryTokens.size === 0) {
+    return items.slice(-topK).reverse().map((it) => ({ id: it.id, score: 0 }));
+  }
+  const scored = items.map((it) => {
+    const tokens = tokenize(it.text);
+    if (tokens.length === 0) return { id: it.id, score: 0 };
+    let overlap = 0;
+    const seen = /* @__PURE__ */ new Set();
+    for (const t of tokens) {
+      if (queryTokens.has(t) && !seen.has(t)) {
+        overlap++;
+        seen.add(t);
+      }
+    }
+    return { id: it.id, score: overlap / Math.sqrt(tokens.length) };
+  });
+  const positive = scored.filter((s) => s.score > 0).sort((a, b) => b.score - a.score);
+  if (positive.length > 0) return positive.slice(0, topK);
+  return items.slice(-topK).reverse().map((it) => ({ id: it.id, score: 0 }));
+}
+function cosine(a, b) {
+  let dot = 0;
+  let na = 0;
+  let nb = 0;
+  const len = Math.min(a.length, b.length);
+  for (let i = 0; i < len; i++) {
+    dot += a[i] * b[i];
+    na += a[i] * a[i];
+    nb += b[i] * b[i];
+  }
+  if (na === 0 || nb === 0) return 0;
+  return dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+async function rankByRelevance(query, items, topK) {
+  if (items.length === 0) return [];
+  try {
+    const { isEmbeddingsEnabled: isEmbeddingsEnabled2, embedText: embedText2, embedItems: embedItems2 } = await Promise.resolve().then(() => (init_embeddings(), embeddings_exports));
+    if (isEmbeddingsEnabled2()) {
+      const queryVec = await embedText2(query);
+      if (queryVec) {
+        const withVecs = await embedItems2(items);
+        const scored = withVecs.filter((it) => it.embedding && it.embedding.length > 0).map((it) => ({ id: it.id, score: cosine(queryVec, it.embedding) })).sort((a, b) => b.score - a.score);
+        if (scored.length > 0) return scored.slice(0, topK);
+      }
+    }
+  } catch {
+  }
+  return keywordRank(query, items, topK);
+}
+var STOPWORDS;
+var init_retrieval = __esm({
+  "src/memory/retrieval.ts"() {
+    "use strict";
+    STOPWORDS = /* @__PURE__ */ new Set([
+      "the",
+      "and",
+      "for",
+      "are",
+      "was",
+      "were",
+      "with",
+      "that",
+      "this",
+      "from",
+      "have",
+      "has",
+      "had",
+      "our",
+      "your",
+      "you",
+      "what",
+      "which",
+      "how",
+      "why",
+      "who",
+      "when",
+      "where",
+      "into",
+      "about",
+      "over",
+      "than",
+      "then",
+      "they",
+      "them",
+      "their",
+      "there",
+      "here",
+      "been",
+      "being",
+      "does",
+      "did",
+      "doing",
+      "can",
+      "could",
+      "would",
+      "should",
+      "will",
+      "shall",
+      "may",
+      "might",
+      "must",
+      "not",
+      "but",
+      "all",
+      "any",
+      "some",
+      "more",
+      "most",
+      "much",
+      "many",
+      "very",
+      "just",
+      "like",
+      "out",
+      "off",
+      "per",
+      "via",
+      "use",
+      "get",
+      "got"
+    ]);
+  }
+});
+
 // src/strategies/readers.ts
 import { createHash } from "crypto";
 import { existsSync as existsSync15, readFileSync as readFileSync13 } from "fs";
@@ -14822,6 +15729,37 @@ var init_readers = __esm({
   }
 });
 
+// src/memory/knowledge.ts
+import { existsSync as existsSync16, readFileSync as readFileSync14, appendFileSync as appendFileSync3, readdirSync as readdirSync2 } from "fs";
+import { join as join13 } from "path";
+import { randomUUID as randomUUID4 } from "crypto";
+function knowledgePath() {
+  return join13(getMemoryDir(), KNOWLEDGE_FILE);
+}
+function loadKnowledgeChunks() {
+  const path = knowledgePath();
+  if (!existsSync16(path)) return [];
+  const out = [];
+  for (const line of readFileSync14(path, "utf-8").split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      out.push(JSON.parse(trimmed));
+    } catch {
+    }
+  }
+  return out;
+}
+var KNOWLEDGE_FILE;
+var init_knowledge = __esm({
+  "src/memory/knowledge.ts"() {
+    "use strict";
+    init_store();
+    init_readers();
+    KNOWLEDGE_FILE = "knowledge.jsonl";
+  }
+});
+
 // src/ai/strategy-normalize.ts
 function stripFences2(text) {
   const trimmed = text.trim();
@@ -15352,175 +16290,10 @@ var init_strategy = __esm({
   }
 });
 
-// src/investigation/verbosity-cli.ts
-init_context2();
-init_schema();
-
-// src/services/verbosity-investigation.ts
-init_context2();
-init_schema();
-init_agentic_loop();
-init_health_score();
-init_divergence();
-
 // src/memory/store.ts
-init_store();
 import { existsSync as existsSync17, readFileSync as readFileSync15, appendFileSync as appendFileSync4, readdirSync as readdirSync4, writeFileSync as writeFileSync11 } from "fs";
 import { join as join16 } from "path";
 import { randomUUID as randomUUID5 } from "crypto";
-
-// src/memory/retrieval.ts
-var STOPWORDS = /* @__PURE__ */ new Set([
-  "the",
-  "and",
-  "for",
-  "are",
-  "was",
-  "were",
-  "with",
-  "that",
-  "this",
-  "from",
-  "have",
-  "has",
-  "had",
-  "our",
-  "your",
-  "you",
-  "what",
-  "which",
-  "how",
-  "why",
-  "who",
-  "when",
-  "where",
-  "into",
-  "about",
-  "over",
-  "than",
-  "then",
-  "they",
-  "them",
-  "their",
-  "there",
-  "here",
-  "been",
-  "being",
-  "does",
-  "did",
-  "doing",
-  "can",
-  "could",
-  "would",
-  "should",
-  "will",
-  "shall",
-  "may",
-  "might",
-  "must",
-  "not",
-  "but",
-  "all",
-  "any",
-  "some",
-  "more",
-  "most",
-  "much",
-  "many",
-  "very",
-  "just",
-  "like",
-  "out",
-  "off",
-  "per",
-  "via",
-  "use",
-  "get",
-  "got"
-]);
-function tokenize(text) {
-  return text.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length >= 3 && !STOPWORDS.has(t));
-}
-function keywordRank(query, items, topK) {
-  const queryTokens = new Set(tokenize(query));
-  if (queryTokens.size === 0) {
-    return items.slice(-topK).reverse().map((it) => ({ id: it.id, score: 0 }));
-  }
-  const scored = items.map((it) => {
-    const tokens = tokenize(it.text);
-    if (tokens.length === 0) return { id: it.id, score: 0 };
-    let overlap = 0;
-    const seen = /* @__PURE__ */ new Set();
-    for (const t of tokens) {
-      if (queryTokens.has(t) && !seen.has(t)) {
-        overlap++;
-        seen.add(t);
-      }
-    }
-    return { id: it.id, score: overlap / Math.sqrt(tokens.length) };
-  });
-  const positive = scored.filter((s) => s.score > 0).sort((a, b) => b.score - a.score);
-  if (positive.length > 0) return positive.slice(0, topK);
-  return items.slice(-topK).reverse().map((it) => ({ id: it.id, score: 0 }));
-}
-function cosine(a, b) {
-  let dot = 0;
-  let na = 0;
-  let nb = 0;
-  const len = Math.min(a.length, b.length);
-  for (let i = 0; i < len; i++) {
-    dot += a[i] * b[i];
-    na += a[i] * a[i];
-    nb += b[i] * b[i];
-  }
-  if (na === 0 || nb === 0) return 0;
-  return dot / (Math.sqrt(na) * Math.sqrt(nb));
-}
-async function rankByRelevance(query, items, topK) {
-  if (items.length === 0) return [];
-  try {
-    const { isEmbeddingsEnabled: isEmbeddingsEnabled2, embedText: embedText2, embedItems: embedItems2 } = await Promise.resolve().then(() => (init_embeddings(), embeddings_exports));
-    if (isEmbeddingsEnabled2()) {
-      const queryVec = await embedText2(query);
-      if (queryVec) {
-        const withVecs = await embedItems2(items);
-        const scored = withVecs.filter((it) => it.embedding && it.embedding.length > 0).map((it) => ({ id: it.id, score: cosine(queryVec, it.embedding) })).sort((a, b) => b.score - a.score);
-        if (scored.length > 0) return scored.slice(0, topK);
-      }
-    }
-  } catch {
-  }
-  return keywordRank(query, items, topK);
-}
-
-// src/memory/knowledge.ts
-init_store();
-init_readers();
-import { existsSync as existsSync16, readFileSync as readFileSync14, appendFileSync as appendFileSync3, readdirSync as readdirSync2 } from "fs";
-import { join as join13 } from "path";
-import { randomUUID as randomUUID4 } from "crypto";
-var KNOWLEDGE_FILE = "knowledge.jsonl";
-function knowledgePath() {
-  return join13(getMemoryDir(), KNOWLEDGE_FILE);
-}
-function loadKnowledgeChunks() {
-  const path = knowledgePath();
-  if (!existsSync16(path)) return [];
-  const out = [];
-  for (const line of readFileSync14(path, "utf-8").split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    try {
-      out.push(JSON.parse(trimmed));
-    } catch {
-    }
-  }
-  return out;
-}
-
-// src/memory/store.ts
-var FACTS_FILE = "facts.jsonl";
-var LEDGER_FILE = "ledger.jsonl";
 function memPath(file) {
   return join16(getMemoryDir(), file);
 }
@@ -15637,14 +16410,19 @@ async function buildMemoryBlock(query, opts = {}) {
   }
   return sections.join("\n\n");
 }
-
-// src/services/verbosity-investigation.ts
-init_context2();
-init_phase();
+var FACTS_FILE, LEDGER_FILE;
+var init_store2 = __esm({
+  "src/memory/store.ts"() {
+    "use strict";
+    init_store();
+    init_retrieval();
+    init_knowledge();
+    FACTS_FILE = "facts.jsonl";
+    LEDGER_FILE = "ledger.jsonl";
+  }
+});
 
 // src/ai/thread.ts
-var DEFAULT_THREAD_CHAR_BUDGET = 24e3;
-var MIN_RECENT_MESSAGES = 6;
 function summarizeAssistantTurn(text, max = 360) {
   const plain = text.replace(/#{1,6}\s+/g, "").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/`([^`]+)`/g, "$1").replace(/^---\s*$/gm, "").replace(/\s+/g, " ").trim();
   if (plain.length <= max) return plain;
@@ -15658,7 +16436,6 @@ function summarizeAssistantTurn(text, max = 360) {
   const trimmed = out.trim();
   return trimmed.length > 0 ? trimmed : plain.slice(0, max).replace(/\s+\S*$/, "") + "\u2026";
 }
-var ASSISTANT_SUMMARIZE_THRESHOLD = 420;
 function mergeConsecutive(messages) {
   const out = [];
   for (const message of messages) {
@@ -15712,6 +16489,58 @@ function boundConversation(messages, charBudget = DEFAULT_THREAD_CHAR_BUDGET) {
 function distillThread(rawMessages, charBudget = DEFAULT_THREAD_CHAR_BUDGET) {
   return boundConversation(compactConversation(rawMessages), charBudget);
 }
+var DEFAULT_THREAD_CHAR_BUDGET, MIN_RECENT_MESSAGES, ASSISTANT_SUMMARIZE_THRESHOLD;
+var init_thread = __esm({
+  "src/ai/thread.ts"() {
+    "use strict";
+    DEFAULT_THREAD_CHAR_BUDGET = 24e3;
+    MIN_RECENT_MESSAGES = 6;
+    ASSISTANT_SUMMARIZE_THRESHOLD = 420;
+  }
+});
+
+// src/ai/explore-mode.ts
+function isDeepDiveQuestion(question) {
+  return DEEP_DIVE_PATTERNS.some((p) => p.test(question.trim()));
+}
+function resolveExploreResponseMode(question, ctx, priorTurnCount) {
+  if (isDeepDiveQuestion(question)) return "deep";
+  if (isAnalysisReady(ctx)) return "brief";
+  if (ctx.stage === "analyzed" || ctx.analysis.completed.length > 0) return "brief";
+  if (priorTurnCount === 0) return "deep";
+  return "brief";
+}
+function parsePromptExperiment(raw) {
+  if (!raw || raw === "production") return "production";
+  if (raw === "baseline" || raw === "a" || raw === "b" || raw === "c") return raw;
+  return "production";
+}
+var DEEP_DIVE_PATTERNS;
+var init_explore_mode = __esm({
+  "src/ai/explore-mode.ts"() {
+    "use strict";
+    init_context2();
+    DEEP_DIVE_PATTERNS = [
+      /\b(break down|breakdown|drill|dig deeper|show me|list all|by rep|by stage|by segment|query|sql|detail|expand|elaborate|full analysis|walk me through|pull up|give me the data)\b/i,
+      /\b(how many|which deals|which accounts|who owns|top \d+|every deal|all stuck)\b/i
+    ];
+  }
+});
+
+// src/investigation/verbosity-cli.ts
+init_context2();
+init_schema();
+
+// src/services/verbosity-investigation.ts
+init_context2();
+init_schema();
+init_agentic_loop();
+init_health_score();
+init_divergence();
+init_store2();
+init_context2();
+init_phase();
+init_thread();
 
 // src/ai/verbosity-metrics.ts
 function analyzeAnswerText(text) {
@@ -15744,29 +16573,8 @@ function formatInvestigationTable(rows) {
   return [header, ...lines].join("\n");
 }
 
-// src/ai/explore-mode.ts
-init_context2();
-var DEEP_DIVE_PATTERNS = [
-  /\b(break down|breakdown|drill|dig deeper|show me|list all|by rep|by stage|by segment|query|sql|detail|expand|elaborate|full analysis|walk me through|pull up|give me the data)\b/i,
-  /\b(how many|which deals|which accounts|who owns|top \d+|every deal|all stuck)\b/i
-];
-function isDeepDiveQuestion(question) {
-  return DEEP_DIVE_PATTERNS.some((p) => p.test(question.trim()));
-}
-function resolveExploreResponseMode(question, ctx, priorTurnCount) {
-  if (isDeepDiveQuestion(question)) return "deep";
-  if (isAnalysisReady(ctx)) return "brief";
-  if (ctx.stage === "analyzed" || ctx.analysis.completed.length > 0) return "brief";
-  if (priorTurnCount === 0) return "deep";
-  return "brief";
-}
-function parsePromptExperiment(raw) {
-  if (!raw || raw === "production") return "production";
-  if (raw === "baseline" || raw === "a" || raw === "b" || raw === "c") return raw;
-  return "production";
-}
-
 // src/services/verbosity-investigation.ts
+init_explore_mode();
 init_session_analysis();
 init_agentic_loop();
 var FOLLOW_UP_QUESTIONS = [
@@ -15895,6 +16703,7 @@ ${turn.answer}`;
 }
 
 // src/investigation/verbosity-cli.ts
+init_explore_mode();
 function runUnitChecks() {
   const verbose = analyzeAnswerText(`### Risk