@colmbus72/yeehaw 0.5.0 → 0.6.0

package/claude-plugin/skills/yeehaw-development/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: yeehaw-development
+description: Guide development using Yeehaw's wiki as context source and living documentation. Use when working on any project tracked in Yeehaw - consult wiki before architectural decisions and contribute back when patterns evolve.
+---
+
+# Yeehaw Development
+
+You're working on a project tracked in Yeehaw. The project wiki contains curated context to guide development - architecture patterns, conventions, gotchas, and common tasks documented by the project owner and evolved through development.
+
+## Wiki-First Development
+
+Before making architectural decisions or implementing significant features:
+
+1. **Check available sections** with `mcp__yeehaw__get_wiki`
+2. **Fetch relevant sections** with `mcp__yeehaw__get_wiki_section`
+3. **Respect documented patterns** - they exist for a reason
+
+The wiki is your primary source of project-specific context. It contains knowledge that isn't obvious from the code alone.
+
+## When to Consult the Wiki
+
+| Task | Check These Sections |
+|------|---------------------|
+| Adding features | Architecture, Conventions, Common Tasks |
+| Debugging issues | Gotchas, Domain Context |
+| Unsure about patterns | Conventions, Architecture |
+| New integrations | Architecture, Gotchas |
+| Understanding domain | Domain Context |
+
+If a section exists that's relevant to your task, read it before proceeding.
+
+## Proactive Wiki Updates
+
+The wiki is a living document. After completing significant work, consider whether the wiki should be updated:
+
+**When to update existing sections:**
+- A documented pattern has evolved
+- You discovered nuances worth capturing
+- Steps in Common Tasks have changed
+
+**When to add new sections:**
+- Introduced a new architectural pattern
+- Discovered gotchas during debugging
+- Built a feature type that others might repeat
+- Established new conventions
+
+**How to update:**
+- `mcp__yeehaw__update_wiki_section` for edits
+- `mcp__yeehaw__add_wiki_section` for new content
+
+**Guidelines:**
+- Not every session needs to update the wiki
+- Only update when something genuinely changes project direction or establishes new patterns
+- Keep sections focused and scannable
+- Be specific to THIS codebase, not generic advice
+
+## Project Context
+
+Use `mcp__yeehaw__get_project` to understand:
+- Project structure and configured paths
+- Deployment environments (livestock)
+- Available wiki sections
+
+When spawned from a specific livestock, you may be focused on deployment-specific work - check if there's relevant context in the wiki.
+
+## Summary
+
+1. **Before major decisions** → check the wiki
+2. **After significant work** → consider updating the wiki
+3. **When unsure** → the wiki likely has guidance

package/dist/app.js

@@ -13,12 +13,15 @@ import { WikiView } from './views/WikiView.js';
 import { IssuesView } from './views/IssuesView.js';
 import { LivestockDetailView } from './views/LivestockDetailView.js';
 import { LogsView } from './views/LogsView.js';
+import { CritterDetailView } from './views/CritterDetailView.js';
+import { CritterLogsView } from './views/CritterLogsView.js';
 import { NightSkyView } from './views/NightSkyView.js';
 import { useConfig } from './hooks/useConfig.js';
 import { useSessions } from './hooks/useSessions.js';
 import { useRemoteYeehaw } from './hooks/useRemoteYeehaw.js';
-import { hasTmux, switchToWindow, updateStatusBar, createShellWindow, createSshWindow, detachFromSession, killYeehawSession, restartYeehaw, enterRemoteMode, ensureCorrectStatusBar, } from './lib/tmux.js';
+import { hasTmux, switchToWindow, updateStatusBar, createShellWindow, createSshWindow, detachFromSession, killYeehawSession, restartYeehaw, enterRemoteMode, ensureCorrectStatusBar, createClaudeWindowWithPrompt, } from './lib/tmux.js';
 import { saveProject, deleteProject, saveBarn, deleteBarn, getLivestockForBarn, isLocalBarn, hasValidSshConfig, addCritterToBarn, removeCritterFromBarn } from './lib/config.js';
