@heylemon/lemonade 0.2.1 → 0.2.3

package/skills/openai-image-gen/SKILL.md

@@ -2,7 +2,7 @@
 name: openai-image-gen
 description: Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.
 homepage: https://platform.openai.com/docs/api-reference/images
-metadata: {"lemonade":{"emoji":"🖼️","requires":{"bins":["python3"],"env":["OPENAI_API_KEY"]},"primaryEnv":"OPENAI_API_KEY","install":[{"id":"python-brew","kind":"brew","formula":"python","bins":["python3"],"label":"Install Python (brew)"}]}}
+metadata: {"lemonade":{"emoji":"🖼️","requires":{"bins":["python3"]},"install":[{"id":"python-brew","kind":"brew","formula":"python","bins":["python3"],"label":"Install Python (brew)"}]}}
 ---
 
 # OpenAI Image Gen

package/skills/openai-image-gen/scripts/gen.py

@@ -74,6 +74,19 @@ def get_model_defaults(model: str) -> tuple[str, str]:
         return ("1024x1024", "high")
 
 
+def resolve_api_url_and_key() -> tuple[str, str]:
+    """Resolve the images API base URL and auth token.
+    Prefers the Lemonade backend proxy; falls back to direct OpenAI key."""
+    backend = (os.environ.get("LEMON_BACKEND_URL") or "").strip()
+    gw_token = (os.environ.get("GATEWAY_TOKEN") or "").strip()
+    if backend and gw_token:
+        return f"{backend}/api/lemonade/proxy/v1/images/generations", gw_token
+    api_key = (os.environ.get("OPENAI_API_KEY") or "").strip()
+    if api_key:
+        return "https://api.openai.com/v1/images/generations", api_key
+    return "", ""
+
+
 def request_images(
     api_key: str,
     prompt: str,
@@ -83,8 +96,9 @@ def request_images(
     background: str = "",
     output_format: str = "",
     style: str = "",
+    api_url: str = "",
 ) -> dict:
-    url = "https://api.openai.com/v1/images/generations"
+    url = api_url or "https://api.openai.com/v1/images/generations"
     args = {
         "model": model,
         "prompt": prompt,
@@ -173,9 +187,9 @@ def main() -> int:
     ap.add_argument("--out-dir", default="", help="Output directory (default: ./tmp/openai-image-gen-<ts>).")
     args = ap.parse_args()
 
-    api_key = (os.environ.get("OPENAI_API_KEY") or "").strip()
+    api_url, api_key = resolve_api_url_and_key()
     if not api_key:
-        print("Missing OPENAI_API_KEY", file=sys.stderr)
+        print("No API credentials available for image generation", file=sys.stderr)
         return 2
 
     # Apply model-specific defaults if not specified
@@ -211,6 +225,7 @@ def main() -> int:
             args.background,
             args.output_format,
             args.style,
+            api_url=api_url,
         )
         data = res.get("data", [{}])[0]
         image_b64 = data.get("b64_json")

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
+```

package/skills/stock-analysis/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: stock-analysis
+description: Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
+version: 6.2.0
+homepage: https://finance.yahoo.com
+commands:
+  - /stock - Analyze a stock or crypto (e.g., /stock AAPL)
+  - /stock_compare - Compare multiple tickers
+  - /stock_dividend - Analyze dividend metrics
+  - /stock_watch - Add/remove from watchlist
+  - /stock_alerts - Check triggered alerts
+  - /stock_hot - Find trending stocks & crypto (Hot Scanner)
+  - /stock_rumors - Find early signals, M&A rumors, insider activity (Rumor Scanner)
+  - /portfolio - Show portfolio summary
+  - /portfolio_add - Add asset to portfolio
+metadata: {"lemonade":{"emoji":"📈","requires":{"bins":["uv"],"env":[]},"install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}}
+---
+
+# Stock Analysis v6.1
+
+Analyze US stocks and cryptocurrencies with 8-dimension analysis, portfolio management, watchlists, alerts, dividend analysis, and **viral trend detection**.
+
+## What's New in v6.2
+
+- **Rumor Scanner** — Early signals before mainstream news
+  - M&A rumors and takeover bids
+  - Insider buying/selling activity
+  - Analyst upgrades/downgrades
+  - Twitter/X "hearing that...", "sources say..." detection
+- **Impact Scoring** — Rumors ranked by potential market impact
+
+## What's in v6.1
+
+- **Hot Scanner** — Find viral stocks & crypto across multiple sources
+- **Twitter/X Integration** — Social sentiment via bird CLI
+- **Multi-Source Aggregation** — CoinGecko, Google News, Yahoo Finance
+- **Cron Support** — Daily trend reports
+
+## What's in v6.0
+
+- **Watchlist + Alerts** — Price targets, stop losses, signal changes
+- **Dividend Analysis** — Yield, payout ratio, growth, safety score
+- **Fast Mode** — `--fast` skips slow analyses (insider, news)
+- **Improved Performance** — `--no-insider` for faster runs
+
+## Quick Commands
+
+### Stock Analysis
+```bash
+# Basic analysis
+uv run {baseDir}/scripts/analyze_stock.py AAPL
+
+# Fast mode (skips insider trading & breaking news)
+uv run {baseDir}/scripts/analyze_stock.py AAPL --fast
+
+# Compare multiple
+uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL
+
+# Crypto
+uv run {baseDir}/scripts/analyze_stock.py BTC-USD ETH-USD
+```
+
+### Dividend Analysis
+```bash
+uv run {baseDir}/scripts/dividends.py JNJ
+uv run {baseDir}/scripts/dividends.py JNJ PG KO MCD --output json
+```
+
+### Watchlist + Alerts
+```bash
+uv run {baseDir}/scripts/watchlist.py add AAPL
+uv run {baseDir}/scripts/watchlist.py add AAPL --target 200
+uv run {baseDir}/scripts/watchlist.py add AAPL --stop 150
+uv run {baseDir}/scripts/watchlist.py list
+uv run {baseDir}/scripts/watchlist.py check
+```
+
+### Portfolio Management
+```bash
+uv run {baseDir}/scripts/portfolio.py create "Tech Portfolio"
+uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150
+uv run {baseDir}/scripts/portfolio.py show
+```
+
+### Hot Scanner
+```bash
+python3 {baseDir}/scripts/hot_scanner.py
+python3 {baseDir}/scripts/hot_scanner.py --no-social
+python3 {baseDir}/scripts/hot_scanner.py --json
+```
+
+### Rumor Scanner
+```bash
+python3 {baseDir}/scripts/rumor_scanner.py
+```
+
+## Analysis Dimensions (8 for stocks, 3 for crypto)
+
+### Stocks
+| Dimension | Weight | Description |
+|-----------|--------|-------------|
+| Earnings Surprise | 30% | EPS beat/miss |
+| Fundamentals | 20% | P/E, margins, growth |
+| Analyst Sentiment | 20% | Ratings, price targets |
+| Historical | 10% | Past earnings reactions |
+| Market Context | 10% | VIX, SPY/QQQ trends |
+| Sector | 15% | Relative strength |
+| Momentum | 15% | RSI, 52-week range |
+| Sentiment | 10% | Fear/Greed, shorts, insiders |
+
+### Crypto
+- Market Cap & Category
+- BTC Correlation (30-day)
+- Momentum (RSI, range)
+
+## Supported Cryptos (Top 20)
+
+BTC, ETH, BNB, SOL, XRP, ADA, DOGE, AVAX, DOT, MATIC, LINK, ATOM, UNI, LTC, BCH, XLM, ALGO, VET, FIL, NEAR
+
+(Use `-USD` suffix: `BTC-USD`, `ETH-USD`)
+
+## Limitations
+
+- Yahoo Finance may lag 15-20 minutes
+- Short interest lags ~2 weeks (FINRA)
+- Insider trades lag 2-3 days (SEC filing)
+- US markets only (non-US incomplete)
+
+## Disclaimer
+
+**NOT FINANCIAL ADVICE.** For informational purposes only. Consult a licensed financial advisor before making investment decisions.