@heylemon/lemonade 0.2.2 → 0.2.3

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.2",
-  "commit": "86be80740f2b0083dd4e3816f9c7d85e53780b2b",
-  "builtAt": "2026-02-22T13:52:37.675Z"
+  "version": "0.2.3",
+  "commit": "a0535878314984aba3836015e906997cadb9bb7f",
+  "builtAt": "2026-02-22T15:12:12.410Z"
 }

package/dist/canvas-host/a2ui/.bundle.hash

@@ -1 +1 @@
-b91bfc9de067fe8db99816d14e4bf59e599bae482cd3f3511d73b463997f3112
+dda15b99462cc0b2ef3beeaf3b47c8ead319daf27fd6466820c14e02ea7b21a3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heylemon/lemonade",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "AI gateway CLI for Lemon - local AI assistant with integrations",
   "publishConfig": {
     "access": "restricted"

package/skills/brave-search/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: brave-search
+description: Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
+metadata: {"lemonade":{"emoji":"🦁","requires":{"bins":["node"]}}}
+---
+
+# Brave Search
+
+Headless web search and content extraction using Brave Search. No browser required.
+
+## Setup
+
+Run once before first use:
+
+```bash
+cd {baseDir}
+npm ci
+```
+
+## Search
+
+```bash
+node {baseDir}/search.js "query"                    # Basic search (5 results)
+node {baseDir}/search.js "query" -n 10              # More results
+node {baseDir}/search.js "query" --content          # Include page content as markdown
+node {baseDir}/search.js "query" -n 3 --content     # Combined
+```
+
+## Extract Page Content
+
+```bash
+node {baseDir}/content.js https://example.com/article
+```
+
+Fetches a URL and extracts readable content as markdown.
+
+## Output Format
+
+```
+--- Result 1 ---
+Title: Page Title
+Link: https://example.com/page
+Snippet: Description from search results
+Content: (if --content flag used)
+  Markdown content extracted from the page...
+
+--- Result 2 ---
+...
+```
+
+## When to Use
+
+- Searching for documentation or API references
+- Looking up facts or current information
+- Fetching content from specific URLs
+- Any task requiring web search without interactive browsing
+```

package/skills/brave-search/content.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+import { Readability } from "@mozilla/readability";
+import { JSDOM } from "jsdom";
+import TurndownService from "turndown";
+import { gfm } from "turndown-plugin-gfm";
+
+const url = process.argv[2];
+
+if (!url) {
+  console.log("Usage: content.js <url>");
+  console.log("\nExtracts readable content from a webpage as markdown.");
+  console.log("\nExamples:");
+  console.log(" content.js https://example.com/article");
+  console.log(" content.js https://doc.rust-lang.org/book/ch04-01-what-is-ownership.html");
+  process.exit(1);
+}
+
+function htmlToMarkdown(html) {
+  const turndown = new TurndownService({ headingStyle: "atx", codeBlockStyle: "fenced" });
+  turndown.use(gfm);
+  turndown.addRule("removeEmptyLinks", {
+    filter: (node) => node.nodeName === "A" && !node.textContent?.trim(),
+    replacement: () => "",
+  });
+  return turndown
+    .turndown(html)
+    .replace(/\[\\?\[\s*\\?\]\]\([^)]*\)/g, "")
+    .replace(/ +/g, " ")
+    .replace(/\s+,/g, ",")
+    .replace(/\s+\./g, ".")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+}
+
+try {
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+      "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+      "Accept-Language": "en-US,en;q=0.9",
+    },
+    signal: AbortSignal.timeout(15000),
+  });
+
+  if (!response.ok) {
+    console.error(`HTTP ${response.status}: ${response.statusText}`);
+    process.exit(1);
+  }
+
+  const html = await response.text();
+  const dom = new JSDOM(html, { url });
+  const reader = new Readability(dom.window.document);
+  const article = reader.parse();
+
+  if (article && article.content) {
+    if (article.title) {
+      console.log(`# ${article.title}\n`);
+    }
+    console.log(htmlToMarkdown(article.content));
+    process.exit(0);
+  }
+
+  // Fallback: try to extract main content
+  const fallbackDoc = new JSDOM(html, { url });
+  const body = fallbackDoc.window.document;
+  body.querySelectorAll("script, style, noscript, nav, header, footer, aside").forEach(el => el.remove());
+
+  const title = body.querySelector("title")?.textContent?.trim();
+  const main = body.querySelector("main, article, [role='main'], .content, #content") || body.body;
+
+  if (title) {
+    console.log(`# ${title}\n`);
+  }
+
+  const text = main?.innerHTML || "";
+  if (text.trim().length > 100) {
+    console.log(htmlToMarkdown(text));
+  } else {
+    console.error("Could not extract readable content from this page.");
+    process.exit(1);
+  }
+} catch (e) {
+  console.error(`Error: ${e.message}`);
+  process.exit(1);
+}

