@hienlh/ppm 0.9.79 → 0.9.81

package/.opencode/skills/social/scripts/schedule-post.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+
+/**
+ * Schedule social media posts with queue management
+ * Handles timing, rate limits, and multi-platform coordination
+ *
+ * Usage:
+ *   node schedule-post.js --platforms "x,linkedin" --content "Hello" --time "2025-01-20T10:00:00Z"
+ */
+
+const DEFAULT_CONFIG = {
+  maxConcurrent: {
+    x: 1,
+    linkedin: 2,
+    facebook: 100,
+    threads: 2,
+    tiktok: 1,
+    youtube: 200,
+  },
+  minDelayMs: {
+    x: 2000,
+    linkedin: 1000,
+    facebook: 500,
+    threads: 3000,
+    tiktok: 5000,
+    youtube: 1000,
+  },
+};
+
+// Optimal posting times by platform (UTC)
+const OPTIMAL_TIMES = {
+  x: { days: [2, 3, 4, 5], hours: [9, 10, 11, 12] }, // Tue-Fri 9am-12pm
+  linkedin: { days: [2, 3, 4], hours: [8, 9, 10] }, // Tue-Thu 8-10am
+  facebook: { days: [1, 2, 3, 4, 5], hours: [9, 10, 11, 12, 13] }, // Mon-Fri 9am-1pm
+  threads: { days: [1, 2, 3, 4, 5], hours: [11, 12, 13, 14] }, // Mon-Fri 11am-2pm
+  tiktok: { days: [2, 3, 4], hours: [19, 20, 21] }, // Tue-Thu 7-9pm
+  youtube: { days: [4, 5, 6], hours: [14, 15, 16, 17] }, // Thu-Sat 2-5pm
+};
+
+function generateId() {
+  return `post_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+
+function getNextOptimalTime(platform, afterDate = new Date()) {
+  const optimal = OPTIMAL_TIMES[platform.toLowerCase()];
+  if (!optimal) return afterDate;
+
+  const result = new Date(afterDate);
+
+  // Find next optimal day
+  while (!optimal.days.includes(result.getDay())) {
+    result.setDate(result.getDate() + 1);
+  }
+
+  // Find next optimal hour
+  const currentHour = result.getHours();
+  const nextHour = optimal.hours.find((h) => h > currentHour);
+
+  if (nextHour) {
+    result.setHours(nextHour, 0, 0, 0);
+  } else {
+    // Move to next optimal day
+    result.setDate(result.getDate() + 1);
+    while (!optimal.days.includes(result.getDay())) {
+      result.setDate(result.getDate() + 1);
+    }
+    result.setHours(optimal.hours[0], 0, 0, 0);
+  }
+
+  return result;
+}
+
+function validateScheduledTime(time) {
+  const now = new Date();
+
+  if (time < now) {
+    return { valid: false, error: 'Scheduled time is in the past' };
+  }
+
+  const maxFuture = new Date();
+  maxFuture.setDate(maxFuture.getDate() + 30); // 30 days max
+
+  if (time > maxFuture) {
+    return { valid: false, error: 'Scheduled time is too far in the future (max 30 days)' };
+  }
+
+  return { valid: true };
+}
+
+function createScheduledPost(platforms, content, scheduledTime, mediaUrls = []) {
+  return {
+    id: generateId(),
+    platforms,
+    content,
+    mediaUrls,
+    scheduledTime,
+    status: 'pending',
+    results: {},
+  };
+}
+
+function formatScheduleOutput(post) {
+  const lines = [
+    '\n=== Scheduled Post ===',
+    `ID: ${post.id}`,
+    `Status: ${post.status}`,
+    `Scheduled: ${post.scheduledTime.toISOString()}`,
+    `Platforms: ${post.platforms.join(', ')}`,
+    `Content: ${post.content.substring(0, 50)}${post.content.length > 50 ? '...' : ''}`,
+    `Media: ${post.mediaUrls.length} files`,
+  ];
+
+  if (Object.keys(post.results).length > 0) {
+    lines.push('\nResults:');
+    for (const [platform, result] of Object.entries(post.results)) {
+      if (result.success) {
+        lines.push(`  ✓ ${platform}: ${result.postUrl}`);
+      } else {
+        lines.push(`  ✗ ${platform}: ${result.error}`);
+      }
+    }
+  }
+
+  return lines.join('\n');
+}
+
+// CLI interface
+function main() {
+  const args = process.argv.slice(2);
+  const params = {};
+
+  // Boolean flags that don't take values
+  const booleanFlags = ['suggest-time', 'help'];
+
+  for (let i = 0; i < args.length; i++) {
+    if (!args[i].startsWith('--')) continue;
+    const key = args[i].replace('--', '');
+    if (booleanFlags.includes(key)) {
+      params[key] = true;
+    } else if (args[i + 1] && !args[i + 1].startsWith('--')) {
+      params[key] = args[i + 1];
+      i++; // Skip the value in next iteration
+    }
+  }
+
+  if (params.help || (!params.platforms && !params['suggest-time'])) {
+    console.log(`
+Social Post Scheduler
+
+Usage:
+  node schedule-post.js --platforms "x,linkedin" --content "Hello" --time "2025-01-20T10:00:00Z"
+  node schedule-post.js --suggest-time --platforms "x,linkedin"
+
+Options:
+  --platforms     Comma-separated list of platforms (x, linkedin, facebook, threads, tiktok, youtube)
+  --content       Post content text
+  --time          ISO 8601 datetime for scheduling (UTC)
+  --media         Comma-separated list of media URLs
+  --suggest-time  Suggest optimal posting times for platforms
+  --help          Show this help message
+
+Examples:
+  # Schedule a post
+  node schedule-post.js --platforms "x,linkedin" --content "Check out our new feature!" --time "2025-01-20T14:00:00Z"
+
+  # Get optimal posting times
+  node schedule-post.js --suggest-time --platforms "x,linkedin,tiktok"
+    `);
+    process.exit(0);
+  }
+
+  const platforms = params.platforms ? params.platforms.split(',').map((p) => p.trim().toLowerCase()) : [];
+
+  // Suggest optimal times
+  if (params['suggest-time']) {
+    console.log('\n=== Optimal Posting Times (UTC) ===');
+    for (const platform of platforms) {
+      const nextTime = getNextOptimalTime(platform);
+      const optimal = OPTIMAL_TIMES[platform];
+      console.log(`\n${platform.toUpperCase()}:`);
+      console.log(`  Best days: ${optimal?.days.map((d) => ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'][d]).join(', ')}`);
+      console.log(`  Best hours: ${optimal?.hours.map((h) => `${h}:00`).join(', ')}`);
+      console.log(`  Next optimal: ${nextTime.toISOString()}`);
+    }
+    process.exit(0);
+  }
+
+  if (!params.content) {
+    console.error('Error: --content is required');
+    process.exit(1);
+  }
+
+  const scheduledTime = params.time ? new Date(params.time) : getNextOptimalTime(platforms[0]);
+  const validation = validateScheduledTime(scheduledTime);
+
+  if (!validation.valid) {
+    console.error(`Error: ${validation.error}`);
+    process.exit(1);
+  }
+
+  const mediaUrls = params.media ? params.media.split(',').map((m) => m.trim()) : [];
+
+  const post = createScheduledPost(platforms, params.content, scheduledTime, mediaUrls);
+
+  console.log(formatScheduleOutput(post));
+  console.log('\nNote: This is a scheduling preview. Actual posting requires API integration.');
+  console.log('See references/unified-api-services.md for implementation options.');
+}
+
+// Export for programmatic use
+module.exports = {
+  createScheduledPost,
+  getNextOptimalTime,
+  validateScheduledTime,
+  OPTIMAL_TIMES,
+  DEFAULT_CONFIG,
+};
+
+// Run if called directly
+if (require.main === module) {
+  main();
+}

