crewly 1.5.14 → 1.5.15

package/config/skills/_common/lib.sh

@@ -21,8 +21,10 @@ CREWLY_API_URL="${CREWLY_API_URL:-http://localhost:8787}"
 # and replaces the script's positional parameters with the file contents.
 # All downstream parsing (read_json_input, custom arg loops) works unchanged.
 #
-# Usage (by LLM CLI):
-#   printf '%s' '{"summary":"text with 'quotes'"}' > /tmp/crewly_input.json
+# Usage (by LLM CLI — use heredoc to avoid single-quote EOF issues):
+#   cat > /tmp/crewly_input.json << 'CREWLY_EOF'
+#   {"summary":"text with 'quotes' and special chars"}
+#   CREWLY_EOF
 #   bash execute.sh --file /tmp/crewly_input.json
 #
 # This runs at source-time, so every script that sources lib.sh gets it for free.

package/config/skills/_common/lib.test.sh

@@ -156,6 +156,34 @@ echo '{}' > "$TEMP_DIR/empty.json"
 RESULT=$(bash "$TEMP_DIR/test_read_json.sh" --file "$TEMP_DIR/empty.json")
 assert_eq "--file with empty JSON" '{}' "$RESULT"
 
+# ---- Test 14: --file with heredoc-created file (single quotes in JSON) ----
+# This simulates the exact pattern Gemini CLI agents now use:
+#   cat > /tmp/file << 'CREWLY_EOF'
+#   {"summary":"it's working — don't worry"}
+#   CREWLY_EOF
+cat > "$TEMP_DIR/heredoc_single_quotes.json" << 'CREWLY_EOF'
+{"summary":"it's working — don't worry about 'edge cases'"}
+CREWLY_EOF
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/heredoc_single_quotes.json")
+assert_contains "heredoc with single quotes" "it's working" "$RESULT"
+assert_contains "heredoc with multiple single quotes" "edge cases" "$RESULT"
+
+# ---- Test 15: --file with heredoc-created file (backticks and $vars) ----
+cat > "$TEMP_DIR/heredoc_special.json" << 'CREWLY_EOF'
+{"text":"Use `jq` to parse $HOME and $(whoami) safely"}
+CREWLY_EOF
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/heredoc_special.json")
+assert_contains "heredoc preserves backticks" '`jq`' "$RESULT"
+assert_contains "heredoc preserves \$HOME" '$HOME' "$RESULT"
+assert_contains "heredoc preserves \$()" '$(whoami)' "$RESULT"
+
+# ---- Test 16: --file with heredoc-created file (mixed quotes) ----
+cat > "$TEMP_DIR/heredoc_mixed.json" << 'CREWLY_EOF'
+{"text":"He said \"it's fine\" and she said 'OK'"}
+CREWLY_EOF
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/heredoc_mixed.json")
+assert_contains "heredoc handles mixed quotes" "it's fine" "$RESULT"
+
 echo ""
 echo "=== Results: $PASS/$TOTAL passed, $FAIL failed ==="
 

package/config/skills/agent/screenshot-compare/execute.sh

@@ -15,7 +15,7 @@
 set -euo pipefail
 
 # ── Configuration ──────────────────────────────────────────────────────────────
-MODEL="${GEMINI_MODEL:-gemini-2.5-flash-preview-05-20}"
+MODEL="${GEMINI_MODEL:-gemini-2.0-flash}"
 GEMINI_API_BASE="https://generativelanguage.googleapis.com"
 GEMINI_CONTENT_URL="${GEMINI_API_BASE}/v1beta/models/${MODEL}:generateContent"
 MAX_IMAGE_SIZE_MB=4
@@ -149,12 +149,12 @@ REQUEST_BODY=$(cat <<ENDJSON
 ENDJSON
 )
 
-TMPFILE=$(mktemp /tmp/gemini-compare-XXXXXX.json)
+TMPFILE="/tmp/gemini-compare-$(date +%s).json"
 echo "$REQUEST_BODY" > "$TMPFILE"
-RESPONSE=$(curl -sf -X POST \
+RESPONSE=$(curl -s -X POST \
   "${GEMINI_CONTENT_URL}?key=${GEMINI_API_KEY}" \
   -H "Content-Type: application/json" \
-  -d "@${TMPFILE}" 2>&1)
+  -d "@${TMPFILE}")
 rm -f "$TMPFILE"
 
 HTTP_CODE=$?

package/config/skills/agent/xhs-article-to-image/SKILL.md

