claude-presentation-master 8.2.0 → 8.3.0

package/dist/index.d.mts

@@ -1067,6 +1067,8 @@ declare class ContentAnalyzer {
     /**
      * Extract SCQA structure (Barbara Minto)
      * CRITICAL: Answer must be clean prose, NOT bullet points
+     * @param text - The content text to analyze
+     * @param subtitle - Optional subtitle to exclude (prevents redundancy with title slide)
      */
     private extractSCQA;
     /**

package/dist/index.d.ts

@@ -1067,6 +1067,8 @@ declare class ContentAnalyzer {
     /**
      * Extract SCQA structure (Barbara Minto)
      * CRITICAL: Answer must be clean prose, NOT bullet points
+     * @param text - The content text to analyze
+     * @param subtitle - Optional subtitle to exclude (prevents redundancy with title slide)
      */
     private extractSCQA;
     /**

package/dist/index.js

@@ -1186,7 +1186,7 @@ var ContentAnalyzer = class {
     logger.step(`Detected type: ${detectedType}`);
     const sections = this.extractSections(text);
     logger.step(`Found ${sections.length} sections`);
-    const scqa = this.extractSCQA(text);
+    const scqa = this.extractSCQA(text, subtitle);
     const sparkline = this.extractSparkline(text);
     const keyMessages = this.extractKeyMessages(text);
     const dataPoints = this.extractDataPoints(text);
@@ -1453,15 +1453,24 @@ var ContentAnalyzer = class {
   /**
    * Extract SCQA structure (Barbara Minto)
    * CRITICAL: Answer must be clean prose, NOT bullet points
+   * @param text - The content text to analyze
+   * @param subtitle - Optional subtitle to exclude (prevents redundancy with title slide)
    */
-  extractSCQA(text) {
+  extractSCQA(text, subtitle) {
     const paragraphs = text.split(/\n\n+/).filter((p) => p.trim());
+    const normalizedSubtitle = (subtitle || "").toLowerCase().trim();
+    const isSubtitle = (para) => {
+      if (!normalizedSubtitle) return false;
+      const normalized = para.toLowerCase().trim();
+      return normalized === normalizedSubtitle || normalized.includes(normalizedSubtitle) || normalizedSubtitle.includes(normalized);
+    };
     let situation = "";
     let complication = "";
     let question = "";
     let answer = "";
     for (const para of paragraphs.slice(0, 5)) {
       if (para.startsWith("-") || para.startsWith("#") || para.startsWith("|")) continue;
+      if (isSubtitle(para)) continue;
       if (this.containsSignals(para.toLowerCase(), this.situationSignals)) {
         situation = this.extractFirstSentence(para);
         break;
@@ -1489,6 +1498,7 @@ var ContentAnalyzer = class {
     if (!situation && paragraphs.length > 0) {
       for (const para of paragraphs.slice(0, 5)) {
         if (!para.startsWith("-") && !para.startsWith("#") && para.length > 50) {
+          if (isSubtitle(para)) continue;
           situation = this.extractFirstSentence(para);
           break;
         }
@@ -1935,7 +1945,8 @@ var ContentPatternClassifier = class {
     if (!match || !match[1]) return null;
     const value = match[1];
     const afterNumber = content.slice(content.indexOf(value) + value.length);
-    const context = afterNumber.trim().slice(0, 60).split(/[.!?]/)[0]?.trim() ?? "";
+    const contextRaw = afterNumber.trim().split(/[\n\r]|-\s|[.!?]|(?=\d+%)|(?=\$\d)/)[0] || "";
+    const context = contextRaw.trim().slice(0, 60);
     return { value, context };
   }
   /**
@@ -2632,6 +2643,16 @@ var SlideFactory = class {
         continue;
       }
       this.usedContent.add(contentKey);
+      const normalizedHeader = section.header.toLowerCase().replace(/[^a-z0-9]/g, "");
+      const normalizedTitle = analysis.title.toLowerCase().replace(/[^a-z0-9]/g, "");
+      const normalizedSubtitle = (analysis.subtitle || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+      const normalizedContent = (section.content || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+      const headerMatchesTitle = normalizedHeader === normalizedTitle || normalizedTitle.includes(normalizedHeader) || normalizedHeader.includes(normalizedTitle);
+      const contentMatchesSubtitle = normalizedContent && (normalizedContent === normalizedSubtitle || normalizedSubtitle.includes(normalizedContent) || normalizedContent.includes(normalizedSubtitle));
+      if (headerMatchesTitle && (contentMatchesSubtitle || !section.content || section.content.length < 30)) {
+        logger.warn(`Section "${section.header}" skipped - duplicates title slide`);
+        continue;
+      }
       const headerLower = section.header.toLowerCase();
       const isCTASection = headerLower.includes("call to action") || headerLower.includes("next step") || headerLower.includes("take action") || headerLower.includes("get started") || headerLower.includes("start today");
       if (isCTASection) {
@@ -2811,47 +2832,69 @@ var SlideFactory = class {
     const scqa = analysis.scqa;
     const titles = this.config.scqaTitles;
     const minBodyLength = 20;
+    const normalizedTitle = analysis.title.toLowerCase().replace(/[^a-z0-9]/g, "");
+    const normalizedSubtitle = (analysis.subtitle || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+    const duplicatesHeadline = (body) => {
+      if (!body) return true;
+      const normalizedBody = body.toLowerCase().replace(/[^a-z0-9]/g, "");
+      if (!normalizedBody || normalizedBody.length < 10) return false;
+      const titleMatch = normalizedTitle.length > 5 && (normalizedBody === normalizedTitle || normalizedTitle.includes(normalizedBody) || normalizedBody.includes(normalizedTitle));
+      const subtitleMatch = normalizedSubtitle.length > 5 && (normalizedBody === normalizedSubtitle || normalizedSubtitle.includes(normalizedBody) || normalizedBody.includes(normalizedSubtitle));
+      return titleMatch || subtitleMatch;
+    };
     const situationBody = scqa?.situation ? this.truncateText(scqa.situation, this.config.rules.wordsPerSlide.max) : "";
     if (situationBody.length >= minBodyLength && !this.usedContent.has("scqa-situation")) {
-      this.usedContent.add("scqa-situation");
-      slides.push({
-        index: slides.length,
-        type: "single-statement",
-        data: {
-          title: titles.situation,
-          // FROM KB - not hardcoded 'Current Situation'
-          body: situationBody
-        },
-        classes: ["situation-slide"]
-      });
+      if (duplicatesHeadline(situationBody)) {
+        logger.warn(`SCQA Situation skipped - duplicates title/subtitle: "${situationBody.slice(0, 50)}..."`);
+      } else {
+        this.usedContent.add("scqa-situation");
+        slides.push({
+          index: slides.length,
+          type: "single-statement",
+          data: {
+            title: titles.situation,
+            // FROM KB - not hardcoded 'Current Situation'
+            body: situationBody
+          },
+          classes: ["situation-slide"]
+        });
+      }
     }
     const complicationBody = scqa?.complication ? this.truncateText(scqa.complication, this.config.rules.wordsPerSlide.max) : "";
     if (complicationBody.length >= minBodyLength && !this.usedContent.has("scqa-complication")) {
-      this.usedContent.add("scqa-complication");
-      slides.push({
-        index: slides.length,
-        type: "single-statement",
-        data: {
-          title: titles.complication,
-          // FROM KB - not hardcoded 'The Challenge'
-          body: complicationBody
-        },
-        classes: ["complication-slide"]
-      });
+      if (duplicatesHeadline(complicationBody)) {
+        logger.warn(`SCQA Complication skipped - duplicates title/subtitle`);
+      } else {
+        this.usedContent.add("scqa-complication");
+        slides.push({
+          index: slides.length,
+          type: "single-statement",
+          data: {
+            title: titles.complication,
+            // FROM KB - not hardcoded 'The Challenge'
+            body: complicationBody
+          },
+          classes: ["complication-slide"]
+        });
+      }
     }
     const questionBody = scqa?.question ? this.truncateText(scqa.question, this.config.rules.wordsPerSlide.max) : "";
     if (questionBody.length >= minBodyLength && !this.usedContent.has("scqa-question")) {
-      this.usedContent.add("scqa-question");
-      slides.push({
-        index: slides.length,
-        type: "single-statement",
-        data: {
-          title: titles.question,
-          // FROM KB - not hardcoded 'The Question'
-          body: questionBody
-        },
-        classes: ["question-slide"]
-      });
+      if (duplicatesHeadline(questionBody)) {
+        logger.warn(`SCQA Question skipped - duplicates title/subtitle`);
+      } else {
+        this.usedContent.add("scqa-question");
+        slides.push({
+          index: slides.length,
+          type: "single-statement",
+          data: {
+            title: titles.question,
+            // FROM KB - not hardcoded 'The Question'
+            body: questionBody
+          },
+          classes: ["question-slide"]
+        });
+      }
     }
   }
   addSparklineSlides(slides, analysis) {
@@ -2904,14 +2947,41 @@ var SlideFactory = class {
   // CONTENT SLIDES - ALL values from KB
   // ===========================================================================
   createBigNumberSlide(index, section, pattern) {
-    const fullContent = `${section.header} ${section.content} ${section.bullets.join(" ")}`;
-    const bigNumber = this.classifier.extractBigNumber(fullContent);
+    let bigNumber = null;
+    let sourceBullet = null;
+    for (const bullet of section.bullets) {
+      const extracted = this.classifier.extractBigNumber(bullet);
+      if (extracted) {
+        bigNumber = extracted;
+        sourceBullet = bullet;
+        break;
+      }
+    }
+    if (!bigNumber) {
+      bigNumber = this.classifier.extractBigNumber(section.header);
+    }
+    if (!bigNumber && section.content) {
+      bigNumber = this.classifier.extractBigNumber(section.content);
+    }
     const actualValue = bigNumber?.value || pattern.bigNumberValue;
     if (!actualValue) {
       logger.warn(`No number found for big-number slide, falling back to single-statement`);
       return this.createSingleStatementSlide(index, section);
     }
-    const contextContent = bigNumber?.context || section.content;
+    let contextContent = bigNumber?.context || "";
+    if (sourceBullet && !contextContent) {
+      contextContent = sourceBullet.replace(actualValue, "").trim();
+    }
+    if (!contextContent) {
+      contextContent = section.content || section.header;
+    }
+    let cleanTitle = section.header;
+    if (actualValue && cleanTitle.includes(actualValue.replace(/[,$%]/g, ""))) {
+      cleanTitle = cleanTitle.replace(new RegExp(`\\$?${actualValue.replace(/[,$%]/g, "").replace(/\./g, "\\.?")}[KMBkmb]?`, "gi"), "").replace(/\s+/g, " ").trim();
+    }
+    if (!cleanTitle || cleanTitle.length < 5) {
+      cleanTitle = bigNumber?.context?.split(/[.!?]/)[0] || section.header;
+    }
     const craftedContext = this.craftExpertContent(
       contextContent,
       "big_number",
@@ -2921,7 +2991,7 @@ var SlideFactory = class {
       index,
       type: "big-number",
       data: {
-        title: this.createTitle(section.header, section),
+        title: cleanTitle,
         keyMessage: actualValue,
         body: craftedContext
       },
@@ -5668,12 +5738,15 @@ var VisualQualityEvaluator = class {
       glanceTest += 1;
       glanceNotes.push("Clean, minimal text - passes glance test easily");
     }
-    if (slideData.bullets.length > 5) {
+    const isAgendaSlide = slideType === "agenda" || (slideData.classes || []).includes("agenda-slide");
+    const bulletLimit = isAgendaSlide ? 8 : 5;
+    const bulletWarning = isAgendaSlide ? 6 : 3;
+    if (slideData.bullets.length > bulletLimit) {
       glanceTest -= 4;
       glanceNotes.push("Too many bullets - cannot scan in 3 seconds");
-    } else if (slideData.bullets.length > 3) {
-      glanceTest -= 2;
-      glanceNotes.push("Multiple bullets - needs careful structuring");
+    } else if (slideData.bullets.length > bulletWarning) {
+      glanceTest -= isAgendaSlide ? 1 : 2;
+      glanceNotes.push(isAgendaSlide ? "Agenda with many items" : "Multiple bullets - needs careful structuring");
     }
     if (slideData.hasImage || slideData.hasChart) {
       glanceTest += 1;

package/dist/index.mjs

@@ -1117,7 +1117,7 @@ var ContentAnalyzer = class {
     logger.step(`Detected type: ${detectedType}`);
     const sections = this.extractSections(text);
     logger.step(`Found ${sections.length} sections`);
-    const scqa = this.extractSCQA(text);
+    const scqa = this.extractSCQA(text, subtitle);
     const sparkline = this.extractSparkline(text);
     const keyMessages = this.extractKeyMessages(text);
     const dataPoints = this.extractDataPoints(text);
@@ -1384,15 +1384,24 @@ var ContentAnalyzer = class {
   /**
    * Extract SCQA structure (Barbara Minto)
    * CRITICAL: Answer must be clean prose, NOT bullet points
+   * @param text - The content text to analyze
+   * @param subtitle - Optional subtitle to exclude (prevents redundancy with title slide)
    */
-  extractSCQA(text) {
+  extractSCQA(text, subtitle) {
     const paragraphs = text.split(/\n\n+/).filter((p) => p.trim());
+    const normalizedSubtitle = (subtitle || "").toLowerCase().trim();
+    const isSubtitle = (para) => {
+      if (!normalizedSubtitle) return false;
+      const normalized = para.toLowerCase().trim();
+      return normalized === normalizedSubtitle || normalized.includes(normalizedSubtitle) || normalizedSubtitle.includes(normalized);
+    };
     let situation = "";
     let complication = "";
     let question = "";
     let answer = "";
     for (const para of paragraphs.slice(0, 5)) {
       if (para.startsWith("-") || para.startsWith("#") || para.startsWith("|")) continue;
+      if (isSubtitle(para)) continue;
       if (this.containsSignals(para.toLowerCase(), this.situationSignals)) {
         situation = this.extractFirstSentence(para);
         break;
@@ -1420,6 +1429,7 @@ var ContentAnalyzer = class {
     if (!situation && paragraphs.length > 0) {
       for (const para of paragraphs.slice(0, 5)) {
         if (!para.startsWith("-") && !para.startsWith("#") && para.length > 50) {
+          if (isSubtitle(para)) continue;
           situation = this.extractFirstSentence(para);
           break;
         }
@@ -1866,7 +1876,8 @@ var ContentPatternClassifier = class {
     if (!match || !match[1]) return null;
     const value = match[1];
     const afterNumber = content.slice(content.indexOf(value) + value.length);
-    const context = afterNumber.trim().slice(0, 60).split(/[.!?]/)[0]?.trim() ?? "";
+    const contextRaw = afterNumber.trim().split(/[\n\r]|-\s|[.!?]|(?=\d+%)|(?=\$\d)/)[0] || "";
+    const context = contextRaw.trim().slice(0, 60);
     return { value, context };
   }
   /**
@@ -2563,6 +2574,16 @@ var SlideFactory = class {
         continue;
       }
       this.usedContent.add(contentKey);
+      const normalizedHeader = section.header.toLowerCase().replace(/[^a-z0-9]/g, "");
+      const normalizedTitle = analysis.title.toLowerCase().replace(/[^a-z0-9]/g, "");
+      const normalizedSubtitle = (analysis.subtitle || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+      const normalizedContent = (section.content || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+      const headerMatchesTitle = normalizedHeader === normalizedTitle || normalizedTitle.includes(normalizedHeader) || normalizedHeader.includes(normalizedTitle);
+      const contentMatchesSubtitle = normalizedContent && (normalizedContent === normalizedSubtitle || normalizedSubtitle.includes(normalizedContent) || normalizedContent.includes(normalizedSubtitle));
+      if (headerMatchesTitle && (contentMatchesSubtitle || !section.content || section.content.length < 30)) {
+        logger.warn(`Section "${section.header}" skipped - duplicates title slide`);
+        continue;
+      }
       const headerLower = section.header.toLowerCase();
       const isCTASection = headerLower.includes("call to action") || headerLower.includes("next step") || headerLower.includes("take action") || headerLower.includes("get started") || headerLower.includes("start today");
       if (isCTASection) {
@@ -2742,47 +2763,69 @@ var SlideFactory = class {
     const scqa = analysis.scqa;
     const titles = this.config.scqaTitles;
     const minBodyLength = 20;
+    const normalizedTitle = analysis.title.toLowerCase().replace(/[^a-z0-9]/g, "");
+    const normalizedSubtitle = (analysis.subtitle || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+    const duplicatesHeadline = (body) => {
+      if (!body) return true;
+      const normalizedBody = body.toLowerCase().replace(/[^a-z0-9]/g, "");
+      if (!normalizedBody || normalizedBody.length < 10) return false;
+      const titleMatch = normalizedTitle.length > 5 && (normalizedBody === normalizedTitle || normalizedTitle.includes(normalizedBody) || normalizedBody.includes(normalizedTitle));
+      const subtitleMatch = normalizedSubtitle.length > 5 && (normalizedBody === normalizedSubtitle || normalizedSubtitle.includes(normalizedBody) || normalizedBody.includes(normalizedSubtitle));
+      return titleMatch || subtitleMatch;
+    };
     const situationBody = scqa?.situation ? this.truncateText(scqa.situation, this.config.rules.wordsPerSlide.max) : "";
     if (situationBody.length >= minBodyLength && !this.usedContent.has("scqa-situation")) {
-      this.usedContent.add("scqa-situation");
-      slides.push({
-        index: slides.length,
-        type: "single-statement",
-        data: {
-          title: titles.situation,
-          // FROM KB - not hardcoded 'Current Situation'
-          body: situationBody
-        },
-        classes: ["situation-slide"]
-      });
+      if (duplicatesHeadline(situationBody)) {
+        logger.warn(`SCQA Situation skipped - duplicates title/subtitle: "${situationBody.slice(0, 50)}..."`);
+      } else {
+        this.usedContent.add("scqa-situation");
+        slides.push({
+          index: slides.length,
+          type: "single-statement",
+          data: {
+            title: titles.situation,
+            // FROM KB - not hardcoded 'Current Situation'
+            body: situationBody
+          },
+          classes: ["situation-slide"]
+        });
+      }
     }
     const complicationBody = scqa?.complication ? this.truncateText(scqa.complication, this.config.rules.wordsPerSlide.max) : "";
     if (complicationBody.length >= minBodyLength && !this.usedContent.has("scqa-complication")) {
-      this.usedContent.add("scqa-complication");
-      slides.push({
-        index: slides.length,
-        type: "single-statement",
-        data: {
-          title: titles.complication,
-          // FROM KB - not hardcoded 'The Challenge'
-          body: complicationBody
-        },
-        classes: ["complication-slide"]
-      });
+      if (duplicatesHeadline(complicationBody)) {
+        logger.warn(`SCQA Complication skipped - duplicates title/subtitle`);
+      } else {
+        this.usedContent.add("scqa-complication");
+        slides.push({
+          index: slides.length,
+          type: "single-statement",
+          data: {
+            title: titles.complication,
+            // FROM KB - not hardcoded 'The Challenge'
+            body: complicationBody
+          },
+          classes: ["complication-slide"]
+        });
+      }
     }
     const questionBody = scqa?.question ? this.truncateText(scqa.question, this.config.rules.wordsPerSlide.max) : "";
     if (questionBody.length >= minBodyLength && !this.usedContent.has("scqa-question")) {
-      this.usedContent.add("scqa-question");
-      slides.push({
-        index: slides.length,
-        type: "single-statement",
-        data: {
-          title: titles.question,
-          // FROM KB - not hardcoded 'The Question'
-          body: questionBody
-        },
-        classes: ["question-slide"]
-      });
+      if (duplicatesHeadline(questionBody)) {
+        logger.warn(`SCQA Question skipped - duplicates title/subtitle`);
+      } else {
+        this.usedContent.add("scqa-question");
+        slides.push({
+          index: slides.length,
+          type: "single-statement",
+          data: {
+            title: titles.question,
+            // FROM KB - not hardcoded 'The Question'
+            body: questionBody
+          },
+          classes: ["question-slide"]
+        });
+      }
     }
   }
   addSparklineSlides(slides, analysis) {
@@ -2835,14 +2878,41 @@ var SlideFactory = class {
   // CONTENT SLIDES - ALL values from KB
   // ===========================================================================
   createBigNumberSlide(index, section, pattern) {
-    const fullContent = `${section.header} ${section.content} ${section.bullets.join(" ")}`;
-    const bigNumber = this.classifier.extractBigNumber(fullContent);
+    let bigNumber = null;
+    let sourceBullet = null;
+    for (const bullet of section.bullets) {
+      const extracted = this.classifier.extractBigNumber(bullet);
+      if (extracted) {
+        bigNumber = extracted;
+        sourceBullet = bullet;
+        break;
+      }
+    }
+    if (!bigNumber) {
+      bigNumber = this.classifier.extractBigNumber(section.header);
+    }
+    if (!bigNumber && section.content) {
+      bigNumber = this.classifier.extractBigNumber(section.content);
+    }
     const actualValue = bigNumber?.value || pattern.bigNumberValue;
     if (!actualValue) {
       logger.warn(`No number found for big-number slide, falling back to single-statement`);
       return this.createSingleStatementSlide(index, section);
     }
-    const contextContent = bigNumber?.context || section.content;
+    let contextContent = bigNumber?.context || "";
+    if (sourceBullet && !contextContent) {
+      contextContent = sourceBullet.replace(actualValue, "").trim();
+    }
+    if (!contextContent) {
+      contextContent = section.content || section.header;
+    }
+    let cleanTitle = section.header;
+    if (actualValue && cleanTitle.includes(actualValue.replace(/[,$%]/g, ""))) {
+      cleanTitle = cleanTitle.replace(new RegExp(`\\$?${actualValue.replace(/[,$%]/g, "").replace(/\./g, "\\.?")}[KMBkmb]?`, "gi"), "").replace(/\s+/g, " ").trim();
+    }
+    if (!cleanTitle || cleanTitle.length < 5) {
+      cleanTitle = bigNumber?.context?.split(/[.!?]/)[0] || section.header;
+    }
     const craftedContext = this.craftExpertContent(
       contextContent,
       "big_number",
@@ -2852,7 +2922,7 @@ var SlideFactory = class {
       index,
       type: "big-number",
       data: {
-        title: this.createTitle(section.header, section),
+        title: cleanTitle,
         keyMessage: actualValue,
         body: craftedContext
       },
@@ -5599,12 +5669,15 @@ var VisualQualityEvaluator = class {
       glanceTest += 1;
       glanceNotes.push("Clean, minimal text - passes glance test easily");
     }
-    if (slideData.bullets.length > 5) {
+    const isAgendaSlide = slideType === "agenda" || (slideData.classes || []).includes("agenda-slide");
+    const bulletLimit = isAgendaSlide ? 8 : 5;
+    const bulletWarning = isAgendaSlide ? 6 : 3;
+    if (slideData.bullets.length > bulletLimit) {
       glanceTest -= 4;
       glanceNotes.push("Too many bullets - cannot scan in 3 seconds");
-    } else if (slideData.bullets.length > 3) {
-      glanceTest -= 2;
-      glanceNotes.push("Multiple bullets - needs careful structuring");
+    } else if (slideData.bullets.length > bulletWarning) {
+      glanceTest -= isAgendaSlide ? 1 : 2;
+      glanceNotes.push(isAgendaSlide ? "Agenda with many items" : "Multiple bullets - needs careful structuring");
     }
     if (slideData.hasImage || slideData.hasChart) {
       glanceTest += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-presentation-master",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "description": "Generate world-class presentations using expert methodologies from Duarte, Reynolds, Gallo, and Anderson. Enforces rigorous quality standards through real visual validation.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",