claude-presentation-master 1.0.2 → 2.1.1

package/README.md

@@ -5,22 +5,33 @@
 ![NPM Version](https://img.shields.io/npm/v/claude-presentation-master)
 ![Downloads](https://img.shields.io/npm/dm/claude-presentation-master)
 ![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)
+![Zero Cost](https://img.shields.io/badge/cost-FREE-success)
 
-### Turn your Claude projects into polished presentations — instantly.
+### World-Class Presentations from Any Content — Zero Cost, Zero API Keys
 
-You've been working in Claude on a business project. Strategy docs, research, analysis, plans.
-Now someone asks for a presentation. **This is usually where things get painful.**
-
-Not anymore.
+**7 Presentation Types • Expert Methodologies • QA Validation • Auto-Remediation**
 
 [Install Now](#installation) •
 [See It Work](#quick-start) •
-[What's Inside](#the-knowledge-base)
+[Presentation Types](#7-presentation-types) •
+[Expert Knowledge](#the-knowledge-base)
 
 </div>
 
 ---
 
+## What's New in v2.1.0
+
+- **7 Specialized Presentation Types** — TED Keynote, Sales Pitch, Consulting Deck, Investment Banking, Investor Pitch, Technical Presentation, All Hands
+- **Strategy Pattern Architecture** — Each type uses its own expert methodology (Duarte for keynotes, Minto for consulting, etc.)
+- **Investment Banking Charts** — Football field, waterfall, sources & uses tables, comparable companies analysis
+- **Professional Typography** — Google Fonts for each presentation type (Libre Baskerville for IB, Space Grotesk for technical, etc.)
+- **Hallucination Detection** — Zero-tolerance fact checking ensures all content is sourced from your input
+- **Auto-Remediation** — Automatically fixes quality issues until 95/100 threshold is met
+- **100% Zero Cost** — No API keys, no subscriptions, runs entirely on your machine
+
+---
+
 ## The Scenario
 
 You're deep in a Claude Code session. You've built something real:
@@ -49,157 +60,305 @@ Ready to present. Ready to send to clients.
 
 ---
 
-## Why This Works
+## 7 Presentation Types
 
-Claude is brilliant at research, analysis, and strategy. But presentations? Not so much.
+The engine automatically detects your content and applies the right expert methodology:
 
-That's because Claude wasn't trained on what actually makes presentations work:
-- McKinsey consultants don't use bullet points — they use action titles
-- TED speakers don't dump information — they follow the Sparkline narrative arc
-- Steve Jobs averaged 10 words per slide — not 100
-- Investment bankers structure decks with the Pyramid Principle — answer first, support second
+| Type | Expert Methodology | Visual Style | Best For |
+|------|-------------------|--------------|----------|
+| **TED Keynote** | Nancy Duarte (Sparkline) | Bold, minimal, black backgrounds | Conference talks, inspiration |
+| **Sales Pitch** | Robert Cialdini (Persuasion) | Trust blue, success green | Closing deals, demos |
+| **Consulting Deck** | Barbara Minto (Pyramid Principle) | McKinsey blue, action titles | Strategy, recommendations |
+| **Investment Banking** | Analyst Academy | Navy + gold, serif fonts | M&A, valuations, pitchbooks |
+| **Investor Pitch** | Sequoia/YC frameworks | Clean, startup purple | Fundraising, board decks |
+| **Technical Presentation** | Edward Tufte (Data-ink) | Dark mode, Space Grotesk | Architecture, engineering |
+| **All Hands Meeting** | Internal comms best practices | Corporate blue, win green | Company updates, celebrations |
 
-**We spent months building a knowledge base that knows all of this.**
+### Investment Banking Specialty Charts
 
-We scoured the internet for everything ever written about making great presentations:
+For IB presentations, the engine generates industry-standard visualizations:
 
-| Source | What We Extracted |
-|--------|-------------------|
-| **600+ consulting decks** | McKinsey, BCG, Bain slide structures and standards |
-| **Nancy Duarte** | Sparkline narrative, STAR moments, Glance Test |
-| **Garr Reynolds** | Presentation Zen, signal-to-noise ratio |
-| **Carmine Gallo** | TED talk patterns, Rule of Three, 18-minute rule |
-| **Barbara Minto** | Pyramid Principle, SCQA framework, MECE logic |
-| **Edward Tufte** | Data-ink ratio, chartjunk elimination |
-| **Cole Nussbaumer Knaflic** | Storytelling with Data principles |
-| **10M+ views of YouTube content** | Analyst Academy, PowerPoint School, and more |
+```typescript
+// Football Field Valuation Chart
+engine.addFootballFieldChart(slide, {
+  title: 'Valuation Summary',
+  methodologies: [
+    { name: 'DCF', low: 42, mid: 48, high: 55 },
+    { name: 'Comps', low: 38, mid: 45, high: 52 },
+    { name: 'Precedents', low: 44, mid: 50, high: 58 }
+  ],
+  currentPrice: 46
+});
 
-All of it — **6,300+ lines of expert knowledge** — encoded into an agentic vector database.
+// Waterfall Chart
+engine.addWaterfallChart(slide, {
+  title: 'Enterprise Value Bridge',
+  startLabel: 'Equity Value',
+  startValue: 850000,
+  steps: [
+    { label: 'Plus: Debt', value: 250000 },
+    { label: 'Less: Cash', value: -150000 },
+    { label: 'EV', value: 950000, isTotal: true }
+  ]
+});
 
-**Now Claude doesn't have to figure out presentations. The knowledge base already knows.**
+// Sources & Uses Table
+engine.addSourcesUsesTable(slide, {
+  title: 'Transaction Financing',
+  sources: [
+    { label: 'Senior Debt', amount: 500000 },
+    { label: 'Equity', amount: 300000 }
+  ],
+  uses: [
+    { label: 'Purchase Price', amount: 750000 },
+    { label: 'Fees & Expenses', amount: 50000 }
+  ]
+});
+
+// Comparable Companies Table
+engine.addCompsTable(slide, {
+  title: 'Trading Comparables',
+  columns: ['EV/Revenue', 'EV/EBITDA', 'P/E'],
+  companies: [
+    { name: 'Company A', values: [3.2, 12.5, 18.3] },
+    { name: 'Company B', values: [2.8, 10.2, 15.7] },
+    { name: 'Target Co', values: [2.5, 9.8, 14.2], highlight: true }
+  ],
+  medianRow: true
+});
+```
 
 ---
 
-## What You Actually Get
+## Professional Typography
 
-### Two Output Formats
+Each presentation type loads appropriate Google Fonts (zero cost):
 
-**HTML Presentations (Reveal.js)**
+| Type | Heading Font | Body Font | Personality |
+|------|-------------|-----------|-------------|
+| TED Keynote | DM Sans | DM Sans | Modern, bold |
+| Sales Pitch | Poppins | Poppins | Friendly, approachable |
+| Consulting | IBM Plex Sans | IBM Plex Sans | Clean, corporate |
+| Investment Banking | Libre Baskerville | IBM Plex Sans | Classic, authoritative |
+| Investor Pitch | DM Sans | Source Sans Pro | Startup, modern |
+| Technical | Space Grotesk | Source Sans Pro | Precision, engineering |
+| All Hands | Source Sans Pro | Source Sans Pro | Clear, professional |
 
-Modern, web-native slides that run in any browser:
+---
 
-- Share via URL — just send a link
-- Works on any device — desktop, tablet, phone
-- Animations and transitions built-in
-- Speaker notes with `S` key
-- Fullscreen with `F` key
-- Looks like a polished online version of PowerPoint
+## Quality Assurance System
 
-*Best for: Tech audiences, conferences, product demos, anything you want to share online*
+### Bulletproof QA Pipeline
 
-**PowerPoint (PPTX)**
+Every presentation goes through a rigorous validation pipeline:
 
-Traditional format that opens in Microsoft PowerPoint:
+```
+Content Analysis → Slide Generation → QA Validation → Auto-Remediation → Final Output
+                                           ↓
+                           [Loops until 95/100 threshold met]
+```
 
-- Edit further if needed
-- Send to clients who expect PPTX
-- Print to PDF for handouts
-- Works offline
+### What Gets Validated
 
-*Best for: Board decks, client deliverables, corporate environments*
+| Category | Checks |
+|----------|--------|
+| **Content** | Word count per slide, bullet count, one-idea-per-slide |
+| **Visual** | Whitespace %, font consistency, color count |
+| **Structure** | Title slide present, conclusion slide, logical flow |
+| **Expert Rules** | Glance test (3-second rule), Rule of Three, Pyramid structure |
+| **Accessibility** | WCAG contrast ratios, minimum font sizes |
+| **Hallucination** | Every fact must be traceable to source content |
 
-### Two Presentation Modes
+### Hallucination Detection
 
-**Keynote Mode** — For inspiring and persuading
+The engine includes a **zero-tolerance hallucination detector**:
 
-- 6-15 words per slide (like Steve Jobs)
-- 40%+ whitespace
-- One idea per slide
-- Emotional narrative structure
-- Big visuals, minimal text
+```typescript
+// The engine checks every statistic, quote, and claim
+const factCheck = await hallucinationDetector.checkForHallucinations(
+  slides,
+  originalContent,
+  contentAnalysis
+);
+
+// If unverified facts are found, they're automatically flagged and removed
+if (!factCheck.passed) {
+  slides = hallucinationDetector.remediate(slides, factCheck);
+  console.log(`Removed ${factCheck.issues.length} unverified claims`);
+}
+```
 
-*Use for: Product launches, investor pitches, conference talks, TED-style presentations*
+---
 
-**Business Mode** — For informing and documenting
+## Installation
 
-- 40-80 words per slide
-- Action titles (full sentences that state conclusions)
-- Data with callouts
-- Structured with Pyramid Principle
-- Charts, tables, metrics grids
+### Option 1: npx (Quick One-Off — No Install Needed)
+
+Run directly without installing anything. Perfect for trying it out or one-off presentations:
+
+```bash
+# Generate a presentation instantly (downloads temporarily, runs, cleans up)
+npx claude-presentation-master generate notes.md -m keynote -f html
 
-*Use for: Board meetings, strategy reviews, consulting deliverables, quarterly reports*
+# Generate a consulting deck as PowerPoint
+npx claude-presentation-master generate strategy.md --type consulting_deck -f pptx
+
+# See all options
+npx claude-presentation-master --help
+```
+
+**When to use npx:**
+- Quick one-off presentation
+- Trying out the tool before installing
+- CI/CD pipelines where you don't want permanent installs
+- Sharing a command that "just works" for anyone
 
 ---
 
-## Installation
+### Option 2: npm install (For Regular Use)
+
+Install once, use anytime with the short `cpm` command:
+
+```bash
+# Install globally (recommended for regular use)
+npm install -g claude-presentation-master
+
+# Now use the short command anywhere
+cpm generate notes.md -m keynote -f html
+cpm generate strategy.md --type investment_banking -f pptx
+cpm info
+```
+
+**Or install as a project dependency:**
 
 ```bash
+# In your project directory
 npm install claude-presentation-master
+
+# Use programmatically in your code (see below)
+```
+
+**When to use npm install:**
+- You create presentations regularly
+- You want the short `cpm` command
+- You're building it into a Claude Code workflow
+- You want to use the TypeScript API in your code
+
+---
+
+### Optional: Visual Testing
+
+For Playwright-based visual regression testing (not required for generation):
+
+```bash
 npx playwright install chromium
 ```
 
-That's it. You're ready.
+**No API keys. No subscriptions. Zero cost.**
 
 ---
 
 ## Quick Start
 
-### From the Command Line
+### From the Command Line (npx)
+
+```bash
+# One-liner: Generate keynote from markdown (no install needed)
+npx claude-presentation-master generate notes.md -m keynote -f html
+
+# Generate consulting deck
+npx claude-presentation-master generate strategy.md --type consulting_deck -f pptx
+
+# Generate IB pitchbook with both formats
+npx claude-presentation-master generate deal.md --type investment_banking -f html,pptx -o ./output
+```
+
+### From the Command Line (after npm install -g)
 
 ```bash
-# Turn your markdown notes into a keynote-style HTML presentation
-cpm generate project-notes.md --mode keynote --format html
+# TED-style keynote presentation
+cpm generate keynote-talk.md --mode keynote --format html
 
-# Create a consulting-style PowerPoint deck
+# Consulting strategy deck
 cpm generate strategy.md --mode business --format pptx
 
-# Generate both formats at once
+# Investment banking pitchbook
+cpm generate deal-memo.md --type investment_banking --format pptx
+
+# Generate both formats
 cpm generate quarterly-review.md --mode business --format html,pptx
 ```
 
 ### From Your Code
 
 ```typescript
-import { generate } from 'claude-presentation-master';
+import { PresentationEngine } from 'claude-presentation-master';
 
-const result = await generate({
+const engine = new PresentationEngine();
+
+const result = await engine.generate({
   content: `
-# Q4 Strategy Update
+# Series A Pitch
 
-## Where We Are
-Revenue up 23% YoY. Market share down 2 points.
+## The Problem
+Enterprise teams waste 40% of time on manual data entry.
+$50B market. Growing 23% annually.
 
-## The Challenge
-Three new competitors launched in Q3.
-Customer acquisition costs up 40%.
+## Our Solution
+AI-powered automation that learns from your workflow.
+Currently serving 150 enterprise customers.
 
-## What We're Doing
-1. Launch enterprise tier in Q2
-2. Expand into adjacent markets
-3. Shift to product-led growth
+## Traction
+- $2.4M ARR (up from $800K last year)
+- 94% customer retention
+- NPS score of 72
 
-## Expected Result
-Market share leadership within 18 months.
+## The Ask
+Raising $15M to expand into Europe and build enterprise sales team.
   `,
   contentType: 'markdown',
-  mode: 'business',
+  title: 'Series A Pitch',
+  mode: 'keynote',
   format: ['html', 'pptx'],
-  title: 'Q4 Strategy Update'
+  author: 'Founder Name'
 });
 
-// result.outputs.html — Complete HTML presentation
-// result.outputs.pptx — PowerPoint file buffer
-// result.score — Quality score (must be 95+ to pass)
+// Guaranteed 95/100 quality or higher
+console.log(`Score: ${result.score}/100`);
+console.log(`Grade: ${result.metadata.grade}`);
+
+// Save outputs
+fs.writeFileSync('pitch.html', result.outputs.html);
+fs.writeFileSync('pitch.pptx', result.outputs.pptx);
+```
+
+### Specifying Presentation Type
+
+```typescript
+// Let the engine auto-detect (recommended)
+const result = await engine.generate({
+  content: dealMemo,
+  mode: 'business',
+  format: ['pptx']
+});
+// Engine detects "investment_banking" from content keywords
+
+// Or specify explicitly
+const result = await engine.generate({
+  content: techSpec,
+  mode: 'keynote',
+  presentationType: 'technical_presentation',
+  format: ['html']
+});
 ```
 
 ---
 
 ## The Knowledge Base
 
-This isn't a template library. It's a **complete expert system** for presentations.
+This isn't a template library. It's a **complete expert system** — 6,300+ lines of encoded expertise.
 
-### What's Encoded
+### What's Inside
 
 **From McKinsey, BCG, Bain:**
 - Pyramid Principle — Lead with the answer
@@ -234,67 +393,126 @@ This isn't a template library. It's a **complete expert system** for presentatio
 - MECE Grouping — Mutually Exclusive, Collectively Exhaustive
 - Vertical Logic — Each level supports the one above
 
-### Design System
+**From Robert Cialdini (Influence):**
+- Social Proof — Show who else succeeded
+- Scarcity — Limited time, limited availability
+- Authority — Credentials and expertise
+- Reciprocity — Give value first
+
+---
+
+## Two Modes × Seven Types
+
+### Presentation Modes
+
+**Keynote Mode** — For inspiring and persuading
+- 6-15 words per slide (like Steve Jobs)
+- 40%+ whitespace
+- One idea per slide
+- Emotional narrative structure
+- Big visuals, minimal text
+
+**Business Mode** — For informing and documenting
+- 40-80 words per slide
+- Action titles (full sentences that state conclusions)
+- Data with callouts
+- Structured with Pyramid Principle
+- Charts, tables, metrics grids
+
+### Presentation Types (Auto-Detected)
+
+| Keyword Triggers | Detected Type |
+|-----------------|---------------|
+| "TED", "keynote", "inspire" | `ted_keynote` |
+| "sales", "demo", "prospect" | `sales_pitch` |
+| "strategy", "recommendation", "McKinsey" | `consulting_deck` |
+| "M&A", "valuation", "DCF", "pitchbook" | `investment_banking` |
+| "Series A", "raise", "investor" | `investor_pitch` |
+| "API", "architecture", "system design" | `technical_presentation` |
+| "all hands", "company update", "quarterly" | `all_hands` |
 
-Complete color palettes tested for accessibility:
-- **Consulting Classic** — Cream background, navy text (McKinsey/BCG look)
-- **Executive Professional** — Warm gray, sophisticated
-- **Modern Tech** — Light with teal accents
-- **Dark Executive** — Dark mode for screens
+---
+
+## Output Formats
 
-Typography rules:
-- Keynote: 54-72px titles, max 2 fonts
-- Business: 18-22px action titles, 11-14px body
-- Accessibility: 18pt minimum, 30pt+ for projection
+### HTML Presentations (Reveal.js)
+
+Modern, web-native slides:
+- Share via URL — just send a link
+- Works on any device — desktop, tablet, phone
+- Keyboard shortcuts: `S` for speaker notes, `F` for fullscreen
+- Embedded CSS with presentation-type-specific theming
+- Glass morphism effects, smooth transitions
+
+### PowerPoint (PPTX)
+
+Traditional format:
+- Opens in Microsoft PowerPoint
+- Fully editable
+- Send to clients who expect PPTX
+- Print to PDF for handouts
+- Includes IB specialty charts (football field, waterfall, etc.)
 
 ---
 
-## Quality Validation
+## Quality Scores
+
+Every presentation gets a quality score:
 
-Every presentation passes through real visual QA using Playwright:
+| Score | Grade | Status |
+|-------|-------|--------|
+| 97-100 | A+ | Exceptional |
+| 93-96 | A | Excellent |
+| 90-92 | A- | Very Good |
+| 85-89 | B+ | Good |
+| 80-84 | B | Acceptable |
+| 75-79 | B- | Needs Work |
+| < 75 | C or below | Blocked (auto-remediation applied) |
 
-| Check | What's Measured |
-|-------|-----------------|
-| **Whitespace** | Percentage of empty space (40%+ for keynote, 25%+ for business) |
-| **Balance** | Center of mass — is the layout visually balanced? |
-| **Contrast** | WCAG 4.5:1 minimum for text readability |
-| **Word Count** | Enforced limits per slide type |
-| **Font Count** | Maximum 2 font families |
-| **Color Count** | Maximum 5 colors |
+**Default threshold: 95/100**
 
-**Presentations must score 95/100 or higher.** If they don't, you get a specific list of what to fix.
+The engine will automatically remediate issues (up to 5 iterations) until the threshold is met. If it can't reach 95, it delivers the best result with a detailed report of remaining issues.
 
 ---
 
-## The Difference
+## Zero Cost Guarantee
+
+| Component | Cost | Notes |
+|-----------|------|-------|
+| NPM Package | FREE | MIT License |
+| Dependencies | FREE | pptxgenjs, reveal.js, marked, etc. |
+| Fonts | FREE | Google Fonts CDN |
+| QA Validation | FREE | Built-in validators |
+| Visual Testing | FREE | Playwright (optional) |
+| API Keys | NONE | Runs 100% locally |
 
-| Without This Library | With This Library |
-|---------------------|-------------------|
-| Ask Claude for slides, get bullet point soup | Structured presentation following expert frameworks |
-| Manually fix formatting for hours | Production-ready output in seconds |
-| Hope it looks professional | 95/100 quality bar enforced |
-| Generic templates | 6,300+ lines of encoded expertise |
-| Text only | HTML or PowerPoint output |
-| No validation | Real visual QA with screenshots |
+**No subscriptions. No usage limits. No API costs.**
 
 ---
 
-## Use Cases
+## FAQ
+
+**Does this require an API key?**
+No. Everything runs locally on your machine.
+
+**What's the difference between mode and type?**
+- **Mode** (`keynote` or `business`) controls word counts and visual density
+- **Type** (e.g., `investment_banking`) selects the expert methodology and theming
 
-**You're building a product strategy in Claude**
-→ Generate an investor pitch deck in keynote mode
+**Can I customize the output?**
+Yes. HTML is just HTML. PPTX opens in PowerPoint. Edit freely.
 
-**You've analyzed Q4 performance**
-→ Create a board presentation in business mode
+**What if I don't like the auto-detected type?**
+Specify it explicitly: `presentationType: 'consulting_deck'`
 
-**You're planning a product launch**
-→ Build a TED-style keynote for the all-hands
+**Does it work with Claude Code?**
+Yes — that's exactly what it's designed for.
 
-**You've done competitive research**
-→ Turn it into a consulting-style strategy deck
+**What about images?**
+The engine generates placeholder boxes. Replace with your actual images.
 
-**You have meeting notes that need to become a presentation**
-→ One command, done
+**Can I lower the quality threshold?**
+Yes, but not recommended: `qaThreshold: 80`
 
 ---
 
@@ -302,37 +520,61 @@ Every presentation passes through real visual QA using Playwright:
 
 | Theme | Look | Best For |
 |-------|------|----------|
-| `default` | Clean, professional | General use |
-| `consulting-classic` | Cream, navy | McKinsey/BCG style |
-| `modern-tech` | Light, teal accents | Startups, tech |
+| `default` | Dark executive | General use |
+| `consulting-classic` | Cream + navy | McKinsey/BCG style |
+| `modern-tech` | Light + teal | Startups |
 | `minimal` | Maximum whitespace | Design-focused |
 | `dark-executive` | Dark mode | Screen presentations |
+| `investment-banking` | Navy + gold | Finance |
 
 ---
 
 ## Slide Types
 
 **Keynote Mode:**
-Big Idea • Single Statement • Full Image • Big Number • Quote
+Title • Big Idea • Single Statement • Full Image • Big Number • Quote • CTA • Thank You
 
 **Business Mode:**
-Agenda • Bullet Points • Two Column • Three Column • Metrics Grid • Timeline • Process Flow • Comparison • Case Study • Pricing Table
+Title • Agenda • Bullet Points • Two Column • Three Column • Metrics Grid • Timeline • Process Flow • Comparison • Case Study • Section Divider • Thank You
+
+**Investment Banking (PPTX):**
+Football Field Chart • Waterfall Chart • Sources & Uses Table • Comparable Companies Table
 
 ---
 
-## FAQ
+## API Reference
 
-**Does this require an API key?**
-No. The knowledge base is bundled with the package. Works 100% offline.
+### PresentationEngine
 
-**Can I edit the output?**
-Yes. HTML is just HTML. PPTX opens in PowerPoint for further editing.
-
-**What if I don't like the result?**
-Adjust your input content or lower the quality threshold (not recommended).
+```typescript
+const engine = new PresentationEngine();
+
+const result = await engine.generate({
+  // Required
+  content: string,           // Your source content
+  title: string,             // Presentation title
+  mode: 'keynote' | 'business',
+  format: ('html' | 'pptx')[],
+
+  // Optional
+  contentType?: 'markdown' | 'text' | 'html',
+  presentationType?: PresentationType,  // Auto-detected if omitted
+  author?: string,
+  theme?: string,
+  qaThreshold?: number,      // Default: 95
+});
 
-**Does it work with Claude Code?**
-Yes — that's exactly what it's designed for. Generate presentations from your project context.
+// Result
+interface PresentationResult {
+  outputs: {
+    html?: string,
+    pptx?: Buffer
+  },
+  score: number,             // Quality score 0-100
+  qaResults: QAResults,      // Detailed validation results
+  metadata: PresentationMetadata
+}
+```
 
 ---
 
@@ -346,6 +588,8 @@ MIT — free to use, modify, and distribute.
 
 **Stuart Kerr** — [Isovision.ai](https://isovision.ai)
 
+Questions? [stuart@isovision.ai](mailto:stuart@isovision.ai)
+
 ---
 
 <div align="center">
@@ -356,7 +600,10 @@ MIT — free to use, modify, and distribute.
 npm install claude-presentation-master
 ```
 
-Built on methodologies from McKinsey • BCG • Bain • Nancy Duarte • Garr Reynolds
-Carmine Gallo • Chris Anderson • Barbara Minto • Edward Tufte
+**100% Free • Zero API Keys • Runs Locally**
+
+Built on methodologies from:
+McKinsey • BCG • Bain • Nancy Duarte • Garr Reynolds • Carmine Gallo
+Chris Anderson • Barbara Minto • Edward Tufte • Robert Cialdini
 
 </div>