@@ -0,0 +1,52 @@
+# xhs-article-to-image
+
+Convert markdown articles into XiaoHongShu (小红书) style image cards.
+
+## Description
+
+Generates multiple PNG images (1080×1440, 3:4 portrait ratio) from markdown article content, styled in the popular XiaoHongShu magazine-layout format: bold titles, clean white backgrounds, structured paragraphs with visual hierarchy.
+
+## Usage
+
+```bash
+bash execute.sh '{"content":"# Title\n\nArticle body...","outputDir":"/tmp/xhs-output"}'
+```
+
+Or from a file:
+```bash
+bash execute.sh '{"sourceFile":"/path/to/article.md","outputDir":"/tmp/xhs-output"}'
+```
+
+## Parameters
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| content | Yes* | - | Markdown article content (required if no sourceFile) |
+| sourceFile | Yes* | - | Path to markdown file (required if no content) |
+| outputDir | Yes | - | Directory to write PNG images to |
+| title | No | auto | Override the article title (auto-extracts from first H1) |
+| author | No | "" | Author name shown at bottom of pages |
+| accentColor | No | "#1a1a1a" | Accent color for decorative elements |
+| bgColor | No | "#fafaf8" | Background color |
+| maxCharsPerPage | No | 350 | Approximate characters per page before splitting |
+| coverImage | No | "" | URL or path to image for the cover page |
+
+## Output
+
+- Multiple PNG files: `page-01.png`, `page-02.png`, etc.
+- First page is the title/cover page
+- Returns JSON with file paths and metadata
+
+## Dependencies
+
+- Node.js 18+
+- Playwright (chromium)
+
+## Style Features
+
+- 3:4 portrait ratio (1080×1440px) optimized for XHS
+- Bold sans-serif Chinese/English typography (Noto Sans SC)
+- Clean white/cream background with subtle decorative elements
+- Magazine-style paragraph layout with visual breathing room
+- Page numbering (current/total)
+- Optional author attribution

package/config/skills/agent/xhs-article-to-image/execute.sh

