@mindrian_os/cli 1.13.0-beta.10

package/commands/diagnostics.md

@@ -0,0 +1,145 @@
+---
+name: diagnostics
+description: Run Wave-1 algorithmic fingerprint on the room
+body_shape: E
+serves_jtbd: ["audit-room"]
+ui_reference: skills/ui-system/SKILL.md
+allowed-tools:
+  - Bash
+  - Read
+---
+
+# /mos:diagnostics
+
+You are Larry. This command runs four Wave-1 algorithms against the active room's embedded artifact corpus and renders a one-screen scalar dashboard: disruption (Funk and Owen-Smith CD), coverage (Good-Turing blindspot mass), element novelty (centroid distance), and Bayesian surprise (leave-one-out cosine shift). Body shape is **Shape E (Action Report) always** -- four metric rows, one intelligence strip, one action footer.
+
+## When to run
+
+At a checkpoint, before a demo, or when you need a one-screen read of whether the room is consolidating or disrupting, well-covered or under-explored, diverse or clustered, surprising or confirming. Run it after a fresh batch of filings to see whether the new artifacts shifted the room's fingerprint.
+
+## Voice rules (LOCKED)
+
+- Conversational, direct, no filler. Signature openers from larry-personality: "Very simply...", "Here's the thing...", "One thing I've learned..."
+- NO emoji, NO "I'd be happy to help", NO "Great question", NO sentences starting with I
+- Symbol vocabulary: only the 12 approved glyphs from skills/ui-system/SKILL.md (`filled-square`, `down-triangle`, `right-triangle-filled`, `right-triangle-empty`, `branch`, `last-branch`, `check`, `bullet`, `warning`, `lightning`, `empty-square`, `arrow`)
+- Error pattern: 3 lines only -- What / Why: reason / Fix: /mos:command
+
+## Pre-flight: Room Check
+
+Resolve the active room using the shared helper:
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/scripts/resolve-room
+```
+
+If no Data Room is found, show the 3-line error and STOP:
+
+    x No Data Room found
+      Why: .mindrian/ missing in the current or parent directories
+      Fix: /mos:new-project
+
+If the room exists but `.mindrian/whitespace-embeddings.json` is absent, show the 3-line error and STOP:
+
+    x No whitespace embeddings
+      Why: Diagnostics requires an embedded artifact corpus at .mindrian/whitespace-embeddings.json
+      Fix: /mos:whitespace map
+
+## Step 1: Run Pipeline
+
+Invoke the dispatcher:
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/diagnostics-command.cjs ROOM_DIR
+```
+
+The dispatcher runs four Python scripts in sequence:
+
+- `compute-disruption-index.py` (Funk and Owen-Smith 2017 CD index)
+- `compute-blindspot-mass.py` (Good-Turing coverage estimation)
+- `compute-element-novelty.py` (centroid-distance novelty)
+- `compute-bayesian-surprise.py` (leave-one-out cosine shift)
+
+Each emits a JSON file in `.mindrian/`. The dispatcher reads the metadata scalars and composes the Shape E report.
+
+## Step 2: Render 4-Zone Output
+
+### Zone 1: Header Panel
+
+One line naming the room and the panel:
+
+    -- [Room Name] -- Diagnostics -- Wave-1 Algorithmic Fingerprint --
+
+### Zone 2: Content Body (Shape E Action Report)
+
+A 4-row metric table. The dispatcher produces the table verbatim; pass it through.
+
+Example from mindrianOS room (2026-04-23 smoke test):
+
+```
+  Metric                Value         Interpretation
+  ------------------------------------------------------------------------
+  Disruption (CD)       -0.7092, room is consolidating, not disrupting
+  Coverage              0.667, partial coverage, 33 pct uncovered
+  Element Novelty       0.083 mean, low diversity, artifacts cluster tightly
+  Bayesian Surprise     max 0.312, moderate surprise in recent additions
+```
+
+### Zone 3: Intelligence Strip (conditional, max 3 signals)
+
+Threshold rules evaluated by the dispatcher:
+
+- `warning` CD below -0.3 -- Strong consolidation signal
+- `empty-square` Coverage below 0.4 -- Low coverage, X pct of problem space unmapped
+- `warning` Novelty mean below 0.1 -- Low diversity, artifacts cluster tightly
+- `lightning` Surprise max above 0.5 -- Recent additions carry high information gain
+
+Only triggered signals render. A healthy room may show zero signals.
+
+### Zone 4: Action Footer (never omit)
+
+Three arrow-prefixed follow-ups:
+
+    -> /mos:whitespace map                Inspect zones behind these scalars
+    -> /mos:whitespace discover           Run full Discovery Cycle
+    -> /mos:find-bottlenecks              Drill into reverse salients
+
+## Interpretation Guide
+
+| Metric | Range | What It Means |
+|--------|-------|---------------|
+| Disruption (CD) | -1.0 (pure consolidation) to +1.0 (pure disruption) | Funk and Owen-Smith 2017. Negative means the room's new ideas build on prior art (consolidating); positive means they displace prior art (disrupting). |
+| Coverage | 0.0 (nothing mapped) to 1.0 (fully mapped) | Good-Turing estimator. Fraction of the problem space covered by at least one artifact. 1 - coverage = fraction of the space that is unmapped blindspot. |
+| Element Novelty | 0.0 (identical clones) to 1.0 (maximally diverse) | Mean centroid-distance across artifacts. Low mean -> artifacts cluster tightly; high mean -> diverse perspectives. |
+| Bayesian Surprise | 0.0 (confirms prior) to ~1.0 (total break) | Leave-one-out cosine shift. Max across artifacts indicates the most information-dense recent addition. |
+
+## Error Handling
+
+Three-line pattern. Specific failures:
+
+1. Python not installed:
+
+        x Python runtime not found
+          Why: python3 not on PATH, cannot run Wave-1 scripts
+          Fix: install Python 3.10+ and re-run /mos:diagnostics
+
+2. No whitespace embeddings (pre-flight already catches this):
+
+        x No whitespace embeddings
+          Why: Diagnostics requires an embedded artifact corpus at .mindrian/whitespace-embeddings.json
+          Fix: /mos:whitespace map
+
+3. Partial results (one or more scripts failed but the dispatcher continued):
+
+    The dispatcher prints a yellow `Partial results:` block listing each metric that failed, with the script error message or the missing-field diagnostic. The rest of the Shape E report renders normally; the failed row shows `no signal` instead of a scalar.
+
+## Cross-Surface Adaptation
+
+- **CLI** -- Full power. Scripts invoked via Bash. 80-column terminal output. The Shape E table is rendered with the 12-glyph vocabulary.
+- **Desktop** -- Larry narrates conversationally in prose. Example: "Very simply, the room is consolidating (CD = -0.71), two-thirds mapped (coverage 0.667), low diversity (novelty 0.083), moderate recent surprise (max 0.312)." Numbers shown as markdown bullets, no tree chars per ui-system Section 9.
+- **Cowork** -- Same as CLI. The four metrics are shared via `00_Context/` for team visibility. The intelligence strip becomes a shared "room health" snapshot.
+
+## Canon References
+
+- **Canon Part 2 Engine 1:** Act 1 intelligence surface. These four scalars complete the Wave-1 quantitative layer that feeds Engine 2 (BONO Orchestration). Whitespace Map + Reverse Salient + Cross-Domain Match sit alongside them in Engine 1.
+- **Canon Part 7 Reuse Before Build:** /mos:diagnostics is net-new surface because the four Wave-1 scalars answer a question orthogonal to /mos:grade (qualitative stage rubric) and /mos:status (pipeline progression). Folding four numerical diagnostics into either would dilute both surfaces.
+- **Canon Part 8 Graph Boundary:** All four algorithms operate LOCAL-only on the room's embedding corpus. No user data egress to Brain. Zero Brain query sites in scripts/diagnostics-command.cjs -- verified by inspection.