package/skills/brave-search/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "brave-search",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Headless web search via Brave Search - no browser required",
+  "author": "Mario Zechner",
+  "license": "MIT",
+  "dependencies": {
+    "@mozilla/readability": "^0.6.0",
+    "jsdom": "^27.0.1",
+    "turndown": "^7.2.2",
+    "turndown-plugin-gfm": "^1.0.2"
+  }
+}

package/skills/brave-search/search.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+import { Readability } from "@mozilla/readability";
+import { JSDOM } from "jsdom";
+import TurndownService from "turndown";
+import { gfm } from "turndown-plugin-gfm";
+
+const args = process.argv.slice(2);
+
+const contentIndex = args.indexOf("--content");
+const fetchContent = contentIndex !== -1;
+if (fetchContent) args.splice(contentIndex, 1);
+
+let numResults = 5;
+const nIndex = args.indexOf("-n");
+if (nIndex !== -1 && args[nIndex + 1]) {
+  numResults = parseInt(args[nIndex + 1], 10);
+  args.splice(nIndex, 2);
+}
+
+const query = args.join(" ");
+
+if (!query) {
+  console.log("Usage: search.js [-n] [--content]");
+  console.log("\nOptions:");
+  console.log(" -n Number of results (default: 5)");
+  console.log(" --content Fetch readable content as markdown");
+  console.log("\nExamples:");
+  console.log(' search.js "javascript async await"');
+  console.log(' search.js "rust programming" -n 10');
+  console.log(' search.js "climate change" --content');
+  process.exit(1);
+}
+
+async function fetchBraveResults(query, numResults) {
+  const url = `https://search.brave.com/search?q=${encodeURIComponent(query)}`;
+
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36",
+      "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8",
+      "Accept-Language": "en-US,en;q=0.9",
+      "sec-ch-ua": '"Chromium";v="142", "Google Chrome";v="142", "Not_A Brand";v="99"',
+      "sec-ch-ua-mobile": "?0",
+      "sec-ch-ua-platform": '"macOS"',
+      "sec-fetch-dest": "document",
+      "sec-fetch-mode": "navigate",
+      "sec-fetch-site": "none",
+      "sec-fetch-user": "?1",
+    }
+  });
+
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+  }
+
+  const html = await response.text();
+  const dom = new JSDOM(html);
+  const doc = dom.window.document;
+
+  const results = [];
+
+  // Find all search result snippets with data-type="web"
+  const snippets = doc.querySelectorAll('div.snippet[data-type="web"]');
+
+  for (const snippet of snippets) {
+    if (results.length >= numResults) break;
+
+    // Get the main link and title
+    const titleLink = snippet.querySelector('a.svelte-14r20fy');
+    if (!titleLink) continue;
+
+    const link = titleLink.getAttribute('href');
+    if (!link || link.includes('brave.com')) continue;
+
+    const titleEl = titleLink.querySelector('.title');
+    const title = titleEl?.textContent?.trim() || titleLink.textContent?.trim() || '';
+
+    // Get the snippet/description
+    const descEl = snippet.querySelector('.generic-snippet .content');
+    let snippetText = descEl?.textContent?.trim() || '';
+    // Remove date prefix if present
+    snippetText = snippetText.replace(/^[A-Z][a-z]+ \d+, \d{4} -\s*/, '');
+
+    if (title && link) {
+      results.push({ title, link, snippet: snippetText });
+    }
+  }
+
+  return results;
+}
+
+function htmlToMarkdown(html) {
+  const turndown = new TurndownService({ headingStyle: "atx", codeBlockStyle: "fenced" });
+  turndown.use(gfm);
+  turndown.addRule("removeEmptyLinks", {
+    filter: (node) => node.nodeName === "A" && !node.textContent?.trim(),
+    replacement: () => "",
+  });
+  return turndown
+    .turndown(html)
+    .replace(/\[\\?\[\s*\\?\]\]\([^)]*\)/g, "")
+    .replace(/ +/g, " ")
+    .replace(/\s+,/g, ",")
+    .replace(/\s+\./g, ".")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+}
+
+async function fetchPageContent(url) {
+  try {
+    const response = await fetch(url, {
+      headers: {
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
+        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+      },
+      signal: AbortSignal.timeout(10000),
+    });
+
+    if (!response.ok) {
+      return `(HTTP ${response.status})`;
+    }
+
+    const html = await response.text();
+    const dom = new JSDOM(html, { url });
+    const reader = new Readability(dom.window.document);
+    const article = reader.parse();
+
+    if (article && article.content) {
+      return htmlToMarkdown(article.content).substring(0, 5000);
+    }
+
+    // Fallback: try to get main content
+    const fallbackDoc = new JSDOM(html, { url });
+    const body = fallbackDoc.window.document;
+    body.querySelectorAll("script, style, noscript, nav, header, footer, aside").forEach(el => el.remove());
+    const main = body.querySelector("main, article, [role='main'], .content, #content") || body.body;
+    const text = main?.textContent || "";
+
+    if (text.trim().length > 100) {
+      return text.trim().substring(0, 5000);
+    }
+
+    return "(Could not extract content)";
+  } catch (e) {
+    return `(Error: ${e.message})`;
+  }
+}
+
+// Main
+try {
+  const results = await fetchBraveResults(query, numResults);
+
+  if (results.length === 0) {
+    console.error("No results found.");
+    process.exit(0);
+  }
+
+  if (fetchContent) {
+    for (const result of results) {
+      result.content = await fetchPageContent(result.link);
+    }
+  }
+
+  for (let i = 0; i < results.length; i++) {
+    const r = results[i];
+    console.log(`--- Result ${i + 1} ---`);
+    console.log(`Title: ${r.title}`);
+    console.log(`Link: ${r.link}`);
+    console.log(`Snippet: ${r.snippet}`);
+    if (r.content) {
+      console.log(`Content:\n${r.content}`);
+    }
+    console.log("");
+  }
+} catch (e) {
+  console.error(`Error: ${e.message}`);
+  process.exit(1);
+}