+import { buildProjectContext, buildLivestockContext } from './lib/context.js';
 import { getVersionInfo } from './lib/update-check.js';
 function getHotkeyScope(view) {
     switch (view.type) {
@@ -29,6 +32,8 @@ function getHotkeyScope(view) {
         case 'issues': return 'issues-view';
         case 'livestock': return 'livestock-detail';
         case 'logs': return 'logs-view';
+        case 'critter': return 'critter-detail';
+        case 'critter-logs': return 'critter-logs';
         case 'night-sky': return 'night-sky';
         default: return 'global-dashboard';
     }
@@ -40,7 +45,8 @@ function expandPath(path) {
     return path;
 }
 // Global bottom bar items - minimal, consistent across all views
-function getBottomBarItems(viewType) {
+// Every hotkey should be visible somewhere in our 3-tier system
+function getBottomBarItems(viewType, options) {
     // Night sky has its own unique actions
     if (viewType === 'night-sky') {
         return [
@@ -49,29 +55,92 @@ function getBottomBarItems(viewType) {
             { key: 'Esc', label: 'exit' },
         ];
     }
-    // Global dashboard: exit options
+    // Global dashboard: exit options + visualizer
     if (viewType === 'global') {
         return [
+            { key: 'v', label: 'visualizer' },
             { key: 'q', label: 'detach' },
             { key: 'Q', label: 'quit' },
             { key: 'Tab', label: '' },
             { key: '?', label: 'help' },
         ];
     }
+    // Project context: page-level actions
+    if (viewType === 'project') {
+        return [
+            { key: 'w', label: 'wiki' },
+            { key: 'i', label: 'issues' },
+            { key: 'e', label: 'edit' },
+            { key: 'Esc', label: 'back' },
+            { key: 'Tab', label: '' },
+            { key: '?', label: 'help' },
+        ];
+    }
+    // Barn context: page-level actions (edit only for remote barns)
+    if (viewType === 'barn') {
+        const items = [];
+        if (!options?.isLocalBarn) {
+            items.push({ key: 'e', label: 'edit' });
+        }
+        items.push({ key: 'Esc', label: 'back' }, { key: 'Tab', label: '' }, { key: '?', label: 'help' });
+        return items;
+    }
+    // Wiki view: panel hints handle n/e/d, bottom bar just needs navigation
+    if (viewType === 'wiki') {
+        return [
+            { key: 'Esc', label: 'back' },
+            { key: 'Tab', label: '' },
+            { key: '?', label: 'help' },
+        ];
+    }
+    // Issues view: page-level actions (f/r are page-level, c/o are row-level shown on selected item)
+    if (viewType === 'issues') {
+        return [
+            { key: 'f', label: 'filter' },
+            { key: 'r', label: 'refresh' },
+            { key: 'Esc', label: 'back' },
+            { key: 'Tab', label: '' },
+            { key: '?', label: 'help' },
+        ];
+    }
     // Livestock detail: page-level actions
+    // Local livestock gets [c] claude, remote only gets [s] shell
     if (viewType === 'livestock') {
+        const items = [];
+        if (options?.isLocalLivestock) {
+            items.push({ key: 'c', label: 'claude' });
+        }
+        items.push({ key: 's', label: 'shell' }, { key: 'l', label: 'logs' }, { key: 'e', label: 'edit' }, { key: 'Esc', label: 'back' }, { key: '?', label: 'help' });
+        return items;
+    }
+    // Logs view: page-level actions
+    if (viewType === 'logs') {
+        return [
+            { key: 'r', label: 'refresh' },
+            { key: 'Esc', label: 'back' },
+            { key: '?', label: 'help' },
+        ];
+    }
+    // Critter detail: page-level actions
+    if (viewType === 'critter') {
         return [
-            { key: 's', label: 'shell' },
             { key: 'l', label: 'logs' },
             { key: 'e', label: 'edit' },
             { key: 'Esc', label: 'back' },
             { key: '?', label: 'help' },
         ];
     }
-    // All other views: back + help
+    // Critter logs view: page-level actions
+    if (viewType === 'critter-logs') {
+        return [
+            { key: 'r', label: 'refresh' },
+            { key: 'Esc', label: 'back' },
+            { key: '?', label: 'help' },
+        ];
+    }
+    // Fallback (shouldn't reach here)
     return [
         { key: 'Esc', label: 'back' },
-        { key: 'Tab', label: '' },
         { key: '?', label: 'help' },
     ];
 }
@@ -127,6 +196,16 @@ export function App() {
                     return { ...currentView, barn: freshBarn };
                 }
             }
+            // Update critter detail view
+            if (currentView.type === 'critter' || currentView.type === 'critter-logs') {
+                const freshBarn = barns.find((b) => b.name === currentView.barn.name);
+                if (freshBarn && freshBarn !== currentView.barn) {
+                    const freshCritter = (freshBarn.critters || []).find((c) => c.name === currentView.critter.name);
+                    if (freshCritter) {
+                        return { ...currentView, barn: freshBarn, critter: freshCritter };
+                    }
+                }
+            }
             return currentView;
         });
     }, [projects, barns]);
