noslop 0.1.0 → 0.2.0

package/README.md

@@ -74,12 +74,20 @@ noslop
 |---------|-------------|
 | `noslop ready <id>` | Mark draft as ready |
 | `noslop unready <id>` | Mark as in-progress |
-| `noslop post <id>` | Move to posts folder |
-| `noslop unpost <id>` | Move back to drafts |
-| `noslop publish <id> <url>` | Add published URL |
 | `noslop schedule <id> <datetime>` | Set schedule (YYYY-MM-DD HH:MM) |
 | `noslop delete <id>` | Delete a draft |
 
+### X Integration
+
+| Command | Description |
+|---------|-------------|
+| `noslop auth x` | Authenticate with X API |
+| `noslop auth x --status` | Check authentication status |
+| `noslop auth x --list` | List all authenticated accounts |
+| `noslop auth x --unlink` | Remove account link from project |
+| `noslop auth x --logout <name>` | Remove stored credentials |
+| `noslop x post <id>` | Post a draft to X immediately |
+
 ## TUI Keyboard Shortcuts
 
 | Key | Action |
@@ -87,7 +95,7 @@ noslop
 | `Tab` | Switch between Drafts/Posts |
 | `↑/↓` | Navigate items |
 | `Enter` | Toggle ready (drafts) / Add URL (posts) |
-| `Space` | Move to Posts / Move to Drafts |
+| `Space` | Move to Posts |
 | `Backspace` | Delete draft (in-progress only) |
 | `s` | Toggle schedule view |
 | `←/→` | Navigate weeks (schedule view) |