package/skills/caldav-calendar/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: caldav-calendar
+description: Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
+metadata: {"lemonade":{"emoji":"📅","os":["linux"],"requires":{"bins":["vdirsyncer","khal"]},"install":[{"id":"apt","kind":"apt","packages":["vdirsyncer","khal"],"bins":["vdirsyncer","khal"],"label":"Install vdirsyncer + khal via apt"}]}}
+---
+
+# CalDAV Calendar (vdirsyncer + khal)
+
+**vdirsyncer** syncs CalDAV calendars to local `.ics` files. **khal** reads and writes them.
+
+## Sync First
+
+Always sync before querying or after making changes:
+```bash
+vdirsyncer sync
+```
+
+## View Events
+
+```bash
+khal list                        # Today
+khal list today 7d               # Next 7 days
+khal list tomorrow               # Tomorrow
+khal list 2026-01-15 2026-01-20  # Date range
+khal list -a Work today          # Specific calendar
+```
+
+## Search
+
+```bash
+khal search "meeting"
+khal search "dentist" --format "{start-date} {title}"
+```
+
+## Create Events
+
+```bash
+khal new 2026-01-15 10:00 11:00 "Meeting title"
+khal new 2026-01-15 "All day event"
+khal new tomorrow 14:00 15:30 "Call" -a Work
+khal new 2026-01-15 10:00 11:00 "With notes" :: Description goes here
+```
+
+After creating, sync to push changes:
+```bash
+vdirsyncer sync
+```
+
+## Initial Setup
+
+### 1. Configure vdirsyncer (`~/.config/vdirsyncer/config`)
+
+Example for iCloud:
+```ini
+[general]
+status_path = "~/.local/share/vdirsyncer/status/"
+
+[pair icloud_calendar]
+a = "icloud_remote"
+b = "icloud_local"
+collections = ["from a", "from b"]
+conflict_resolution = "a wins"
+
+[storage icloud_remote]
+type = "caldav"
+url = "https://caldav.icloud.com/"
+username = "you@icloud.com"
+password.fetch = ["command", "cat", "~/.config/vdirsyncer/icloud_password"]
+
+[storage icloud_local]
+type = "filesystem"
+path = "~/.local/share/vdirsyncer/calendars/"
+fileext = ".ics"
+```
+
+Provider URLs:
+- iCloud: `https://caldav.icloud.com/`
+- Google: Use `google_calendar` storage type
+- Fastmail: `https://caldav.fastmail.com/dav/calendars/user/EMAIL/`
+- Nextcloud: `https://YOUR.CLOUD/remote.php/dav/calendars/USERNAME/`
+
+### 2. Configure khal (`~/.config/khal/config`)
+
+```ini
+[calendars]
+[[my_calendars]]
+path = ~/.local/share/vdirsyncer/calendars/*
+type = discover
+
+[default]
+default_calendar = Home
+highlight_event_days = True
+
+[locale]
+timeformat = %H:%M
+dateformat = %Y-%m-%d
+```
+
+### 3. Discover and sync
+
+```bash
+vdirsyncer discover
+vdirsyncer sync
+```

