noslop 0.1.0

package/dist/lib/templates.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Template for new draft posts
+ * Placeholders:
+ * - {{TITLE}}: Will be replaced with the post title
+ */
+export declare const POST_TEMPLATE = "# {{TITLE}}\n\n## Post\n```\n\n```\n\n## Status\ndraft\n\n## Media\nNone\n\n## Scheduled\n\n## Posted\n\n## Published\n";
+/**
+ * Template for NOSLOP.md - tool documentation
+ * This file is regenerated on every launch to ensure documentation is up-to-date
+ */
+export declare const NOSLOP_TEMPLATE = "# noslop - Content Workflow CLI\n\nA command-line tool for managing social media content with an interactive TUI.\n\n## Quick Start\n\n```bash\nnoslop          # Open interactive TUI\nnoslop init     # Initialize new project\nnoslop new \"My Post\"  # Create new draft\n```\n\n## Commands\n\n### Core\n| Command | Description |\n|---------|-------------|\n| `noslop` | Open interactive TUI |\n| `noslop init` | Create folder structure + config files |\n| `noslop help` | Show all commands |\n\n### Content Management\n| Command | Description |\n|---------|-------------|\n| `noslop new <title>` | Create new draft with title |\n| `noslop list [--drafts|--posts]` | List content with schedule |\n| `noslop status` | Summary: counts, next scheduled |\n| `noslop show <id>` | Show full content of a post/draft |\n\n### Workflow Actions\n| Command | Description |\n|---------|-------------|\n| `noslop ready <id>` | Mark draft as ready to post |\n| `noslop unready <id>` | Mark draft as in-progress |\n| `noslop post <id>` | Move draft to posts folder |\n| `noslop unpost <id>` | Move post back to drafts |\n| `noslop publish <id> <url>` | Add published URL to post |\n| `noslop schedule <id> <datetime>` | Set/update scheduled time |\n| `noslop delete <id>` | Delete a draft |\n\n### Examples\n```bash\n# Full workflow\nnoslop new \"Monday Motivation\"\nnoslop schedule monday-motivation \"2026-01-27 09:00\"\nnoslop ready monday-motivation\n# ... post manually to platform ...\nnoslop post monday-motivation\nnoslop publish monday-motivation \"https://x.com/user/status/123\"\n```\n\n## Folder Structure\n\n```\nyour-project/\n\u251C\u2500\u2500 CLAUDE.md      # Your brand voice & guidelines\n\u251C\u2500\u2500 NOSLOP.md      # This file (tool documentation)\n\u251C\u2500\u2500 drafts/        # Work in progress\n\u2502   \u2514\u2500\u2500 post-name/\n\u2502       \u251C\u2500\u2500 x.md   # Post content\n\u2502       \u2514\u2500\u2500 assets/ # Images, videos (optional)\n\u2514\u2500\u2500 posts/         # Published/scheduled content\n    \u2514\u2500\u2500 post-name/\n        \u251C\u2500\u2500 x.md\n        \u2514\u2500\u2500 assets/\n```\n\n## Post File Format (x.md)\n\n```markdown\n# Post Title\n\n## Post\n\\`\\`\\`\nyour post content here\nlowercase, brand voice, etc.\n\\`\\`\\`\n\n## Status\ndraft | ready\n\n## Media\nDescription of media to create/attach\n\n## Scheduled\n2026-01-27 09:00\n\n## Posted\n2026-01-27 09:00\n\n## Published\nhttps://x.com/user/status/123\n```\n\n## TUI Keyboard Shortcuts\n\n| Key | Drafts Tab | Posts Tab |\n|-----|------------|-----------|\n| `Tab` | Switch to Posts | Switch to Drafts |\n| `\u2191/\u2193` | Navigate items | Navigate items |\n| `Enter` | Toggle ready/draft | Add URL |\n| `Space` | Move to Posts | Move to Drafts |\n| `Backspace` | Delete (drafts only) | \u2014 |\n| `s` | Toggle schedule view | Toggle schedule view |\n| `\u2190/\u2192` | Navigate weeks | Navigate weeks |\n| `q` | Quit | Quit |\n\n## Working with AI Assistants\n\nThis project is designed to work with Claude Code and other AI assistants:\n\n1. **Use CLI commands** instead of manual file editing\n2. **CLAUDE.md** contains your brand voice and guidelines\n3. **NOSLOP.md** (this file) documents all available commands\n\nThe AI should use commands like `noslop new`, `noslop ready`, `noslop post`\ninstead of directly creating/moving files.\n";
+/**
+ * Template for CLAUDE.md - user-specific brand content
+ * This file contains brand voice guidelines for AI assistants
+ */
+export declare const CLAUDE_TEMPLATE = "# Content Guide\n\n> This project uses noslop for content management. See NOSLOP.md for CLI commands.\n\n---\n\n## Brand Voice\n\n<!--\nINSTRUCTIONS FOR AI: If this section is empty, interview the user to fill it in.\nAsk about tone, style, what to avoid, platform preferences, etc.\n-->\n\n### Tone & Style\n\n\n### Do's\n\n\n### Don'ts\n\n\n---\n\n## Platform Guidelines\n\n<!-- Which platforms? What's different about each? -->\n\n### Twitter/X\n\n\n### Other Platforms\n\n\n---\n\n## Key Messaging\n\n### Taglines\n\n\n### Key Phrases\n\n\n### Topics to Cover\n\n\n---\n\n## Content Examples\n\n<!-- Add example posts as you create them -->\n\n### Good Examples\n\n\n### Transformations (before \u2192 after)\n\n\n---\n\n## Visual Elements\n\n### Emoji Policy\n\n\n### ASCII Art Library\n\n\n";
+/**
+ * Ensure NOSLOP.md documentation file exists and is up-to-date
+ * Creates or overwrites NOSLOP.md in the specified directory with
+ * the latest tool documentation template.
+ * @param cwd - Working directory (defaults to process.cwd())
+ */
+export declare function ensureNoslopMd(cwd?: string): void;
+/**
+ * Initialize a new noslop project in the specified directory
+ * Creates the following structure:
+ * - drafts/ directory for work in progress
+ * - posts/ directory for published content
+ * - CLAUDE.md with brand guidelines template
+ * - NOSLOP.md with tool documentation
+ *
+ * @param cwd - Directory to initialize (defaults to process.cwd())
+ * @param projectName - Optional project name for CLAUDE.md header
+ */
+export declare function initProject(cwd?: string, projectName?: string): void;