package/.opencode/skills/social/scripts/validate-post-content.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+
+/**
+ * Validate social media post content before posting
+ * Checks: length limits, media formats, required fields
+ *
+ * Usage:
+ *   node validate-post-content.js --platform x --content "Hello world"
+ *   node validate-post-content.js --platform linkedin --content "Post" --media "image.jpg,video.mp4"
+ */
+
+const PLATFORM_LIMITS = {
+  x: {
+    maxLength: 280,
+    premiumMaxLength: 4000,
+    supportedMediaTypes: ['image/jpeg', 'image/png', 'image/gif', 'video/mp4'],
+    maxMediaCount: 4,
+    maxMediaSizeMB: 15,
+    maxVideoDurationSec: 140,
+  },
+  linkedin: {
+    maxLength: 3000,
+    supportedMediaTypes: ['image/jpeg', 'image/png', 'image/gif', 'video/mp4', 'application/pdf'],
+    maxMediaCount: 9,
+    maxMediaSizeMB: 200,
+    maxVideoDurationSec: 600,
+  },
+  facebook: {
+    maxLength: 63206,
+    supportedMediaTypes: ['image/jpeg', 'image/png', 'video/mp4'],
+    maxMediaCount: 10,
+    maxMediaSizeMB: 4,
+    maxVideoDurationSec: 14400,
+  },
+  threads: {
+    maxLength: 500,
+    supportedMediaTypes: ['image/jpeg', 'image/png', 'video/mp4'],
+    maxMediaCount: 10,
+    maxMediaSizeMB: 8,
+    maxVideoDurationSec: 300,
+  },
+  tiktok: {
+    maxLength: 2000,
+    supportedMediaTypes: ['video/mp4', 'image/jpeg', 'image/png'],
+    maxMediaCount: 35,
+    maxMediaSizeMB: 287,
+    maxVideoDurationSec: 600,
+    minVideoDurationSec: 3,
+    requiresVideo: false,
+  },
+  youtube: {
+    maxLength: 5000,
+    supportedMediaTypes: ['video/mp4', 'video/webm', 'video/avi', 'video/mov'],
+    maxMediaCount: 1,
+    maxMediaSizeMB: 128000,
+    maxVideoDurationSec: 43200,
+    minVideoDurationSec: 1,
+    requiresVideo: true,
+  },
+};
+
+function getMimeType(filename) {
+  const ext = filename.toLowerCase().split('.').pop();
+  const mimeTypes = {
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    png: 'image/png',
+    gif: 'image/gif',
+    mp4: 'video/mp4',
+    webm: 'video/webm',
+    avi: 'video/avi',
+    mov: 'video/mov',
+    pdf: 'application/pdf',
+  };
+  return mimeTypes[ext] || 'application/octet-stream';
+}
+
+function validatePost(platform, content, media = [], isPremium = false) {
+  const result = { valid: true, errors: [], warnings: [] };
+  const limits = PLATFORM_LIMITS[platform.toLowerCase()];
+
+  if (!limits) {
+    result.valid = false;
+    result.errors.push(`Unknown platform: ${platform}. Supported: ${Object.keys(PLATFORM_LIMITS).join(', ')}`);
+    return result;
+  }
+
+  // Check content length
+  const maxLength = isPremium && limits.premiumMaxLength ? limits.premiumMaxLength : limits.maxLength;
+  if (content.length > maxLength) {
+    result.valid = false;
+    result.errors.push(`Content too long: ${content.length}/${maxLength} characters`);
+  } else if (content.length > maxLength * 0.9) {
+    result.warnings.push(`Content near limit: ${content.length}/${maxLength} characters`);
+  }
+
+  // Check media count
+  if (media.length > limits.maxMediaCount) {
+    result.valid = false;
+    result.errors.push(`Too many media files: ${media.length}/${limits.maxMediaCount}`);
+  }
+
+  // Check media types
+  for (const file of media) {
+    const mimeType = getMimeType(file);
+    if (!limits.supportedMediaTypes.includes(mimeType)) {
+      result.valid = false;
+      result.errors.push(`Unsupported media type: ${file} (${mimeType})`);
+    }
+  }
+
+  // Check video requirements
+  if (limits.requiresVideo && media.length === 0) {
+    result.valid = false;
+    result.errors.push(`${platform} requires video content`);
+  }
+
+  // Check for mixed media types on platforms that don't support it
+  if (platform === 'tiktok' && media.length > 0) {
+    const hasVideo = media.some((f) => getMimeType(f).startsWith('video/'));
+    const hasImage = media.some((f) => getMimeType(f).startsWith('image/'));
+    if (hasVideo && hasImage) {
+      result.valid = false;
+      result.errors.push('TikTok does not support mixing videos and images in one post');
+    }
+  }
+
+  // Platform-specific warnings
+  if (platform === 'linkedin' && content.includes('@') && !content.includes('urn:li:')) {
+    result.warnings.push('LinkedIn mentions should use format: @[Name](urn:li:organization:ID)');
+  }
+
+  if (platform === 'x' && content.includes('facebook.com')) {
+    result.warnings.push('X may suppress posts containing Facebook links');
+  }
+
+  return result;
+}
+
+// CLI interface
+function main() {
+  const args = process.argv.slice(2);
+  const params = {};
+
+  // Boolean flags that don't take values
+  const booleanFlags = ['premium', 'help'];
+
+  for (let i = 0; i < args.length; i++) {
+    if (!args[i].startsWith('--')) continue;
+    const key = args[i].replace('--', '');
+    if (booleanFlags.includes(key)) {
+      params[key] = true;
+    } else if (args[i + 1] && !args[i + 1].startsWith('--')) {
+      params[key] = args[i + 1];
+      i++; // Skip the value in next iteration
+    }
+  }
+
+  if (!params.platform || !params.content) {
+    console.log('Usage: node validate-post-content.js --platform <platform> --content "<text>" [--media "file1,file2"]');
+    console.log('\nSupported platforms:', Object.keys(PLATFORM_LIMITS).join(', '));
+    process.exit(1);
+  }
+
+  const media = params.media ? params.media.split(',').map((m) => m.trim()) : [];
+  const isPremium = params.premium === true;
+
+  const result = validatePost(params.platform, params.content, media, isPremium);
+
+  console.log('\n=== Validation Result ===');
+  console.log(`Platform: ${params.platform}`);
+  console.log(`Content length: ${params.content.length} characters`);
+  console.log(`Media files: ${media.length}`);
+  console.log(`Valid: ${result.valid ? '✓' : '✗'}`);
+
+  if (result.errors.length > 0) {
+    console.log('\nErrors:');
+    result.errors.forEach((e) => console.log(`  ✗ ${e}`));
+  }
+
+  if (result.warnings.length > 0) {
+    console.log('\nWarnings:');
+    result.warnings.forEach((w) => console.log(`  ⚠ ${w}`));
+  }
+
+  process.exit(result.valid ? 0 : 1);
+}
+
+// Export for programmatic use
+module.exports = { validatePost, PLATFORM_LIMITS };
+
+// Run if called directly
+if (require.main === module) {
+  main();
+}