@@ -154,7 +233,11 @@ export function App() {
             const projectName = view.type === 'project' ? view.project.name : 'yeehaw';
             const workingDir = view.type === 'project' ? expandPath(view.project.path) : process.cwd();
             const windowName = `${projectName}-claude`;
-            const windowIndex = createClaude(workingDir, windowName);
+            // Inject context when in a project view
+            const context = view.type === 'project' ? buildProjectContext(view.project.name) : null;
+            const windowIndex = context
+                ? createClaudeWindowWithPrompt(workingDir, windowName, context)
+                : createClaude(workingDir, windowName);
             switchToWindow(windowIndex);
         }
         catch (err) {
@@ -170,7 +253,11 @@ export function App() {
         try {
             const workingDir = expandPath(project.path);
             const windowName = `${project.name}-claude`;
-            const windowIndex = createClaude(workingDir, windowName);
+            const context = buildProjectContext(project.name);
+            // Use context injection if we have project context, otherwise fall back to basic
+            const windowIndex = context
+                ? createClaudeWindowWithPrompt(workingDir, windowName, context)
+                : createClaude(workingDir, windowName);
             switchToWindow(windowIndex);
         }
         catch (err) {
@@ -186,7 +273,11 @@ export function App() {
         try {
             const workingDir = expandPath(livestock.path);
             const windowName = `${projectName}-${livestock.name}-claude`;
-            const windowIndex = createClaude(workingDir, windowName);
+            const context = buildLivestockContext(projectName, livestock.name);
+            // Use context injection if we have project context, otherwise fall back to basic
+            const windowIndex = context
+                ? createClaudeWindowWithPrompt(workingDir, windowName, context)
+                : createClaude(workingDir, windowName);
             switchToWindow(windowIndex);
         }
         catch (err) {
@@ -194,6 +285,24 @@ export function App() {
             setError(`Failed to create Claude session: ${message}`);
         }
     }, [tmuxAvailable, createClaude]);
+    const handleOpenClaudeWithContext = useCallback((workingDir, issueContext) => {
+        if (!tmuxAvailable) {
+            setError('tmux is not installed');
+            return;
+        }
+        try {
+            // Get the project name for the window name
+            const projectName = (view.type === 'issues' ? view.project.name : 'issue');
+            const windowName = `${projectName}-claude`;
+            // Create claude window with system prompt
+            const index = createClaudeWindowWithPrompt(workingDir, windowName, issueContext);
+            switchToWindow(index);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            setError(`Failed to create Claude session: ${message}`);
+        }
+    }, [tmuxAvailable, view]);
     const handleOpenLivestockSession = useCallback((livestock, barn, projectName) => {
         if (!tmuxAvailable) {
             setError('tmux is not installed');
@@ -276,6 +385,26 @@ export function App() {
         // Update the view with the new livestock data, preserving navigation context
         setView({ type: 'livestock', project: updatedProject, livestock: updatedLivestock, source, sourceBarn });
     }, [reload]);
+    const handleOpenCritterDetail = useCallback((barn, critter) => {
+        setView({ type: 'critter', barn, critter });
+        updateStatusBar(`${barn.name} / ${critter.name}`);
+    }, []);
+    const handleOpenCritterLogs = useCallback((barn, critter) => {
+        setView({ type: 'critter-logs', barn, critter });
+        updateStatusBar(`${barn.name} / ${critter.name} Logs`);
+    }, []);
+    const handleBackFromCritter = useCallback((barn) => {
+        setView({ type: 'barn', barn });
+        updateStatusBar(`Barn: ${barn.name}`);
+    }, []);
+    const handleUpdateCritter = useCallback((barn, originalCritter, updatedCritter) => {
+        // Remove old critter and add updated one
+        removeCritterFromBarn(barn.name, originalCritter.name);
+        addCritterToBarn(barn.name, updatedCritter);
+        reload();
+        // Update view with new critter data
+        setView({ type: 'critter', barn, critter: updatedCritter });
+    }, [reload]);
     const handleDeleteProject = useCallback((projectName) => {
         deleteProject(projectName);
         reload();
@@ -407,6 +536,13 @@ export function App() {
             else if (view.type === 'livestock') {
                 handleBackFromLivestock(view.source, view.project, view.sourceBarn);
             }
+            else if (view.type === 'critter-logs') {
+                setView({ type: 'critter', barn: view.barn, critter: view.critter });
+                updateStatusBar(`${view.barn.name} / ${view.critter.name}`);
+            }
+            else if (view.type === 'critter') {
+                handleBackFromCritter(view.barn);
+            }
             else if (view.type === 'project' || view.type === 'barn') {
                 handleBack();
             }
@@ -475,21 +611,29 @@ export function App() {
                     }, onRemoveCritter: (critterName) => {
                         removeCritterFromBarn(view.barn.name, critterName);
                         reload();
-                    } }));
+                    }, onSelectCritter: (critter) => handleOpenCritterDetail(view.barn, critter) }));
             case 'wiki':
                 return (_jsx(WikiView, { project: view.project, onBack: () => handleBackFromSubview(view.project), onUpdateProject: handleUpdateProject }));
             case 'issues':
-                return (_jsx(IssuesView, { project: view.project, onBack: () => handleBackFromSubview(view.project) }));
+                return (_jsx(IssuesView, { project: view.project, onBack: () => handleBackFromSubview(view.project), onOpenClaude: handleOpenClaudeWithContext }));
             case 'livestock':
+                const livestockBarn = barns.find((b) => b.name === view.livestock.barn) || null;
+                const isLocalLivestock = !livestockBarn || isLocalBarn(livestockBarn);
                 return (_jsx(LivestockDetailView, { project: view.project, livestock: view.livestock, source: view.source, sourceBarn: view.sourceBarn, windows: windows, onBack: () => handleBackFromLivestock(view.source, view.project, view.sourceBarn), onOpenLogs: () => handleOpenLogs(view.project, view.livestock, view.source, view.sourceBarn), onOpenSession: () => {
-                        const barn = barns.find((b) => b.name === view.livestock.barn) || null;
-                        handleOpenLivestockSession(view.livestock, barn, view.project.name);
-                    }, onSelectWindow: handleSelectWindow, onUpdateLivestock: (originalLivestock, updatedLivestock) => handleUpdateLivestock(view.project, originalLivestock, updatedLivestock, view.source, view.sourceBarn) }));
+                        handleOpenLivestockSession(view.livestock, livestockBarn, view.project.name);
+                    }, onOpenClaude: isLocalLivestock ? () => handleNewClaudeForLivestock(view.livestock, view.project.name) : undefined, onSelectWindow: handleSelectWindow, onUpdateLivestock: (originalLivestock, updatedLivestock) => handleUpdateLivestock(view.project, originalLivestock, updatedLivestock, view.source, view.sourceBarn) }));
             case 'logs':
                 return (_jsx(LogsView, { project: view.project, livestock: view.livestock, onBack: () => {
                         setView({ type: 'livestock', project: view.project, livestock: view.livestock, source: view.source, sourceBarn: view.sourceBarn });
                         updateStatusBar(`${view.project.name} / ${view.livestock.name}`);
                     } }));
