jfl 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alec Taggart (@402goose)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,313 @@
+# JFL - Just Fucking Launch
+
+Your team's context layer for shipping products. Any AI. Any task.
+
+JFL is a CLI toolkit that powers go-to-market campaigns from zero to launch. It creates structured GTM workspaces where product code, strategy, brand, and content all work together.
+
+## What JFL Does
+
+- **Initialize GTM workspaces** with proper architecture
+- **Manage your launch dashboard** with countdown, phases, and tasks
+- **Authenticate and manage billing** ($5/day per person, crypto-first)
+- **Deploy to platform** for team collaboration
+- **Orchestrate parallel agents** for Pro tier
+- **Track feedback** and iterate
+
+## Installation
+
+```bash
+npm install -g jfl
+```
+
+JFL automatically installs all required dependencies, including:
+- **httpcat-cli** - For gasless USDC transfers via x402 (bundled, no separate install needed)
+- **@x402/evm** - x402 payment protocol for Day Pass payments
+
+## Quick Start
+
+```bash
+# Create a new GTM workspace
+jfl init my-project-gtm
+
+# Check status
+cd my-project-gtm
+jfl status
+
+# View launch dashboard
+jfl hud
+
+# Or just type. It will walk you through it
+jfl
+```
+
+## Architecture
+
+JFL creates GTM workspaces that are **separate from your product code**:
+
+```
+my-project-gtm/              ← GTM workspace (strategy, content, brand)
+├── product/                 ← SUBMODULE → your-product-repo
+├── knowledge/               ← Strategy, vision, narrative
+├── content/                 ← Marketing content
+├── suggestions/             ← Contributor work
+├── skills/                  ← JFL skills (updated via jfl update)
+└── CLAUDE.md                ← AI instructions
+
+your-product-repo/           ← SEPARATE REPO (all code lives here)
+├── src/
+├── cli/
+└── ...
+```
+
+**Why?**
+- Clean separation of concerns
+- Product can be worked on independently
+- GTM context doesn't pollute product repo
+- Multiple GTMs can reference same product
+- `jfl update` updates GTM toolkit without touching product
+
+## Commands
+
+### Core Commands
+
+```bash
+jfl                          # Start interactive session (with optional --update)
+jfl init [template]          # Initialize new GTM workspace
+jfl status                   # Show project status
+jfl hud                      # Show campaign dashboard
+jfl hud --compact            # One-line status
+jfl update                   # Pull latest JFL updates
+jfl update --dry             # Preview updates without applying
+```
+
+### Platform Commands
+
+```bash
+jfl login                    # Authenticate to JFL platform
+jfl login --x402             # Use x402 Day Pass ($5/day, crypto)
+jfl login --solo             # Use Solo plan ($49/mo)
+jfl login --team             # Use Team plan ($199/mo)
+jfl login --free             # Stay on trial
+jfl logout                   # Logout from platform
+jfl wallet                   # Show wallet and day pass status
+jfl deploy                   # Deploy to JFL platform
+jfl deploy --force           # Force deploy even if no changes
+jfl agents [action]          # Manage parallel agents (list, create, start, stop)
+jfl feedback                 # Rate your session
+```
+
+### Skill Shortcuts
+
+These skills run in your Claude Code session:
+
+```bash
+jfl brand [subcommand]       # Run /brand-architect skill
+jfl content <type> [topic]   # Run /content skill (thread, post, article, one-pager)
+```
+
+## Authentication
+
+JFL supports two authentication methods:
+
+**GitHub OAuth**
+```bash
+jfl login
+```
+
+**x402 Crypto Wallet** (with httpcat-cli bundled)
+```bash
+jfl login --x402
+```
+
+This enables:
+- Gasless USDC transfers (no ETH needed for gas)
+- $5/day payments via x402 protocol
+- httpcat-cli automatically installed and configured
+
+View your auth status:
+```bash
+jfl wallet
+```
+
+## Pricing
+
+**Trial - $0**
+- Full JFL toolkit
+- Foundation + brand setup
+- Use Claude Code or Codex CLI - download Claude Pro or Max at claude.ai 
+- Ends when you add teammates (context is more fun when you shape it together)
+
+**Day Pass - $5/day per person**
+- Only pay the days you use it
+- AI included (no API key needed)
+- Chat in Telegram, Slack, Discord
+- Dashboard + Deploy at [TBD]
+- Pay with USDC (gasless via x402)
+
+**Solo - $49/mo**
+- Just you (1 seat)
+- AI included
+- Everything in Day Pass
+- Best if you use it most days
+
+**Team - $199/mo**
+- Up to 5 seats (+$25/seat after)
+- AI included for everyone
+- Team dashboard + analytics
+- Parallel agents
+- Priority support
+
+## Project Setup Types
+
+When initializing a project, JFL asks about your setup:
+
+**Building a product**
+- You're writing code
+- Product repo linked as submodule at `product/`
+- Code changes go to product repo
+
+**GTM only**
+- Team handles code
+- You focus on content, brand, outreach
+- No code changes, just marketing
+
+**Contributor**
+- Working on specific tasks
+- Changes go to `suggestions/{name}.md`
+- Owner reviews and merges
+
+## Skills Available
+
+JFL includes powerful skills for Claude Code:
+
+| Skill | Description |
+|-------|-------------|
+| `/hud` | Campaign dashboard with countdown and tasks |
+| `/brand-architect` | Generate brand identity (marks, colors, typography) |
+| `/web-architect` | Implement assets (SVG, favicon, OG images) |
+| `/content` | Create content (threads, posts, articles, one-pagers) |
+| `/x-algorithm` | Optimize tweets for X For You feed using the open-sourced algorithm |
+| `/video` | Founder video scripts (viral short-form) |
+| `/startup` | Startup journey guidance (idea to scale) |
+| `/agent-browser` | Headless browser automation - navigate, screenshot, scrape |
+| `/search` | Semantic search across GTM knowledge base using qmd |
+| `/spec` | Multi-agent adversarial spec refinement |
+| `/react-best-practices` | React/Next.js performance optimization |
+| `/remotion-best-practices` | Remotion video creation in React |
+
+Run these in Claude Code after initializing your project. Easy to add more skills, it has a sklls factory just ask it or copy your favorite skills repos
+
+## Knowledge Layer
+
+JFL structures your GTM knowledge:
+
+```
+knowledge/
+├── VISION.md              # What you're building
+├── NARRATIVE.md           # How you tell the story
+├── THESIS.md              # Why you'll win
+├── ROADMAP.md             # What ships when
+├── BRAND_BRIEF.md         # Brand inputs
+├── BRAND_DECISIONS.md     # Finalized brand choices
+├── VOICE_AND_TONE.md      # How the brand speaks
+├── TASKS.md               # Master task list
+└── CRM.md                 # Contact database
+```
+
+These docs are the source of truth that AI reads to generate content, make decisions, and maintain consistency.
+
+## Updating JFL
+
+JFL updates independently of your project:
+
+```bash
+jfl update                   # Pull latest skills and CLAUDE.md
+jfl update --dry             # Preview changes first
+```
+
+This updates:
+- `skills/` - Latest skill implementations
+- `CLAUDE.md` - Latest AI instructions
+- Templates for new docs
+
+Your project content (knowledge/, content/, product/) is never touched.
+
+## Session Management
+
+**Default:** Single session, direct in repo.
+
+**Advanced:** For parallel work across multiple sessions, use worktrees:
+
+```bash
+./scripts/worktree-session.sh create [username]    # Create isolated session
+./scripts/worktree-session.sh list                 # List active sessions
+./scripts/worktree-session.sh end [session-name]   # End session
+```
+
+Each worktree session has:
+- Isolated git worktree
+- Auto-commit (every 5 min)
+- Auto-merge to main (every 15 min)
+- Own branch for changes
+
+## Development
+
+Contributing to JFL itself:
+
+```bash
+# Clone through GTM structure
+jfl init my-jfl-gtm
+# During setup, add: https://github.com/402goose/just-fucking-launch.git
+
+# Run dev setup
+cd my-jfl-gtm/product
+./scripts/dev-setup.sh
+
+# Work in the submodule
+cd product/cli
+npm install
+npm run build
+
+# Link globally for testing
+npm link
+```
+
+## Environment Variables
+
+```bash
+CRM_SHEET_ID=your-sheet-id   # Google Sheets CRM integration
+```
+
+## Files You'll Work With
+
+```
+.jfl/config.json              # Project configuration
+knowledge/                    # Strategy docs (you fill these)
+content/                      # Generated content
+suggestions/{name}.md         # Per-person working space
+previews/                     # Generated assets
+```
+
+## Help
+
+```bash
+jfl help                      # Show all commands
+jfl --version                 # Show version
+```
+
+For issues or feedback:
+- GitHub: https://github.com/402goose/just-fucking-launch
+- Docs: https://jfl.run
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Credits
+
+Built by [@tagga](https://x.com/taggaoyl) (Alec Taggart)
+
+Powered by:
+- Claude (Anthropic)
+- x402 (crypto micropayments)
+- Commander.js, Inquirer, Chalk, and more

package/clawdbot-skill/README.md

@@ -0,0 +1,328 @@
+# JFL GTM Clawdbot Skill
+
+Access your JFL GTMs from Telegram, Slack, or Discord with full session isolation.
+
+## Architecture
+
+Clawdbot skills are markdown instruction files (SKILL.md) that teach Clawdbot how to use tools. This skill:
+
+1. Uses `jfl session` commands for proper isolation (worktrees)
+2. Each Telegram thread = isolated session with auto-commit
+3. Executes via `jfl session exec` (syncs repos before every command)
+4. Button UI for GTM picker and command menus
+5. Formats output for chat (strips ANSI, converts to Markdown)
+
+**Critical:** Every thread gets its own git worktree with journaling and auto-commit daemon.
+
+## Local Testing
+
+### 1. Verify JFL CLI is installed
+
+```bash
+jfl --version
+# Should show version 0.1.0 or later
+
+# If not installed:
+cd ../jfl-cli && npm link
+```
+
+### 2. Link skill to Clawdbot
+
+```bash
+cd product/clawdbot-skill
+
+# Create symlink in Clawdbot's managed skills directory
+ln -sf $(pwd) ~/.clawdbot/skills/jfl-gtm
+
+# Verify - should point to this directory
+ls -la ~/.clawdbot/skills/jfl-gtm
+```
+
+### 3. Restart Clawdbot to load the skill
+
+```bash
+# If running as daemon:
+clawdbot restart
+
+# Or kill and restart Telegram/Slack session
+```
+
+### 4. Test session commands directly
+
+Before testing in Telegram, verify the session commands work:
+
+```bash
+# Create a test session
+TEST_SESSION=$(jfl session create --platform telegram --thread test-123)
+echo "Created: $TEST_SESSION"
+
+# Execute command through session
+jfl session exec $TEST_SESSION "jfl hud"
+
+# List active sessions
+jfl session list
+
+# Clean up
+jfl session destroy $TEST_SESSION
+```
+
+### 5. Test in Telegram
+
+```
+You: /jfl
+
+Clawdbot:
+🚀 JFL - Just Fucking Launch
+
+Your team's context layer. Any AI. Any task.
+
+Open a project:
+
+[📂 JFL-GTM]
+[📂 Kodiak]
+[+ Create new]
+```
+
+Click a GTM → Clawdbot creates session → shows command menu → execute commands
+
+### 4. Test commands
+
+```
+/hud        → Dashboard
+/crm list   → Pipeline
+/brand      → Brand menu
+/content    → Content menu
+/gtm        → Switch GTM
+```
+
+## How It Works
+
+### On First Message in Thread
+
+1. **Find GTMs**: Scan for directories with `.jfl/`
+2. **Show picker**: Button UI listing available GTMs
+3. **Wait for selection**
+
+### On GTM Selection
+
+1. **Create isolated session**:
+   ```bash
+   jfl session create --platform telegram --thread ${THREAD_ID}
+   # Returns: session-telegram-${THREAD_ID}
+   ```
+
+   This creates:
+   - Git worktree at `worktrees/session-telegram-${THREAD_ID}/`
+   - Auto-commit daemon (commits every 2 minutes)
+   - Journal file at `.jfl/journal/session-telegram-${THREAD_ID}.jsonl`
+   - Session metadata in `.jfl/sessions.json`
+
+2. **Store session mapping**: Thread ID → Session ID
+3. **Show command menu**: Dashboard, CRM, Brand, Content
+
+### On Command Execution
+
+1. **Lookup session ID** for this thread
+2. **Execute through session**:
+   ```bash
+   jfl session exec ${SESSION_ID} "jfl hud"
+   ```
+
+   This:
+   - Runs `session-sync.sh` (syncs repos with remotes)
+   - CDs to worktree
+   - Executes command in isolated context
+   - Returns output
+
+3. **Format output**: Strip ANSI, convert to Markdown
+4. **Return to Telegram**
+
+### Session Lifecycle
+
+- **Created**: On first GTM selection in thread
+- **Persists**: Across messages (doesn't recreate every time)
+- **Auto-commits**: Every 2 minutes while active
+- **Journals**: All commands logged to `.jfl/journal/`
+- **Destroyed**: Optional cleanup (or let it persist)
+
+## Local Development
+
+### Test functions directly
+
+```bash
+# Install deps
+npm install
+
+# Test GTM detection
+node -e "import('./index.js').then(m => m.findGTMs().then(console.log))"
+
+# Test command execution
+node -e "import('./index.js').then(m => m.runJFLCommand({gtmPath: '/Users/you/JFL-GTM'}, 'hud').then(console.log))"
+```
+
+### Debug mode
+
+Set `DEBUG=1` to see command execution:
+
+```bash
+export DEBUG=1
+# Then use Clawdbot normally
+```
+
+## Publishing (Later)
+
+### To ClawdHub
+
+```bash
+# Build
+npm run build
+
+# Publish
+clawdbot skill publish
+
+# Or to npm
+npm publish --access public
+```
+
+### To npm (bundled with CLI)
+
+The skill will be bundled in `jfl-cli` package:
+
+```
+jfl-cli/
+├── skills/
+│   └── clawdbot/         ← This skill
+│       ├── skill.json
+│       └── index.ts
+└── package.json
+```
+
+Post-install script detects Clawdbot and auto-registers.
+
+## Requirements
+
+- `jfl` CLI installed (`npm install -g jfl` or local dev)
+- Clawdbot installed and configured
+- At least one GTM created (`jfl init`)
+
+## File Structure
+
+```
+product/clawdbot-skill/
+├── skill.json      # ClawdHub metadata
+├── index.ts        # Skill implementation
+├── package.json    # npm metadata
+└── README.md       # This file
+```
+
+## Key Functions
+
+| Function | What It Does |
+|----------|--------------|
+| `onBoot()` | Shows GTM picker on first run |
+| `onCallback()` | Handles button clicks |
+| `onCommand()` | Handles `/` commands |
+| `findGTMs()` | Scans for `.jfl` directories |
+| `runJFLCommand()` | Executes actual `jfl` commands |
+| `formatForTelegram()` | Strips ANSI, converts to Markdown |
+
+## Examples
+
+### Dashboard in Telegram
+
+```
+User: /hud
+
+Clawdbot:
+━━━━━━━━━━━━━━━━━━━━━━━━
+JFL - Just Fucking Launch
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+Phase: CLI Launch Prep
+Version: 0.1.0
+
+PIPELINE
+🟠 Jack (Nascent) - IN_CONVO
+🟠 Luca - IN_CONVO
+✅ Wes - COMMITTED
+
+NEXT: Publish CLI to npm
+━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### CRM in Telegram
+
+```
+User: /crm list
+
+Clawdbot:
+DEALS (22)
+
+🟠 Jack (Nascent) - IN_CONVO
+🟠 Luca - IN_CONVO
+🟡 Avi (Coinfund) - REACHED_OUT
+✅ Wes (Formation) - COMMITTED
+```
+
+### Button UI
+
+```
+User: [clicks 📂 JFL-GTM]
+
+Clawdbot:
+✓ Opened JFL-GTM
+
+[📊 Dashboard] [👥 CRM]
+[🎨 Brand] [✍️ Content]
+[🔄 Sync] [📝 Status]
+```
+
+## Troubleshooting
+
+### "JFL CLI not found"
+
+```bash
+# Check if jfl is installed
+jfl --version
+
+# If not:
+npm install -g jfl
+
+# Or use local dev build:
+cd jfl-cli && npm link
+```
+
+### "No GTMs found"
+
+```bash
+# Create a GTM
+jfl init
+
+# Or check paths in findGTMs()
+# Default search paths:
+# - ~/CascadeProjects
+# - ~/Projects
+# - ~/code
+```
+
+### Skill not showing in Clawdbot
+
+```bash
+# Check symlink
+ls -la ~/.clawdbot/skills/jfl-gtm
+
+# Should point to:
+# product/clawdbot-skill
+
+# Restart Clawdbot
+clawdbot restart
+```
+
+## Next Steps
+
+- [ ] Test in Telegram
+- [ ] Test in Slack
+- [ ] Add voice note support
+- [ ] Add image attachment support
+- [ ] Publish to ClawdHub
+- [ ] Bundle with CLI