package/.opencode/skills/stitch/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: ck:stitch
+description: "AI design generation with Google Stitch. Generate UI designs from text prompts, export Tailwind/HTML/DESIGN.md, orchestrate design-to-code pipeline. Use for rapid prototyping, UI generation, design exploration."
+license: MIT
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+argument-hint: "[design prompt or action]"
+metadata:
+  author: claudekit
+  version: "1.0.0"
+---
+
+# Google Stitch — AI Design Generation
+
+Generate high-fidelity UI designs from text prompts via Google Stitch. Export Tailwind/HTML, orchestrate design-to-code pipelines with existing UI skills.
+
+**Free tier:** 400 credits/day + 15 redesign credits/day. Resets at midnight UTC.
+
+## Setup
+
+### 1. API Key
+
+Get an API key at https://stitch.withgoogle.com → Settings → API Keys.
+
+Add `STITCH_API_KEY=sk_...` to `~/.opencode/.env` (or `~/.opencode/skills/.env`).
+
+Running `install.sh` auto-adds the placeholder if missing — just fill in the value.
+
+### 2. Install SDK
+
+```bash
+cd ~/.opencode/skills/stitch/scripts && npm install
+```
+
+Or run `~/.opencode/skills/install.sh` which handles this automatically.
+
+### 3. Optional
+
+```bash
+# In ~/.opencode/.env
+STITCH_PROJECT_ID="my-project"    # Default project (auto-creates "claudekit-default" if unset)
+STITCH_QUOTA_LIMIT="200"          # Override daily limit
+```
+
+### 4. MCP Server (optional)
+
+Add to `~/.opencode/.mcp.json` for native design context in Claude Code:
+
+```json
+{
+  "mcpServers": {
+    "stitch": {
+      "command": "npx",
+      "args": ["@_davideast/stitch-mcp", "proxy"],
+      "env": { "STITCH_API_KEY": "${STITCH_API_KEY}" }
+    }
+  }
+}
+```
+
+See `references/stitch-mcp-setup.md` for alternative options (gcloud, auto-installer).
+
+## Quick Start
+
+```bash
+# Check quota
+npx tsx scripts/stitch-quota.ts check
+
+# Generate design
+npx tsx scripts/stitch-generate.ts "A checkout page with payment form and cart summary"
+
+# Export as HTML + DESIGN.md
+npx tsx scripts/stitch-export.ts <screen-id> --format all --output ./stitch-exports/
+```
+
+## Actions
+
+### generate
+
+Generate UI design from text prompt.
+
+```bash
+npx tsx scripts/stitch-generate.ts "<prompt>" [--project <id>] [--device MOBILE|DESKTOP|TABLET] [--variants <count>]
+```
+
+Returns: screen ID, preview image URL. With `--variants`: additional design alternatives.
+
+### export
+
+Export generated design as HTML/Tailwind, screenshot, or DESIGN.md.
+
+```bash
+npx tsx scripts/stitch-export.ts <screen-id> [--format html|image|all] [--output <dir>]
+```
+
+Outputs:
+- `design.html` — Semantic HTML with Tailwind CSS classes
+- `design.png` — Screenshot of the design
+- `DESIGN.md` — Agent-readable design spec (colors, typography, spacing, components)
+
+### quota
+
+Check and manage daily quota.
+
+```bash
+npx tsx scripts/stitch-quota.ts check       # Show remaining credits
+npx tsx scripts/stitch-quota.ts increment   # Bump after generation
+npx tsx scripts/stitch-quota.ts reset       # Force reset (auto-resets daily)
+```
+
+### edit
+
+Refine an existing design.
+
+```typescript
+const editedScreen = await screen.edit("Make the header darker and add a search bar");
+```
+
+## Orchestration Pipeline
+
+### Design-to-Code Flow
+
+1. **Check quota** — Run `stitch-quota.ts check`. If exhausted, suggest `ck:ui-ux-pro-max` fallback.
+2. **Generate** — Run `stitch-generate.ts` with user's design prompt
+3. **Review** — Show generated design image to user for feedback
+4. **Variants** (optional) — Generate alternatives if user wants exploration
+5. **Export** — Run `stitch-export.ts --format all` to get HTML + DESIGN.md
+6. **Implement** — Hand off exported artifacts to implementation skill:
+   - `ck:frontend-design` — React/Vue/Svelte components from Tailwind export
+   - `ck:ui-ux-pro-max` — Full page layouts with style guide integration
+   - `ck:ui-styling` — Design token extraction from DESIGN.md
+7. **Track quota** — Run `stitch-quota.ts increment`
+
+### Handoff Protocol
+
+- Export creates `DESIGN.md` in project root or plan directory
+- Implementation skills detect `DESIGN.md` and use it as design spec
+- DESIGN.md takes precedence over text descriptions when present
+- If no DESIGN.md exists, skills fall back to normal text-based design flow
+
+See `references/design-to-code-pipeline.md` for detailed patterns and examples.
+
+## Quota Management
+
+- 400 credits/day + 15 redesign/day, resets at midnight UTC
+- Local tracking via `~/.claudekit/.stitch-quota.json`
+- Warns when remaining credits < 20%
+- **Fallback:** When exhausted, use `ck:ui-ux-pro-max` for text-based design generation
+
+See `references/quota-management.md` for strategies.
+
+## Limitations
+
+- **No React export** — HTML/Tailwind only; Claude converts to React/Vue components
+- **Non-responsive layouts** — Must add breakpoints manually during implementation
+- **No animations** — Static designs only; add micro-interactions in code
+- **Single-user** — No multiplayer/collaboration features
+- **Hard daily quota** — No paid tier to increase limits
+- **Generic output risk** — Combine with style guides for differentiation
+
+## References
+
+| Topic | File |
+|-------|------|
+| SDK API | `references/stitch-sdk-api.md` |
+| MCP Setup | `references/stitch-mcp-setup.md` |
+| Pipeline Patterns | `references/design-to-code-pipeline.md` |
+| Quota Strategy | `references/quota-management.md` |

package/.opencode/skills/stitch/data/mcp-config-snippet.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "stitch": {
+      "command": "npx",
+      "args": ["@_davideast/stitch-mcp", "proxy"],
+      "env": {
+        "STITCH_API_KEY": "${STITCH_API_KEY}"
+      }
+    }
+  }
+}