fraim-framework 2.0.34 → 2.0.35

package/registry/scripts/markdown-to-pdf.js

@@ -0,0 +1,391 @@
+#!/usr/bin/env node
+
+/**
+ * Markdown to PDF Converter Script
+ * 
+ * This script converts markdown files to PDF using puppeteer and markdown-it.
+ * It supports various markdown features including tables, code blocks, and images.
+ * 
+ * EXECUTION MODEL:
+ * - Script location: ~/.fraim/scripts/markdown-to-pdf.js
+ * - Working directory: Current project directory (process.cwd())
+ * - Input/output files: Relative to current project directory
+ * - Config: Reads from .fraim/config.json in current project directory
+ * 
+ * Usage:
+ *   node ~/.fraim/scripts/markdown-to-pdf.js <input.md> [output.pdf] [options]
+ * 
+ * Options:
+ *   --format <format>     Paper format (A4, Letter, Legal, etc.) - default: A4
+ *   --margin <margin>     Page margins in inches - default: 0.5
+ *   --css <file>          Custom CSS file for styling
+ *   --header <text>       Header text
+ *   --footer <text>       Footer text
+ *   --landscape           Use landscape orientation
+ *   --no-background       Disable background graphics
+ * 
+ * Examples:
+ *   node ~/.fraim/scripts/markdown-to-pdf.js README.md
+ *   node ~/.fraim/scripts/markdown-to-pdf.js docs/spec.md output/spec.pdf --format Letter
+ *   node ~/.fraim/scripts/markdown-to-pdf.js report.md --css custom.css --header "Company Report"
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Get project directory (where the user is working)
+const PROJECT_DIR = process.cwd();
+const CONFIG_FILE = path.join(PROJECT_DIR, '.fraim', 'config.json');
+
+// Load project configuration if available
+function loadProjectConfig() {
+  try {
+    if (fs.existsSync(CONFIG_FILE)) {
+      const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+      return config;
+    }
+  } catch (error) {
+    console.warn('Warning: Could not load project config from .fraim/config.json');
+  }
+  return {};
+}
+
+// Check if required dependencies are available
+function checkDependencies() {
+  const requiredPackages = ['puppeteer', 'markdown-it', 'markdown-it-highlightjs'];
+  const missingPackages = [];
+
+  for (const pkg of requiredPackages) {
+    try {
+      require.resolve(pkg);
+    } catch (error) {
+      missingPackages.push(pkg);
+    }
+  }
+
+  if (missingPackages.length > 0) {
+    console.error('Missing required packages:', missingPackages.join(', '));
+    console.error('Install them with: npm install', missingPackages.join(' '));
+    process.exit(1);
+  }
+}
+
+// Parse command line arguments
+function parseArgs() {
+  const args = process.argv.slice(2);
+  
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    console.log(`
+Markdown to PDF Converter
+
+Usage: node ~/.fraim/scripts/markdown-to-pdf.js <input.md> [output.pdf] [options]
+
+Options:
+  --format <format>     Paper format (A4, Letter, Legal, etc.) - default: A4
+  --margin <margin>     Page margins in inches - default: 0.5
+  --css <file>          Custom CSS file for styling
+  --header <text>       Header text
+  --footer <text>       Footer text
+  --landscape           Use landscape orientation
+  --no-background       Disable background graphics
+  --help, -h            Show this help message
+
+Examples:
+  node ~/.fraim/scripts/markdown-to-pdf.js README.md
+  node ~/.fraim/scripts/markdown-to-pdf.js docs/spec.md output/spec.pdf --format Letter
+  node ~/.fraim/scripts/markdown-to-pdf.js report.md --css custom.css --header "Company Report"
+
+Working Directory: ${PROJECT_DIR}
+Config File: ${CONFIG_FILE}
+    `);
+    process.exit(0);
+  }
+
+  const config = {
+    input: args[0],
+    output: null,
+    format: 'A4',
+    margin: '0.5in',
+    css: null,
+    header: null,
+    footer: null,
+    landscape: false,
+    background: true
+  };
+
+  // Resolve input path relative to project directory
+  if (!path.isAbsolute(config.input)) {
+    config.input = path.resolve(PROJECT_DIR, config.input);
+  }
+
+  // Check if second argument is output file or option
+  if (args[1] && !args[1].startsWith('--')) {
+    config.output = args[1];
+  }
+
+  // Parse options
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    if (arg === '--format' && args[i + 1]) {
+      config.format = args[i + 1];
+      i++;
+    } else if (arg === '--margin' && args[i + 1]) {
+      config.margin = args[i + 1];
+      i++;
+    } else if (arg === '--css' && args[i + 1]) {
+      config.css = args[i + 1];
+      i++;
+    } else if (arg === '--header' && args[i + 1]) {
+      config.header = args[i + 1];
+      i++;
+    } else if (arg === '--footer' && args[i + 1]) {
+      config.footer = args[i + 1];
+      i++;
+    } else if (arg === '--landscape') {
+      config.landscape = true;
+    } else if (arg === '--no-background') {
+      config.background = false;
+    }
+  }
+
+  // Set default output if not provided
+  if (!config.output) {
+    const inputPath = path.parse(config.input);
+    config.output = path.join(inputPath.dir, inputPath.name + '.pdf');
+  }
+
+  // Resolve output path relative to project directory
+  if (!path.isAbsolute(config.output)) {
+    config.output = path.resolve(PROJECT_DIR, config.output);
+  }
+
+  // Resolve CSS path relative to project directory if provided
+  if (config.css && !path.isAbsolute(config.css)) {
+    config.css = path.resolve(PROJECT_DIR, config.css);
+  }
+
+  return config;
+}
+
+// Convert markdown to HTML
+async function markdownToHtml(markdownContent, customCss = null) {
+  const MarkdownIt = require('markdown-it');
+  const hljs = require('markdown-it-highlightjs');
+  
+  const md = new MarkdownIt({
+    html: true,
+    linkify: true,
+    typographer: true,
+    breaks: false
+  }).use(hljs);
+
+  const htmlContent = md.render(markdownContent);
+  
+  // Default CSS for better PDF rendering
+  const defaultCss = `
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      line-height: 1.6;
+      color: #333;
+      max-width: none;
+      margin: 0;
+      padding: 20px;
+    }
+    
+    h1, h2, h3, h4, h5, h6 {
+      color: #2c3e50;
+      margin-top: 2em;
+      margin-bottom: 1em;
+    }
+    
+    h1 { font-size: 2.5em; border-bottom: 2px solid #3498db; padding-bottom: 0.3em; }
+    h2 { font-size: 2em; border-bottom: 1px solid #bdc3c7; padding-bottom: 0.3em; }
+    h3 { font-size: 1.5em; }
+    
+    code {
+      background-color: #f8f9fa;
+      padding: 2px 4px;
+      border-radius: 3px;
+      font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
+    }
+    
+    pre {
+      background-color: #f8f9fa;
+      border: 1px solid #e9ecef;
+      border-radius: 6px;
+      padding: 16px;
+      overflow-x: auto;
+      margin: 1em 0;
+    }
+    
+    pre code {
+      background: none;
+      padding: 0;
+    }
+    
+    table {
+      border-collapse: collapse;
+      width: 100%;
+      margin: 1em 0;
+    }
+    
+    th, td {
+      border: 1px solid #ddd;
+      padding: 12px;
+      text-align: left;
+    }
+    
+    th {
+      background-color: #f2f2f2;
+      font-weight: bold;
+    }
+    
+    blockquote {
+      border-left: 4px solid #3498db;
+      margin: 1em 0;
+      padding-left: 1em;
+      color: #7f8c8d;
+    }
+    
+    img {
+      max-width: 100%;
+      height: auto;
+    }
+    
+    a {
+      color: #3498db;
+      text-decoration: none;
+    }
+    
+    a:hover {
+      text-decoration: underline;
+    }
+    
+    ul, ol {
+      padding-left: 2em;
+    }
+    
+    li {
+      margin: 0.5em 0;
+    }
+    
+    @media print {
+      body { margin: 0; }
+      h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
+      pre, blockquote { page-break-inside: avoid; }
+      img { page-break-inside: avoid; }
+    }
+  `;
+  
+  let customCssContent = '';
+  if (customCss && fs.existsSync(customCss)) {
+    customCssContent = fs.readFileSync(customCss, 'utf8');
+  }
+  
+  return `
+    <!DOCTYPE html>
+    <html>
+    <head>
+      <meta charset="utf-8">
+      <title>Converted from Markdown</title>
+      <style>${defaultCss}${customCssContent}</style>
+    </head>
+    <body>
+      ${htmlContent}
+    </body>
+    </html>
+  `;
+}
+
+// Convert HTML to PDF using Puppeteer
+async function htmlToPdf(html, outputPath, config) {
+  const puppeteer = require('puppeteer');
+  
+  const browser = await puppeteer.launch({
+    headless: 'new',
+    args: ['--no-sandbox', '--disable-setuid-sandbox']
+  });
+  
+  try {
+    const page = await browser.newPage();
+    await page.setContent(html, { waitUntil: 'networkidle0' });
+    
+    const pdfOptions = {
+      path: outputPath,
+      format: config.format,
+      margin: {
+        top: config.margin,
+        right: config.margin,
+        bottom: config.margin,
+        left: config.margin
+      },
+      landscape: config.landscape,
+      printBackground: config.background,
+      preferCSSPageSize: true
+    };
+    
+    if (config.header) {
+      pdfOptions.displayHeaderFooter = true;
+      pdfOptions.headerTemplate = `<div style="font-size: 10px; width: 100%; text-align: center;">${config.header}</div>`;
+    }
+    
+    if (config.footer) {
+      pdfOptions.displayHeaderFooter = true;
+      pdfOptions.footerTemplate = `<div style="font-size: 10px; width: 100%; text-align: center;">${config.footer}</div>`;
+    }
+    
+    await page.pdf(pdfOptions);
+    console.log(`✅ PDF generated successfully: ${path.relative(PROJECT_DIR, outputPath)}`);
+    
+  } finally {
+    await browser.close();
+  }
+}
+
+// Main function
+async function main() {
+  try {
+    checkDependencies();
+    const config = parseArgs();
+    const projectConfig = loadProjectConfig();
+    
+    console.log(`📄 Converting markdown to PDF...`);
+    console.log(`   Working directory: ${PROJECT_DIR}`);
+    console.log(`   Input: ${path.relative(PROJECT_DIR, config.input)}`);
+    console.log(`   Output: ${path.relative(PROJECT_DIR, config.output)}`);
+    
+    // Validate input file
+    if (!fs.existsSync(config.input)) {
+      console.error(`❌ Input file not found: ${path.relative(PROJECT_DIR, config.input)}`);
+      process.exit(1);
+    }
+    
+    // Ensure output directory exists
+    const outputDir = path.dirname(config.output);
+    if (!fs.existsSync(outputDir)) {
+      fs.mkdirSync(outputDir, { recursive: true });
+      console.log(`📁 Created output directory: ${path.relative(PROJECT_DIR, outputDir)}`);
+    }
+    
+    // Read markdown file
+    const markdownContent = fs.readFileSync(config.input, 'utf8');
+    
+    // Convert to HTML
+    const html = await markdownToHtml(markdownContent, config.css);
+    
+    // Convert to PDF
+    await htmlToPdf(html, config.output, config);
+    
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run if called directly
+if (require.main === module) {
+  main();
+}
+
+module.exports = { markdownToHtml, htmlToPdf, parseArgs };

package/registry/scripts/prep-issue.sh

@@ -134,6 +134,7 @@ try {
     
     // Support both 'repository' (new) and 'git' (legacy/current) schemas
     let repo = config.repository;
+    let defaultBranch = 'master'; // Default fallback
     
     if (!repo) {
         if (config.git) {
@@ -142,13 +143,18 @@ try {
                 name: config.git.repoName,
                 url: config.git.repoUrl || \`https://github.com/\${config.git.repoOwner}/\${config.git.repoName}.git\`
             };
+            // Extract defaultBranch from git config
+            defaultBranch = config.git.defaultBranch || 'master';
         }
+    } else {
+        // Extract defaultBranch from repository config
+        defaultBranch = repo.defaultBranch || 'master';
     }
 
     if (!repo || !repo.owner || !repo.name || !repo.url) {
         process.exit(1);
     }
-    console.log(\`\${repo.owner}:\${repo.name}:\${repo.url}\`);
+    console.log(\`\${repo.owner}|\${repo.name}|\${repo.url}|\${defaultBranch}\`);
 } catch (e) {
     process.exit(1);
 }
@@ -161,13 +167,14 @@ if [ $? -ne 0 ]; then
     exit 1
 fi
 
-# Split the result into variables
-IFS=':' read -r REPO_OWNER REPO_NAME REPO_URL <<< "$REPO_INFO"
+# Split the result into variables using pipe delimiter
+IFS='|' read -r REPO_OWNER REPO_NAME REPO_URL CONFIG_DEFAULT_BRANCH <<< "$REPO_INFO"
 
 echo "Repository Configuration:"
 echo "  Owner: $REPO_OWNER"
 echo "  Name:  $REPO_NAME"
 echo "  URL:   $REPO_URL"
+echo "  Default Branch: $CONFIG_DEFAULT_BRANCH"
 echo
 
 echo "=== $REPO_NAME - Issue Preparation ==="
@@ -195,45 +202,69 @@ echo "Step 1: Determining base branch from current repository..."
 
 # Determine base branch from the ORIGINAL repository (before cloning)
 if [ "$USE_DEFAULT_BRANCH" = true ]; then
-    # Detect the default branch
-    DEFAULT_BRANCH=""
-    for candidate in main master develop; do
-        if git ls-remote --exit-code --heads "$REPO_URL" "$candidate" >/dev/null 2>&1; then
-            DEFAULT_BRANCH="$candidate"
-            echo "✓ Detected default branch: $DEFAULT_BRANCH"
-            break
-        fi
-    done
-    
-    # Fallback to master if nothing else worked
-    if [ -z "$DEFAULT_BRANCH" ]; then
-        DEFAULT_BRANCH="master"
-        echo "⚠️  Could not detect default branch, defaulting to: $DEFAULT_BRANCH"
-    fi
-    
-    BASE_BRANCH="$DEFAULT_BRANCH"
-    echo "Using detected default branch as base: $BASE_BRANCH (--use-default flag)"
-else
-    # Get current branch from the original repo
-    ORIGINAL_BRANCH=$(git branch --show-current 2>/dev/null || echo "")
+    # Use the default branch from FRAIM config
+    DEFAULT_BRANCH="$CONFIG_DEFAULT_BRANCH"
+    echo "✓ Using default branch from FRAIM config: $DEFAULT_BRANCH"
     
-    if [ -z "$ORIGINAL_BRANCH" ]; then
-        echo "Warning: Detached HEAD detected in original repo, falling back to default branch detection"
+    # Verify the branch exists on remote
+    if git ls-remote --exit-code --heads "$REPO_URL" "$DEFAULT_BRANCH" >/dev/null 2>&1; then
+        echo "✓ Confirmed branch '$DEFAULT_BRANCH' exists on remote"
+    else
+        echo "⚠️  Warning: Configured default branch '$DEFAULT_BRANCH' not found on remote"
+        echo "   Falling back to branch detection..."
         
-        # Detect the default branch
+        # Fallback to detection if configured branch doesn't exist
         DEFAULT_BRANCH=""
         for candidate in main master develop; do
             if git ls-remote --exit-code --heads "$REPO_URL" "$candidate" >/dev/null 2>&1; then
                 DEFAULT_BRANCH="$candidate"
-                echo "✓ Detected default branch: $DEFAULT_BRANCH"
+                echo "✓ Detected fallback branch: $DEFAULT_BRANCH"
                 break
             fi
         done
         
-        # Fallback to master if nothing else worked
+        # Final fallback to master
         if [ -z "$DEFAULT_BRANCH" ]; then
             DEFAULT_BRANCH="master"
-            echo "⚠️  Could not detect default branch, defaulting to: $DEFAULT_BRANCH"
+            echo "⚠️  Could not detect any branch, defaulting to: $DEFAULT_BRANCH"
+        fi
+    fi
+    
+    BASE_BRANCH="$DEFAULT_BRANCH"
+    echo "Using default branch as base: $BASE_BRANCH (--use-default flag)"
+else
+    # Get current branch from the original repo
+    ORIGINAL_BRANCH=$(git branch --show-current 2>/dev/null || echo "")
+    
+    if [ -z "$ORIGINAL_BRANCH" ]; then
+        echo "Warning: Detached HEAD detected in original repo, falling back to configured default branch"
+        
+        # Use the default branch from FRAIM config
+        DEFAULT_BRANCH="$CONFIG_DEFAULT_BRANCH"
+        echo "✓ Using default branch from FRAIM config: $DEFAULT_BRANCH"
+        
+        # Verify the branch exists on remote
+        if git ls-remote --exit-code --heads "$REPO_URL" "$DEFAULT_BRANCH" >/dev/null 2>&1; then
+            echo "✓ Confirmed branch '$DEFAULT_BRANCH' exists on remote"
+        else
+            echo "⚠️  Warning: Configured default branch '$DEFAULT_BRANCH' not found on remote"
+            echo "   Falling back to branch detection..."
+            
+            # Fallback to detection if configured branch doesn't exist
+            DEFAULT_BRANCH=""
+            for candidate in main master develop; do
+                if git ls-remote --exit-code --heads "$REPO_URL" "$candidate" >/dev/null 2>&1; then
+                    DEFAULT_BRANCH="$candidate"
+                    echo "✓ Detected fallback branch: $DEFAULT_BRANCH"
+                    break
+                fi
+            done
+            
+            # Final fallback to master
+            if [ -z "$DEFAULT_BRANCH" ]; then
+                DEFAULT_BRANCH="master"
+                echo "⚠️  Could not detect any branch, defaulting to: $DEFAULT_BRANCH"
+            fi
         fi
         
         BASE_BRANCH="$DEFAULT_BRANCH"

package/registry/templates/marketing/STORYTELLING-TEMPLATE.md

@@ -0,0 +1,130 @@
+# Template: Marketing Storytelling
+
+Use this template to transform product development experiences into compelling founder narratives for events and speaking opportunities.
+
+## Project Setup
+- **Product/Project Name**: 
+- **Issue Number**: 
+- **Target Event**: 
+- **Event Type**: [Conference Talk / Panel / Workshop / Podcast / Accelerator / Meetup]
+- **Audience**: [Technical / Business / Mixed]
+- **Event Date**: 
+- **Submission Deadline**: 
+
+## Story Arc Development
+
+### Original Intent
+**What was the vision?**
+
+
+**Why did it matter?**
+
+
+**What problem were you solving?**
+
+
+### Friction Points
+**What unexpected challenges emerged?**
+
+
+**What failures or setbacks occurred?**
+
+
+**What assumptions proved wrong?**
+
+
+### Key Insights
+**What "aha moments" happened?**
+
+
+**What counterintuitive discoveries were made?**
+
+
+**What would you do differently?**
+
+
+### Final Outcome
+**What was actually built?**
+
+
+**Why does it work?**
+
+
+**What makes it different/better?**
+
+
+## Founder Lessons (3-5 key takeaways)
+
+### Lesson 1
+**Lesson**: 
+**Context**: 
+**Application**: 
+
+### Lesson 2
+**Lesson**: 
+**Context**: 
+**Application**: 
+
+### Lesson 3
+**Lesson**: 
+**Context**: 
+**Application**: 
+
+## Event Content
+
+### Session Title Options
+1. 
+2. 
+3. 
+
+### Session Description (1-2 sentences)
+
+
+### Email Pitch (2-3 paragraphs)
+
+
+### Speaker Bio (50-100 words)
+
+
+### Presentation Outline
+
+#### 5-Minute Version
+- **Hook** (1 min): 
+- **Problem** (1 min): 
+- **Journey** (2 min): 
+- **Takeaway** (1 min): 
+
+#### 15-Minute Version
+- **Opening** (2 min): 
+- **Problem Setup** (3 min): 
+- **Journey/Challenges** (5 min): 
+- **Insights/Solutions** (3 min): 
+- **Takeaways** (2 min): 
+
+#### 30-Minute Version
+- **Introduction** (3 min): 
+- **Context/Background** (5 min): 
+- **Challenge Deep-Dive** (8 min): 
+- **Solution Journey** (8 min): 
+- **Lessons & Applications** (4 min): 
+- **Q&A Prep** (2 min): 
+
+### Q&A Preparation
+**Likely Questions**:
+1. Q: 
+   A: 
+
+2. Q: 
+   A: 
+
+3. Q: 
+   A: 
+
+## Quality Checklist
+- [ ] Story is grounded in actual experience
+- [ ] Avoids internal jargon
+- [ ] Follows clear story arc (intent → friction → insight → outcome)
+- [ ] Provides actionable lessons
+- [ ] Sounds authentic, not sales-y
+- [ ] Matches event format and audience
+- [ ] Professional presentation materials ready