jfl 0.0.0

package/scripts/voice-start.sh

@@ -0,0 +1,128 @@
+#!/bin/bash
+# voice-start.sh - Start voice input with one command
+# Usage: ./voice-start.sh [--daemon]
+
+set -e
+
+JFL_DIR="$HOME/.jfl"
+MODELS_DIR="$JFL_DIR/models"
+WHISPER_MODEL="$MODELS_DIR/ggml-base.bin"
+VAD_MODEL="$MODELS_DIR/ggml-silero-vad.bin"
+SOCKET_PATH="$JFL_DIR/voice.sock"
+TOKEN_PATH="$JFL_DIR/voice-server.token"
+PID_FILE="$JFL_DIR/voice-server.pid"
+WHISPER_SERVER="/Users/alectaggart/CascadeProjects/jfl-platform/packages/whisper-server/build/whisper-stream-server"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+GRAY='\033[0;90m'
+NC='\033[0m'
+
+echo -e "${GREEN}🎤 JFL Voice - Starting${NC}"
+echo ""
+
+# Check if server binary exists
+if [ ! -f "$WHISPER_SERVER" ]; then
+    echo -e "${RED}✗ Whisper server not built${NC}"
+    echo -e "${GRAY}  Run: cd product/packages/whisper-server && ./build.sh${NC}"
+    exit 1
+fi
+
+# Check if models exist
+if [ ! -f "$WHISPER_MODEL" ]; then
+    echo -e "${YELLOW}⚠ Whisper model not found. Downloading...${NC}"
+    jfl voice model download base
+fi
+
+if [ ! -f "$VAD_MODEL" ]; then
+    echo -e "${YELLOW}⚠ VAD model not found. Downloading...${NC}"
+    curl -L "https://huggingface.co/ggml-org/whisper-vad/resolve/main/ggml-silero-v5.1.2.bin" \
+        -o "$VAD_MODEL"
+fi
+
+# Generate token if needed
+if [ ! -f "$TOKEN_PATH" ]; then
+    TOKEN=$(openssl rand -hex 16)
+    echo "$TOKEN" > "$TOKEN_PATH"
+    chmod 600 "$TOKEN_PATH"
+    echo -e "${GRAY}  Generated auth token${NC}"
+fi
+
+TOKEN=$(cat "$TOKEN_PATH")
+
+# Check if server already running
+if [ -f "$PID_FILE" ]; then
+    OLD_PID=$(cat "$PID_FILE")
+    if ps -p "$OLD_PID" > /dev/null 2>&1; then
+        echo -e "${GREEN}✓ Server already running (PID: $OLD_PID)${NC}"
+    else
+        rm -f "$PID_FILE"
+    fi
+fi
+
+# Start server if not running
+if [ ! -f "$PID_FILE" ]; then
+    echo -e "${GRAY}  Starting whisper server...${NC}"
+
+    # Start server in background
+    # Note: VAD threshold lowered to 0.05 for better sensitivity to quiet speech
+    "$WHISPER_SERVER" \
+        --model "$WHISPER_MODEL" \
+        --vad-model "$VAD_MODEL" \
+        --vad-threshold 0.05 \
+        --port 9090 \
+        --host 127.0.0.1 \
+        --token "$TOKEN" \
+        > "$JFL_DIR/voice-server.log" 2>&1 &
+
+    SERVER_PID=$!
+    echo "$SERVER_PID" > "$PID_FILE"
+
+    # Wait for server to load models
+    echo -e "${GRAY}  Loading models (takes ~8s on first run)...${NC}"
+    sleep 8
+
+    if ps -p "$SERVER_PID" > /dev/null 2>&1; then
+        echo -e "${GREEN}✓ Server started (PID: $SERVER_PID)${NC}"
+    else
+        echo -e "${RED}✗ Server failed to start${NC}"
+        echo -e "${GRAY}  Check logs: cat $JFL_DIR/voice-server.log${NC}"
+        rm -f "$PID_FILE"
+        exit 1
+    fi
+fi
+
+# Set up Unix socket bridge (kill old one first)
+pkill -f "socat.*voice.sock" 2>/dev/null || true
+rm -f "$SOCKET_PATH"
+
+socat UNIX-LISTEN:"$SOCKET_PATH",mode=600,fork TCP:127.0.0.1:9090 &
+SOCAT_PID=$!
+sleep 1
+
+if [ -S "$SOCKET_PATH" ]; then
+    echo -e "${GREEN}✓ Unix socket ready${NC}"
+else
+    echo -e "${RED}✗ Failed to create socket${NC}"
+    exit 1
+fi
+
+echo ""
+echo -e "${GREEN}Voice input ready!${NC}"
+echo ""
+
+# If --daemon flag, start the hotkey daemon
+if [ "$1" = "--daemon" ]; then
+    echo -e "${GRAY}Starting hotkey daemon...${NC}"
+    jfl voice daemon start
+else
+    echo -e "Commands:"
+    echo -e "  ${GRAY}jfl voice test${NC}           Record 3s and transcribe"
+    echo -e "  ${GRAY}jfl voice${NC}                Record with VAD (stops on silence)"
+    echo -e "  ${GRAY}jfl voice hotkey${NC}         Start hotkey listener (Cmd+Shift+V)"
+    echo -e "  ${GRAY}jfl voice daemon start${NC}   Run hotkey in background"
+    echo ""
+    echo -e "To stop: ${GRAY}./voice-stop.sh${NC}"
+fi

