@research-copilot/plugin 1.1.17 → 1.1.19

package/dist/skills/paper-slide-deck/references/figure-container-template.md

@@ -0,0 +1,177 @@
+# Figure Container Template
+
+Visual specifications for applying the academic-paper style container to extracted PDF figures.
+
+## Container Dimensions
+
+| Property | Value | Notes |
+|----------|-------|-------|
+| Aspect Ratio | 16:9 | Standard presentation format |
+| Resolution | 1920 x 1080 px | Full HD |
+| High-Res Option | 3840 x 2160 px | 4K for print quality |
+
+## Layout Specifications
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                           TITLE AREA                            │
+│                         (120px height)                          │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│                                                                 │
+│                       FIGURE AREA                               │
+│                    (centered, scaled)                           │
+│                     max 85% width                               │
+│                     max 70% height                              │
+│                                                                 │
+│                                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                         CAPTION AREA                            │
+│                          (80px height)                          │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Dimensions (1920x1080)
+
+| Area | Position | Size |
+|------|----------|------|
+| Title | y: 40px, centered | height: 80px |
+| Figure Container | centered | max-width: 1632px (85%), max-height: 756px (70%) |
+| Caption | y: 960px, centered | height: 60px |
+| Margins | all sides | 60px |
+
+## Color Specifications (academic-paper style)
+
+| Element | Color | Hex |
+|---------|-------|-----|
+| Background | White | #FFFFFF |
+| Title Text | Dark Blue-Gray | #1E3A5F |
+| Caption Text | Medium Gray | #6B7280 |
+| Figure Border | Light Gray | #E5E7EB |
+| Figure Shadow | Gray (10% opacity) | rgba(0,0,0,0.1) |
+
+## Typography
+
+### Title
+- Font: Sans-serif (system default: Arial, Helvetica)
+- Size: 48px (1920w) / 96px (3840w)
+- Weight: Bold (700)
+- Color: #1E3A5F
+- Alignment: Center
+- Max lines: 2
+
+### Caption
+- Font: Sans-serif (system default: Arial, Helvetica)
+- Size: 24px (1920w) / 48px (3840w)
+- Weight: Normal (400)
+- Style: Italic
+- Color: #6B7280
+- Alignment: Center
+- Format: "Figure N: [Caption text]"
+
+## Figure Area Styling
+
+### Container
+- Background: White (#FFFFFF)
+- Border: 1px solid #E5E7EB
+- Border Radius: 8px
+- Box Shadow: 0 4px 6px rgba(0,0,0,0.1)
+- Padding: 20px
+
+### Figure Scaling
+- Maintain aspect ratio
+- Scale to fit container (contain mode)
+- Center horizontally and vertically
+- Minimum margin from container edge: 20px
+
+## Implementation Notes
+
+### Canvas Setup (Node.js)
+
+```typescript
+import { createCanvas, loadImage } from 'canvas';
+
+const WIDTH = 1920;
+const HEIGHT = 1080;
+
+const canvas = createCanvas(WIDTH, HEIGHT);
+const ctx = canvas.getContext('2d');
+
+// Background
+ctx.fillStyle = '#FFFFFF';
+ctx.fillRect(0, 0, WIDTH, HEIGHT);
+```
+
+### Title Rendering
+
+```typescript
+ctx.fillStyle = '#1E3A5F';
+ctx.font = 'bold 48px Arial, Helvetica, sans-serif';
+ctx.textAlign = 'center';
+ctx.textBaseline = 'middle';
+ctx.fillText(title, WIDTH / 2, 80);
+```
+
+### Figure Placement
+
+```typescript
+// Load and scale figure
+const figure = await loadImage(figurePath);
+const maxWidth = WIDTH * 0.85;
+const maxHeight = HEIGHT * 0.70;
+
+const scale = Math.min(maxWidth / figure.width, maxHeight / figure.height);
+const scaledWidth = figure.width * scale;
+const scaledHeight = figure.height * scale;
+
+// Center position
+const x = (WIDTH - scaledWidth) / 2;
+const y = (HEIGHT - scaledHeight) / 2;
+
+// Draw shadow
+ctx.shadowColor = 'rgba(0,0,0,0.1)';
+ctx.shadowBlur = 12;
+ctx.shadowOffsetY = 4;
+
+// Draw border
+ctx.strokeStyle = '#E5E7EB';
+ctx.lineWidth = 1;
+ctx.strokeRect(x - 20, y - 20, scaledWidth + 40, scaledHeight + 40);
+
+// Draw figure
+ctx.drawImage(figure, x, y, scaledWidth, scaledHeight);
+```
+
+### Caption Rendering
+
+```typescript
+ctx.fillStyle = '#6B7280';
+ctx.font = 'italic 24px Arial, Helvetica, sans-serif';
+ctx.textAlign = 'center';
+ctx.textBaseline = 'middle';
+ctx.fillText(`Figure ${figureNum}: ${caption}`, WIDTH / 2, HEIGHT - 60);
+```
+
+## Variants
+
+### Minimal Container
+- No border or shadow
+- Figure fills more space (90% width)
+- Smaller title/caption (36px/18px)
+
+### With Sub-caption
+- Add second line below caption
+- For additional notes or source attribution
+- Smaller font (18px), lighter gray (#9CA3AF)
+
+### Table Container
+- Same layout as figure
+- Replace "Figure N" with "Table N"
+- Consider larger padding for table borders
+
+## Output Format
+
+- Format: PNG
+- Color Space: sRGB
+- Compression: Lossless
+- Filename: Same as slide filename from outline

package/dist/skills/paper-slide-deck/references/modification-guide.md

@@ -0,0 +1,85 @@
+# Slide Modification Guide
+
+Workflows for modifying individual slides after initial generation.
+
+## Edit Single Slide
+
+Regenerate a specific slide with modified content:
+
+1. Identify slide to edit (e.g., `03-slide-key-findings.png`)
+2. Update prompt in `prompts/03-slide-key-findings.md`
+3. If content changes significantly, update slug in filename
+4. Regenerate image using same session ID
+5. Regenerate PPTX and PDF
+
+## Add New Slide
+
+Insert a new slide at specified position:
+
+1. Specify insertion position (e.g., after slide 3)
+2. Create new prompt with appropriate slug (e.g., `04-slide-new-section.md`)
+3. Generate new slide image
+4. **Renumber files**: All subsequent slides increment NN by 1
+   - `04-slide-conclusion.png` → `05-slide-conclusion.png`
+   - Slugs remain unchanged
+5. Update `outline.md` with new slide entry
+6. Regenerate PPTX and PDF
+
+## Delete Slide
+
+Remove a slide and renumber:
+
+1. Identify slide to delete (e.g., `03-slide-key-findings.png`)
+2. Remove image file and prompt file
+3. **Renumber files**: All subsequent slides decrement NN by 1
+   - `04-slide-conclusion.png` → `03-slide-conclusion.png`
+   - Slugs remain unchanged
+4. Update `outline.md` to remove slide entry
+5. Regenerate PPTX and PDF
+
+## File Naming Convention
+
+Files use meaningful slugs for better readability:
+
+```
+NN-slide-[slug].png
+NN-slide-[slug].md (in prompts/)
+```
+
+Examples:
+- `01-slide-cover.png`
+- `02-slide-problem-statement.png`
+- `03-slide-key-findings.png`
+- `04-slide-back-cover.png`
+
+## Slug Rules
+
+| Rule | Description |
+|------|-------------|
+| Format | Kebab-case (lowercase, hyphens) |
+| Source | Derived from slide title/content |
+| Uniqueness | Must be unique within the deck |
+| Updates | Change slug when content changes significantly |
+
+## Renumbering Rules
+
+| Scenario | Action |
+|----------|--------|
+| Add slide | Increment NN for all subsequent slides |
+| Delete slide | Decrement NN for all subsequent slides |
+| Reorder slides | Update NN to match new positions |
+| Edit slide | NN unchanged, update slug if needed |
+
+**Important**: Slugs remain unchanged during renumbering. Only the NN prefix changes.
+
+## Post-Modification Checklist
+
+After any modification:
+
+- [ ] Image file renamed/created correctly
+- [ ] Prompt file renamed/created correctly
+- [ ] Subsequent files renumbered (if add/delete)
+- [ ] `outline.md` updated to reflect changes
+- [ ] PPTX regenerated
+- [ ] PDF regenerated
+- [ ] Slide count in outline header updated

package/dist/skills/paper-slide-deck/references/outline-template.md

@@ -0,0 +1,437 @@
+# Outline Template
+
+Standard structure for slide deck outlines with style instructions.
+
+## Outline Format
+
+```markdown
+# Slide Deck Outline
+
+**Topic**: [topic description]
+**Style**: [selected style]
+**Audience**: [target audience]
+**Language**: [output language]
+**Slide Count**: N slides
+**Generated**: YYYY-MM-DD HH:mm
+
+---
+
+<STYLE_INSTRUCTIONS>
+Design Aesthetic: [2-3 sentence description from style file]
+
+Background:
+  Color: [Name] ([Hex])
+  Texture: [description]
+
+Typography:
+  Primary Font: [detailed description for image generation]
+  Secondary Font: [detailed description for image generation]
+
+Color Palette:
+  Primary Text: [Name] ([Hex]) - [usage]
+  Background: [Name] ([Hex]) - [usage]
+  Accent 1: [Name] ([Hex]) - [usage]
+  Accent 2: [Name] ([Hex]) - [usage]
+
+Visual Elements:
+  - [element 1 with rendering guidance]
+  - [element 2 with rendering guidance]
+  - ...
+
+Style Rules:
+  Do: [guidelines from style file]
+  Don't: [anti-patterns from style file]
+</STYLE_INSTRUCTIONS>
+
+---
+
+[Slide entries follow...]
+```
+
+## Cover Slide Template
+
+```markdown
+## Slide 1 of N
+
+**Type**: Cover
+**Filename**: 01-slide-cover.png
+
+// NARRATIVE GOAL
+[What this slide achieves in the story arc]
+
+// KEY CONTENT
+Headline: [main title]
+Sub-headline: [supporting tagline]
+
+// VISUAL
+[Detailed visual description - specific elements, composition, mood]
+
+// LAYOUT
+Layout: [optional: layout name from gallery, e.g., title-hero]
+[Composition, hierarchy, spatial arrangement]
+```
+
+## Content Slide Template
+
+```markdown
+## Slide X of N
+
+**Type**: Content
+**Filename**: {NN}-slide-{slug}.png
+
+// NARRATIVE GOAL
+[What this slide achieves in the story arc]
+
+// KEY CONTENT
+Headline: [main message - narrative, not label]
+Sub-headline: [supporting context]
+Body:
+- [point 1 with specific detail]
+- [point 2 with specific detail]
+- [point 3 with specific detail]
+
+// VISUAL
+[Detailed visual description]
+
+// LAYOUT
+Layout: [optional: layout name from gallery]
+[Composition, hierarchy, spatial arrangement]
+```
+
+## Image Source Metadata (Automatic Figure Extraction)
+
+For academic presentations, IMAGE_SOURCE metadata is **automatically populated** based on figure detection.
+
+### Auto-Population Process
+
+1. **Figure Detection**: `detect-figures.ts` scans PDF and outputs `figures.json`
+2. **Mapping Algorithm**: Agent maps figures to slides using caption keywords:
+   - "architecture", "framework", "pipeline" → Methods slides
+   - "comparison", "results", "performance" → Results slides (quantitative)
+   - "qualitative", "visual", "segmentation" → Results slides (qualitative)
+   - Table I/II/III → Quantitative results slides
+3. **Auto-Insert**: `// IMAGE_SOURCE` blocks added to outline during generation
+
+### IMAGE_SOURCE Format
+
+```markdown
+// IMAGE_SOURCE
+Source: generate | extract
+Figure: [Figure/Table number from paper, e.g., "Figure 2", "Table 1"]
+Page: [PDF page number, 1-indexed]
+Caption: [Figure caption for container template]
+```
+
+### IMAGE_SOURCE Values
+
+| Value | Description | Processing |
+|-------|-------------|------------|
+| `generate` | AI generates the slide image (default) | Standard prompt → Gemini generation |
+| `extract` | Extract figure from source PDF | PDF extraction → Apply container template |
+
+### Auto-Mapping Rules
+
+| Figure Caption Contains | Maps To | Default Source |
+|-------------------------|---------|----------------|
+| architecture, framework, pipeline, network, overview | Methods slide | `extract` |
+| comparison, results, performance, evaluation | Quantitative results | `extract` |
+| qualitative, visual, segmentation, detection | Qualitative results | `extract` |
+| ablation, analysis | Analysis slide | `extract` |
+| Table I, Table II, TABLE 1, TABLE 2 | Results slide | `extract` |
+| motivation, challenge, problem | Background slide | `generate` |
+| illustration, concept, example | Any | `generate` |
+
+### Manual Override
+
+To override auto-detection, manually edit the `// IMAGE_SOURCE` block in outline:
+
+```markdown
+// IMAGE_SOURCE
+Source: extract    # Change to 'generate' if needed
+Figure: Figure 3   # Correct figure number if wrong
+Page: 5            # Correct page number if wrong
+Caption: Corrected caption text
+```
+
+### Example: Extracted Figure Slide
+
+```markdown
+## Slide 5 of 12
+
+**Type**: Content
+**Filename**: 05-slide-architecture.png
+
+// NARRATIVE GOAL
+Present the core network architecture
+
+// KEY CONTENT
+Headline: Proposed Architecture
+Sub-headline: Two-Stage Coarse-to-Fine Framework
+Body:
+- Stage 1: Global feature extraction
+- Stage 2: Local refinement module
+
+// VISUAL
+Central architecture diagram from Figure 2 of the paper
+
+// LAYOUT
+Layout: methods-diagram
+
+// IMAGE_SOURCE
+Source: extract
+Figure: Figure 2
+Page: 4
+Caption: Overall architecture of our proposed two-stage framework
+```
+
+### Example: Generated Slide (Default)
+
+```markdown
+## Slide 3 of 12
+
+**Type**: Content
+**Filename**: 03-slide-motivation.png
+
+// NARRATIVE GOAL
+Establish the problem motivation
+
+// KEY CONTENT
+Headline: Current Methods Fall Short
+Body:
+- Existing approaches struggle with X
+- Performance gap in Y scenarios
+
+// VISUAL
+Split comparison showing limitation vs desired outcome
+
+// LAYOUT
+Layout: binary-comparison
+
+// IMAGE_SOURCE
+Source: generate
+```
+
+**Note**: If `// IMAGE_SOURCE` section is omitted, defaults to `Source: generate`.
+
+## Back Cover Slide Template
+
+```markdown
+## Slide N of N
+
+**Type**: Back Cover
+**Filename**: {NN}-slide-back-cover.png
+
+// NARRATIVE GOAL
+[Meaningful closing - not just "thank you"]
+
+// KEY CONTENT
+Headline: [memorable closing statement or call-to-action]
+Body: [optional summary points or next steps]
+
+// VISUAL
+[Visual that reinforces the core message]
+
+// LAYOUT
+Layout: [optional: layout name from gallery]
+[Clean, impactful composition]
+```
+
+## STYLE_INSTRUCTIONS Block
+
+The `<STYLE_INSTRUCTIONS>` block contains all style-specific guidance for image generation:
+
+| Section | Content |
+|---------|---------|
+| Design Aesthetic | Overall visual direction from style file |
+| Background | Base color and texture details |
+| Typography | Font descriptions for Gemini (no font names, describe appearance) |
+| Color Palette | Named colors with hex codes and usage guidance |
+| Visual Elements | Specific graphic elements with rendering instructions |
+| Style Rules | Do/Don't guidelines from style file |
+
+**Important**: Typography descriptions must describe the visual appearance (e.g., "rounded sans-serif", "bold geometric") since image generators cannot use font names.
+
+## Section Dividers
+
+Use `---` (horizontal rule) between:
+- Header metadata and STYLE_INSTRUCTIONS
+- STYLE_INSTRUCTIONS and first slide
+- Each slide entry
+
+## Slide Numbering
+
+- Cover is always Slide 1
+- Content slides use sequential numbers
+- Back Cover is always final slide (N)
+- Filename prefix matches slide position: `01-`, `02-`, etc.
+
+## Filename Slugs
+
+Generate meaningful slugs from slide content:
+
+| Slide Type | Slug Pattern | Example |
+|------------|--------------|---------|
+| Cover | `cover` | `01-slide-cover.png` |
+| Content | `{topic-slug}` | `02-slide-problem-statement.png` |
+| Back Cover | `back-cover` | `10-slide-back-cover.png` |
+
+Slug rules:
+- Kebab-case (lowercase, hyphens)
+- Derived from headline or main topic
+- Maximum 30 characters
+- Unique within deck
+
+## Academic Slide Templates
+
+For `academic-paper` style presentations.
+
+### Academic Cover Slide
+
+```markdown
+## Slide 1 of N
+
+**Type**: Cover
+**Filename**: 01-slide-cover.png
+
+// NARRATIVE GOAL
+Establish paper title, authors, affiliations, and venue
+
+// KEY CONTENT
+Headline: [Paper Title - can be multi-line]
+Sub-headline: [Conference/Journal Name, Year]
+Authors: [Author1, Author2, Author3]
+Affiliations: [University/Company logos or names]
+
+// VISUAL
+Clean white background, centered title in dark blue, author names below, institutional logos/names at bottom
+
+// LAYOUT
+Layout: paper-title
+```
+
+### Methods/Architecture Slide
+
+```markdown
+## Slide X of N
+
+**Type**: Content
+**Filename**: {NN}-slide-method.png
+
+// NARRATIVE GOAL
+Present the core methodology or system architecture
+
+// KEY CONTENT
+Headline: [Method Name] / Our Approach
+Body:
+- Architecture diagram with labeled components
+- Data flow arrows between modules
+- Key innovation highlighted
+
+// VISUAL
+Central pipeline/architecture diagram, labeled boxes for each component, arrows showing data flow, key module emphasized with accent color
+
+// LAYOUT
+Layout: methods-diagram
+```
+
+### Results Slide (Quantitative)
+
+```markdown
+## Slide X of N
+
+**Type**: Content
+**Filename**: {NN}-slide-results.png
+
+// NARRATIVE GOAL
+Present main experimental results with clear comparisons
+
+// KEY CONTENT
+Headline: [Key finding - narrative, e.g., "Our method achieves state-of-the-art on X"]
+Body:
+- Table or chart with baselines
+- Best results highlighted
+- Metric names and units clear
+
+// VISUAL
+Clean table or bar chart, baseline rows in gray, our method highlighted in blue, best values in bold, clear column headers
+
+// LAYOUT
+Layout: results-chart
+```
+
+### Results Slide (Qualitative)
+
+```markdown
+## Slide X of N
+
+**Type**: Content
+**Filename**: {NN}-slide-qualitative.png
+
+// NARRATIVE GOAL
+Show visual comparison of results
+
+// KEY CONTENT
+Headline: [Qualitative Comparison]
+Body:
+- 2x2 or 3x2 grid of comparison images
+- Labels: Input, Baseline, Ours, Ground Truth
+- Caption describing what to observe
+
+// VISUAL
+Grid layout with equal-sized images, clear labels below each, subtle borders between cells
+
+// LAYOUT
+Layout: qualitative-grid
+```
+
+### Contributions Slide
+
+```markdown
+## Slide X of N
+
+**Type**: Content
+**Filename**: {NN}-slide-contributions.png
+
+// NARRATIVE GOAL
+Summarize key contributions of the work
+
+// KEY CONTENT
+Headline: Contributions
+Body:
+1. [First contribution - specific and measurable]
+2. [Second contribution]
+3. [Third contribution]
+(Optional: Code/data release information)
+
+// VISUAL
+Numbered list with checkmarks or icons, each contribution on separate line, clean spacing
+
+// LAYOUT
+Layout: contributions
+```
+
+### References Slide
+
+```markdown
+## Slide N of N
+
+**Type**: Back Cover
+**Filename**: {NN}-slide-references.png
+
+// NARRATIVE GOAL
+Acknowledge key related work and provide resources
+
+// KEY CONTENT
+Headline: References / Thank You
+Body:
+[1] Author et al. "Title." Venue, Year.
+[2] Author et al. "Title." Venue, Year.
+...
+(Optional: QR code for paper/code, contact email)
+
+// VISUAL
+Two-column reference list, smaller font, optional QR code in corner, "Questions?" or contact info at bottom
+
+// LAYOUT
+Layout: references-list
+```