package/skills/frontend-design/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: frontend-design
+description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
+---
+
+This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.
+
+The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints.
+
+## Design Thinking
+
+Before coding, understand the context and commit to a BOLD aesthetic direction:
+- **Purpose**: What problem does this interface solve? Who uses it?
+- **Tone**: Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian, etc.
+- **Constraints**: Technical requirements (framework, performance, accessibility).
+- **Differentiation**: What makes this UNFORGETTABLE? What's the one thing someone will remember?
+
+**CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work - the key is intentionality, not intensity.
+
+Then implement working code (HTML/CSS/JS, React, Vue, etc.) that is:
+- Production-grade and functional
+- Visually striking and memorable
+- Cohesive with a clear aesthetic point-of-view
+- Meticulously refined in every detail
+
+## Frontend Aesthetics Guidelines
+
+Focus on:
+- **Typography**: Choose fonts that are beautiful, unique, and interesting. Avoid generic fonts like Arial and Inter; opt instead for distinctive choices that elevate the frontend's aesthetics; unexpected, characterful font choices. Pair a distinctive display font with a refined body font.
+- **Color & Theme**: Commit to a cohesive aesthetic. Use CSS variables for consistency. Dominant colors with sharp accents outperform timid, evenly-distributed palettes.
+- **Motion**: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for HTML. Focus on high-impact moments: one well-orchestrated page load with staggered reveals creates more delight than scattered micro-interactions.
+- **Spatial Composition**: Unexpected layouts. Asymmetry. Overlap. Diagonal flow. Grid-breaking elements. Generous negative space OR controlled density.
+- **Backgrounds & Visual Details**: Create atmosphere and depth rather than defaulting to solid colors. Add contextual effects and textures that match the overall aesthetic.
+
+NEVER use generic AI-generated aesthetics like overused font families (Inter, Roboto, Arial, system fonts), cliched color schemes (particularly purple gradients on white backgrounds), predictable layouts, and cookie-cutter design that lacks context-specific character.
+
+Interpret creatively and make unexpected choices that feel genuinely designed for the context. No design should be the same. Vary between light and dark themes, different fonts, different aesthetics.
+
+**IMPORTANT**: Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details.