@@ -138,6 +146,78 @@ Description of media to attach
 https://x.com/user/status/123
 ```
 
+The `## Published` URL is automatically added when you use `noslop x post`.
+
+## X Integration
+
+noslop can post directly to X (Twitter).
+
+### Setup
+
+1. Create an X Developer App at [X Developer Portal](https://developer.x.com/en/portal/dashboard)
+   - Enable "Read and Write" permissions
+   - Note your API Key and API Secret
+
+2. Authenticate (in your noslop project folder):
+
+```bash
+noslop auth x
+```
+
+3. Follow the prompts:
+   - Enter an account name (e.g., "personal", "work", "client-acme")
+   - Enter your API Key and Secret (or set `NOSLOP_X_API_KEY` and `NOSLOP_X_API_SECRET`)
+   - Browser opens to X for authorization
+   - Click "Authorize" on X
+   - Enter the PIN shown by X
+
+The account name is saved in your project's `CLAUDE.md` file:
+```markdown
+## X Account
+personal
+```
+
+Credentials are stored globally at `~/.config/noslop/credentials/x/`.
+
+### Multiple Accounts
+
+Each noslop project can be linked to a different X account:
+
+```bash
+# In project A (your personal account)
+noslop auth x              # Enter: personal
+
+# In project B (client work)
+noslop auth x              # Enter: client-acme
+
+# List all authenticated accounts
+noslop auth x --list
+
+# Check which account this project uses
+noslop auth x --status
+
+# Unlink project from account
+noslop auth x --unlink
+
+# Remove stored credentials
+noslop auth x --logout personal
+```
+
+### Workflow
+
+```bash
+# 1. Create a draft
+noslop new "Monday Motivation"
+
+# 2. Mark it ready when done
+noslop ready D001
+
+# 3. Post to X
+noslop x post D001
+
+# Draft is automatically moved to posts/ with the X URL saved
+```
+
 ## Working with AI Assistants
 
 noslop is designed to work with Claude Code and other AI assistants:

package/dist/index.js

@@ -1,7 +1,46 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { isNoslopProject, getAllContent, findItem, createDraft, updateStatus, updateSchedule, moveToPosts, moveToDrafts, addPublishedUrl, deleteDraft, sortBySchedule, } from './lib/content.js';
+import { isNoslopProject, getAllContent, findItem, createDraft, updateStatus, updateSchedule, moveToPosts, addPublishedUrl, deleteDraft, sortBySchedule, } from './lib/content.js';
 import { initProject, ensureNoslopMd } from './lib/templates.js';
+import { hasXCredentials, loadXCredentials, saveXCredentials, deleteXCredentials, validateXCredentials, getProjectXAccount, setProjectXAccount, removeProjectXAccount, listXAccounts, isValidAccountName, } from './lib/config.js';
+import { postTweet, verifyCredentials, getOAuthRequestToken, getOAuthAccessToken, } from './lib/x-api.js';
+import readline from 'readline';
+import { exec } from 'child_process';
+/**
+ * Prompt user for input
+ */
+function prompt(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise(resolve => {
+        rl.question(question, answer => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Open URL in default browser
+ */
+function openBrowser(url) {
+    let command;
+    if (process.platform === 'darwin') {
+        command = `open "${url}"`;
+    }
+    else if (process.platform === 'win32') {
+        command = `start "${url}"`;
+    }
+    else {
+        command = `xdg-open "${url}"`;
+    }
+    exec(command, err => {
+        if (err) {
+            console.log(`Could not open browser. Please visit: ${url}`);
+        }
+    });
+}
 const program = new Command();
 program
     .name('noslop')
@@ -185,12 +224,13 @@ program
     updateStatus(item, 'draft');
     console.log(`Marked as in-progress: ${item.folder}`);
 });
-// Post command (move to posts)
+// Schedule command
 program
-    .command('post')
-    .description('Move draft to posts folder')
+    .command('schedule')
+    .description('Set/update scheduled time')
     .argument('<id>', 'Folder name or ID')
-    .action((id) => {
+    .argument('<datetime>', 'Date and time (YYYY-MM-DD HH:MM)')
+    .action((id, datetime) => {
     if (!isNoslopProject()) {
         console.log('Not a noslop project. Run `noslop init` first.');
         process.exit(1);
@@ -200,13 +240,13 @@ program
         console.log(`Not found: ${id}`);
         process.exit(1);
     }
-    moveToPosts(item);
-    console.log(`Moved to posts: ${item.folder}`);
+    updateSchedule(item, datetime);
+    console.log(`Scheduled: ${item.folder} @ ${datetime}`);
 });
-// Unpost command (move back to drafts)
+// Delete command
 program
-    .command('unpost')
-    .description('Move post back to drafts')
+    .command('delete')
+    .description('Delete a draft')
     .argument('<id>', 'Folder name or ID')
     .action((id) => {
     if (!isNoslopProject()) {
@@ -218,64 +258,297 @@ program
         console.log(`Not found: ${id}`);
         process.exit(1);
     }
-    moveToDrafts(item);
-    console.log(`Moved to drafts: ${item.folder}`);
+    deleteDraft(item);
+    console.log(`Deleted: ${item.folder}`);
 });
-// Publish command
-program
-    .command('publish')
-    .description('Add published URL to post')
-    .argument('<id>', 'Folder name or ID')
-    .argument('<url>', 'Published URL')
-    .action((id, url) => {
+// Auth command group
+const auth = program.command('auth').description('Manage platform authentication');
+auth
+    .command('x')
+    .description('Authenticate with X (Twitter)')
+    .option('--status', 'Check authentication status')
+    .option('--list', 'List all authenticated accounts')
+    .option('--unlink', 'Remove account link from this project')
+    .option('--logout <account>', 'Remove stored credentials for account')
+    .action(async (options) => {
+    // --logout: Remove credentials for a specific account
+    if (options.logout) {
+        if (!hasXCredentials(options.logout)) {
+            console.log(`Account "${options.logout}" not found.`);
+            process.exit(1);
+        }
+        deleteXCredentials(options.logout);
+        console.log(`Credentials removed for account "${options.logout}".`);
+        return;
+    }
+    // --list: Show all authenticated accounts
+    if (options.list) {
+        const accounts = listXAccounts();
+        if (accounts.length === 0) {
+            console.log('No authenticated X accounts.');
+            console.log('Run `noslop auth x` to authenticate.');
+            return;
+        }
+        console.log('Authenticated X accounts:');
+        for (const acc of accounts) {
+            const handle = acc.screenName ? ` (@${acc.screenName})` : '';
+            console.log(`  ${acc.name}${handle}`);
+        }
+        return;
+    }
+    // --unlink: Remove account link from project
+    if (options.unlink) {
+        if (!isNoslopProject()) {
+            console.log('Not a noslop project. Run `noslop init` first.');
+            process.exit(1);
+        }
+        const current = getProjectXAccount();
+        if (!current) {
+            console.log('This project is not linked to an X account.');
+            return;
+        }
+        removeProjectXAccount();
+        console.log(`Unlinked project from account "${current}".`);
+        return;
+    }
+    // --status: Show current account status
+    if (options.status) {
+        if (!isNoslopProject()) {
+            console.log('Not a noslop project. Run `noslop init` first.');
+            process.exit(1);
+        }
+        const accountName = getProjectXAccount();
+        if (!accountName) {
+            console.log('This project is not linked to an X account.');
+            console.log('Run `noslop auth x` to link an account.');
+            return;
+        }
+        if (!hasXCredentials(accountName)) {
+            console.log(`Project linked to "${accountName}" but credentials not found.`);
+            console.log('Run `noslop auth x` to re-authenticate.');
+            return;
+        }
+        const creds = loadXCredentials(accountName);
+        if (!creds || !validateXCredentials(creds)) {
+            console.log(`Credentials for "${accountName}" are invalid.`);
+            console.log('Run `noslop auth x` to re-authenticate.');
+            return;
+        }
+        console.log(`Account: ${accountName}`);
+        console.log(`  Handle: @${creds.screenName || '(unknown)'}`);
+        console.log(`  Since: ${creds.createdAt}`);
+        // Verify credentials work
+        const user = await verifyCredentials(creds);
+        console.log(`  Status: ${user ? 'connected' : 'not connected'}`);
+        return;
+    }
+    // Default: Link project to account (with authentication if needed)
     if (!isNoslopProject()) {
         console.log('Not a noslop project. Run `noslop init` first.');
         process.exit(1);
     }
-    const item = findItem(id);
-    if (!item) {
-        console.log(`Not found: ${id}`);
+    console.log('X API Authentication');
+    console.log('====================');
+    console.log('');
+    // Check if project already has an account
+    const existingAccount = getProjectXAccount();
+    if (existingAccount) {
+        console.log(`This project is linked to account "${existingAccount}".`);
+        const change = await prompt('Change account? [y/N]: ');
+        if (change.toLowerCase() !== 'y') {
+            return;
+        }
+        console.log('');
+    }
+    // Ask for account name
+    const accountName = await prompt('Account name for this project (e.g., personal, work): ');
+    if (!accountName) {
+        console.log('Account name is required.');
         process.exit(1);
     }
-    addPublishedUrl(item, url);
-    console.log(`Published: ${item.folder}`);
-    console.log(`  URL: ${url}`);
-});
-// Schedule command
-program
-    .command('schedule')
-    .description('Set/update scheduled time')
-    .argument('<id>', 'Folder name or ID')
-    .argument('<datetime>', 'Date and time (YYYY-MM-DD HH:MM)')
-    .action((id, datetime) => {
-    if (!isNoslopProject()) {
-        console.log('Not a noslop project. Run `noslop init` first.');
+    if (!isValidAccountName(accountName)) {
+        console.log('Invalid account name. Use only letters, numbers, dashes, underscores.');
         process.exit(1);
     }
-    const item = findItem(id);
-    if (!item) {
-        console.log(`Not found: ${id}`);
+    // Check if account already exists
+    if (hasXCredentials(accountName)) {
+        const creds = loadXCredentials(accountName);
+        const handle = creds?.screenName ? ` (@${creds.screenName})` : '';
+        console.log('');
+        console.log(`Account "${accountName}"${handle} already exists.`);
+        const useExisting = await prompt('Use this account? [Y/n]: ');
+        if (useExisting.toLowerCase() !== 'n') {
+            setProjectXAccount(accountName);
+            console.log('');
+            console.log(`Project linked to account "${accountName}".`);
+            return;
+        }
+        console.log('');
+        console.log('Starting new authentication...');
+    }
+    // Get API key and secret
+    let apiKey = process.env.NOSLOP_X_API_KEY;
+    let apiSecret = process.env.NOSLOP_X_API_SECRET;
+    if (!apiKey || !apiSecret) {
+        console.log('');
+        console.log('You need an X Developer App. Create one at:');
+        console.log('  https://developer.x.com/en/portal/dashboard');
+        console.log('');
+        console.log('Make sure to enable "Read and Write" permissions.');
+        console.log('');
+        apiKey = await prompt('Enter API Key (Consumer Key): ');
+        apiSecret = await prompt('Enter API Secret (Consumer Secret): ');
+        if (!apiKey || !apiSecret) {
+            console.log('API Key and Secret are required.');
+            process.exit(1);
+        }
+    }
+    else {
+        console.log('');
+        console.log('Using API credentials from environment variables.');
+    }
+    // Get request token
+    console.log('');
+    console.log('Starting authorization...');
+    let requestToken;
+    try {
+        requestToken = await getOAuthRequestToken(apiKey, apiSecret);
+    }
+    catch (error) {
+        console.log(`Failed to start authorization: ${error.message}`);
+        console.log('');
+        console.log('Check that your API Key and Secret are correct.');
         process.exit(1);
     }
-    updateSchedule(item, datetime);
-    console.log(`Scheduled: ${item.folder} @ ${datetime}`);
+    // Open browser for user authorization
+    console.log('');
+    console.log('Opening browser for authorization...');
+    console.log('');
+    console.log('If browser does not open, visit:');
+    console.log(`  ${requestToken.authorizeUrl}`);
+    console.log('');
+    openBrowser(requestToken.authorizeUrl);
+    // Get PIN from user
+    const pin = await prompt('Enter the PIN from X: ');
+    if (!pin) {
+        console.log('PIN is required.');
+        process.exit(1);
+    }
+    // Exchange PIN for access tokens
+    console.log('');
+    console.log('Completing authorization...');
+    let accessTokenResponse;
+    try {
+        accessTokenResponse = await getOAuthAccessToken(apiKey, apiSecret, requestToken.oauthToken, requestToken.oauthTokenSecret, pin);
+    }
+    catch (error) {
+        console.log(`Authorization failed: ${error.message}`);
+        console.log('');
+        console.log('Make sure you entered the correct PIN.');
+        process.exit(1);
+    }
+    // Create credentials
+    const credentials = {
+        apiKey,
+        apiSecret,
+        accessToken: accessTokenResponse.accessToken,
+        accessTokenSecret: accessTokenResponse.accessTokenSecret,
+        screenName: accessTokenResponse.screenName,
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    };
+    console.log('');
+    console.log(`Authorized as @${accessTokenResponse.screenName}`);
+    // Verify credentials work
+    const user = await verifyCredentials(credentials);
+    if (!user) {
+        saveXCredentials(accountName, credentials);
+        setProjectXAccount(accountName);
+        console.log('');
+        console.log('Credentials saved but verification failed.');
+        console.log('You may need to check your API permissions.');
+        console.log('');
+        console.log(`Project linked to account "${accountName}".`);
+        return;
+    }
+    saveXCredentials(accountName, credentials);
+    setProjectXAccount(accountName);
+    console.log('');
+    console.log('Authentication successful!');
+    console.log(`  Account: ${accountName} (@${user.username})`);
+    console.log('');
+    console.log(`Project linked to account "${accountName}".`);
+    console.log('');
+    console.log('You can now post to X with: noslop x post <id>');
 });
-// Delete command
-program
-    .command('delete')
-    .description('Delete a draft')
-    .argument('<id>', 'Folder name or ID')
-    .action((id) => {
+/**
+ * Get X credentials for the current project
+ * Exits with error if not authenticated
+ */
+function getProjectCredentials() {
     if (!isNoslopProject()) {
         console.log('Not a noslop project. Run `noslop init` first.');
         process.exit(1);
     }
+    const accountName = getProjectXAccount();
+    if (!accountName) {
+        console.log('This project is not linked to an X account.');
+        console.log('Run `noslop auth x` to link an account.');
+        process.exit(1);
+    }
+    if (!hasXCredentials(accountName)) {
+        console.log(`Account "${accountName}" not found.`);
+        console.log('Run `noslop auth x` to re-authenticate.');
+        process.exit(1);
+    }
+    const creds = loadXCredentials(accountName);
+    if (!creds) {
+        console.log(`Failed to load credentials for "${accountName}".`);
+        process.exit(1);
+    }
+    return creds;
+}
+// X command group
+const x = program.command('x').description('X (Twitter) integration commands');
+x.command('post')
+    .description('Post a draft to X immediately')
+    .argument('<id>', 'Draft folder name or ID')
+    .action(async (id) => {
+    const creds = getProjectCredentials();
+    // Find the item
     const item = findItem(id);
     if (!item) {
         console.log(`Not found: ${id}`);
         process.exit(1);
     }
-    deleteDraft(item);
-    console.log(`Deleted: ${item.folder}`);
+    // Check if already posted
+    if (item.published?.startsWith('http')) {
+        console.log(`Already published: ${item.folder}`);
+        console.log(`  URL: ${item.published}`);
+        process.exit(1);
+    }
+    // Validate content
+    if (!item.post || item.post.trim() === '') {
+        console.log(`Empty post content: ${item.folder}`);
+        process.exit(1);
+    }
+    // Post to X
+    console.log(`Posting to X: ${item.folder}`);
+    console.log('');
+    try {
+        const result = await postTweet(item.post, creds);
+        // Add published URL
+        addPublishedUrl(item, result.url);
+        // Move to posts folder if in drafts
+        if (item.path.includes('/drafts/')) {
+            moveToPosts(item);
+        }
+        console.log('Posted successfully!');
+        console.log(`  URL: ${result.url}`);
+    }
+    catch (error) {
+        console.log(`Failed to post: ${error.message}`);
+        process.exit(1);
+    }
 });
 program.parse();

package/dist/lib/config.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Get the noslop config directory path
+ * Uses ~/.config/noslop following XDG Base Directory spec
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get the X credentials directory path
+ */
+export declare function getXCredentialsDir(): string;
+/**
+ * Ensure config directories exist with proper permissions
+ */
+export declare function ensureConfigDirs(): void;
+/**
+ * X API credentials structure
+ */
+export interface XCredentials {
+    apiKey: string;
+    apiSecret: string;
+    accessToken: string;
+    accessTokenSecret: string;
+    screenName?: string;
+    accountId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Validate account name (alphanumeric, dashes, underscores)
+ */
+export declare function isValidAccountName(name: string): boolean;
+/**
+ * Get the path to X credentials file for an account
+ */
+export declare function getXCredentialsPath(accountName: string): string;
+/**
+ * Check if X credentials exist for an account
+ */
+export declare function hasXCredentials(accountName: string): boolean;
+/**
+ * Load X credentials from disk for an account
+ * @returns Credentials object or null if not found
+ */
+export declare function loadXCredentials(accountName: string): XCredentials | null;
+/**
+ * Save X credentials to disk with restricted permissions
+ * @param accountName - Account name to save under
+ * @param credentials - Credentials to save
+ */
+export declare function saveXCredentials(accountName: string, credentials: XCredentials): void;
+/**
+ * Delete X credentials from disk
+ */
+export declare function deleteXCredentials(accountName: string): void;
+/**
+ * List all X accounts with stored credentials
+ */
+export declare function listXAccounts(): Array<{
+    name: string;
+    screenName?: string;
+}>;
+/**
+ * Validate that credentials have all required fields
+ */
+export declare function validateXCredentials(creds: XCredentials): boolean;
+/**
+ * Get the X account name from project's CLAUDE.md
+ */
+export declare function getProjectXAccount(cwd?: string): string | null;
+/**
+ * Set the X account name in project's CLAUDE.md
+ */
+export declare function setProjectXAccount(accountName: string, cwd?: string): void;
+/**
+ * Remove the X account from project's CLAUDE.md
+ */
+export declare function removeProjectXAccount(cwd?: string): void;