@leejungkiin/awkit 1.6.4 → 1.6.5

package/scripts/obsidian-sync.js

@@ -0,0 +1,494 @@
+#!/usr/bin/env node
+
+/**
+ * Obsidian Sync — Exports Symphony task data to Obsidian Markdown notes.
+ *
+ * Reads task data from Symphony SQLite DB and writes a formatted Markdown
+ * section into an Obsidian note file. Uses boundary markers to preserve
+ * any user-written content outside the sync region.
+ *
+ * Config is read from `.project-identity` → `automation.obsidian`.
+ *
+ * Usage (via awkit CLI):
+ *   awkit obsidian sync          Full sync for current project
+ *   awkit obsidian sync --all    Sync all projects that have obsidian config
+ *   awkit obsidian status        Show sync status (dry-run)
+ *   awkit obsidian help          Show help
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// ─── Constants ────────────────────────────────────────────────────────────────
+
+const HOME = process.env.HOME || process.env.USERPROFILE;
+const SYMPHONY_DB = path.join(HOME, '.gemini', 'antigravity', 'symphony', 'symphony.db');
+
+// ─── Color helpers ────────────────────────────────────────────────────────────
+
+const C = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m',
+};
+
+const log = (msg) => console.log(msg);
+const ok = (msg) => log(`${C.green}✔${C.reset} ${msg}`);
+const warn = (msg) => log(`${C.yellow}⚠${C.reset} ${msg}`);
+const err = (msg) => log(`${C.red}✖${C.reset} ${msg}`);
+const info = (msg) => log(`${C.cyan}ℹ${C.reset} ${msg}`);
+const dim = (msg) => log(`${C.gray}${msg}${C.reset}`);
+
+// ─── SQLite reader (uses system sqlite3 CLI) ──────────────────────────────────
+
+/**
+ * Execute a SQLite query via the system `sqlite3` command.
+ * Returns an array of objects with column names as keys.
+ */
+function querySqlite(dbPath, sql) {
+    if (!fs.existsSync(dbPath)) {
+        return [];
+    }
+
+    try {
+        // Use JSON output mode for reliable parsing
+        const raw = execSync(
+            `sqlite3 -json "${dbPath}" "${sql.replace(/"/g, '\\"')}"`,
+            { encoding: 'utf8', maxBuffer: 1024 * 1024, stdio: ['pipe', 'pipe', 'pipe'] }
+        );
+        const trimmed = raw.trim();
+        if (!trimmed || trimmed === '[]') return [];
+        return JSON.parse(trimmed);
+    } catch (e) {
+        // sqlite3 may not support -json on older versions, fallback to CSV
+        try {
+            const raw = execSync(
+                `sqlite3 -header -csv "${dbPath}" "${sql.replace(/"/g, '\\"')}"`,
+                { encoding: 'utf8', maxBuffer: 1024 * 1024, stdio: ['pipe', 'pipe', 'pipe'] }
+            );
+            return parseCsvOutput(raw.trim());
+        } catch (e2) {
+            warn(`SQLite query failed: ${e2.message}`);
+            return [];
+        }
+    }
+}
+
+/**
+ * Parse CSV output from sqlite3 -header -csv into array of objects.
+ */
+function parseCsvOutput(csv) {
+    if (!csv) return [];
+    const lines = csv.split('\n').filter(l => l.trim());
+    if (lines.length < 2) return [];
+
+    const headers = parseCSVLine(lines[0]);
+    const rows = [];
+
+    for (let i = 1; i < lines.length; i++) {
+        const values = parseCSVLine(lines[i]);
+        const obj = {};
+        headers.forEach((h, idx) => {
+            obj[h] = values[idx] || '';
+        });
+        rows.push(obj);
+    }
+    return rows;
+}
+
+/**
+ * Simple CSV line parser (handles quoted fields).
+ */
+function parseCSVLine(line) {
+    const fields = [];
+    let current = '';
+    let inQuotes = false;
+
+    for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (ch === '"') {
+            if (inQuotes && line[i + 1] === '"') {
+                current += '"';
+                i++;
+            } else {
+                inQuotes = !inQuotes;
+            }
+        } else if (ch === ',' && !inQuotes) {
+            fields.push(current);
+            current = '';
+        } else {
+            current += ch;
+        }
+    }
+    fields.push(current);
+    return fields;
+}
+
+// ─── .project-identity reader ─────────────────────────────────────────────────
+
+function readProjectIdentity(startDir = process.cwd()) {
+    let dir = path.resolve(startDir);
+    const root = path.parse(dir).root;
+
+    while (dir !== root) {
+        const candidate = path.join(dir, '.project-identity');
+        if (fs.existsSync(candidate)) {
+            try {
+                return JSON.parse(fs.readFileSync(candidate, 'utf8'));
+            } catch (e) {
+                return null;
+            }
+        }
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+
+/**
+ * Get obsidian config from .project-identity.
+ * Returns { enabled, path, template, autoSync } or null.
+ */
+function getObsidianConfig(identity) {
+    if (!identity) return null;
+    const obsidian = identity.automation?.obsidian;
+    if (!obsidian || !obsidian.enabled || !obsidian.path) return null;
+    return obsidian;
+}
+
+// ─── Markdown renderer (Obsidian Kanban format) ──────────────────────────────
+
+/**
+ * Map priority values to emoji tag for Kanban cards.
+ */
+function priorityTag(priority) {
+    const map = {
+        '0': '🔴', '1': '🟠', '2': '🟡', '3': '🟢',
+        'critical': '🔴', 'high': '🟠', 'medium': '🟡', 'low': '🟢',
+    };
+    return map[String(priority).toLowerCase()] || '⚪';
+}
+
+/**
+ * Format a task line for Kanban card.
+ * Done tasks get ✅ YYYY-MM-DD suffix (Kanban plugin convention).
+ */
+function formatKanbanCard(task) {
+    const emoji = priorityTag(task.priority);
+    const title = task.title || 'Untitled';
+
+    if (task.status === 'done') {
+        const doneDate = task.completed_at
+            ? task.completed_at.substring(0, 10)  // Extract YYYY-MM-DD
+            : new Date().toISOString().substring(0, 10);
+        return `- [x] ${emoji} ${title} ✅ ${doneDate}`;
+    }
+    return `- [ ] ${emoji} ${title}`;
+}
+
+/**
+ * Extract existing frontmatter and kanban settings to preserve customizations.
+ */
+function extractExistingBlocks(filePath) {
+    let result = { frontmatterLines: null, settingsJson: null };
+    if (!fs.existsSync(filePath)) return result;
+
+    try {
+        const content = fs.readFileSync(filePath, 'utf8');
+
+        // Extract Frontmatter
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (fmMatch) {
+            result.frontmatterLines = fmMatch[1].trim().split('\n');
+        }
+
+        // Extract Kanban Settings
+        const setMatch = content.match(/%% kanban:settings\n```.*\n([\s\S]*?)\n```\n%%/);
+        if (setMatch) {
+            try {
+                result.settingsJson = JSON.parse(setMatch[1].trim());
+            } catch (e) {}
+        }
+    } catch (e) {}
+
+    return result;
+}
+
+/**
+ * Render full Obsidian Kanban board Markdown.
+ * Output is the ENTIRE file content (frontmatter + columns + settings).
+ */
+function renderKanbanContent(projectInfo, tasks, existingData = {}) {
+    // Group tasks by status
+    const inProgress = tasks.filter(t => t.status === 'in_progress' || t.status === 'internal_review');
+    const ready = tasks.filter(t => t.status === 'ready');
+    const done = tasks.filter(t => t.status === 'done');
+    const blocked = tasks.filter(t => t.status === 'blocked');
+
+    // Count columns that have content (for list-collapse array)
+    const columns = [];
+
+    const lines = [];
+
+    // ── Frontmatter ──
+    lines.push('---');
+    if (existingData.frontmatterLines && existingData.frontmatterLines.length > 0) {
+        existingData.frontmatterLines.forEach(l => lines.push(l));
+    } else {
+        lines.push('');
+        lines.push('kanban-plugin: board');
+        lines.push(`sticker: lucide//list-checks`);
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+
+    // ── Doing column ──
+    lines.push('## Doing');
+    lines.push('');
+    if (inProgress.length > 0) {
+        inProgress
+            .sort((a, b) => String(a.priority).localeCompare(String(b.priority)))
+            .forEach(t => lines.push(formatKanbanCard(t)));
+    }
+    lines.push('');
+    lines.push('');
+    columns.push(false);
+
+    // ── Blocked column (only if there are blocked tasks) ──
+    if (blocked.length > 0) {
+        lines.push('## Blocked');
+        lines.push('');
+        blocked.forEach(t => lines.push(formatKanbanCard(t)));
+        lines.push('');
+        lines.push('');
+        columns.push(false);
+    }
+
+    // ── Todo column ──
+    lines.push('## Todo');
+    lines.push('');
+    if (ready.length > 0) {
+        ready
+            .sort((a, b) => String(a.priority).localeCompare(String(b.priority)))
+            .forEach(t => lines.push(formatKanbanCard(t)));
+    }
+    lines.push('');
+    lines.push('');
+    columns.push(false);
+
+    // ── Done column ──
+    lines.push('## Done');
+    lines.push('');
+    if (done.length > 0) {
+        done
+            .sort((a, b) => (b.completed_at || '').localeCompare(a.completed_at || ''))
+            .forEach(t => lines.push(formatKanbanCard(t)));
+    }
+    lines.push('');
+    lines.push('');
+    columns.push(true); // Done column collapsed by default
+
+    // ── Kanban settings block ──
+    lines.push('');
+    lines.push('');
+    lines.push('%% kanban:settings');
+    lines.push('```');
+    const settings = existingData.settingsJson || {
+        'kanban-plugin': 'board',
+        'show-checkboxes': true,
+        'move-dates': true,
+    };
+    
+    // Always sync list-collapse with the current number of dynamically generated columns
+    settings['list-collapse'] = columns;
+    
+    lines.push(JSON.stringify(settings));
+    lines.push('```');
+    lines.push('%%');
+
+    return lines.join('\n');
+}
+
+// ─── File writer (full Kanban board) ──────────────────────────────────────────
+
+/**
+ * Write Kanban board content to the Obsidian file.
+ * Since Kanban plugin owns the entire file format, we overwrite the full file.
+ */
+function writeSyncToFile(filePath, content) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+
+    const existed = fs.existsSync(filePath);
+    fs.writeFileSync(filePath, content + '\n', 'utf8');
+    return existed ? 'updated' : 'created';
+}
+
+// ─── Sync executor ────────────────────────────────────────────────────────────
+
+/**
+ * Perform sync for a single project.
+ * @param {object} identity - Parsed .project-identity
+ * @param {object} obsidianConfig - The automation.obsidian config
+ * @param {boolean} dryRun - If true, only print what would happen
+ * @returns {boolean} success
+ */
+function syncProject(identity, obsidianConfig, dryRun = false) {
+    const projectId = identity.projectId;
+    const projectName = identity.projectName || projectId;
+    const projectIcon = identity.icon || '📁';
+    const filePath = obsidianConfig.path;
+
+    info(`Syncing "${projectName}" → ${filePath}`);
+
+    // Query project info from Symphony
+    const projects = querySqlite(SYMPHONY_DB,
+        `SELECT id, name, icon FROM projects WHERE id = '${projectId}'`
+    );
+
+    const projectInfo = projects[0] || {
+        id: projectId,
+        name: projectName,
+        icon: projectIcon,
+    };
+
+    // Query tasks for this project
+    const tasks = querySqlite(SYMPHONY_DB,
+        `SELECT id, title, status, priority, phase, completed_at FROM tasks WHERE project_id = '${projectId}' ORDER BY status, priority`
+    );
+
+    info(`Found ${tasks.length} tasks for project "${projectId}"`);
+
+    // Extract existing formatting if any
+    const existingData = extractExistingBlocks(filePath);
+
+    // Render Kanban board
+    const content = renderKanbanContent(projectInfo, tasks, existingData);
+
+    if (dryRun) {
+        dim('─── Preview ───');
+        log(content);
+        dim('─── End Preview ───');
+        return true;
+    }
+
+    // Write to file
+    const result = writeSyncToFile(filePath, content);
+    ok(`Sync complete (${result}): ${filePath}`);
+    return true;
+}
+
+// ─── CLI handler ──────────────────────────────────────────────────────────────
+
+function obsidianHelp() {
+    log('');
+    log(`${C.cyan}${C.bold}📓 Obsidian Sync${C.reset}`);
+    log(`${C.gray}  Exports Symphony task data to Obsidian Markdown notes.${C.reset}`);
+    log('');
+    log(`  ${C.green}awkit obsidian sync${C.reset}            Sync current project`);
+    log(`  ${C.green}awkit obsidian status${C.reset}          Preview sync (dry-run)`);
+    log(`  ${C.green}awkit obsidian help${C.reset}            Show this help`);
+    log('');
+    log(`${C.gray}  Config: .project-identity → automation.obsidian${C.reset}`);
+    log(`${C.gray}  Example:${C.reset}`);
+    log(`${C.gray}    "automation": {${C.reset}`);
+    log(`${C.gray}      "obsidian": {${C.reset}`);
+    log(`${C.gray}        "enabled": true,${C.reset}`);
+    log(`${C.gray}        "path": "/path/to/vault/ProjectNote.md",${C.reset}`);
+    log(`${C.gray}        "autoSync": true${C.reset}`);
+    log(`${C.gray}      }${C.reset}`);
+    log(`${C.gray}    }${C.reset}`);
+    log('');
+}
+
+/**
+ * Main handler for `awkit obsidian` subcommand.
+ * @param {string[]} args - CLI args after 'obsidian'
+ */
+function cmdObsidian(args) {
+    const action = args[0];
+
+    if (!action || action === 'help' || action === '--help' || action === '-h') {
+        obsidianHelp();
+        return;
+    }
+
+    // Read project identity
+    const identity = readProjectIdentity();
+    if (!identity) {
+        err('No .project-identity found. Run this from a project directory.');
+        return;
+    }
+
+    const obsidianConfig = getObsidianConfig(identity);
+    if (!obsidianConfig) {
+        err('Obsidian sync not configured. Add automation.obsidian to .project-identity.');
+        dim('Example:');
+        dim('  "automation": {');
+        dim('    "obsidian": {');
+        dim('      "enabled": true,');
+        dim('      "path": "/path/to/vault/Note.md",');
+        dim('      "autoSync": true');
+        dim('    }');
+        dim('  }');
+        return;
+    }
+
+    switch (action) {
+        case 'sync':
+            log('');
+            log(`${C.cyan}${C.bold}📓 Obsidian Sync${C.reset}`);
+            log('');
+            syncProject(identity, obsidianConfig, false);
+            break;
+
+        case 'status':
+            log('');
+            log(`${C.cyan}${C.bold}📓 Obsidian Sync — Status (Dry Run)${C.reset}`);
+            log('');
+            syncProject(identity, obsidianConfig, true);
+            break;
+
+        default:
+            err(`Unknown obsidian action: ${action}`);
+            obsidianHelp();
+            break;
+    }
+}
+
+// ─── Auto-sync trigger (called from automation-gate) ──────────────────────────
+
+/**
+ * Silently attempt Obsidian sync if configured.
+ * Used as a hook after gate operations (git commit, trello, etc.).
+ * Does NOT throw errors — fails silently to avoid blocking gate operations.
+ */
+function autoSyncObsidian() {
+    try {
+        const identity = readProjectIdentity();
+        if (!identity) return;
+
+        const obsidianConfig = getObsidianConfig(identity);
+        if (!obsidianConfig || !obsidianConfig.autoSync) return;
+
+        syncProject(identity, obsidianConfig, false);
+    } catch (_) {
+        // Silent fail — don't block gate operations
+    }
+}
+
+// ─── Exports ──────────────────────────────────────────────────────────────────
+
+module.exports = {
+    cmdObsidian,
+    autoSyncObsidian,
+    syncProject,
+    getObsidianConfig,
+};

package/skills/app-store-screenshots/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: app-store-screenshots
+description: Specializes in generating high-conversion App Store and Google Play screenshots using Next.js and html-to-image. Handles design, copywriting, and bulk export at correct resolutions.
+version: 1.0.0
+trigger: conditional
+activation_keywords:
+  - "app store screenshots"
+  - "play store screenshots"
+  - "marketing screenshots"
+  - "marketing assets"
+  - "screenshot generator"
+  - "android screenshots"
+  - "ios screenshots"
+---
+
+# 📱 App Store & Google Play Screenshots Generator
+
+This skill empowers you to build professional screenshot generators that render as **advertisements**, not just UI showcases. It leverages Next.js and `html-to-image` to ensure high-fidelity exports at all required Apple and Google resolutions.
+
+## 🚀 Activation Triggers
+Trigger this skill when asked to:
+- "Build/Create App Store screenshots"
+- "Generate marketing assets for the Play Store"
+- "Design exportable screenshots for iOS/Android"
+
+## 🛠️ Resources
+- **Mockup**: iPhone mockup at `./resources/mockup.png`.
+- **Note**: All other device frames (Android, iPad, Tablet) are rendered via CSS-only components defined in this skill.
+
+## 📋 Interaction Flow
+
+### Phase 1: Brand & Asset Discovery
+Before any code is written, you MUST collect:
+1. **Source Screenshots**: PNG captures of the actual app UI.
+2. **App Icon**: PNG icon for branding slides.
+3. **Brand Palette**: Accent, background, and text colors.
+4. **Style Direction**: e.g., Dark/Moody, Clean/Minimal, Bold/Vibrant.
+5. **Feature Priority**: Top 3-5 outcomes/benefits the app provides.
+
+### Phase 2: Narrative & Copywriting
+- **Rule**: One idea per slide.
+- **Copy**: 3-5 words per headline. Readable at thumbnail size.
+- **Tone**: Focus on outcomes, not feature lists.
+
+### Phase 3: Scaffolding (Next.js)
+The generator is always a single-file Next.js page (`page.tsx`) for simplicity.
+- **Library**: `html-to-image` (Native SVG serialization).
+- **Setup**: `bun create-next-app` (preferred) or `npx`.
+
+### Phase 4: Resolution-Independent Design
+Use the following coordinates and sizing logic provided in the reference instructions below.
+
+---
+
+## 📖 Reference Instructions (The Core Engine)
+
+Build a Next.js page that renders App Store **and** Google Play screenshots as **advertisements** (not UI showcases) and exports them via `html-to-image` at Apple's and Google's required resolutions.
+
+### Supported Devices
+- **iPhone** (1320x2868)
+- **iPad** (2064x2752)
+- **Android Phone** (1080x1920)
+- **Android Tablet 7" & 10"** (Portrait & Landscape)
+- **Feature Graphic** (1024x500)
+
+### ⚠️ Critical Implementation Rules
+- **Double-Capture Trick**: `html-to-image` requires two sequential calls to warm up fonts/images.
+- **Data URI Preloading**: ALL images (mockups, screenshots) MUST be converted to base64 data URIs at load time to prevent blank exports.
+- **Canvas Scaling**: Use `ResizeObserver` and `transform: scale()` for the preview grid, but render at true resolution for export.
+
+### [Core Device Geometries]
+(Included in full in the implementation)
+- iPhone Mockup Ratios (based on `./resources/mockup.png`)
+- CSS-only frame components for iPad and Android.
+
+---
+
+> [!TIP]
+> **Narrative Arc**: Start with a Hero (Main Benefit), follow with Differentiators, and end with a "Trust/More Features" slide.
+
+> [!IMPORTANT]
+> **Localization**: Supports RTL-native layouts for Arabic/Hebrew by mirroring asymmetric compositions intentionally.
+
+---
+
+*This skill was shipped by Antigravity from ParthJadhav/app-store-screenshots.*