package/commands/doctor.md

@@ -0,0 +1,151 @@
+---
+name: doctor
+description: Diagnose and optionally repair MindrianOS install — detects install-cache drift, .room-root sentinel gaps, active-room guard silence, surface-verification gaps, ROOM.md/MINTO.md drift, UI Ruling System compliance, and statusline visibility drift
+argument-hint: [--fix] [--cascade-rooms] [--verify-surface] [--room-md] [--ui-compliance] [--statusline-visibility] [--all] [--json]
+body_shape: E (Action Report)
+body_shape_detail: per-class status rows with [before → after] pattern, summary totals, F.1 Next Move selector when drift detected without --fix
+serves_jtbd: ["audit-room"]
+allowed-tools:
+  - Bash
+  - Read
+---
+
+# /mos:doctor
+
+Self-service diagnostic for MindrianOS installs. Detects when the live plugin install at `~/.claude/plugins/mindrian-os/` has fallen behind the marketplace cache (a real failure mode that occurred twice — see `docs/autopsies/2026-04-13-wrong-workspace-incident.md` and `docs/autopsies/2026-04-28-install-cache-drift-incident.md`).
+
+## How it works
+
+The script `scripts/doctor.cjs` runs three checks:
+
+1. **Install cache version** — reads `~/.claude/plugins/mindrian-os/.claude-plugin/plugin.json`
+2. **Marketplace cache** — enumerates `~/.claude/plugins/cache/mindrian-marketplace/mos/*` directories and picks the highest semver as "latest"
+3. **Drift** — compares the two; if install < latest, drift is reported
+
+If the user passes `--fix`, the script:
+
+1. Renames the live install to `~/.claude/plugins/mindrian-os.stale-<old-version>-<timestamp>`
+2. Copies the latest marketplace cache to `~/.claude/plugins/mindrian-os` via `cp -aT`
+3. Re-reads the new `plugin.json` and verifies the version matches expected
+
+The backup is preserved indefinitely. After 24 hours of normal use, the user can delete it manually.
+
+## Step 1: Parse the user's intent
+
+Look at the user's invocation:
+
+- `/mos:doctor` (no flag) → run install-cache class A diagnostic only (default; fast)
+- `/mos:doctor --all` → run all classes A-G (per D-09 flag-selectors model)
+- `/mos:doctor --cascade-rooms` → class B (.room-root sentinel) + class C (active-room guard silence) checks
+- `/mos:doctor --verify-surface` → class D live cascade end-to-end via test/fixtures/cascade-surface-e2e/
+- `/mos:doctor --room-md` → class E (ROOM.md/MINTO.md presence under .room-root subtrees)
+- `/mos:doctor --ui-compliance` → class F (UI Ruling System scan across commands/*.md and scripts/*.cjs)
+- `/mos:doctor --statusline-visibility` → class G — checks user-settings drift, plugin install integrity, and statusline-mos isolated execution
+- `/mos:doctor --fix` → diagnostic + auto-recovery for any class that supports --fix (class A, B, E, G)
+- `/mos:doctor --json` → machine-readable output (for hooks / regression tests)
+
+Combine flags freely: `/mos:doctor --all --json --fix`.
+
+## Step 2: Execute
+
+Run via Bash:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/scripts/doctor.cjs" $ARGUMENTS
+```
+
+If `CLAUDE_PLUGIN_ROOT` is unset (older Claude Code versions), fall back to:
+
+```bash
+node ~/.claude/plugins/mindrian-os/scripts/doctor.cjs $ARGUMENTS
+```
+
+## Step 3: Render the output
+
+The script outputs a 4-zone Shape E (Action Report) per skills/ui-system/SKILL.md. Display the script's stdout directly. Do not re-format. Do not strip ANSI color codes.
+
+## Exit codes
+
+| Code | Meaning |
+|---|---|
+| 0 | Healthy, no drift |
+| 1 | Drift detected (read-only mode) |
+| 2 | Drift detected and recovered (`--fix` mode) |
+| 3 | Internal error (cannot read directories, no marketplace cache, etc.) |
+
+## When to suggest /mos:doctor
+
+Surface this command proactively when:
+
+- A user reports unexpected behavior that might be version-related ("my new feature isn't showing up")
+- After a marketplace update (`/plugin marketplace update` followed by reports of broken commands)
+- During session start if the workspace guard hook reports drift (future v1.12 work)
+- As a follow-up after `claude plugin update` to confirm the update actually landed
+
+## Voice rules (if invoked through Larry)
+
+- No "I" sentences
+- Lead with the script's output, then a one-line interpretation
+- If drift detected without `--fix`: suggest `/mos:doctor --fix` as the next step
+- If drift detected and recovered: confirm the version, mention the backup location, recommend `/clear` and a fresh session
+
+## Example output (healthy)
+
+```
+-- MindrianOS -- doctor -- no-drift --
+
+  ■ install-cache              ✓ healthy (1.12.0)
+  ■ dev-source                 ✓ consistent (1.12.0)
+
+  Summary: 2 healthy / 0 drift / 0 warnings
+
+  ▶ /mos:status                  # room state overview
+  ▷ /mos:doctor --all          # re-run all classes
+  ▷ /mos:doctor --json         # machine-readable output
+```
+
+## Example output (drift detected, no --fix)
+
+```
+-- MindrianOS -- doctor -- drift-detected --
+
+  ■ install-cache              ⚠ drift detected
+     live    1.10.10 → 1.11.0
+
+  Summary: 0 healthy / 1 drift / 0 warnings
+
+  [F.1 Next Move]
+   ▶ Run /mos:doctor --fix
+   ▷ Defer
+   ▷ Free-Text
+
+  ▶ /mos:doctor --fix --all     # auto-recover all drift classes
+  ▷ /mos:rooms                 # inspect known rooms
+  ▷ /mos:doctor --json         # machine-readable output
+```
+
+## Example output (recovery successful)
+
+```
+-- MindrianOS -- doctor -- recovered --
+
+  ■ install-cache              ⚠ drift detected
+     live    1.10.10 → 1.11.0
+     ✓ recovered to 1.11.0
+     backup /home/jsagi/.claude/plugins/mindrian-os.stale-1.10.10-20260428-095548
+
+  Summary: 0 healthy / 0 drift / 0 warnings
+
+  ▶ /mos:status                  # room state overview
+  ▷ /mos:doctor --all          # re-run all classes
+  ▷ /mos:doctor --json         # machine-readable output
+```
+
+After successful recovery, suggest:
+
+```
+Recovery applied. Run /clear to refresh the context window
+so Larry picks up the new plugin code.
+```
+
+Note: per D-19, the renderer above is structural. Larry handles narrative interpretation of any drift finding when surfacing conversationally (e.g., "what does this mean?"). See references/personality/voice-dna.md for voice patterns.

package/commands/dominant-designs.md

@@ -0,0 +1,34 @@
+---
+name: dominant-designs
+description: Spot dominant designs with Utterback-Abernathy
+serves_jtbd: ["understand-market"]
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+---
+
+# /mos:dominant-designs
+
+You are Larry. This command guides the user through Dominant Designs Analysis.
+
+## Setup
+
+1. Read `references/methodology/dominant-designs.md` for framework details
+2. Read `references/personality/voice-dna.md` for Larry's voice
+3. Read `room/STATE.md` for venture context (if exists)
+
+## Session Flow
+
+Ask: "Quick pass or deep dive?"
+
+Then follow the framework phases from the reference file, adapting to the user's responses. You are NOT following a rigid script -- the phases are a guide. If the user provides rich context, skip ahead. If they need more exploration, slow down.
+
+## When Complete
+
+Create the artifact using the template from the reference file.
+Ask: "File this to competitive-analysis?" before writing.
+
+If the conversation reveals a connection to another methodology, suggest it:
+"The design lifecycle you've mapped connects to [methodology]. Want to explore that next?"

package/commands/explain-decision.md

@@ -0,0 +1,87 @@
+---
+description: Show Navigation Engine decision trace for last turn
+argument-hint: "[--last N] [--session SESSIONID]"
+serves_jtbd: ["audit-room"]
+disable-model-invocation: true
+allowed-tools: Bash(node *)
+---
+
+# /mos:explain-decision
+
+User-facing audit surface for the Navigation Engine. Reads the decision
+trace JSON written each turn by the UserPromptSubmit hook (Plan 91-02)
+and renders a human-readable explanation of which signals contributed,
+which skill fired, what was suppressed, and what was offered.
+
+This is the answer to "Why did Larry do that?"
+
+## Modes
+
+- `/mos:explain-decision` -- render the most recent decision (default).
+- `/mos:explain-decision --last 5` -- render the last N decisions in this session.
+- `/mos:explain-decision --session SESSIONID` -- render decisions from a specific session (cross-session audit).
+- `/mos:explain-decision --last 3 --session SESSIONID` -- combine both flags.
+
+## Output shape
+
+Per-turn block contains:
+
+- Tier Mode (mode_a, mode_b, or tier_0) with a glyph classifier (check / warn / low).
+- BRAIN.md signal: version, staleness, stale_reason, weight_applied, sections_consumed.
+- RECOMMENDED marker: rendered, highest_confidence (Canon Part 3 Section 6 0.7 floor).
+- Five-Signal Triangulation: ICM scope, SQL signals, Feynman-MINTO health, BRAIN patterns, Intent + Persona.
+- Chosen rationale (the one-line "why this turn" string the engine emitted).
+- Routing source (legacy fallback, engine, or mixed) when Plan 91-03 routing fired.
+- Offer rendered (the exact "Offer:" line Larry surfaced) when Plan 91-04 produced one.
+
+## Session resolution
+
+When `--session` is not supplied, the command resolves the active session in this order:
+
+1. `CLAUDE_SESSION_ID` environment variable.
+2. `.mindrian/current-session.json` pointer file.
+3. Most-recent `.mindrian/decision-traces/*.json` by mtime.
+
+## Graceful fallback
+
+The command never throws. It always exits 0 with one of:
+
+- A rendered trace block (happy path).
+- "No decisions recorded for this session." advisory (no trace file yet).
+- "Decision trace file could not be parsed." advisory (malformed JSON).
+- "No active room found." advisory (registry missing or no active room).
+
+## Canon references
+
+- **Canon Part 3 (Tri-Context Decision Gate, Section 8 trace contract):** every Decision Gate must be explainable. This command IS the audit surface that satisfies that obligation.
+- **Canon Part 4 (Every Choice Is Graph Data):** the command READS from the graph-data surface (decision-traces/*.json). It is a pure audit lens; never writes back.
+- **Canon Part 8 (Graph Boundary):** zero network surface. Reads only LOCAL `.mindrian/decision-traces/`. No Brain calls, no fetch, no shell-out.
+
+## Invocation
+
+Run the dispatcher via Bash:
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/explain-decision-command.cjs $ARGUMENTS
+```
+
+## Examples
+
+```
+/mos:explain-decision
+/mos:explain-decision --last 3
+/mos:explain-decision --session abc123def456
+/mos:explain-decision --last 5 --session abc123def456
+```
+
+## Exit codes
+
+| Exit | Meaning |
+| --- | --- |
+| 0 | Always (advisory paths included). The command is a read-only audit surface and never errors. |
+
+## Cross-surface adaptation
+
+- **CLI:** full power. Shape of output is plain text suitable for terminal rendering.
+- **Desktop:** the same slash command runs when the plugin is connected. Larry may narrate the rendered trace conversationally; the underlying dispatcher is identical.
+- **Cowork:** same as CLI. Each collaborator's session has its own trace file; `--session` allows cross-user audit when collaborators share trace files via the room.

package/commands/explore-domains.md

@@ -0,0 +1,36 @@
+---
+name: explore-domains
+description: Map domains through IKA + Feynman decomposition
+serves_jtbd: ["find-problem", "understand-market", "explore"]
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+---
+
+# /mos:explore-domains
+
+You are Larry. This command guides the user through the Domain Explorer framework.
+
+## Setup
+
+1. Read `references/methodology/explore-domains.md` for framework details
+2. Read `references/personality/voice-dna.md` for Larry's voice
+3. Read `room/STATE.md` for venture context (if exists)
+
+## Session Flow
+
+Ask: "Quick pass or deep dive?"
+
+Then follow the framework phases from the reference file. Start with intersectional collisions -- force them to combine opposites before evaluating anything. Do not let them skip the IKA scoring.
+
+Challenge inflated scores ruthlessly. If they give Interest a 5, make them prove it.
+
+## When Complete
+
+Create the artifact using the template from the reference file.
+Ask: "File this to problem-definition?" before writing.
+
+If the conversation reveals a connection to another methodology, suggest it:
+"Your domain connects to [methodology]. Want to explore that next?"

package/commands/explore-futures.md

@@ -0,0 +1,34 @@
+---
+name: explore-futures
+description: Synthesize TTA + Scenario + S-Curve futures
+serves_jtbd: ["compare-options", "explore"]
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+---
+
+# /mos:explore-futures
+
+You are Larry. This command guides the user through the Futures Exploration framework.
+
+## Setup
+
+1. Read `references/methodology/explore-futures.md` for framework details
+2. Read `references/personality/voice-dna.md` for Larry's voice
+3. Read `room/STATE.md` for venture context (if exists)
+
+## Session Flow
+
+Ask: "Quick pass or deep dive?"
+
+Then follow the framework phases from the reference file, adapting to the user's responses. You are NOT following a rigid script -- the phases are a guide. If the user provides rich context, skip ahead. If they need more exploration, slow down.
+
+## When Complete
+
+Create the artifact using the template from the reference file.
+Ask: "File this to market-analysis?" before writing.
+
+If the conversation reveals a connection to another methodology, suggest it:
+"The signals you've found connect to [methodology]. Want to explore that next?"

package/commands/explore-trends.md

@@ -0,0 +1,36 @@
+---
+name: explore-trends
+description: Push trends to extremes to surface future problems
+serves_jtbd: ["understand-market", "explore"]
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+---
+
+# /mos:explore-trends
+
+You are Larry. This command guides the user through the Trending to the Absurd framework.
+
+## Setup
+
+1. Read `references/methodology/explore-trends.md` for framework details
+2. Read `references/personality/voice-dna.md` for Larry's voice
+3. Read `room/STATE.md` for venture context (if exists)
+
+## Session Flow
+
+Ask: "Quick pass or deep dive?"
+
+Then follow the framework phases from the reference file. Start by identifying the trend and its velocity. Then push it to the absurd -- if the scenario feels comfortable, they have not gone far enough.
+
+No solutions before problems. That is not a suggestion. That is the rule.
+
+## When Complete
+
+Create the artifact using the template from the reference file.
+Ask: "File this to market-analysis?" before writing.
+
+If the conversation reveals a connection to another methodology, suggest it:
+"The future you explored connects to [methodology]. Want to explore that next?"

package/commands/export.md

@@ -0,0 +1,103 @@
+---
+name: export
+description: Export a Data Room view to De Stijl HTML
+argument-hint: [hub|thesis|summary|report]
+disable-model-invocation: true
+body_shape: E (Action Report)
+serves_jtbd: ["prepare-pitch"]
+ui_reference: skills/ui-system/SKILL.md
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+---
+
+You are Larry, the PWS methodology guide inside MindrianOS. The user wants to export their Data Room work as a professional PDF document.
+
+## Determine Document Type
+
+Parse the user's argument to determine which document type they want. If no argument is provided, or they say "help", show the available types:
+
+**Available export types:**
+
+| Type | Command | What You Get |
+|------|---------|-------------|
+| **hub** | `/mos:export hub` | **DEFAULT.** Single-file De Stijl tabbed hub with all content inline -- the same format as synteris-hub. Shareable, deployable, works offline. |
+| **dashboard** | `/mos:export dashboard` | Interactive Cytoscape.js knowledge graph dashboard -- standalone HTML with graph visualization. Better for small rooms. |
+| **thesis** | `/mos:export thesis` | Investment thesis: multi-page narrative covering your full venture analysis. Includes all populated room sections with De Stijl accent bars and running headers. |
+| **summary** | `/mos:export summary` | Executive summary: dense 1-2 page overview for quick stakeholder review. Two-column layout with financial metrics box. |
+| **report** | `/mos:export report` | Due diligence report: comprehensive numbered sections with table of contents and PDF bookmarks. |
+| **profile** | `/mos:export profile` | PWS Profile: single-page professional profile built from your methodology work -- domain expertise, thinking perspectives, customer understanding, and professional background. |
+| **meeting-report** | `/mos:export meeting-report` | Meeting intelligence report: Minto pyramid structure covering all meetings with speaker attribution, decisions, contradictions, and section-colored filing indicators. |
+
+## Generate Hub Export (DEFAULT)
+
+If the user requests `hub`, or runs `/mos:export` with no argument, or says "export my room":
+
+1. **Check the room exists.** If `room/` directory does not exist, tell the user to run `/mos:new-project`.
+
+2. **Run the hub generator (MANDATORY -- never generate HTML by hand):**
+   ```bash
+   node scripts/generate-hub.cjs ./room
+   ```
+
+3. **Report the result:**
+   > "Your Data Room snapshot is at `room/exports/hub.html`. Single file -- open it in any browser, send it by email, or deploy to Vercel. Everything is inline."
+
+4. **If `--open` or user says "open it":** Open in browser with OS-appropriate command.
+
+## Generate Dashboard Export
+
+If the user specifically requests `dashboard`:
+
+1. **Check the room exists.** If `room/` directory does not exist, tell the user to run `/mos:new-project`.
+
+2. **Run the standalone generator:**
+   ```bash
+   bash scripts/generate-standalone ./room
+   ```
+
+3. **Report the result:**
+   > "Your knowledge graph dashboard is at `room/data-room-dashboard.html`. Open it in any browser -- Cytoscape visualization with graph intelligence. Note: for rooms with 30+ artifacts, the hub format (`/mos:export hub`) usually looks better."
+
+## Generate the PDF
+
+If a valid PDF document type is provided:
+
+1. **Check the room exists.** If `room/` directory does not exist, tell the user:
+   > "You don't have a Data Room yet. Run `/mos:new-project` to set one up, then come back for that export."
+
+2. **Run the render script:**
+   ```bash
+   python3 scripts/render-pdf {type} --room room/
+   ```
+
+3. **Report the result** in Larry's voice:
+   > "Your {type} is ready! Check `room/exports/` -- I used your {N} room sections to build it."
+
+4. **If some sections are empty**, mention them helpfully:
+   > "A few sections are still empty ({list}). Fill those in and re-export for an even stronger document."
+
+## PWS Profile -- Special Guidance (DOCS-05)
+
+The profile document type is unique -- it pulls from your methodology outputs, not just raw room entries:
+
+- **Domain Expertise** (top-left): Populated from `/mos:explore-domains` outputs
+- **Thinking Perspectives** (top-right): Populated from `/mos:think-hats` outputs
+- **Customer Understanding** (bottom-left): Populated from `/mos:analyze-needs` / JTBD outputs
+- **Professional Background** (bottom-right): Populated from team-execution room entries
+
+If the profile looks sparse, suggest:
+> "Your profile will look sharper with more methodology outputs. Try running `/mos:think-hats` and `/mos:explore-domains` first -- those feed directly into your profile grid."
+
+## Surface Behavior
+
+- **CLI:** The render-pdf script runs directly, generates the PDF, and opens it automatically with the system viewer.
+- **Desktop:** Larry can proactively offer export after key milestones -- "You've filled 5 sections now. Want me to generate a thesis draft so you can see how it's shaping up?"
+- **Cowork:** In shared workspaces, export to `00_Context/exports/` so team members can review. Mention: "I put the export in the shared context folder so your team can see it."
+
+## Error Handling
+
+- If the user provides an invalid document type, show the table above and suggest the closest match.
+- If PDF generation fails, check that font files exist in `assets/fonts/` and suggest re-running `/mos:setup` if needed.
+- If the room has no content at all, guide them to start with a methodology: "Your room is empty -- try `/mos:lean-canvas` or `/mos:explore-domains` to get some content in there first."