+            case 'critter':
+                return (_jsx(CritterDetailView, { barn: view.barn, critter: view.critter, onBack: () => handleBackFromCritter(view.barn), onOpenLogs: () => handleOpenCritterLogs(view.barn, view.critter), onUpdateCritter: (original, updated) => handleUpdateCritter(view.barn, original, updated) }));
+            case 'critter-logs':
+                return (_jsx(CritterLogsView, { barn: view.barn, critter: view.critter, onBack: () => {
+                        setView({ type: 'critter', barn: view.barn, critter: view.critter });
+                        updateStatusBar(`${view.barn.name} / ${view.critter.name}`);
+                    } }));
             case 'night-sky':
                 return (_jsx(NightSkyView, { onExit: handleExitNightSky }));
         }
@@ -500,5 +644,12 @@ export function App() {
     if (showSplash) {
         return _jsx(SplashScreen, { onComplete: handleSplashComplete });
     }
-    return (_jsxs(Box, { flexDirection: "column", height: terminalHeight, children: [error && (_jsx(Box, { paddingX: 1, children: _jsxs(Text, { color: "red", children: ["Error: ", error] }) })), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: renderView() }), !showHelp && (_jsx(BottomBar, { items: getBottomBarItems(view.type), environments: environments, isDetecting: isDetecting }))] }));
+    return (_jsxs(Box, { flexDirection: "column", height: terminalHeight, children: [error && (_jsx(Box, { paddingX: 1, children: _jsxs(Text, { color: "red", children: ["Error: ", error] }) })), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: renderView() }), !showHelp && (_jsx(BottomBar, { items: getBottomBarItems(view.type, {
+                    isLocalLivestock: view.type === 'livestock'
+                        ? !view.livestock.barn || isLocalBarn(barns.find((b) => b.name === view.livestock.barn) || { name: 'local' })
+                        : undefined,
+                    isLocalBarn: view.type === 'barn'
+                        ? isLocalBarn(view.barn)
+                        : undefined,
+                }), environments: environments, isDetecting: isDetecting }))] }));
 }