package/dist/lib/templates.js

@@ -0,0 +1,264 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Template for new draft posts
+ * Placeholders:
+ * - {{TITLE}}: Will be replaced with the post title
+ */
+export const POST_TEMPLATE = `# {{TITLE}}
+
+## Post
+\`\`\`
+
+\`\`\`
+
+## Status
+draft
+
+## Media
+None
+
+## Scheduled
+
+## Posted
+
+## Published
+`;
+/**
+ * Template for NOSLOP.md - tool documentation
+ * This file is regenerated on every launch to ensure documentation is up-to-date
+ */
+export const NOSLOP_TEMPLATE = `# noslop - Content Workflow CLI
+
+A command-line tool for managing social media content with an interactive TUI.
+
+## Quick Start
+
+\`\`\`bash
+noslop          # Open interactive TUI
+noslop init     # Initialize new project
+noslop new "My Post"  # Create new draft
+\`\`\`
+
+## Commands
+
+### Core
+| Command | Description |
+|---------|-------------|
+| \`noslop\` | Open interactive TUI |
+| \`noslop init\` | Create folder structure + config files |
+| \`noslop help\` | Show all commands |
+
+### Content Management
+| Command | Description |
+|---------|-------------|
+| \`noslop new <title>\` | Create new draft with title |
+| \`noslop list [--drafts|--posts]\` | List content with schedule |
+| \`noslop status\` | Summary: counts, next scheduled |
+| \`noslop show <id>\` | Show full content of a post/draft |
+
+### Workflow Actions
+| Command | Description |
+|---------|-------------|
+| \`noslop ready <id>\` | Mark draft as ready to post |
+| \`noslop unready <id>\` | Mark draft as in-progress |
+| \`noslop post <id>\` | Move draft to posts folder |
+| \`noslop unpost <id>\` | Move post back to drafts |
+| \`noslop publish <id> <url>\` | Add published URL to post |
+| \`noslop schedule <id> <datetime>\` | Set/update scheduled time |
+| \`noslop delete <id>\` | Delete a draft |
+
+### Examples
+\`\`\`bash
+# Full workflow
+noslop new "Monday Motivation"
+noslop schedule monday-motivation "2026-01-27 09:00"
+noslop ready monday-motivation
+# ... post manually to platform ...
+noslop post monday-motivation
+noslop publish monday-motivation "https://x.com/user/status/123"
+\`\`\`
+
+## Folder Structure
+
+\`\`\`
+your-project/
+├── CLAUDE.md      # Your brand voice & guidelines
+├── NOSLOP.md      # This file (tool documentation)
+├── drafts/        # Work in progress
+│   └── post-name/
+│       ├── x.md   # Post content
+│       └── assets/ # Images, videos (optional)
+└── posts/         # Published/scheduled content
+    └── post-name/
+        ├── x.md
+        └── assets/
+\`\`\`
+
+## Post File Format (x.md)
+
+\`\`\`markdown
+# Post Title
+
+## Post
+\\\`\\\`\\\`
+your post content here
+lowercase, brand voice, etc.
+\\\`\\\`\\\`
+
+## Status
+draft | ready
+
+## Media
+Description of media to create/attach
+
+## Scheduled
+2026-01-27 09:00
+
+## Posted
+2026-01-27 09:00
+
+## Published
+https://x.com/user/status/123
+\`\`\`
+
+## TUI Keyboard Shortcuts
+
+| Key | Drafts Tab | Posts Tab |
+|-----|------------|-----------|
+| \`Tab\` | Switch to Posts | Switch to Drafts |
+| \`↑/↓\` | Navigate items | Navigate items |
+| \`Enter\` | Toggle ready/draft | Add URL |
+| \`Space\` | Move to Posts | Move to Drafts |
+| \`Backspace\` | Delete (drafts only) | — |
+| \`s\` | Toggle schedule view | Toggle schedule view |
+| \`←/→\` | Navigate weeks | Navigate weeks |
+| \`q\` | Quit | Quit |
+
+## Working with AI Assistants
+
+This project is designed to work with Claude Code and other AI assistants:
+
+1. **Use CLI commands** instead of manual file editing
+2. **CLAUDE.md** contains your brand voice and guidelines
+3. **NOSLOP.md** (this file) documents all available commands
+
+The AI should use commands like \`noslop new\`, \`noslop ready\`, \`noslop post\`
+instead of directly creating/moving files.
+`;
+/**
+ * Template for CLAUDE.md - user-specific brand content
+ * This file contains brand voice guidelines for AI assistants
+ */
+export const CLAUDE_TEMPLATE = `# Content Guide
+
+> This project uses noslop for content management. See NOSLOP.md for CLI commands.
+
+---
+
+## Brand Voice
+
+<!--
+INSTRUCTIONS FOR AI: If this section is empty, interview the user to fill it in.
+Ask about tone, style, what to avoid, platform preferences, etc.
+-->
+
+### Tone & Style
+
+
+### Do's
+
+
+### Don'ts
+
+
+---
+
+## Platform Guidelines
+
+<!-- Which platforms? What's different about each? -->
+
+### Twitter/X
+
+
+### Other Platforms
+
+
+---
+
+## Key Messaging
+
+### Taglines
+
+
+### Key Phrases
+
+
+### Topics to Cover
+
+
+---
+
+## Content Examples
+
+<!-- Add example posts as you create them -->
+
+### Good Examples
+
+
+### Transformations (before → after)
+
+
+---
+
+## Visual Elements
+
+### Emoji Policy
+
+
+### ASCII Art Library
+
+
+`;
+/**
+ * Ensure NOSLOP.md documentation file exists and is up-to-date
+ * Creates or overwrites NOSLOP.md in the specified directory with
+ * the latest tool documentation template.
+ * @param cwd - Working directory (defaults to process.cwd())
+ */
+export function ensureNoslopMd(cwd = process.cwd()) {
+    const noslopFile = path.join(cwd, 'NOSLOP.md');
+    fs.writeFileSync(noslopFile, NOSLOP_TEMPLATE);
+}
+/**
+ * Initialize a new noslop project in the specified directory
+ * Creates the following structure:
+ * - drafts/ directory for work in progress
+ * - posts/ directory for published content
+ * - CLAUDE.md with brand guidelines template
+ * - NOSLOP.md with tool documentation
+ *
+ * @param cwd - Directory to initialize (defaults to process.cwd())
+ * @param projectName - Optional project name for CLAUDE.md header
+ */
+export function initProject(cwd = process.cwd(), projectName) {
+    const postsDir = path.join(cwd, 'posts');
+    const draftsDir = path.join(cwd, 'drafts');
+    const noslopFile = path.join(cwd, 'NOSLOP.md');
+    const claudeFile = path.join(cwd, 'CLAUDE.md');
+    // Create directories
+    if (!fs.existsSync(postsDir)) {
+        fs.mkdirSync(postsDir, { recursive: true });
+    }
+    if (!fs.existsSync(draftsDir)) {
+        fs.mkdirSync(draftsDir, { recursive: true });
+    }
+    // Create NOSLOP.md (tool documentation)
+    fs.writeFileSync(noslopFile, NOSLOP_TEMPLATE);
+    // Create CLAUDE.md (brand content)
+    let claudeContent = CLAUDE_TEMPLATE;
+    if (projectName) {
+        claudeContent = claudeContent.replace('# Content Guide', `# ${projectName} Content Guide`);
+    }
+    fs.writeFileSync(claudeFile, claudeContent);
+}