@@ -0,0 +1,120 @@
+#!/bin/bash
+# Convert markdown articles into XiaoHongShu-style image cards (1080x1440 PNG)
+# Uses Playwright to render HTML+CSS templates and capture screenshots.
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT=$(read_json_input "${1:-}")
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"content\":\"# Title\\n\\nBody...\",\"outputDir\":\"/tmp/xhs\"}' or '{\"sourceFile\":\"/path/to/article.md\",\"outputDir\":\"/tmp/xhs\"}'"
+
+# Parse parameters
+CONTENT=$(printf '%s' "$INPUT" | jq -r '.content // empty')
+SOURCE_FILE=$(printf '%s' "$INPUT" | jq -r '.sourceFile // empty')
+OUTPUT_DIR=$(printf '%s' "$INPUT" | jq -r '.outputDir // empty')
+TITLE_OVERRIDE=$(printf '%s' "$INPUT" | jq -r '.title // empty')
+AUTHOR=$(printf '%s' "$INPUT" | jq -r '.author // empty')
+ACCENT_COLOR=$(printf '%s' "$INPUT" | jq -r '.accentColor // "#1a1a1a"')
+BG_COLOR=$(printf '%s' "$INPUT" | jq -r '.bgColor // "#fafaf8"')
+MAX_CHARS=$(printf '%s' "$INPUT" | jq -r '.maxCharsPerPage // "350"')
+COVER_IMAGE=$(printf '%s' "$INPUT" | jq -r '.coverImage // empty')
+
+# Load content from file if sourceFile is provided
+if [ -n "$SOURCE_FILE" ]; then
+  if [ ! -f "$SOURCE_FILE" ]; then
+    error_exit "Source file not found: $SOURCE_FILE"
+  fi
+  CONTENT=$(cat "$SOURCE_FILE")
+fi
+
+require_param "content" "$CONTENT"
+require_param "outputDir" "$OUTPUT_DIR"
+
+# Create output directory
+mkdir -p "$OUTPUT_DIR"
+
+# Extract title from markdown (first # heading)
+if [ -n "$TITLE_OVERRIDE" ]; then
+  TITLE="$TITLE_OVERRIDE"
+else
+  TITLE=$(echo "$CONTENT" | grep -m1 '^# ' | sed 's/^# //' || echo "Untitled")
+  if [ -z "$TITLE" ]; then
+    TITLE="Untitled"
+  fi
+fi
+
+# Remove title line from content body
+BODY=$(echo "$CONTENT" | sed '0,/^# .*$/d')
+if [ -z "$BODY" ]; then
+  BODY="$CONTENT"
+fi
+
+# ─── Split content into pages ─────────────────────────────────────────────────
+# Split on explicit --- page breaks first, then by character count
+
+# Use node to do the splitting and rendering (complex text processing)
+RENDER_INPUT=$(jq -n \
+  --arg title "$TITLE" \
+  --arg author "$AUTHOR" \
+  --arg accentColor "$ACCENT_COLOR" \
+  --arg bgColor "$BG_COLOR" \
+  --arg outputDir "$OUTPUT_DIR" \
+  --arg coverImage "$COVER_IMAGE" \
+  --arg body "$BODY" \
+  --argjson maxChars "$MAX_CHARS" \
+  '{
+    title: $title,
+    author: $author,
+    accentColor: $accentColor,
+    bgColor: $bgColor,
+    outputDir: $outputDir,
+    coverImage: $coverImage,
+    maxChars: $maxChars,
+    body: $body
+  }')
+
+# Use Node.js to split content into pages (handles complex markdown parsing)
+PAGES_JSON=$(node -e "
+const input = JSON.parse(process.argv[1]);
+const body = input.body;
+const maxChars = input.maxChars;
+
+function splitIntoPages(markdown, maxChars) {
+  const explicitSections = markdown.split(/\n---\n/).filter(s => s.trim());
+  const pages = [];
+  for (const section of explicitSections) {
+    if (section.length <= maxChars) {
+      pages.push(section.trim());
+      continue;
+    }
+    const blocks = section.split(/\n\n/).filter(b => b.trim());
+    let currentPage = '';
+    for (const block of blocks) {
+      if (currentPage.length > 0 && currentPage.length + block.length > maxChars) {
+        pages.push(currentPage.trim());
+        currentPage = block;
+      } else {
+        currentPage += (currentPage ? '\n\n' : '') + block;
+      }
+    }
+    if (currentPage.trim()) pages.push(currentPage.trim());
+  }
+  return pages.length > 0 ? pages : [markdown.trim()];
+}
+
+const pages = splitIntoPages(body, maxChars);
+console.log(JSON.stringify(pages));
+" "$RENDER_INPUT")
+
+# Build final render input with pages array
+FINAL_INPUT=$(printf '%s' "$RENDER_INPUT" | jq --argjson pages "$PAGES_JSON" '. + {pages: $pages} | del(.body, .maxChars)')
+
+# Run Playwright renderer
+RESULT=$(node "$SCRIPT_DIR/render.mjs" "$FINAL_INPUT" 2>&1)
+
+# Check for errors
+if echo "$RESULT" | jq -e '.success == true' > /dev/null 2>&1; then
+  echo "$RESULT" | jq --arg title "$TITLE" '. + {title: $title}'
+else
+  error_exit "Rendering failed: $RESULT"
+fi

package/config/skills/agent/xhs-article-to-image/render.mjs

@@ -0,0 +1,601 @@
+/**
+ * XHS Article-to-Image Renderer
+ *
+ * Converts markdown article content into multiple XiaoHongShu-style
+ * PNG image cards (1080×1440, 3:4 portrait) using Playwright.
+ *
+ * Input: JSON via argv[2] with { pages, title, author, accentColor, bgColor, outputDir, coverImage }
+ * Output: PNG files written to outputDir, JSON result to stdout.
+ */
+import { chromium } from 'playwright';
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join, resolve } from 'path';
+
+const WIDTH = 1080;
+const HEIGHT = 1440;
+
+const input = JSON.parse(process.argv[2]);
+const {
+  pages,
+  title = 'Untitled',
+  author = '',
+  accentColor = '#1a1a1a',
+  bgColor = '#fafaf8',
+  outputDir,
+  coverImage = '',
+} = input;
+
+mkdirSync(outputDir, { recursive: true });
+
+/**
+ * Generate the HTML for the cover (first) page.
+ *
+ * @param {string} title - Article title
+ * @param {string} author - Author name
+ * @param {string} accentColor - Accent color hex
+ * @param {string} bgColor - Background color hex
+ * @param {string} coverImage - Optional cover image URL/path
+ * @param {number} totalPages - Total page count
+ * @returns {string} Complete HTML string
+ */
+function buildCoverHTML(title, author, accentColor, bgColor, coverImage, totalPages) {
+  const imageBlock = coverImage
+    ? `<div class="cover-image"><img src="${coverImage}" alt="cover" /></div>`
+    : '';
+
+  return `<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+${getBaseStyles(bgColor, accentColor)}
+
+.cover-container {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  height: 100%;
+  padding: 100px 80px;
+  box-sizing: border-box;
+  text-align: center;
+}
+
+.cover-decoration-top {
+  width: 60px;
+  height: 4px;
+  background: ${accentColor};
+  margin-bottom: 50px;
+  border-radius: 2px;
+}
+
+.cover-title {
+  font-size: 72px;
+  font-weight: 900;
+  line-height: 1.4;
+  color: ${accentColor};
+  letter-spacing: -1px;
+  margin-bottom: 40px;
+  max-width: 900px;
+  word-break: break-word;
+  padding: 0 20px;
+}
+
+.cover-container::before {
+  content: '';
+  position: absolute;
+  top: 0; left: 0; right: 0; height: 15px;
+  background: ${accentColor};
+}
+
+.cover-decoration-bottom {
+  width: 120px;
+  height: 2px;
+  background: ${accentColor}33;
+  margin-bottom: 40px;
+}
+
+.cover-author {
+  font-size: 28px;
+  color: #888;
+  font-weight: 400;
+  letter-spacing: 2px;
+}
+
+.cover-image {
+  width: 100%;
+  max-width: 700px;
+  margin-bottom: 50px;
+  border-radius: 16px;
+  overflow: hidden;
+}
+
+.cover-image img {
+  width: 100%;
+  height: auto;
+  display: block;
+  object-fit: cover;
+  max-height: 500px;
+}
+
+.page-indicator {
+  position: absolute;
+  bottom: 50px;
+  right: 80px;
+  font-size: 22px;
+  color: #ccc;
+  font-weight: 300;
+}
+</style>
+</head>
+<body>
+<div class="cover-container">
+  <div class="cover-decoration-top"></div>
+  ${imageBlock}
+  <div class="cover-title">${escapeHTML(title)}</div>
+  <div class="cover-decoration-bottom"></div>
+  ${author ? `<div class="cover-author">${escapeHTML(author)}</div>` : ''}
+</div>
+<div class="page-indicator">1 / ${totalPages}</div>
+</body>
+</html>`;
+}
+
+/**
+ * Generate the HTML for a content page.
+ *
+ * @param {string} contentHTML - Pre-rendered HTML content for this page
+ * @param {number} pageNum - Current page number (1-based)
+ * @param {number} totalPages - Total page count
+ * @param {string} title - Article title (shown as header)
+ * @param {string} accentColor - Accent color hex
+ * @param {string} bgColor - Background color hex
+ * @returns {string} Complete HTML string
+ */
+function buildContentPageHTML(contentHTML, pageNum, totalPages, title, accentColor, bgColor) {
+  return `<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+${getBaseStyles(bgColor, accentColor)}
+
+.page-header {
+  padding: 60px 80px 0 80px;
+  display: flex;
+  align-items: center;
+  gap: 16px;
+}
+
+.page-header-line {
+  width: 30px;
+  height: 3px;
+  background: ${accentColor};
+  border-radius: 2px;
+  flex-shrink: 0;
+}
+
+.page-header-title {
+  font-size: 20px;
+  font-weight: 600;
+  color: #bbb;
+  letter-spacing: 1px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.content-area {
+  padding: 40px 80px 80px 80px;
+  flex: 1;
+}
+
+.content-area h2 {
+  font-size: 42px;
+  font-weight: 800;
+  color: ${accentColor};
+  margin: 0 0 28px 0;
+  line-height: 1.35;
+  letter-spacing: -0.5px;
+}
+
+.content-area h3 {
+  font-size: 34px;
+  font-weight: 700;
+  color: ${accentColor};
+  margin: 0 0 22px 0;
+  line-height: 1.35;
+}
+
+.content-area p {
+  font-size: 30px;
+  line-height: 1.75;
+  color: #333;
+  margin: 0 0 24px 0;
+  font-weight: 400;
+}
+
+.content-area ul, .content-area ol {
+  padding-left: 40px;
+  margin: 0 0 24px 0;
+}
+
+.content-area li {
+  font-size: 30px;
+  line-height: 1.7;
+  color: #333;
+  margin-bottom: 12px;
+}
+
+.content-area strong {
+  font-weight: 700;
+  color: ${accentColor};
+}
+
+.content-area em {
+  font-style: italic;
+  color: #555;
+}
+
+.content-area blockquote {
+  border-left: 4px solid ${accentColor}44;
+  margin: 0 0 24px 0;
+  padding: 16px 24px;
+  background: ${accentColor}08;
+  border-radius: 0 12px 12px 0;
+}
+
+.content-area blockquote p {
+  font-size: 28px;
+  color: #555;
+  margin: 0;
+  font-style: italic;
+}
+
+.content-area img {
+  max-width: 100%;
+  border-radius: 12px;
+  margin: 16px 0;
+}
+
+.content-area code {
+  background: #f0f0f0;
+  padding: 2px 8px;
+  border-radius: 4px;
+  font-size: 26px;
+  font-family: 'SF Mono', 'Menlo', monospace;
+}
+
+.page-indicator {
+  position: absolute;
+  bottom: 50px;
+  right: 80px;
+  font-size: 22px;
+  color: #ccc;
+  font-weight: 300;
+}
+
+.page-footer-decoration {
+  position: absolute;
+  bottom: 45px;
+  left: 80px;
+  width: 40px;
+  height: 3px;
+  background: ${accentColor}22;
+  border-radius: 2px;
+}
+</style>
+</head>
+<body>
+<div class="page-header">
+  <div class="page-header-line"></div>
+  <div class="page-header-title">${escapeHTML(title)}</div>
+</div>
+<div class="content-area">
+  ${contentHTML}
+</div>
+<div class="page-footer-decoration"></div>
+<div class="page-indicator">${pageNum} / ${totalPages}</div>
+</body>
+</html>`;
+}
+
+/**
+ * Shared base CSS styles for all pages.
+ *
+ * @param {string} bgColor - Background color
+ * @param {string} accentColor - Accent/text color
+ * @returns {string} CSS string
+ */
+function getBaseStyles(bgColor, accentColor) {
+  return `
+@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@300;400;500;600;700;800;900&display=swap');
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  width: ${WIDTH}px;
+  height: ${HEIGHT}px;
+  background: ${bgColor};
+  font-family: 'Noto Sans SC', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', -apple-system, BlinkMacSystemFont, sans-serif;
+  overflow: hidden;
+  position: relative;
+}
+`;
+}
+
+/**
+ * Escape HTML special characters.
+ *
+ * @param {string} str - Raw string
+ * @returns {string} Escaped HTML string
+ */
+function escapeHTML(str) {
+  return str
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+/**
+ * Simple markdown to HTML converter.
+ * Handles: h1-h3, bold, italic, lists, blockquotes, images, links, code, paragraphs.
+ *
+ * @param {string} md - Markdown text
+ * @returns {string} HTML string
+ */
+function markdownToHTML(md) {
+  let html = md;
+
+  // Images: ![alt](url)
+  html = html.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '<img src="$2" alt="$1" />');
+
+  // Links: [text](url) → just text (no clickable links in images)
+  html = html.replace(/\[([^\]]+)\]\([^)]+\)/g, '<strong>$1</strong>');
+
+  // Bold: **text** or __text__
+  html = html.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>');
+  html = html.replace(/__(.+?)__/g, '<strong>$1</strong>');
+
+  // Italic: *text* or _text_
+  html = html.replace(/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/g, '<em>$1</em>');
+  html = html.replace(/(?<!_)_(?!_)(.+?)(?<!_)_(?!_)/g, '<em>$1</em>');
+
+  // Inline code: `code`
+  html = html.replace(/`([^`]+)`/g, '<code>$1</code>');
+
+  // Process line by line
+  const lines = html.split('\n');
+  const result = [];
+  let inList = false;
+  let listType = '';
+  let inBlockquote = false;
+  let blockquoteLines = [];
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trim();
+
+    // End blockquote
+    if (inBlockquote && !trimmed.startsWith('>')) {
+      result.push(`<blockquote><p>${blockquoteLines.join('<br/>')}</p></blockquote>`);
+      blockquoteLines = [];
+      inBlockquote = false;
+    }
+
+    // End list
+    if (inList && !trimmed.match(/^[-*]\s/) && !trimmed.match(/^\d+\.\s/) && trimmed !== '') {
+      result.push(listType === 'ul' ? '</ul>' : '</ol>');
+      inList = false;
+    }
+
+    // Skip empty lines
+    if (trimmed === '') {
+      if (inList) {
+        result.push(listType === 'ul' ? '</ul>' : '</ol>');
+        inList = false;
+      }
+      continue;
+    }
+
+    // Headers (skip h1 — it's the title, shown on cover)
+    if (trimmed.startsWith('### ')) {
+      result.push(`<h3>${trimmed.slice(4)}</h3>`);
+    } else if (trimmed.startsWith('## ')) {
+      result.push(`<h2>${trimmed.slice(3)}</h2>`);
+    } else if (trimmed.startsWith('# ')) {
+      // Skip h1 (title page handles it)
+      continue;
+    }
+    // Blockquote
+    else if (trimmed.startsWith('>')) {
+      inBlockquote = true;
+      blockquoteLines.push(trimmed.slice(1).trim());
+    }
+    // Unordered list
+    else if (trimmed.match(/^[-*]\s/)) {
+      if (!inList || listType !== 'ul') {
+        if (inList) result.push(listType === 'ul' ? '</ul>' : '</ol>');
+        result.push('<ul>');
+        inList = true;
+        listType = 'ul';
+      }
+      result.push(`<li>${trimmed.slice(2)}</li>`);
+    }
+    // Ordered list
+    else if (trimmed.match(/^\d+\.\s/)) {
+      if (!inList || listType !== 'ol') {
+        if (inList) result.push(listType === 'ul' ? '</ul>' : '</ol>');
+        result.push('<ol>');
+        inList = true;
+        listType = 'ol';
+      }
+      result.push(`<li>${trimmed.replace(/^\d+\.\s/, '')}</li>`);
+    }
+    // Horizontal rule → page break hint (handled at split level)
+    else if (trimmed.match(/^[-*_]{3,}$/)) {
+      result.push('<hr/>');
+    }
+    // Paragraph
+    else {
+      result.push(`<p>${trimmed}</p>`);
+    }
+  }
+
+  // Close any open structures
+  if (inBlockquote) {
+    result.push(`<blockquote><p>${blockquoteLines.join('<br/>')}</p></blockquote>`);
+  }
+  if (inList) {
+    result.push(listType === 'ul' ? '</ul>' : '</ol>');
+  }
+
+  return result.join('\n');
+}
+
+/**
+ * Split markdown content into pages.
+ * Splits on --- (horizontal rules) first, then by approximate character count.
+ *
+ * @param {string} markdown - Full markdown (without title line)
+ * @param {number} maxChars - Max chars per page
+ * @returns {string[]} Array of markdown chunks, one per page
+ */
+function splitIntoPages(markdown, maxChars) {
+  // First split on explicit --- page breaks
+  const explicitSections = markdown.split(/\n---\n/).filter((s) => s.trim());
+
+  const pages = [];
+
+  for (const section of explicitSections) {
+    // If section fits, keep as one page
+    if (section.length <= maxChars) {
+      pages.push(section.trim());
+      continue;
+    }
+
+    // Split further by paragraphs (double newline)
+    const blocks = section.split(/\n\n/).filter((b) => b.trim());
+    let currentPage = '';
+
+    for (const block of blocks) {
+      // If adding this block exceeds limit, start a new page
+      if (currentPage.length > 0 && currentPage.length + block.length > maxChars) {
+        pages.push(currentPage.trim());
+        currentPage = block;
+      } else {
+        currentPage += (currentPage ? '\n\n' : '') + block;
+      }
+    }
+
+    if (currentPage.trim()) {
+      pages.push(currentPage.trim());
+    }
+  }
+
+  return pages.length > 0 ? pages : [markdown.trim()];
+}
+
+/**
+ * Extract the title from markdown content (first # heading).
+ *
+ * @param {string} markdown - Full markdown content
+ * @returns {{ title: string, body: string }} Extracted title and remaining body
+ */
+function extractTitle(markdown) {
+  const lines = markdown.split('\n');
+  let title = '';
+  let bodyStart = 0;
+
+  for (let i = 0; i < lines.length; i++) {
+    const trimmed = lines[i].trim();
+    if (trimmed.startsWith('# ') && !trimmed.startsWith('## ')) {
+      title = trimmed.slice(2).trim();
+      bodyStart = i + 1;
+      break;
+    }
+    if (trimmed !== '') {
+      // No h1 found before content — use first non-empty line
+      break;
+    }
+  }
+
+  const body = lines.slice(bodyStart).join('\n').trim();
+  return { title, body };
+}
+
+// ─── Main ───────────────────────────────────────────────────────────────────
+
+async function main() {
+  const totalContentPages = pages.length;
+  const totalPages = totalContentPages + 1; // +1 for cover
+
+  const browser = await chromium.launch({ headless: true });
+  const context = await browser.newContext({
+    viewport: { width: WIDTH, height: HEIGHT },
+    deviceScaleFactor: 2, // Retina for crisp text
+  });
+
+  const filePaths = [];
+
+  try {
+    // Page 1: Cover
+    const coverHTML = buildCoverHTML(title, author, accentColor, bgColor, coverImage, totalPages);
+    const coverPage = await context.newPage();
+    await coverPage.setContent(coverHTML, { waitUntil: 'networkidle' });
+    // Wait for fonts to load
+    await coverPage.waitForTimeout(500);
+    const coverPath = join(outputDir, 'page-01.png');
+    await coverPage.screenshot({ path: coverPath, type: 'png' });
+    filePaths.push(coverPath);
+    await coverPage.close();
+
+    // Content pages
+    for (let i = 0; i < pages.length; i++) {
+      const pageNum = i + 2; // 1-based, after cover
+      const contentHTML = markdownToHTML(pages[i]);
+      const pageHTML = buildContentPageHTML(
+        contentHTML,
+        pageNum,
+        totalPages,
+        title,
+        accentColor,
+        bgColor
+      );
+
+      const contentPage = await context.newPage();
+      await contentPage.setContent(pageHTML, { waitUntil: 'networkidle' });
+      await contentPage.waitForTimeout(300);
+
+      const pagePath = join(outputDir, `page-${String(pageNum).padStart(2, '0')}.png`);
+      await contentPage.screenshot({ path: pagePath, type: 'png' });
+      filePaths.push(pagePath);
+      await contentPage.close();
+    }
+  } finally {
+    await browser.close();
+  }
+
+  return {
+    success: true,
+    totalPages,
+    files: filePaths,
+    dimensions: { width: WIDTH, height: HEIGHT },
+    outputDir: resolve(outputDir),
+  };
+}
+
+main()
+  .then((result) => {
+    console.log(JSON.stringify(result));
+    process.exit(0);
+  })
+  .catch((err) => {
+    console.error(JSON.stringify({ success: false, error: err.message }));
+    process.exit(1);
+  });

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.d.ts

@@ -31,8 +31,14 @@ export declare class CommunicationModule implements PromptModule {
     build(config: ModuleConfig): Promise<string>;
     /**
      * Build a skill call example snippet. For gemini-cli runtime, uses --file
-     * pattern to avoid shell escaping EOF errors. For other runtimes, uses
-     * inline JSON argument.
+     * pattern with heredoc to avoid shell escaping EOF errors. For other runtimes,
+     * uses inline JSON argument.
+     *
+     * Uses heredoc with single-quoted delimiter (`<< 'CREWLY_EOF'`) instead of
+     * `printf '%s' '...'` because heredoc prevents ALL shell interpretation —
+     * single quotes, double quotes, backticks, $variables, and parentheses all
+     * pass through literally. The previous printf approach broke when JSON
+     * contained single quotes (e.g., "it's working").
      *
      * @param config - Module configuration with runtime type
      * @param skillPath - Relative path to the skill (e.g., 'core/report-status')

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"communication.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACvD,IAAI,SAAmB;IACvB,QAAQ,SAAK;IACb,SAAS,SAAQ;IACjB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;;OAOG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAyE9B;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBxB"}
+{"version":3,"file":"communication.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACvD,IAAI,SAAmB;IACvB,QAAQ,SAAK;IACb,SAAS,SAAQ;IACjB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;;OAOG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAyE9B;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBxB"}

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.js

@@ -48,8 +48,14 @@ export class CommunicationModule {
     }
     /**
      * Build a skill call example snippet. For gemini-cli runtime, uses --file
-     * pattern to avoid shell escaping EOF errors. For other runtimes, uses
-     * inline JSON argument.
+     * pattern with heredoc to avoid shell escaping EOF errors. For other runtimes,
+     * uses inline JSON argument.
+     *
+     * Uses heredoc with single-quoted delimiter (`<< 'CREWLY_EOF'`) instead of
+     * `printf '%s' '...'` because heredoc prevents ALL shell interpretation —
+     * single quotes, double quotes, backticks, $variables, and parentheses all
+     * pass through literally. The previous printf approach broke when JSON
+     * contained single quotes (e.g., "it's working").
      *
      * @param config - Module configuration with runtime type
      * @param skillPath - Relative path to the skill (e.g., 'core/report-status')
@@ -62,7 +68,9 @@ export class CommunicationModule {
         const resolvedBase = basePath || config.agentSkillsPath;
         if (config.runtimeType === 'gemini-cli') {
             return `\`\`\`bash
-printf '%s' '${jsonExample}' > /tmp/crewly_skill_input.json
+cat > /tmp/crewly_skill_input.json << 'CREWLY_EOF'
+${jsonExample}
+CREWLY_EOF
 bash ${resolvedBase}/${skillPath}/execute.sh --file /tmp/crewly_skill_input.json
 \`\`\``;
         }

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"communication.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"communication.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.d.ts