package/dist/components/CritterHeader.d.ts

@@ -0,0 +1,7 @@
+import type { Critter, Barn } from '../types.js';
+interface CritterHeaderProps {
+    barn: Barn;
+    critter: Critter;
+}
+export declare function CritterHeader({ barn, critter }: CritterHeaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/CritterHeader.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+// Rabbit ASCII art template - @ symbols are pattern spots
+const RABBIT_TEMPLATE = [
+    "                              __",
+    "                     /\\    .-\" /",
+    "                    /  ; .'  .' ",
+    "                   :   :/  .'   ",
+    "                    \\  ;-.'     ",
+    "       .--\"\"\"\"--..__/     `.    ",
+    "     .'@@@@@@@@@@@.'     o  \\   ",
+    "    /@@@@@@@@@@@@@@@@        ;  ",
+    "   :@@@@@@@@@@@@@@@@\\       :  ",
+    " .-;@@@@@@@@-.@@@@@@@`.__.--'  ",
+    ":  ;@@@@@@@@@@\\@@@@@,   ;       ",
+    "'._:@@@@@@@@@@@;@@@:   (        ",
+    "    \\/  .__    ;    \\   `-.     ",
+    "     ;     \"-,/_..--\"`-..__)    ",
+    "     '\"\"--.._:                  ",
+];
+// Generate multiple hash values from a string for better distribution
+function multiHash(str) {
+    const hashes = [];
+    // First hash - djb2
+    let hash1 = 5381;
+    for (let i = 0; i < str.length; i++) {
+        hash1 = ((hash1 << 5) + hash1) ^ str.charCodeAt(i);
+    }
+    hashes.push(Math.abs(hash1));
+    // Second hash - sdbm
+    let hash2 = 0;
+    for (let i = 0; i < str.length; i++) {
+        hash2 = str.charCodeAt(i) + (hash2 << 6) + (hash2 << 16) - hash2;
+    }
+    hashes.push(Math.abs(hash2));
+    // Third hash - fnv-1a inspired
+    let hash3 = 2166136261;
+    for (let i = 0; i < str.length; i++) {
+        hash3 ^= str.charCodeAt(i);
+        hash3 = (hash3 * 16777619) >>> 0;
+    }
+    hashes.push(hash3);
+    return hashes;
+}
+// Pattern characters - space and block characters
+const PATTERN_CHARS = [' ', ' ', '░', '░', '▒', '▓', '█'];
+// Generate pattern variation for the rabbit based on critter/barn data
+function generateRabbitArt(critter, barn) {
+    // Use barn name + critter name + service for unique seed
+    const seed = `${barn.name}-${critter.name}-${critter.service}`;
+    const hashes = multiHash(seed);
+    // Replace @ symbols with pattern characters
+    let charIndex = 0;
+    const rabbitArt = RABBIT_TEMPLATE.map((line, lineIndex) => {
+        let result = '';
+        for (const char of line) {
+            if (char === '@') {
+                const h1 = hashes[0];
+                const h2 = hashes[1];
+                const h3 = hashes[2];
+                const mix = (h1 >> (charIndex % 17)) ^
+                    (h2 >> ((charIndex + lineIndex) % 13)) ^
+                    (h3 >> ((charIndex * 7 + lineIndex * 3) % 19));
+                const charChoice = Math.abs(mix) % PATTERN_CHARS.length;
+                result += PATTERN_CHARS[charChoice];
+                charIndex++;
+            }
+            else {
+                result += char;
+            }
+        }
+        return result;
+    });
+    return rabbitArt;
+}
+export function CritterHeader({ barn, critter }) {
+    const rabbitArt = generateRabbitArt(critter, barn);
+    // Use a default color for critters (could be configurable later)
+    const color = '#8fbc8f'; // Dark sea green
+    return (_jsx(Box, { flexDirection: "column", paddingTop: 1, paddingLeft: 1, children: _jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { flexDirection: "column", children: rabbitArt.map((line, i) => (_jsx(Text, { color: color, bold: true, children: line }, i))) }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, justifyContent: "center", children: [_jsx(Text, { bold: true, color: color, children: critter.name }), _jsxs(Text, { dimColor: true, children: ["barn: ", barn.name] }), _jsxs(Text, { dimColor: true, children: ["service: ", critter.service] })] })] }) }));
+}

