@conceptcraft/mindframes 0.1.8 → 0.1.9

package/dist/index.js

@@ -3144,6 +3144,421 @@ init_brand();
 import { Command as Command14 } from "commander";
 import chalk12 from "chalk";
 
+// src/commands/skill/generate-main-skill.ts
+function generateMainSkillContent(context) {
+  const { name, cmd: cmd2, displayName } = context;
+  const envPrefix = name.toUpperCase().replace(/-/g, "_");
+  return `---
+name: ${name}
+description: ${displayName} CLI for AI-powered content creation. Use when user needs to create presentations, generate video assets (voiceover, music, images, stock videos), use text-to-speech, mix audio, search stock media, or manage branding. This is the main entry point - load specialized skills (${name}-video, ${name}-presentation) for detailed workflows.
+---
+
+# ${displayName} CLI
+
+A comprehensive CLI for AI-powered content creation. Generate presentations, video assets, voiceovers, music, and search stock media - all from your terminal.
+
+**Install:** \`npm install -g @${name}/cli\` or \`pnpm add -g @${name}/cli\`
+
+---
+
+## Quick Reference
+
+| Task | Command |
+|------|---------|
+| Create presentation | \`${cmd2} create "Topic"\` |
+| Generate video assets | \`${cmd2} video create < scenes.json\` |
+| Text-to-speech | \`${cmd2} tts generate -t "Text" -o voice.mp3\` |
+| Generate music | \`${cmd2} music generate -p "upbeat corporate"\` |
+| Search images | \`${cmd2} image search -q "mountain landscape"\` |
+| Search videos | \`${cmd2} video search "ocean waves"\` |
+| Mix audio tracks | \`${cmd2} mix create --video v.mp4 --music m.mp3\` |
+
+---
+
+## Authentication
+
+\`\`\`bash
+# Login via OAuth (recommended)
+${cmd2} login
+
+# Or set API key directly
+export ${envPrefix}_API_KEY="your-key-here"
+
+# Verify authentication
+${cmd2} whoami
+\`\`\`
+
+---
+
+## 1. Presentations
+
+Create AI-powered presentations from text, files, URLs, or piped content.
+
+\`\`\`bash
+# From topic
+${cmd2} create "AI-powered analytics platform"
+
+# From file (PDF, PPTX, DOCX, Markdown)
+${cmd2} create "Quarterly Report" --file report.pdf
+
+# From URL
+${cmd2} create "Product Overview" --sources https://company.com/product
+
+# From piped content
+cat notes.md | ${cmd2} create "Meeting Summary"
+
+# With options
+${cmd2} create "Pitch Deck" \\
+  --slides 10 \\
+  --mode balanced \\
+  --tone professional \\
+  --audience "Investors" \\
+  --brand my-company \\
+  --open
+\`\`\`
+
+**Key Options:**
+- \`--slides <1-20>\` - Number of slides (default: 10)
+- \`--mode <instant|ultrafast|fast|balanced|best>\` - Quality/speed tradeoff
+- \`--tone <creative|professional|educational|formal|casual>\`
+- \`--file <paths...>\` - Extract content from files
+- \`--sources <urls...>\` - Scrape URLs for context
+- \`--brand <id|url>\` - Apply branding
+- \`--open\` - Open in browser when done
+
+**Manage presentations:**
+\`\`\`bash
+${cmd2} list                    # List all presentations
+${cmd2} get <slug>              # Get details
+${cmd2} export <slug> -o p.zip  # Export to ZIP
+${cmd2} delete <slug>           # Delete
+\`\`\`
+
+---
+
+## 2. Video Asset Generation
+
+Generate voiceovers, music, and find stock media for video production. Works with Remotion or any video framework.
+
+### Generate All Assets at Once
+
+\`\`\`bash
+cat <<'EOF' | ${cmd2} video create --output ./public
+{
+  "scenes": [
+    {
+      "name": "Hook",
+      "script": "Watch how we transformed complex workflows into a single click.",
+      "imageQuery": "modern dashboard dark theme",
+      "videoQuery": "abstract tech particles"
+    },
+    {
+      "name": "Demo",
+      "script": "Our AI analyzes data in real-time, surfacing insights that matter.",
+      "imageQuery": "data visualization charts"
+    },
+    {
+      "name": "CTA",
+      "script": "Start your free trial today.",
+      "imageQuery": "call to action button"
+    }
+  ],
+  "voice": "Kore",
+  "voiceSettings": {
+    "speed": 0.95,
+    "stability": 0.4,
+    "style": 0.6
+  },
+  "musicPrompt": "upbeat corporate, positive energy, modern synth"
+}
+EOF
+\`\`\`
+
+**Output:** Per-scene voiceovers, background music, stock images/videos, and \`video-manifest.json\` with timing data.
+
+### Initialize Remotion Project
+
+\`\`\`bash
+${cmd2} video init my-video              # 16:9 landscape
+${cmd2} video init my-video --type tiktok # 9:16 vertical
+\`\`\`
+
+### Embed Thumbnail
+
+\`\`\`bash
+${cmd2} video thumbnail video.mp4 --frame 60
+\`\`\`
+
+---
+
+## 3. Text-to-Speech (TTS)
+
+Convert text to natural speech with multiple providers and voices.
+
+\`\`\`bash
+# Basic usage
+${cmd2} tts generate -t "Hello world" -o output.mp3
+
+# With voice selection
+${cmd2} tts generate -t "Welcome to the demo" -v Rachel -o welcome.mp3
+
+# With provider and settings
+${cmd2} tts generate \\
+  -t "Professional narration" \\
+  -v Kore \\
+  -p gemini \\
+  -s 0.9 \\
+  -o narration.mp3
+
+# List available voices
+${cmd2} tts voices
+${cmd2} tts voices --provider elevenlabs
+\`\`\`
+
+**Providers:** \`gemini\`, \`elevenlabs\`, \`openai\`
+**Popular voices:** \`Kore\`, \`Puck\`, \`Rachel\`, \`alloy\`
+**Speed range:** 0.25 - 4.0 (default: 1.0)
+
+---
+
+## 4. Music Generation
+
+Generate AI music from text descriptions.
+
+\`\`\`bash
+# Generate music
+${cmd2} music generate -p "upbeat corporate, modern synth" --duration 30
+
+# Save to file
+${cmd2} music generate -p "calm ambient background" -o music.mp3
+
+# Check generation status (for async operations)
+${cmd2} music status <request-id>
+\`\`\`
+
+**Duration:** 3-30 seconds
+**Providers:** \`elevenlabs\`, \`suno\`
+
+---
+
+## 5. Image Search
+
+Search for stock images from multiple sources.
+
+\`\`\`bash
+# Basic search
+${cmd2} image search -q "mountain landscape"
+
+# With options
+${cmd2} image search -q "business team meeting" \\
+  --max-results 20 \\
+  --size large \\
+  --format json
+
+# Download for video project
+${cmd2} image search -q "tech abstract" -n 5 --format json > images.json
+\`\`\`
+
+**Options:**
+- \`--max-results <n>\` - Number of results (default: 10)
+- \`--size <small|medium|large|any>\` - Image size
+- \`--safe-search / --no-safe-search\` - Filter adult content
+
+---
+
+## 6. Video Search
+
+Search for stock video clips.
+
+\`\`\`bash
+# Basic search
+${cmd2} video search "ocean waves"
+
+# With filters
+${cmd2} video search "city timelapse" \\
+  --max-results 5 \\
+  --orientation landscape \\
+  --license free
+\`\`\`
+
+**Options:**
+- \`--orientation <landscape|portrait|square|any>\`
+- \`--license <free|premium|any>\`
+
+---
+
+## 7. Audio Mixing
+
+Mix video with voiceover and background music.
+
+\`\`\`bash
+# Mix audio tracks
+${cmd2} mix create \\
+  --video input.mp4 \\
+  --voice voiceover.mp3 \\
+  --music background.mp3 \\
+  --music-volume 30 \\
+  --voice-volume 100 \\
+  -o final.mp4
+
+# Check mixing status
+${cmd2} mix status <request-id>
+\`\`\`
+
+Music automatically loops to match video duration.
+
+---
+
+## 8. Branding
+
+Manage brand profiles for consistent styling.
+
+\`\`\`bash
+# List saved brands
+${cmd2} branding list
+
+# Extract branding from website
+${cmd2} branding extract https://company.com
+
+# Get brand details
+${cmd2} branding get <brand-id>
+
+# Set default brand
+${cmd2} branding set-default <brand-id>
+
+# Use in presentations
+${cmd2} create "Topic" --brand my-company
+\`\`\`
+
+---
+
+## 9. Configuration
+
+\`\`\`bash
+# Interactive setup
+${cmd2} config init
+
+# Show current config
+${cmd2} config show
+${cmd2} config show --verify  # Verify API key
+
+# Set values
+${cmd2} config set api-key <key>
+${cmd2} config set team-id <id>
+
+# Clear config
+${cmd2} config clear
+
+# Show config file location
+${cmd2} config path
+\`\`\`
+
+---
+
+## Output Formats
+
+All commands support multiple output formats:
+
+\`\`\`bash
+${cmd2} <command> --format human  # Default, colored terminal output
+${cmd2} <command> --format json   # Machine-readable JSON
+${cmd2} <command> --format quiet  # Minimal output, errors only
+\`\`\`
+
+---
+
+## Environment Variables
+
+\`\`\`bash
+${envPrefix}_API_KEY    # API key for authentication
+${envPrefix}_API_URL    # Custom API URL (optional)
+\`\`\`
+
+---
+
+## Specialized Skills
+
+For detailed workflows, load these skills:
+
+- **\`${name}-video\`** - Detailed video creation workflow, Remotion integration, composition rules, R3F/Three.js patterns
+- **\`${name}-presentation\`** - Detailed presentation creation, styling options, export formats
+
+---
+
+## Common Workflows
+
+### Video Production Pipeline
+
+\`\`\`bash
+# 1. Initialize project
+${cmd2} video init product-demo
+
+# 2. Generate assets
+cat scenes.json | ${cmd2} video create -o product-demo/public
+
+# 3. Implement in Remotion (see ${name}-video skill)
+
+# 4. Render and add thumbnail
+cd product-demo
+pnpm exec remotion render FullVideo
+${cmd2} video thumbnail out/FullVideo.mp4 --frame 60
+\`\`\`
+
+### Presentation from Research
+
+\`\`\`bash
+# Gather content from multiple sources
+${cmd2} create "Market Analysis" \\
+  --file research.pdf \\
+  --sources https://industry-report.com \\
+  --context "Focus on Q4 trends" \\
+  --slides 15 \\
+  --tone professional \\
+  --brand company \\
+  --open
+\`\`\`
+
+### Batch Image Collection
+
+\`\`\`bash
+# Get images for video scenes
+for query in "hero shot" "team photo" "product showcase"; do
+  ${cmd2} image search -q "$query" -n 3 --format json
+done
+\`\`\`
+
+---
+
+## Troubleshooting
+
+**Authentication issues:**
+\`\`\`bash
+${cmd2} whoami              # Check current user
+${cmd2} logout && ${cmd2} login  # Re-authenticate
+\`\`\`
+
+**Check API status:**
+\`\`\`bash
+${cmd2} config show --verify
+\`\`\`
+
+**Debug mode:**
+\`\`\`bash
+${cmd2} <command> --debug
+\`\`\`
+
+---
+
+## Help
+
+\`\`\`bash
+${cmd2} --help              # General help
+${cmd2} <command> --help    # Command-specific help
+${cmd2} --version           # Version info
+\`\`\`
+`;
+}
+
 // src/commands/skill/rules/video/content.ts
 var VIDEO_RULE_CONTENTS = [
   {
@@ -4405,6 +4820,7 @@ function getSupportedEditorNames() {
 }
 
 // src/commands/skill/index.ts
+var SKILL_TYPES = ["main", "video", "presentation"];
 var skillContext = {
   name: brand.name,
   cmd: brand.commands[0],
@@ -4413,25 +4829,39 @@ var skillContext = {
 var skillCommand = new Command14("skill").description(`Manage ${brand.displayName} skills for AI coding assistants`).addHelpText(
   "after",
   `
+${chalk12.bold("Skill Types:")}
+  ${chalk12.cyan("main")}          Main CLI skill with all capabilities (TTS, music, images, videos, presentations)
+  ${chalk12.cyan("video")}         Detailed video creation workflow with Remotion/R3F patterns
+  ${chalk12.cyan("presentation")}  Detailed presentation creation workflow
+
 ${chalk12.bold("Examples:")}
+  ${chalk12.gray("# Install main CLI skill (comprehensive overview)")}
+  $ ${brand.commands[0]} skill install main
+
   ${chalk12.gray("# Install video skill")}
   $ ${brand.commands[0]} skill install video
 
   ${chalk12.gray("# Install presentation skill")}
   $ ${brand.commands[0]} skill install presentation
 
-  ${chalk12.gray("# Install both skills")}
+  ${chalk12.gray("# Install all skills")}
   $ ${brand.commands[0]} skill install
 
   ${chalk12.gray("# Install to specific directory")}
-  $ ${brand.commands[0]} skill install video --dir ~/.claude
+  $ ${brand.commands[0]} skill install main --dir ~/.claude
 
   ${chalk12.gray("# Show skill content")}
-  $ ${brand.commands[0]} skill show video
+  $ ${brand.commands[0]} skill show main
 `
 );
-skillCommand.command("install").description(`Install ${brand.displayName} skills for AI coding assistants`).argument("[type]", "Skill type: video, presentation, or omit for both").option("-d, --dir <path>", "Install to specific directory").option("-g, --global", "Install globally (to home directory)", true).option("-l, --local", "Install locally (to current directory)").option("-f, --force", "Overwrite existing skill files").action(async (type, options) => {
+skillCommand.command("install").description(`Install ${brand.displayName} skills for AI coding assistants`).argument("[type]", "Skill type: main, video, presentation, or omit for all").option("-d, --dir <path>", "Install to specific directory").option("-g, --global", "Install globally (to home directory)", true).option("-l, --local", "Install locally (to current directory)").option("-f, --force", "Overwrite existing skill files").action(async (type, options) => {
   const skillsToInstall = [];
+  if (!type || type === "main") {
+    skillsToInstall.push({
+      name: brand.name,
+      content: generateMainSkillContent(skillContext)
+    });
+  }
   if (!type || type === "video") {
     skillsToInstall.push({
       name: `${brand.name}-video`,
@@ -4444,8 +4874,8 @@ skillCommand.command("install").description(`Install ${brand.displayName} skills
       content: generatePresentationSkillContent(skillContext)
     });
   }
-  if (type && type !== "video" && type !== "presentation") {
-    error(`Invalid skill type: ${type}. Must be "video" or "presentation"`);
+  if (type && !SKILL_TYPES.includes(type)) {
+    error(`Invalid skill type: ${type}. Must be one of: ${SKILL_TYPES.join(", ")}`);
     process.exit(1);
   }
   console.log();
@@ -4477,26 +4907,31 @@ skillCommand.command("install").description(`Install ${brand.displayName} skills
     console.log();
   }
 });
-skillCommand.command("show").description("Display skill content").argument("[type]", "Skill type: video or presentation (default: video)").action((type = "video") => {
-  if (type === "video") {
+skillCommand.command("show").description("Display skill content").argument("[type]", "Skill type: main, video, or presentation (default: main)").action((type = "main") => {
+  if (type === "main") {
+    console.log(generateMainSkillContent(skillContext));
+  } else if (type === "video") {
     console.log(generateVideoSkillContent(skillContext));
   } else if (type === "presentation") {
     console.log(generatePresentationSkillContent(skillContext));
   } else {
-    error(`Invalid skill type: ${type}. Must be "video" or "presentation"`);
+    error(`Invalid skill type: ${type}. Must be one of: ${SKILL_TYPES.join(", ")}`);
     process.exit(1);
   }
 });
-skillCommand.command("uninstall").description(`Remove ${brand.displayName} skills from AI coding assistants`).argument("[type]", "Skill type: video, presentation, or omit for both").option("-g, --global", "Uninstall globally (from home directory)", true).option("-l, --local", "Uninstall locally (from current directory)").action(async (type, options) => {
+skillCommand.command("uninstall").description(`Remove ${brand.displayName} skills from AI coding assistants`).argument("[type]", "Skill type: main, video, presentation, or omit for all").option("-g, --global", "Uninstall globally (from home directory)", true).option("-l, --local", "Uninstall locally (from current directory)").action(async (type, options) => {
   const skillsToRemove = [];
+  if (!type || type === "main") {
+    skillsToRemove.push(brand.name);
+  }
   if (!type || type === "video") {
     skillsToRemove.push(`${brand.name}-video`);
   }
   if (!type || type === "presentation") {
     skillsToRemove.push(`${brand.name}-presentation`);
   }
-  if (type && type !== "video" && type !== "presentation") {
-    error(`Invalid skill type: ${type}. Must be "video" or "presentation"`);
+  if (type && !SKILL_TYPES.includes(type)) {
+    error(`Invalid skill type: ${type}. Must be one of: ${SKILL_TYPES.join(", ")}`);
     process.exit(1);
   }
   console.log();
@@ -5686,7 +6121,7 @@ var thumbnailCommand = new Command19("thumbnail").description("Embed a thumbnail
 var videoCommand = new Command19("video").description("Video asset generation commands").addCommand(initCommand).addCommand(createCommand2).addCommand(searchCommand2).addCommand(thumbnailCommand);
 
 // src/index.ts
-var VERSION = "0.1.8";
+var VERSION = "0.1.9";
 var program = new Command20();
 var cmdName = brand.commands[0];
 program.name(cmdName).description(brand.description).version(VERSION, "-v, --version", "Show version number").option("--debug", "Enable debug logging").option("--no-color", "Disable colored output").configureOutput({