package/dist/lib/templates.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/templates.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { ensureNoslopMd, initProject, NOSLOP_TEMPLATE, CLAUDE_TEMPLATE } from './templates.js';
+describe('templates.ts', () => {
+    let testDir;
+    beforeEach(() => {
+        testDir = fs.mkdtempSync(path.join(os.tmpdir(), 'noslop-templates-'));
+    });
+    afterEach(() => {
+        fs.rmSync(testDir, { recursive: true, force: true });
+    });
+    describe('ensureNoslopMd', () => {
+        it('creates NOSLOP.md if it does not exist', () => {
+            const noslopPath = path.join(testDir, 'NOSLOP.md');
+            expect(fs.existsSync(noslopPath)).toBe(false);
+            ensureNoslopMd(testDir);
+            expect(fs.existsSync(noslopPath)).toBe(true);
+            const content = fs.readFileSync(noslopPath, 'utf-8');
+            expect(content).toBe(NOSLOP_TEMPLATE);
+        });
+        it('overwrites existing NOSLOP.md', () => {
+            const noslopPath = path.join(testDir, 'NOSLOP.md');
+            fs.writeFileSync(noslopPath, 'old content');
+            ensureNoslopMd(testDir);
+            const content = fs.readFileSync(noslopPath, 'utf-8');
+            expect(content).toBe(NOSLOP_TEMPLATE);
+            expect(content).not.toBe('old content');
+        });
+        it('uses current working directory by default', () => {
+            const originalCwd = process.cwd();
+            try {
+                process.chdir(testDir);
+                ensureNoslopMd();
+                expect(fs.existsSync(path.join(testDir, 'NOSLOP.md'))).toBe(true);
+            }
+            finally {
+                process.chdir(originalCwd);
+            }
+        });
+    });
+    describe('initProject', () => {
+        it('creates drafts directory', () => {
+            initProject(testDir);
+            expect(fs.existsSync(path.join(testDir, 'drafts'))).toBe(true);
+            expect(fs.statSync(path.join(testDir, 'drafts')).isDirectory()).toBe(true);
+        });
+        it('creates posts directory', () => {
+            initProject(testDir);
+            expect(fs.existsSync(path.join(testDir, 'posts'))).toBe(true);
+            expect(fs.statSync(path.join(testDir, 'posts')).isDirectory()).toBe(true);
+        });
+        it('creates NOSLOP.md with template content', () => {
+            initProject(testDir);
+            const noslopPath = path.join(testDir, 'NOSLOP.md');
+            expect(fs.existsSync(noslopPath)).toBe(true);
+            const content = fs.readFileSync(noslopPath, 'utf-8');
+            expect(content).toBe(NOSLOP_TEMPLATE);
+        });
+        it('creates CLAUDE.md with template content', () => {
+            initProject(testDir);
+            const claudePath = path.join(testDir, 'CLAUDE.md');
+            expect(fs.existsSync(claudePath)).toBe(true);
+            const content = fs.readFileSync(claudePath, 'utf-8');
+            expect(content).toBe(CLAUDE_TEMPLATE);
+        });
+        it('uses project name in CLAUDE.md if provided', () => {
+            initProject(testDir, 'My Awesome Project');
+            const claudePath = path.join(testDir, 'CLAUDE.md');
+            const content = fs.readFileSync(claudePath, 'utf-8');
+            expect(content).toContain('# My Awesome Project Content Guide');
+            expect(content).not.toContain('# Content Guide');
+        });
+        it('does not overwrite existing directories', () => {
+            // Create drafts with a file inside
+            const draftsDir = path.join(testDir, 'drafts');
+            fs.mkdirSync(draftsDir);
+            fs.writeFileSync(path.join(draftsDir, 'existing.txt'), 'existing content');
+            initProject(testDir);
+            // Verify the existing file is still there
+            expect(fs.existsSync(path.join(draftsDir, 'existing.txt'))).toBe(true);
+            const content = fs.readFileSync(path.join(draftsDir, 'existing.txt'), 'utf-8');
+            expect(content).toBe('existing content');
+        });
+        it('creates all files in a single call', () => {
+            initProject(testDir, 'Test Project');
+            // Verify all expected files and directories exist
+            expect(fs.existsSync(path.join(testDir, 'drafts'))).toBe(true);
+            expect(fs.existsSync(path.join(testDir, 'posts'))).toBe(true);
+            expect(fs.existsSync(path.join(testDir, 'NOSLOP.md'))).toBe(true);
+            expect(fs.existsSync(path.join(testDir, 'CLAUDE.md'))).toBe(true);
+        });
+    });
+    describe('templates', () => {
+        it('NOSLOP_TEMPLATE contains essential sections', () => {
+            expect(NOSLOP_TEMPLATE).toContain('# noslop');
+            expect(NOSLOP_TEMPLATE).toContain('## Commands');
+            expect(NOSLOP_TEMPLATE).toContain('## Folder Structure');
+            expect(NOSLOP_TEMPLATE).toContain('## Post File Format');
+            expect(NOSLOP_TEMPLATE).toContain('## TUI Keyboard Shortcuts');
+        });
+        it('CLAUDE_TEMPLATE contains essential sections', () => {
+            expect(CLAUDE_TEMPLATE).toContain('# Content Guide');
+            expect(CLAUDE_TEMPLATE).toContain('## Brand Voice');
+            expect(CLAUDE_TEMPLATE).toContain('## Platform Guidelines');
+            expect(CLAUDE_TEMPLATE).toContain('## Key Messaging');
+        });
+    });
+});

package/dist/tui.d.ts

@@ -0,0 +1 @@
+export declare function renderTUI(): void;