package/dist/components/List.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { SessionStatus } from '../lib/signals.js';
 export interface RowAction {
     key: string;
@@ -10,6 +11,7 @@ export interface ListItem {
     meta?: string;
     sessionStatus?: SessionStatus;
     actions?: RowAction[];
+    prefix?: React.ReactNode;
 }
 interface ListProps {
     items: ListItem[];

package/dist/components/List.js

@@ -57,6 +57,6 @@ export function List({ items, focused = false, selectedIndex: controlledIndex, o
                     item.sessionStatus === 'error' ? 'red' : undefined;
             const statusColor = item.status === 'active' ? 'green' :
                 item.status === 'error' ? 'red' : 'gray';
-            return (_jsxs(Box, { justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 0, width: 2, children: _jsx(Text, { color: isSelected ? BRAND_COLOR : undefined, children: isSelected ? '›' : ' ' }) }), _jsxs(Box, { gap: 1, flexShrink: 1, flexGrow: 1, overflow: "hidden", children: [_jsx(Text, { color: isSelected ? BRAND_COLOR : undefined, bold: isSelected, wrap: "truncate", children: item.label }), item.status && (_jsx(Text, { color: statusColor, children: "\u25CF" })), item.meta && (_jsx(Text, { color: sessionStatusColor, dimColor: !sessionStatusColor, wrap: "truncate", children: item.meta }))] }), isSelected && item.actions && item.actions.length > 0 && (_jsx(Box, { gap: 2, flexShrink: 0, marginLeft: 1, children: item.actions.map((action) => (_jsxs(Text, { children: [_jsxs(Text, { color: BRAND_COLOR, children: ["[", action.key, "]"] }), _jsxs(Text, { dimColor: true, children: [" ", action.label] })] }, action.key))) }))] }, item.id));
+            return (_jsxs(Box, { justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 0, width: 2, children: _jsx(Text, { color: isSelected ? BRAND_COLOR : undefined, children: isSelected ? '›' : ' ' }) }), _jsxs(Box, { gap: 1, flexShrink: 1, flexGrow: 1, overflow: "hidden", children: [item.prefix && (_jsx(Box, { flexShrink: 0, children: item.prefix })), _jsx(Text, { color: isSelected ? BRAND_COLOR : undefined, bold: isSelected, wrap: "truncate", children: item.label }), item.status && (_jsx(Text, { color: statusColor, children: "\u25CF" })), item.meta && (_jsx(Text, { color: sessionStatusColor, dimColor: !sessionStatusColor, wrap: "truncate", children: item.meta }))] }), isSelected && item.actions && item.actions.length > 0 && (_jsx(Box, { gap: 2, flexShrink: 0, marginLeft: 1, children: item.actions.map((action) => (_jsxs(Text, { children: [_jsxs(Text, { color: BRAND_COLOR, children: ["[", action.key, "]"] }), _jsxs(Text, { dimColor: true, children: [" ", action.label] })] }, action.key))) }))] }, item.id));
         }) }));
 }

