@agendapanda/cli 0.3.2 → 0.4.1

package/dist/src/commands/init.js

@@ -0,0 +1,249 @@
+import chalk from 'chalk';
+import { createInterface } from 'readline';
+import { api, ApiError } from '../lib/api.js';
+import { getApiKey, setApiKey, getActiveProject, setActiveProject, getActiveConnection, setActiveConnection, getConfigPath, } from '../lib/config.js';
+import { outputError } from '../lib/output.js';
+import { openInBrowser } from '../lib/utils.js';
+import { pollForNewConnection } from '../lib/poll.js';
+const PLATFORMS = [
+    { id: 'twitter', label: 'X (Twitter)' },
+    { id: 'linkedin', label: 'LinkedIn' },
+    { id: 'facebook', label: 'Facebook Pages' },
+    { id: 'instagram', label: 'Instagram' },
+    { id: 'threads', label: 'Threads' },
+    { id: 'bluesky', label: 'Bluesky' },
+    { id: 'tiktok', label: 'TikTok' },
+];
+function prompt(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+export function registerInitCommand(program) {
+    program
+        .command('init')
+        .description('Guided first-run setup wizard')
+        .addHelpText('after', `
+Examples:
+  ap init                             # start the interactive setup wizard`)
+        .action(async () => {
+        if (!process.stdin.isTTY) {
+            outputError('ap init requires an interactive terminal', 'NOT_INTERACTIVE');
+            process.exit(1);
+        }
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        try {
+            // Welcome
+            console.log('');
+            console.log(chalk.bold('Welcome to Agenda Panda CLI'));
+            console.log(chalk.dim("Let's get you set up in 4 quick steps."));
+            console.log('');
+            // ── Step 1/4: Auth ──
+            console.log(chalk.bold('Step 1/4 — Authentication'));
+            let apiKey = getApiKey();
+            let authenticated = false;
+            if (apiKey) {
+                try {
+                    const me = await api.get('/api/auth/me');
+                    console.log(chalk.green('✓') + ` Already logged in as ${chalk.bold(me.user.name)} (${me.user.email})`);
+                    authenticated = true;
+                }
+                catch {
+                    console.log(chalk.yellow('Stored key is invalid. Let\'s re-authenticate.'));
+                    apiKey = '';
+                }
+            }
+            if (!authenticated) {
+                const hasKey = await prompt(rl, 'Do you have an API key? (y/N) ');
+                if (hasKey.toLowerCase() !== 'y') {
+                    console.log(chalk.dim('Opening agendapanda.com to get your API key...'));
+                    await openInBrowser('https://agendapanda.com/settings?tab=security');
+                    console.log(chalk.dim('Copy your API key from Settings > Security > API Keys'));
+                }
+                let valid = false;
+                while (!valid) {
+                    const key = await prompt(rl, 'Enter your API key: ');
+                    if (!key || !key.startsWith('ap_')) {
+                        console.log(chalk.red('Invalid key format. Keys start with "ap_". Try again.'));
+                        continue;
+                    }
+                    const originalKey = getApiKey();
+                    setApiKey(key);
+                    try {
+                        const me = await api.get('/api/auth/me');
+                        console.log(chalk.green('✓') + ` Authenticated as ${chalk.bold(me.user.name)} (${me.user.email})`);
+                        valid = true;
+                    }
+                    catch {
+                        setApiKey(originalKey);
+                        console.log(chalk.red('Key validation failed. Check your key and try again.'));
+                    }
+                }
+            }
+            console.log('');
+            // ── Step 2/4: Workspace ──
+            console.log(chalk.bold('Step 2/4 — Workspace'));
+            let activeProject = getActiveProject();
+            if (activeProject) {
+                try {
+                    const data = await api.get(`/api/projects/${activeProject}`);
+                    console.log(chalk.green('✓') + ` Active workspace: ${chalk.bold(data.project.name)}`);
+                }
+                catch {
+                    console.log(chalk.yellow('Stored project not found. Let\'s pick one.'));
+                    activeProject = '';
+                }
+            }
+            if (!activeProject) {
+                let projects = [];
+                try {
+                    const data = await api.get('/api/projects');
+                    projects = data.projects || [];
+                }
+                catch (err) {
+                    const msg = err instanceof ApiError ? err.message : String(err);
+                    console.log(chalk.red(`Could not fetch workspaces: ${msg}`));
+                }
+                if (projects.length === 0) {
+                    console.log(chalk.dim('No workspaces found. Opening browser to create one...'));
+                    await openInBrowser('https://agendapanda.com');
+                    console.log(chalk.dim('Create a workspace, then run `ap init` again.'));
+                    rl.close();
+                    return;
+                }
+                console.log('Your workspaces:');
+                projects.forEach((p, i) => {
+                    console.log(`  ${i + 1}) ${p.name} ${chalk.dim(`(${p.id.slice(0, 8)}...)`)}`);
+                });
+                let chosen;
+                while (!chosen) {
+                    const answer = await prompt(rl, 'Select a workspace (number): ');
+                    const idx = parseInt(answer, 10) - 1;
+                    if (idx >= 0 && idx < projects.length) {
+                        chosen = projects[idx];
+                    }
+                    else {
+                        console.log(chalk.red('Invalid selection. Try again.'));
+                    }
+                }
+                setActiveProject(chosen.id);
+                console.log(chalk.green('✓') + ` Active workspace set to ${chalk.bold(chosen.name)}`);
+            }
+            console.log('');
+            // ── Step 3/4: Connect Platform ──
+            console.log(chalk.bold('Step 3/4 — Connect a Platform'));
+            console.log('Which platform would you like to connect?');
+            PLATFORMS.forEach((p, i) => {
+                console.log(`  ${i + 1}) ${p.label}`);
+            });
+            console.log(`  ${PLATFORMS.length + 1}) ${chalk.dim('Skip for now')}`);
+            const platformAnswer = await prompt(rl, 'Select (number): ');
+            const platformIdx = parseInt(platformAnswer, 10) - 1;
+            let newConnection;
+            if (platformIdx >= 0 && platformIdx < PLATFORMS.length) {
+                const platform = PLATFORMS[platformIdx];
+                try {
+                    // Snapshot existing connections
+                    let existingIds;
+                    try {
+                        const before = await api.get('/api/connections');
+                        existingIds = new Set(before.connections.filter((c) => c.platform === platform.id).map((c) => c.id));
+                    }
+                    catch {
+                        existingIds = new Set();
+                    }
+                    const authUrl = await api.getRedirect(`/api/connections/connect/${encodeURIComponent(platform.id)}`);
+                    await openInBrowser(authUrl);
+                    console.log(chalk.dim(`Opened ${platform.label} authorization in browser...`));
+                    console.log(chalk.dim('Waiting for connection... (press Ctrl+C to skip)'));
+                    const { connection: conn, cancelled } = await pollForNewConnection(platform.id, existingIds);
+                    if (cancelled) {
+                        console.log(chalk.yellow('\nPolling cancelled. Run `ap connections add` later.'));
+                    }
+                    else if (conn) {
+                        newConnection = conn;
+                        const username = conn.platform_username || conn.platform_display_name || platform.id;
+                        console.log(chalk.green('✓') + ` Connected as @${username} on ${platform.label}`);
+                        setActiveConnection(conn.id);
+                        console.log(chalk.dim(`  Set as default connection (${conn.id.slice(0, 8)}...)`));
+                    }
+                    else {
+                        console.log(chalk.yellow('Connection not detected within 60s. Run `ap connections add` later.'));
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof ApiError ? err.message : String(err);
+                    console.log(chalk.red(`Could not start OAuth: ${msg}`));
+                }
+            }
+            else {
+                console.log(chalk.dim('Skipped. Run `ap connections add <platform>` when ready.'));
+            }
+            console.log('');
+            // ── Step 4/4: Test Post ──
+            console.log(chalk.bold('Step 4/4 — Test Post'));
+            const connectionId = getActiveConnection();
+            if (newConnection && connectionId) {
+                const sendTest = await prompt(rl, 'Send a test post to the connected platform? (y/N) ');
+                if (sendTest.toLowerCase() === 'y') {
+                    const projectId = getActiveProject();
+                    if (!projectId) {
+                        console.log(chalk.yellow('No active project. Skipping test post.'));
+                    }
+                    else {
+                        try {
+                            const data = await api.post(`/api/projects/${projectId}/posts`, {
+                                content: 'Hello from Agenda Panda CLI! This is a test post.',
+                                scheduled_at: new Date().toISOString(),
+                                social_connection_id: connectionId,
+                                post_now: true,
+                            });
+                            if (data.post.posted) {
+                                console.log(chalk.green('✓') + ' Test post published successfully!');
+                            }
+                            else if (data.post.error) {
+                                console.log(chalk.yellow('⚠') + ` Post created but failed: ${data.post.error}`);
+                            }
+                            else {
+                                console.log(chalk.green('✓') + ' Test post scheduled.');
+                            }
+                        }
+                        catch (err) {
+                            const msg = err instanceof ApiError ? err.message : String(err);
+                            console.log(chalk.red(`Test post failed: ${msg}`));
+                        }
+                    }
+                }
+                else {
+                    console.log(chalk.dim('Skipped.'));
+                }
+            }
+            else {
+                console.log(chalk.dim('No connection set — skipping test post.'));
+            }
+            console.log('');
+            // ── Summary ──
+            console.log(chalk.bold('Setup complete! Here are some next steps:'));
+            console.log('');
+            console.log(`  ${chalk.dim('$')} ap whoami                       ${chalk.dim('# check your auth status')}`);
+            console.log(`  ${chalk.dim('$')} ap connections list              ${chalk.dim('# see connected platforms')}`);
+            console.log(`  ${chalk.dim('$')} ap post create --content "..."   ${chalk.dim('# create a post')}`);
+            console.log(`  ${chalk.dim('$')} ap calendar import --file cal.json  ${chalk.dim('# bulk import posts')}`);
+            console.log(`  ${chalk.dim('$')} ap context | claude "Write posts"   ${chalk.dim('# AI-powered content')}`);
+            console.log('');
+            console.log(chalk.dim(`Config stored at ${getConfigPath()}`));
+            rl.close();
+        }
+        catch (err) {
+            rl.close();
+            if (err instanceof ApiError) {
+                outputError(err.message, err.code);
+            }
+            else {
+                outputError(String(err));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/src/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/post.js

@@ -1,10 +1,219 @@
 import chalk from 'chalk';
 import { readFile } from 'fs/promises';
+import { createInterface } from 'readline';
 import { api, ApiError } from '../lib/api.js';
-import { getActiveProject } from '../lib/config.js';
+import { getActiveProject, getActiveConnection } from '../lib/config.js';
 import { readStdin } from '../lib/input.js';
 import { filenameFromPath, guessMimeTypeFromPath } from '../lib/media.js';
+import { PLATFORM_RULES } from '../lib/platform-rules.js';
 import { initJsonMode, isJsonMode, outputJson, outputTable, outputError, outputItems, outputMutation, } from '../lib/output.js';
+import { API_KEY_URL_SUFFIX, MISSING_PROJECT_MSG, MISSING_CONNECTION_SUFFIX } from '../lib/errors.js';
+function promptLine(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+function promptMultiline(rl, maxChars) {
+    return new Promise((resolve) => {
+        const lines = [];
+        let currentLen = 0;
+        console.log(chalk.dim(`  (max ${maxChars} chars · Ctrl+D when done)`));
+        const remaining = () => maxChars - currentLen;
+        const onLine = (line) => {
+            lines.push(line);
+            currentLen = lines.join('\n').length;
+            const rem = remaining();
+            process.stdout.write(chalk.dim(`  [${rem} chars left] `) + '> ');
+        };
+        const onClose = () => {
+            rl.removeListener('line', onLine);
+            resolve(lines.join('\n').trim());
+        };
+        process.stdout.write('> ');
+        rl.on('line', onLine);
+        rl.once('close', onClose);
+    });
+}
+async function interactivePostCreate(options) {
+    const openInterfaces = [];
+    const closeAll = () => {
+        for (const iface of openInterfaces) {
+            iface.close();
+        }
+    };
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    openInterfaces.push(rl);
+    try {
+        // Resolve project first
+        const projectId = options.project || getActiveProject();
+        if (!projectId) {
+            outputError(MISSING_PROJECT_MSG, 'MISSING_PROJECT');
+            closeAll();
+            process.exit(1);
+        }
+        // Fetch connections
+        const data = await api.get('/api/connections');
+        const connectionsList = data.connections;
+        if (connectionsList.length === 0) {
+            outputError('No connections found. Run: ap connections add <platform>', 'NO_CONNECTIONS');
+            closeAll();
+            process.exit(1);
+        }
+        // 1. Select connection
+        console.log('');
+        console.log(chalk.bold('? Select connection:'));
+        connectionsList.forEach((c, i) => {
+            const name = c.platform_username
+                ? `@${c.platform_username}`
+                : c.platform_display_name || c.platform;
+            const rule = PLATFORM_RULES[c.platform];
+            const label = rule ? rule.label : c.platform;
+            console.log(`  ${i + 1}. ${label} (${name})`);
+        });
+        let selectedConnection;
+        while (!selectedConnection) {
+            const answer = await promptLine(rl, '> ');
+            const idx = parseInt(answer, 10) - 1;
+            if (idx >= 0 && idx < connectionsList.length) {
+                selectedConnection = connectionsList[idx];
+            }
+            else {
+                console.log(chalk.red('Invalid selection. Try again.'));
+            }
+        }
+        const platform = selectedConnection.platform;
+        const rule = PLATFORM_RULES[platform];
+        const maxChars = rule ? rule.max_chars : 5000;
+        // 2. Content input
+        console.log('');
+        console.log(chalk.bold('? Content:'));
+        const contentRl = createInterface({ input: process.stdin, output: process.stderr });
+        openInterfaces.push(contentRl);
+        const content = await promptMultiline(contentRl, maxChars);
+        contentRl.close();
+        if (!content) {
+            outputError('Post content cannot be empty.', 'MISSING_CONTENT');
+            closeAll();
+            process.exit(1);
+        }
+        if (content.length > maxChars) {
+            outputError(`Content exceeds ${maxChars} char limit for ${platform} (${content.length} chars).`, 'CONTENT_TOO_LONG');
+            closeAll();
+            process.exit(1);
+        }
+        // Re-create readline after multiline consumed the previous one
+        const rl2 = createInterface({ input: process.stdin, output: process.stderr });
+        openInterfaces.push(rl2);
+        // 3. When to post
+        console.log('');
+        console.log(chalk.bold('? When to post?'));
+        console.log('  1. Now');
+        console.log('  2. Schedule for later');
+        let postNow = true;
+        let scheduledAt = new Date().toISOString();
+        let validWhen = false;
+        while (!validWhen) {
+            const answer = await promptLine(rl2, '> ');
+            if (answer === '1') {
+                postNow = true;
+                validWhen = true;
+            }
+            else if (answer === '2') {
+                postNow = false;
+                validWhen = true;
+            }
+            else {
+                console.log(chalk.red('Enter 1 or 2.'));
+            }
+        }
+        if (!postNow) {
+            let validDate = false;
+            while (!validDate) {
+                const dateStr = await promptLine(rl2, chalk.bold('? Date (YYYY-MM-DD): '));
+                if (/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) {
+                    // Validate the date is a real calendar date
+                    const parsedDate = new Date(`${dateStr}T00:00:00Z`);
+                    if (isNaN(parsedDate.getTime()) || parsedDate.toISOString().slice(0, 10) !== dateStr) {
+                        console.log(chalk.red('Invalid date. Use a valid calendar date (e.g. 2026-03-01).'));
+                        continue;
+                    }
+                    let validTime = false;
+                    while (!validTime) {
+                        const timeStr = await promptLine(rl2, chalk.bold('? Time (HH:MM UTC): '));
+                        if (/^\d{2}:\d{2}$/.test(timeStr)) {
+                            const [hours, minutes] = timeStr.split(':').map(Number);
+                            if (hours > 23 || minutes > 59) {
+                                console.log(chalk.red('Invalid time. Hours must be 00-23, minutes 00-59.'));
+                                continue;
+                            }
+                            scheduledAt = `${dateStr}T${timeStr}:00Z`;
+                            // Validate the scheduled time is in the future
+                            if (new Date(scheduledAt) <= new Date()) {
+                                console.log(chalk.red('Scheduled time must be in the future.'));
+                                continue;
+                            }
+                            validTime = true;
+                            validDate = true;
+                        }
+                        else {
+                            console.log(chalk.red('Invalid time format. Use HH:MM (e.g. 14:00).'));
+                        }
+                    }
+                }
+                else {
+                    console.log(chalk.red('Invalid date format. Use YYYY-MM-DD (e.g. 2026-03-01).'));
+                }
+            }
+        }
+        rl2.close();
+        // Upload media if provided
+        let mediaUrl;
+        const mediaPath = options.media || options.image;
+        if (mediaPath) {
+            const mimeType = guessMimeTypeFromPath(mediaPath);
+            if (!mimeType) {
+                outputError('Unsupported media extension. Use jpg/jpeg/png/gif/webp/mp4/mov/webm/m4v.', 'UNSUPPORTED_MEDIA_TYPE');
+                closeAll();
+                process.exit(1);
+            }
+            const mediaData = await readFile(mediaPath);
+            const filename = filenameFromPath(mediaPath);
+            const blob = new Blob([mediaData], { type: mimeType });
+            const formData = new FormData();
+            formData.append('file', blob, filename);
+            const uploadResult = await api.upload('/api/media/upload', formData);
+            mediaUrl = uploadResult.url;
+        }
+        // Create post
+        const result = await api.post(`/api/projects/${projectId}/posts`, {
+            content,
+            scheduled_at: scheduledAt,
+            social_connection_id: selectedConnection.id,
+            media_url: mediaUrl,
+            post_now: postNow,
+        });
+        const connName = selectedConnection.platform_username
+            ? `@${selectedConnection.platform_username}`
+            : selectedConnection.platform_display_name || selectedConnection.platform;
+        const platformLabel = rule ? rule.label : selectedConnection.platform;
+        if (result.post.posted) {
+            console.log('');
+            console.log(chalk.green('✓') + ` Posted to ${platformLabel} (${connName})`);
+        }
+        else if (result.post.error) {
+            console.log('');
+            console.log(chalk.yellow('⚠') + ` Post created but failed to publish: ${result.post.error}`);
+        }
+        else {
+            console.log('');
+            console.log(chalk.green('✓') + ` Scheduled for ${scheduledAt}`);
+        }
+        console.log(chalk.dim(`  ID: ${result.post.id}`));
+    }
+    finally {
+        closeAll();
+    }
+}
 export function registerPostCommands(program) {
     const post = program.command('post').description('Create and manage posts');
     // ap post create
@@ -13,13 +222,36 @@ export function registerPostCommands(program) {
         .description('Create a new post')
         .option('--content <text>', 'Post content')
         .option('--connection <id>', 'Social connection ID (required)')
-        .option('--schedule <datetime>', 'Schedule for later (ISO datetime)')
+        .option('--schedule <datetime>', 'Schedule time in UTC ISO 8601 (e.g. 2026-03-01T14:00:00Z)')
         .option('--now', 'Post immediately (default if no --schedule)')
         .option('--media <path>', 'Upload and attach media (image/video)')
         .option('--image <path>', 'Deprecated alias for --media')
         .option('--project <id>', 'Override active project')
         .option('--json', 'Output as JSON')
+        .addHelpText('after', `
+Examples:
+  ap post create --content "Hello world" --now        # post immediately
+  ap post create --content "Scheduled!" --schedule 2026-03-01T14:00:00Z
+  ap post create --content "With image" --media photo.jpg --now
+  echo "Piped content" | ap post create --now         # pipe from stdin`)
         .action(async (options) => {
+        // Interactive mode: TTY + no content/connection/schedule flags
+        const hasInteractiveFlags = options.content || options.connection || options.schedule || options.now;
+        if (process.stdout.isTTY && process.stdin.isTTY && !hasInteractiveFlags && !options.json) {
+            try {
+                await interactivePostCreate(options);
+            }
+            catch (err) {
+                if (err instanceof ApiError) {
+                    outputError(err.message, err.code);
+                }
+                else {
+                    outputError(String(err));
+                }
+                process.exit(1);
+            }
+            return;
+        }
         initJsonMode(options);
         try {
             // Resolve content
@@ -34,15 +266,16 @@ export function registerPostCommands(program) {
                 outputError('Post content is required. Use --content or pipe via stdin.', 'MISSING_CONTENT');
                 process.exit(1);
             }
-            // Resolve connection
-            if (!options.connection) {
-                outputError('--connection is required', 'MISSING_CONNECTION');
+            // Resolve connection — flag → config/env → error
+            const connectionId = options.connection || getActiveConnection();
+            if (!connectionId) {
+                outputError('--connection is required' + MISSING_CONNECTION_SUFFIX, 'MISSING_CONNECTION');
                 process.exit(1);
             }
             // Resolve project
             const projectId = options.project || getActiveProject();
             if (!projectId) {
-                outputError('No project set. Use --project, AP_PROJECT env, or `ap projects use <id>`.', 'MISSING_PROJECT');
+                outputError(MISSING_PROJECT_MSG, 'MISSING_PROJECT');
                 process.exit(1);
             }
             // Upload media if provided
@@ -68,7 +301,7 @@ export function registerPostCommands(program) {
             const data = await api.post(`/api/projects/${projectId}/posts`, {
                 content,
                 scheduled_at: scheduledAt,
-                social_connection_id: options.connection,
+                social_connection_id: connectionId,
                 media_url: mediaUrl,
                 post_now: postNow,
             });
@@ -90,7 +323,14 @@ export function registerPostCommands(program) {
         }
         catch (err) {
             if (err instanceof ApiError) {
-                outputError(err.message, err.code);
+                let msg = err.message;
+                if (err.code === 'MISSING_PROJECT' || msg.includes('No project set')) {
+                    msg = MISSING_PROJECT_MSG;
+                }
+                if (err.code === 'INVALID_KEY' || msg.includes('Invalid API key')) {
+                    msg += API_KEY_URL_SUFFIX;
+                }
+                outputError(msg, err.code);
             }
             else {
                 outputError(String(err));
@@ -103,6 +343,10 @@ export function registerPostCommands(program) {
         .command('list')
         .description('List all posts')
         .option('--json', 'Output as JSON')
+        .addHelpText('after', `
+Examples:
+  ap post list                        # show all posts in a table
+  ap post list --json                 # JSON output for scripting`)
         .action(async (options) => {
         initJsonMode(options);
         try {
@@ -244,7 +488,7 @@ export function registerPostCommands(program) {
         .command('update <id>')
         .description('Update a post')
         .option('--content <text>', 'New content')
-        .option('--schedule <datetime>', 'New schedule (ISO datetime)')
+        .option('--schedule <datetime>', 'Schedule time in UTC ISO 8601 (e.g. 2026-03-01T14:00:00Z)')
         .option('--media <path>', 'Upload and attach media (image/video)')
         .option('--image <path>', 'Deprecated alias for --media')
         .option('--remove-media', 'Remove attached media')