package/skills/self-improving-agent/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: self-improvement
+description: "Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects the agent, (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Agent realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task."
+metadata: {"lemonade":{"emoji":"🧠"}}
+---
+
+# Self-Improvement Skill
+
+Log learnings and errors to markdown files for continuous improvement. Important learnings get promoted to project memory.
+
+## Quick Reference
+
+| Situation | Action |
+|-----------|--------|
+| Command/operation fails | Log to `.learnings/ERRORS.md` |
+| User corrects you | Log to `.learnings/LEARNINGS.md` with category `correction` |
+| User wants missing feature | Log to `.learnings/FEATURE_REQUESTS.md` |
+| API/external tool fails | Log to `.learnings/ERRORS.md` with integration details |
+| Knowledge was outdated | Log to `.learnings/LEARNINGS.md` with category `knowledge_gap` |
+| Found better approach | Log to `.learnings/LEARNINGS.md` with category `best_practice` |
+| Broadly applicable learning | Promote to project memory files |
+
+## Setup
+
+```bash
+mkdir -p ~/.lemonade/workspace/.learnings
+```
+
+## Logging Format
+
+### Learning Entry
+
+Append to `.learnings/LEARNINGS.md`:
+
+```markdown
+## [LRN-YYYYMMDD-XXX] category
+
+**Logged**: ISO-8601 timestamp
+**Priority**: low | medium | high | critical
+**Status**: pending
+**Area**: frontend | backend | infra | tests | docs | config
+
+### Summary
+One-line description of what was learned
+
+### Details
+Full context: what happened, what was wrong, what's correct
+
+### Suggested Action
+Specific fix or improvement to make
+
+### Metadata
+- Source: conversation | error | user_feedback
+- Related Files: path/to/file.ext
+- Tags: tag1, tag2
+```
+
+### Error Entry
+
+Append to `.learnings/ERRORS.md`:
+
+```markdown
+## [ERR-YYYYMMDD-XXX] skill_or_command_name
+
+**Logged**: ISO-8601 timestamp
+**Priority**: high
+**Status**: pending
+
+### Summary
+Brief description of what failed
+
+### Error
+Actual error message or output
+
+### Context
+- Command/operation attempted
+- Input or parameters used
+
+### Suggested Fix
+If identifiable, what might resolve this
+```
+
+### Feature Request Entry
+
+Append to `.learnings/FEATURE_REQUESTS.md`:
+
+```markdown
+## [FEAT-YYYYMMDD-XXX] capability_name
+
+**Logged**: ISO-8601 timestamp
+**Priority**: medium
+**Status**: pending
+
+### Requested Capability
+What the user wanted to do
+
+### User Context
+Why they needed it
+
+### Suggested Implementation
+How this could be built
+```
+
+## Detection Triggers
+
+Automatically log when you notice:
+
+**Corrections**: "No, that's not right...", "Actually, it should be...", "You're wrong about..."
+
+**Feature Requests**: "Can you also...", "I wish you could...", "Is there a way to..."
+
+**Knowledge Gaps**: User provides information you didn't know, documentation is outdated
+
+**Errors**: Command returns non-zero exit code, exception or stack trace
+
+## Resolving Entries
+
+When an issue is fixed, update `**Status**: pending` to `**Status**: resolved` and add a resolution block.
+
+## Best Practices
+
+1. Log immediately - context is freshest right after the issue
+2. Be specific - future agents need to understand quickly
+3. Include reproduction steps - especially for errors
+4. Link related files - makes fixes easier
+5. Suggest concrete fixes - not just "investigate"
+6. Promote aggressively - if in doubt, add to project memory
+```