studio-lumiere-cli 0.1.0

package/.agents/skills/annotate-image/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: annotate-image
+description: Write text or banners over images with the annotate helper via SDK/CLI; use when you need captioned or labeled outputs.
+---
+
+# Skill: Image Annotation (local-lumiere)
+
+This skill describes how to write text over an image using the `annotate` helper in local-lumiere. It covers the SDK function, CLI usage, parameters, and defaults.
+
+---
+
+## Quick Start
+
+```
+node dist/cli.js annotate \
+  --input path/to/image.png \
+  --output path/to/output.png \
+  --text "Your text here" \
+  --banner
+```
+
+---
+
+## SDK API
+
+```ts
+import { annotateImage } from "./dist/index.js";
+
+await annotateImage(
+  "path/to/input.png",
+  "path/to/output.png",
+  "Your text here",
+  {
+    fontFamily: "Montserrat",
+    fontSize: 48,
+    fontWeight: 700,
+    color: "#FFFFFF",
+    strokeColor: "rgba(0,0,0,0.6)",
+    strokeWidth: 4,
+    banner: true,
+    bannerColor: "rgba(0,0,0,0.45)",
+    bannerPadding: 24,
+    bannerRadius: 16,
+    position: "top-center",
+    padding: 32,
+    maxWidthRatio: 0.85
+  }
+);
+```
+
+### Options
+
+- `fontFamily`: font family name (default `Montserrat`)
+- `fontSize`: size in px (default ~5% of min image dimension)
+- `fontWeight`: font weight (default `700`)
+- `color`: text color (default `#FFFFFF`)
+- `strokeColor`: outline color (default `rgba(0,0,0,0.6)`)
+- `strokeWidth`: outline width (default `fontSize * 0.08`, min 2)
+- `banner`: enable semi-transparent banner (default `false`)
+- `bannerColor`: banner color (default `rgba(0,0,0,0.45)`)
+- `bannerPadding`: inner padding (default `fontSize * 0.6`)
+- `bannerRadius`: corner radius (default `fontSize * 0.4`)
+- `position`: `top-center|top-left|top-right|bottom-center|bottom-center-high|bottom-left|bottom-right|center` (default `top-center`)
+- `padding`: distance from edges (default `fontSize * 0.8`)
+- `maxWidthRatio`: max text width as ratio of image width (default `0.85`)
+
+---
+
+## CLI Usage
+
+```
+node dist/cli.js annotate \
+  --input path/to/image.png \
+  --output path/to/output.png \
+  --text "Your text here" \
+  --position top-center \
+  --size 48 \
+  --color #FFFFFF \
+  --banner
+```
+
+---
+
+## Notes
+
+- The helper uses sharp + SVG overlay.
+- If the font is not installed locally, the system falls back to a generic sans-serif.
+
+End of skill.
+
+## Related Skills
+
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\generate-images.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\generate-video.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\refine-images.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\muse-management.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\tired-girl.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\image-grid.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\config-troubleshooting.md`

package/.agents/skills/config-troubleshooting/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: config-troubleshooting
+description: Reference for local-lumiere configuration defaults, environment variables, outputs, and troubleshooting; use when setup or runtime issues occur.
+---
+
+# Reference: Configuration & Troubleshooting (local-lumiere)
+
+This file collects shared configuration guidance and common troubleshooting patterns for all local-lumiere skills.
+
+---
+
+## 1) Configuration Reference
+
+### 1.1 Environment Variables
+
+- `GEMINI_API_KEY` (required)
+- `LUMIERE_OUTPUT_DIR` (optional, default `outputs`)
+
+### 1.2 Runtime Config Defaults
+
+```ts
+models.prompt = "gemini-3-flash-preview"
+models.image  = "gemini-3-pro-image-preview"
+models.video  = "veo-3.1-generate-preview"
+retry.maxRetries = 3
+retry.baseDelayMs = 1500
+retry.maxDelayMs  = 12000
+```
+
+### 1.3 Output Structure
+
+```
+outputs/
+  generations/<timestamp>/
+  refinements/<timestamp>/
+  upscales/<timestamp>/
+  muses/<timestamp>/
+  videos/<timestamp>/
+  muses.json
+```
+
+---
+
+## 2) Common Errors and Fixes
+
+### 2.1 Missing API Key
+
+**Symptom:** `Missing GEMINI_API_KEY in environment.`
+
+**Fix:** Add `GEMINI_API_KEY=...` to your `.env` and ensure it’s loaded.
+
+### 2.2 Model Overload / 429 / 503
+
+**Symptom:** Requests fail intermittently with overload/timeout errors.
+
+**Fix:** Retry automatically (built-in). If persistent, lower batch sizes or wait and re-run.
+
+### 2.3 Empty Output
+
+**Symptom:** `No image data returned from Gemini.`
+
+**Fix:** Re-run with simpler prompts, ensure input images are valid and not corrupted.
+
+### 2.4 Bad Paths
+
+**Symptom:** File not found errors for inputs.
+
+**Fix:** Ensure all image paths are absolute or relative to the repo root.
+
+---
+
+## 3) Prompt Tips
+
+- Be explicit about jewelry fidelity (no extra jewelry, no fake sparkles).
+- Use clear lighting/mood cues.
+- Keep instructions scoped to avoid unintended changes.
+
+---
+
+## 4) When to Disable Prompt Enhancement
+
+If the enhanced prompt drifts too far from your intent, set `enhancePrompt: false` and use a precise base prompt via selections and style hints.
+
+---
+
+End of reference.
+
+## Related Skills
+
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\generate-images.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\generate-video.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\refine-images.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\muse-management.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\tired-girl.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\image-grid.md`
+- `C:\\Users\\karim\\Documents\\local-lumiere\\.agents\\skills\\config-troubleshooting.md`
+