package/dist/lib/auth/index.d.ts

@@ -0,0 +1,2 @@
+export * from './storage.js';
+export * from './linear.js';

package/dist/lib/auth/index.js

@@ -0,0 +1,3 @@
+// src/lib/auth/index.ts
+export * from './storage.js';
+export * from './linear.js';

package/dist/lib/auth/linear.d.ts

@@ -0,0 +1,20 @@
+import { clearLinearToken } from './storage.js';
+export declare const LINEAR_API_KEY_URL = "https://linear.app/settings/api";
+export { clearLinearToken };
+/**
+ * Check if Linear is currently authenticated.
+ */
+export declare function isLinearAuthenticated(): boolean;
+/**
+ * Save a Linear API key.
+ */
+export declare function saveLinearApiKey(apiKey: string): void;
+/**
+ * Validate a Linear API key by making a test request.
+ * Returns true if valid, false otherwise.
+ */
+export declare function validateLinearApiKey(apiKey: string): Promise<boolean>;
+/**
+ * Make an authenticated request to Linear's GraphQL API.
+ */
+export declare function linearGraphQL<T>(query: string, variables?: Record<string, unknown>): Promise<T>;

package/dist/lib/auth/linear.js

@@ -0,0 +1,79 @@
+// src/lib/auth/linear.ts
+// Linear authentication using Personal API Keys
+// Users create keys at: https://linear.app/settings/api
+import { setLinearToken, getLinearToken, clearLinearToken } from './storage.js';
+export const LINEAR_API_KEY_URL = 'https://linear.app/settings/api';
+export { clearLinearToken };
+/**
+ * Check if Linear is currently authenticated.
+ */
+export function isLinearAuthenticated() {
+    return getLinearToken() !== null;
+}
+/**
+ * Save a Linear API key.
+ */
+export function saveLinearApiKey(apiKey) {
+    setLinearToken(apiKey);
+}
+/**
+ * Validate a Linear API key by making a test request.
+ * Returns true if valid, false otherwise.
+ */
+export async function validateLinearApiKey(apiKey) {
+    try {
+        const response = await fetch('https://api.linear.app/graphql', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': apiKey,
+            },
+            body: JSON.stringify({
+                query: '{ viewer { id } }',
+            }),
+        });
+        if (!response.ok) {
+            return false;
+        }
+        const text = await response.text();
+        // Check if we got HTML instead of JSON (indicates auth/routing issue)
+        if (text.startsWith('<!') || text.startsWith('<html')) {
+            return false;
+        }
+        const result = JSON.parse(text);
+        return !!(result.data?.viewer?.id);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Make an authenticated request to Linear's GraphQL API.
+ */
+export async function linearGraphQL(query, variables) {
+    const token = getLinearToken();
+    if (!token) {
+        throw new Error('Not authenticated with Linear');
+    }
+    const response = await fetch('https://api.linear.app/graphql', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': token,
+        },
+        body: JSON.stringify({ query, variables }),
+    });
+    if (!response.ok) {
+        throw new Error(`Linear API error: ${response.statusText}`);
+    }
+    const text = await response.text();
+    // Check if we got HTML instead of JSON
+    if (text.startsWith('<!') || text.startsWith('<html')) {
+        throw new Error('Linear API returned HTML instead of JSON - check your API key');
+    }
+    const result = JSON.parse(text);
+    if (result.errors?.length) {
+        throw new Error(result.errors[0].message);
+    }
+    return result.data;
+}