package/scripts/voice-stop.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# voice-stop.sh - Stop voice input services
+
+JFL_DIR="$HOME/.jfl"
+PID_FILE="$JFL_DIR/voice-server.pid"
+
+GREEN='\033[0;32m'
+GRAY='\033[0;90m'
+NC='\033[0m'
+
+echo -e "${GRAY}Stopping voice services...${NC}"
+
+# Stop daemon if running
+jfl voice daemon stop 2>/dev/null || true
+
+# Stop socat bridge
+pkill -f "socat.*voice.sock" 2>/dev/null || true
+rm -f "$JFL_DIR/voice.sock"
+
+# Stop whisper server
+if [ -f "$PID_FILE" ]; then
+    PID=$(cat "$PID_FILE")
+    if ps -p "$PID" > /dev/null 2>&1; then
+        kill "$PID" 2>/dev/null || true
+        echo -e "${GREEN}✓ Stopped whisper server${NC}"
+    fi
+    rm -f "$PID_FILE"
+fi
+
+# Also kill any orphaned processes
+pkill -f whisper-stream-server 2>/dev/null || true
+
+echo -e "${GREEN}✓ Voice services stopped${NC}"

package/template/.claude/settings.json

@@ -0,0 +1,92 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./scripts/session/session-init.sh"
+          },
+          {
+            "type": "command",
+            "command": "jfl context-hub ensure >> .jfl/logs/context-hub.log 2>&1 &",
+            "async": true
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if echo \"$TOOL_INPUT\" | grep -qE 'git commit'; then BRANCH=$(cat .jfl/current-session-branch.txt 2>/dev/null || git branch --show-current); MSG=$(git log -1 --pretty=%B 2>/dev/null | head -1); FILES=$(git diff-tree --no-commit-id --name-only -r HEAD 2>/dev/null | tr '\\n' ', ' | sed 's/,$//'); echo ''; echo '═══════════════════════════════════════════════════════════'; echo '📝 JOURNAL REQUIRED: Git commit detected'; echo '═══════════════════════════════════════════════════════════'; echo \"Commit: $(git rev-parse --short HEAD 2>/dev/null)\"; echo \"Message: $MSG\"; echo \"Files: $FILES\"; echo ''; echo 'WRITE JOURNAL ENTRY NOW. File: .jfl/journal/'\"${BRANCH}\"'.jsonl'; echo '═══════════════════════════════════════════════════════════'; fi"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "FILE=$(echo \"$TOOL_INPUT\" | grep -oE '\"file_path\":\\s*\"[^\"]+\"' | head -1 | sed 's/.*\"\\([^\"]*\\)\"/\\1/'); if echo \"$FILE\" | grep -qE '\\.(ts|tsx|js|jsx)$'; then if [ -f \"$FILE\" ] && ! head -20 \"$FILE\" | grep -q '@purpose'; then echo ''; echo '⚠️  MISSING @purpose HEADER'; echo \"   File: $FILE\"; echo '   Add: /** @purpose One-line description */'; fi; fi",
+            "async": true
+          }
+        ]
+      },
+      {
+        "matcher": "TaskUpdate",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if echo \"$TOOL_INPUT\" | grep -q '\"status\":\\s*\"completed\"'; then BRANCH=$(cat .jfl/current-session-branch.txt 2>/dev/null || git branch --show-current); echo ''; echo '═══════════════════════════════════════════════════════════'; echo '📝 JOURNAL REQUIRED: Task completed'; echo '═══════════════════════════════════════════════════════════'; echo 'WRITE JOURNAL ENTRY NOW. File: .jfl/journal/'\"${BRANCH}\"'.jsonl'; echo '═══════════════════════════════════════════════════════════'; fi"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "done|looks good|ship it|approved|lgtm|perfect|yes do it|go ahead|yeah|yep",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "BRANCH=$(cat .jfl/current-session-branch.txt 2>/dev/null || git branch --show-current); echo ''; echo '═══════════════════════════════════════════════════════════'; echo '📝 JOURNAL CHECK: User approved/confirmed something'; echo '═══════════════════════════════════════════════════════════'; echo 'If a decision or feature was just approved, write journal entry.'; echo 'File: .jfl/journal/'\"${BRANCH}\"'.jsonl'; echo '═══════════════════════════════════════════════════════════'"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "BRANCH=$(cat .jfl/current-session-branch.txt 2>/dev/null || git branch --show-current); JOURNAL=\".jfl/journal/${BRANCH}.jsonl\"; if [ ! -s \"$JOURNAL\" ] 2>/dev/null; then echo '⚠️  No journal entry for session'; else echo '✓ Journal exists'; fi; exit 0"
+          },
+          {
+            "type": "command",
+            "command": "jfl context-hub stop >> .jfl/logs/context-hub.log 2>&1; echo '✓ Context hub stopped'; exit 0"
+          },
+          {
+            "type": "command",
+            "command": "./scripts/session/session-end.sh 2>&1 || (git add -A && git diff --cached --quiet || git commit -m 'auto: stop save') 2>/dev/null; echo '✓ Session ended'; exit 0"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "BRANCH=$(cat .jfl/current-session-branch.txt 2>/dev/null || git branch --show-current); JOURNAL=\".jfl/journal/${BRANCH}.jsonl\"; if [ ! -s \"$JOURNAL\" ] 2>/dev/null; then echo ''; echo '🚨 CONTEXT COMPACTING - WRITE JOURNAL NOW'; echo \"File: .jfl/journal/${BRANCH}.jsonl\"; fi"
+          },
+          {
+            "type": "command",
+            "command": "nohup sh -c 'git add -A && git diff --cached --quiet || git commit -m \"auto: pre-compact save\"' > /dev/null 2>&1 & disown; exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}

package/template/.claude/skills/agent-browser/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: agent-browser
+description: Headless browser automation for AI agents - auto-installs if needed
+---
+
+# Agent Browser
+
+Headless browser automation CLI for AI agents. [GitHub](https://github.com/vercel-labs/agent-browser)
+
+## On Skill Invoke
+
+**Step 1: Check if installed**
+
+```bash
+which agent-browser
+```
+
+**Step 2: If NOT installed, offer to install**
+
+```
+agent-browser not installed.
+
+This tool lets me browse the web, fill forms, take screenshots, and scrape dynamic content.
+
+Install it?
+
+  npm install -g agent-browser
+  agent-browser install
+
+[Yes] [No]
+```
+
+If user says yes, run:
+```bash
+npm install -g agent-browser && agent-browser install
+```
+
+On Linux, if install fails with dependency errors:
+```bash
+agent-browser install --with-deps
+```
+
+After install, confirm:
+```
+Done. agent-browser ready.
+
+Try: agent-browser navigate https://example.com
+```
+
+**Step 3: If already installed, show status**
+
+```
+agent-browser is installed.
+
+Quick commands:
+  agent-browser navigate <url>    # Go to URL
+  agent-browser snapshot          # Get page structure (for AI)
+  agent-browser click <ref>       # Click element
+  agent-browser type <ref> <text> # Type into input
+  agent-browser screenshot        # Capture page
+  agent-browser pdf               # Generate PDF
+
+Need help with something specific?
+```
+
+## What It Does
+
+Agent-browser gives Claude the ability to:
+- Navigate and interact with web pages
+- Click, type, scroll
+- Take screenshots and generate PDFs
+- Extract accessibility trees (semantic page understanding)
+- Monitor network requests
+- Manage cookies and storage
+
+## Common Commands
+
+| Command | What It Does |
+|---------|--------------|
+| `agent-browser navigate <url>` | Go to a URL |
+| `agent-browser snapshot` | Get accessibility tree (for AI understanding) |
+| `agent-browser click <ref>` | Click an element by reference |
+| `agent-browser type <ref> <text>` | Type into an input |
+| `agent-browser screenshot` | Capture the page |
+| `agent-browser pdf` | Generate PDF |
+
+## When to Use
+
+Use agent-browser when you need to:
+- Scrape dynamic content (SPAs, JS-rendered pages)
+- Fill out forms programmatically
+- Test user flows
+- Capture screenshots for docs/previews
+- Extract data from authenticated pages
+
+## Typical Workflow
+
+1. `agent-browser navigate <url>` - load the page
+2. `agent-browser snapshot` - understand page structure
+3. `agent-browser click <ref>` / `agent-browser type <ref> <text>` - interact
+4. `agent-browser screenshot` or extract data
+
+## Troubleshooting
+
+### "chromium not found"
+```bash
+agent-browser install
+```
+
+### Permission errors on Linux
+```bash
+agent-browser install --with-deps
+```
+
+### Page not loading
+Some sites block headless browsers. The tool handles most cases, but very aggressive bot detection may block it.

package/template/.claude/skills/brand-architect/SKILL.md

@@ -0,0 +1,240 @@
+---
+name: brand-architect
+description: Generate brand identity options from brief - marks, colors, typography
+---
+
+# Brand Architect Skill
+
+Creates brand identity options based on your brand brief.
+
+## Capabilities
+
+- Generate mark/logo options (SVG)
+- Propose color palettes (dark/light modes)
+- Suggest typography stacks
+- Create mark + text compositions
+- Update preview files with options
+- Guide through selection process
+- Record decisions
+
+## Input Requirements
+
+Requires `knowledge/BRAND_BRIEF.md` with:
+- Brand name and tagline
+- Values and voice
+- Visual direction preferences
+
+## Commands
+
+```
+/brand-architect              # Full workflow
+/brand-architect marks        # Generate mark options only
+/brand-architect colors       # Generate color palette options
+/brand-architect typography   # Suggest typography
+/brand-architect compositions # Mark + text lockups
+/brand-architect review       # Review current options
+/brand-architect decide       # Record selections
+```
+
+## Workflow
+
+### Step 1: Read Brief
+```
+Reading knowledge/BRAND_BRIEF.md...
+
+Brand: {name}
+Tagline: "{tagline}"
+Aesthetic: {aesthetic}
+Mark preference: {type}
+
+Ready to generate options.
+```
+
+### Step 2: Generate Marks
+
+Create 3-5 mark options based on brief:
+
+```
+Generating mark options...
+
+OPTION 1: {description}
+├─ Type: {symbol/lettermark/wordmark/icon}
+├─ Concept: {what it represents}
+└─ File: outputs/svg/mark/mark-v1-transparent.svg
+
+OPTION 2: {description}
+...
+```
+
+For each mark:
+1. Create transparent SVG (base)
+2. Create dark mode variant
+3. Create light mode variant
+4. Test at multiple sizes (16px, 80px, 400px)
+
+### Step 3: Generate Colors
+
+Propose color palette:
+
+```
+Color Palette Proposal:
+
+DARK MODE (default):
+├─ Background: #000000
+├─ Foreground: #FFFFFF
+├─ Accent: {based on brand}
+└─ Preview: [color swatches]
+
+LIGHT MODE:
+├─ Background: #FFFFFF
+├─ Foreground: #000000
+├─ Accent: {darker version}
+└─ Preview: [color swatches]
+```
+
+### Step 4: Suggest Typography
+
+```
+Typography Recommendation:
+
+Based on your {aesthetic} aesthetic:
+
+FONT STACK:
+{stack}
+
+RATIONALE:
+- {why this fits the brand}
+- {where it works well}
+
+ALTERNATIVES:
+1. {alternative stack} - {when to use}
+2. {alternative stack} - {when to use}
+```
+
+### Step 5: Update Previews
+
+Update preview HTML files with generated options:
+
+```
+Updating previews...
+
+✓ previews/brand/twitter-profile.html
+✓ previews/brand/og-preview.html
+✓ previews/brand/favicon-preview.html
+✓ previews/brand/mobile-preview.html
+
+Open these in your browser to see options in context.
+```
+
+### Step 6: Guide Selection
+
+```
+Let's review each option in context.
+
+MARK SELECTION:
+Open previews/brand/twitter-profile.html
+
+Which mark works best as a PFP?
+1. mark-v1 - {description}
+2. mark-v2 - {description}
+3. mark-v3 - {description}
+```
+
+Wait for user input at each decision point.
+
+### Step 7: Record Decisions
+
+Save selections to `knowledge/BRAND_DECISIONS.md`:
+
+```
+Recording your selections...
+
+✓ Primary mark: mark-v3
+✓ Colors: dark-first, accent #00ff88
+✓ Typography: ui-monospace stack
+
+Saved to knowledge/BRAND_DECISIONS.md
+
+Next: Run /web-architect to generate final assets.
+```
+
+## Mark Generation Guidelines
+
+### SVG Structure
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <!-- Use paths, not text elements -->
+  <path d="..." fill="currentColor"/>
+</svg>
+```
+
+### Size Variants
+| Size | Use |
+|------|-----|
+| 16px | Favicon |
+| 32px | Favicon @2x |
+| 80px | Small icon |
+| 160px | Medium icon |
+| 400px | PFP, large icon |
+
+### Naming Convention
+```
+mark-{version}-{size}-{theme}.svg
+mark-v1-transparent.svg     # Base
+mark-v1-80-dark.svg         # Dark mode
+mark-v1-80-light.svg        # Light mode
+```
+
+## Color Generation Guidelines
+
+### Required Tokens
+- Background (bg)
+- Foreground (fg)
+- Accent (primary action color)
+- Success, Error, Warning
+- Muted (secondary text)
+
+### Contrast Requirements
+- Text on bg: 4.5:1 minimum
+- Large text: 3:1 minimum
+
+## Output Files
+
+```
+outputs/
+├── svg/
+│   └── mark/
+│       ├── mark-v1-transparent.svg
+│       ├── mark-v1-80-dark.svg
+│       ├── mark-v1-80-light.svg
+│       ├── mark-v2-transparent.svg
+│       └── ...
+└── (other outputs created by web-architect)
+
+knowledge/
+└── BRAND_DECISIONS.md  # Updated with selections
+```
+
+## Error Handling
+
+### No Brief Found
+```
+Brand brief not found.
+
+Please create knowledge/BRAND_BRIEF.md using the template:
+cp templates/BRAND_BRIEF.md knowledge/BRAND_BRIEF.md
+
+Then fill it out and run /brand-architect again.
+```
+
+### Incomplete Brief
+```
+Brand brief is incomplete.
+
+Missing required fields:
+- {field 1}
+- {field 2}
+
+Please update knowledge/BRAND_BRIEF.md and try again.
+```