@@ -39,8 +39,14 @@ export declare class SkillsReferenceModule implements PromptModule {
      *
      * Gemini CLI's run_shell_command mangles JSON arguments containing quotes,
      * backticks, and parentheses, causing "unexpected EOF" shell errors.
-     * This guide instructs the agent to write JSON to a temp file first,
-     * then pass --file <path> to avoid shell interpretation entirely.
+     * This guide instructs the agent to write JSON to a temp file using heredoc
+     * with a single-quoted delimiter, then pass --file <path>.
+     *
+     * Uses `<< 'CREWLY_EOF'` instead of `printf '%s' '...'` because:
+     * - Single-quoted heredoc delimiter prevents ALL shell interpretation
+     * - Single quotes, double quotes, backticks, $, () all pass through literally
+     * - The previous printf approach broke when JSON contained single quotes
+     *   (e.g., "it's working" or "don't forget")
      *
      * Only included for gemini-cli runtime type.
      *

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAalD;;OAEG;IACH,OAAO,CAAC,eAAe;IAoDvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IAiC1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB1B"}
+{"version":3,"file":"skills-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAalD;;OAEG;IACH,OAAO,CAAC,eAAe;IAoDvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,kBAAkB;IAsC1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB1B"}

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.js

@@ -84,8 +84,14 @@ export class SkillsReferenceModule {
      *
      * Gemini CLI's run_shell_command mangles JSON arguments containing quotes,
      * backticks, and parentheses, causing "unexpected EOF" shell errors.
-     * This guide instructs the agent to write JSON to a temp file first,
-     * then pass --file <path> to avoid shell interpretation entirely.
+     * This guide instructs the agent to write JSON to a temp file using heredoc
+     * with a single-quoted delimiter, then pass --file <path>.
+     *
+     * Uses `<< 'CREWLY_EOF'` instead of `printf '%s' '...'` because:
+     * - Single-quoted heredoc delimiter prevents ALL shell interpretation
+     * - Single quotes, double quotes, backticks, $, () all pass through literally
+     * - The previous printf approach broke when JSON contained single quotes
+     *   (e.g., "it's working" or "don't forget")
      *
      * Only included for gemini-cli runtime type.
      *
@@ -98,13 +104,15 @@ export class SkillsReferenceModule {
         }
         return `## Safe Skill Calling (MANDATORY)
 
-**CRITICAL:** When calling any bash skill, you MUST use the \`--file\` pattern to avoid shell escaping errors.
+**CRITICAL:** When calling any bash skill, you MUST use the \`--file\` pattern with heredoc to avoid shell escaping errors.
 Passing JSON directly as a shell argument will cause "unexpected EOF" errors when the content contains quotes, backticks, or parentheses.
 
 ### Required Pattern
 \`\`\`bash
-# Step 1: Write JSON to a temp file (printf preserves all special characters)
-printf '%s' '{"sessionName":"my-agent","status":"done","summary":"Fixed the bug"}' > /tmp/crewly_skill_input.json
+# Step 1: Write JSON to a temp file using heredoc (single-quoted delimiter prevents ALL shell interpretation)
+cat > /tmp/crewly_skill_input.json << 'CREWLY_EOF'
+{"sessionName":"my-agent","status":"done","summary":"Fixed the bug — it's working now"}
+CREWLY_EOF
 
 # Step 2: Call the skill with --file flag
 bash ${config.agentSkillsPath}/core/report-status/execute.sh --file /tmp/crewly_skill_input.json
@@ -112,16 +120,19 @@ bash ${config.agentSkillsPath}/core/report-status/execute.sh --file /tmp/crewly_
 
 ### Team Leader Skills (delegate-task, verify-output, schedule-check)
 \`\`\`bash
-printf '%s' '{"to":"worker-session","task":"implement feature"}' > /tmp/crewly_skill_input.json
+cat > /tmp/crewly_skill_input.json << 'CREWLY_EOF'
+{"to":"worker-session","task":"implement feature","priority":"high"}
+CREWLY_EOF
 bash ${config.tlSkillsPath}/delegate-task/execute.sh --file /tmp/crewly_skill_input.json
 \`\`\`` : ''}
 
 ### Rules
-1. **ALWAYS** use \`printf '%s' '<json>' > /tmp/crewly_skill_input.json\` then \`--file\`
-2. **NEVER** pass JSON directly as a shell argument: \`bash execute.sh '{"key":"value with 'quotes'"}'\`
-3. Use \`/tmp/crewly_skill_input.json\` as the temp file (overwritten each call)
-4. This applies to ALL skills: report-status, send-message, remember, recall, delegate-task, reply-slack, reply-gchat, etc.
-5. For skills that support named flags (reply-slack, reply-gchat), you may also use \`--text-file\` for the message body`;
+1. **ALWAYS** use heredoc to write JSON: \`cat > /tmp/crewly_skill_input.json << 'CREWLY_EOF'\` then the JSON, then \`CREWLY_EOF\` on its own line
+2. **NEVER** pass JSON directly as a shell argument: \`bash execute.sh '{"key":"value"}'\`
+3. **NEVER** use \`printf '%s' '...'\` — single quotes inside JSON will break it
+4. Use \`/tmp/crewly_skill_input.json\` as the temp file (overwritten each call)
+5. This applies to ALL skills: report-status, send-message, remember, recall, delegate-task, reply-slack, reply-gchat, etc.
+6. For skills that support named flags (reply-slack, reply-gchat), you may also use \`--text-file\` for the message body`;
     }
     /**
      * Build communication and memory tool instructions.

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crewly",
-  "version": "1.5.14",
+  "version": "1.5.15",
   "type": "module",
   "description": "Multi-agent orchestration platform for AI coding teams — coordinates Claude Code, Gemini CLI, and Codex agents with a real-time web dashboard",
   "main": "dist/cli/cli/src/index.js",