package/dist/lib/auth/storage.d.ts

@@ -0,0 +1,12 @@
+export interface LinearAuth {
+    accessToken: string;
+    expiresAt?: string;
+}
+export interface AuthConfig {
+    linear?: LinearAuth;
+}
+export declare function loadAuth(): AuthConfig;
+export declare function saveAuth(auth: AuthConfig): void;
+export declare function getLinearToken(): string | null;
+export declare function setLinearToken(accessToken: string, expiresAt?: Date): void;
+export declare function clearLinearToken(): void;

package/dist/lib/auth/storage.js

@@ -0,0 +1,53 @@
+// src/lib/auth/storage.ts
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import YAML from 'js-yaml';
+import { AUTH_FILE, YEEHAW_DIR } from '../paths.js';
+import { mkdirSync } from 'fs';
+export function loadAuth() {
+    if (!existsSync(YEEHAW_DIR)) {
+        mkdirSync(YEEHAW_DIR, { recursive: true });
+    }
+    if (!existsSync(AUTH_FILE)) {
+        return {};
+    }
+    try {
+        const content = readFileSync(AUTH_FILE, 'utf-8');
+        return YAML.load(content) || {};
+    }
+    catch {
+        return {};
+    }
+}
+export function saveAuth(auth) {
+    if (!existsSync(YEEHAW_DIR)) {
+        mkdirSync(YEEHAW_DIR, { recursive: true });
+    }
+    writeFileSync(AUTH_FILE, YAML.dump(auth), 'utf-8');
+}
+export function getLinearToken() {
+    const auth = loadAuth();
+    if (!auth.linear?.accessToken) {
+        return null;
+    }
+    // Check expiration if set
+    if (auth.linear.expiresAt) {
+        const expiresAt = new Date(auth.linear.expiresAt);
+        if (expiresAt <= new Date()) {
+            return null; // Token expired
+        }
+    }
+    return auth.linear.accessToken;
+}
+export function setLinearToken(accessToken, expiresAt) {
+    const auth = loadAuth();
+    auth.linear = {
+        accessToken,
+        expiresAt: expiresAt?.toISOString(),
+    };
+    saveAuth(auth);
+}
+export function clearLinearToken() {
+    const auth = loadAuth();
+    delete auth.linear;
+    saveAuth(auth);
+}