@colmbus72/yeehaw 0.4.2 → 0.6.0

package/dist/components/List.js

@@ -1,6 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useEffect } from 'react';
 import { Box, Text, useInput } from 'ink';
+// Yeehaw brand gold (darker for light mode readability)
+const BRAND_COLOR = '#d4a020';
 export function List({ items, focused = false, selectedIndex: controlledIndex, onSelect, onAction, onHighlight, onSelectionChange }) {
     const [internalIndex, setInternalIndex] = useState(0);
     // Use controlled index if provided, otherwise internal
@@ -35,8 +37,13 @@ export function List({ items, focused = false, selectedIndex: controlledIndex, o
         if (key.return && items[selectedIndex] && onSelect) {
             onSelect(items[selectedIndex]);
         }
-        if (input === 's' && items[selectedIndex] && onAction) {
-            onAction(items[selectedIndex]);
+        // Handle row-level actions (replaces hardcoded 's' check)
+        const currentItem = items[selectedIndex];
+        if (currentItem?.actions && onAction) {
+            const action = currentItem.actions.find(a => a.key === input);
+            if (action) {
+                onAction(currentItem, action.key);
+            }
         }
     });
     if (items.length === 0) {
@@ -44,10 +51,12 @@ export function List({ items, focused = false, selectedIndex: controlledIndex, o
     }
     return (_jsx(Box, { flexDirection: "column", children: items.map((item, index) => {
             const isSelected = index === selectedIndex && focused;
+            // Session status takes priority for meta coloring
+            const sessionStatusColor = item.sessionStatus === 'waiting' ? 'yellow' :
+                item.sessionStatus === 'working' ? 'cyan' :
+                    item.sessionStatus === 'error' ? 'red' : undefined;
             const statusColor = item.status === 'active' ? 'green' :
                 item.status === 'error' ? 'red' : 'gray';
-            // Yeehaw brand gold for selection
-            const selectionColor = '#f0c040';
-            return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isSelected ? selectionColor : undefined, children: isSelected ? '›' : ' ' }, "arrow"), _jsx(Text, { color: isSelected ? selectionColor : undefined, bold: isSelected, children: item.label }, "label"), item.status && (_jsx(Text, { color: statusColor, children: "\u25CF" }, "status")), item.meta && (_jsx(Text, { dimColor: true, children: item.meta }, "meta"))] }, 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/components/Panel.js

@@ -1,5 +1,31 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
+// Yeehaw brand gold (darker for light mode readability)
+const BRAND_COLOR = '#d4a020';
+// Render hints with gold keys and gray labels: "[n] new" -> gold "[n]" + gray " new"
+function renderHints(hints) {
+    const parts = [];
+    // Match [key] patterns and split around them
+    const regex = /(\[[^\]]+\])/g;
+    let lastIndex = 0;
+    let match;
+    let keyIndex = 0;
+    while ((match = regex.exec(hints)) !== null) {
+        // Add text before the match (gray)
+        if (match.index > lastIndex) {
+            parts.push(_jsx(Text, { dimColor: true, children: hints.slice(lastIndex, match.index) }, `text-${keyIndex}`));
+        }
+        // Add the [key] part (gold)
+        parts.push(_jsx(Text, { color: BRAND_COLOR, children: match[1] }, `key-${keyIndex}`));
+        lastIndex = regex.lastIndex;
+        keyIndex++;
+    }
+    // Add remaining text after last match (gray)
+    if (lastIndex < hints.length) {
+        parts.push(_jsx(Text, { dimColor: true, children: hints.slice(lastIndex) }, `text-end`));
+    }
+    return parts;
+}
 export function Panel({ title, children, focused = false, width, hints }) {
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: focused ? 'cyan' : 'gray', width: width, children: [_jsxs(Box, { paddingX: 1, marginBottom: 0, justifyContent: "space-between", children: [_jsx(Text, { bold: true, color: focused ? 'cyan' : 'white', children: title }), focused && hints && (_jsx(Text, { color: "cyan", children: hints }))] }), _jsx(Box, { flexDirection: "column", paddingX: 1, children: children })] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: focused ? BRAND_COLOR : 'gray', width: width, children: [_jsx(Box, { paddingX: 1, marginBottom: 0, children: _jsx(Text, { bold: true, color: focused ? BRAND_COLOR : 'gray', children: title }) }), _jsx(Box, { flexDirection: "column", paddingX: 1, flexGrow: 1, children: children }), _jsx(Box, { paddingX: 1, justifyContent: "flex-end", height: 1, children: focused && hints ? (_jsx(Text, { children: renderHints(hints) })) : (_jsx(Text, { children: " " })) })] }));
 }

package/dist/components/SplashScreen.js

@@ -10,7 +10,7 @@ const TUMBLEWEED = [
     ' ░▒░ ░▒░ ░',
 ];
 const TUMBLEWEED_COLOR = '#b8860b';
-const BRAND_COLOR = '#f0c040';
+const BRAND_COLOR = '#d4a020'; // Darker for light mode readability
 // Match Header.tsx positioning exactly
 const HEADER_PADDING_TOP = 1;
 const TUMBLEWEED_TOP_PADDING = 1;

package/dist/hooks/useSessions.js

@@ -18,8 +18,8 @@ export function useSessions() {
         const result = listYeehawWindows();
         setWindows(result);
         setLoading(false);
-        // Poll every 5 seconds for window updates (without loading state changes)
-        const interval = setInterval(refresh, 5000);
+        // Poll for window updates (without loading state changes)
+        const interval = setInterval(refresh, 800);
         return () => clearInterval(interval);
     }, [refresh]);
     const createClaude = useCallback((workingDir, name) => {

package/dist/index.js

@@ -5,7 +5,43 @@ import { App } from './app.js';
 import { isInsideYeehawSession, yeehawSessionExists, createYeehawSession, attachToYeehaw, hasTmux, } from './lib/tmux.js';
 import { ensureConfigDirs } from './lib/config.js';
 import { checkForUpdates, formatUpdateMessage } from './lib/update-check.js';
+import { installHookScript, getClaudeHooksConfig, checkClaudeHooksInstalled } from './lib/hooks.js';
+/**
+ * Handle CLI subcommands
+ */
+function handleSubcommands() {
+    const args = process.argv.slice(2);
+    if (args[0] === 'hooks' && args[1] === 'install') {
+        const scriptPath = installHookScript();
+        console.log(`\x1b[32m✓\x1b[0m Hook script installed: ${scriptPath}`);
+        console.log('');
+        console.log('\x1b[33mNote:\x1b[0m Claude sessions started from Yeehaw already have hooks enabled.');
+        console.log('This command is only needed for Claude sessions started outside Yeehaw.');
+        if (checkClaudeHooksInstalled()) {
+            console.log('\n\x1b[32m✓\x1b[0m Claude hooks already configured in ~/.claude/settings.json');
+        }
+        else {
+            console.log('\nTo enable status tracking for external Claude sessions,');
+            console.log('add this to ~/.claude/settings.json:');
+            console.log(JSON.stringify(getClaudeHooksConfig(), null, 2));
+        }
+        return true;
+    }
+    if (args[0] === 'hooks') {
+        console.log('Usage: yeehaw hooks install');
+        console.log('');
+        console.log('Install Claude hooks for session status tracking.');
+        console.log('Note: Sessions started from Yeehaw already have hooks enabled automatically.');
+        console.log('This is only needed for Claude sessions started outside Yeehaw.');
+        return true;
+    }
+    return false;
+}
 function main() {
+    // Handle subcommands first (before tmux checks)
+    if (handleSubcommands()) {
+        process.exit(0);
+    }
     // Ensure config directories exist
     ensureConfigDirs();
     // Check for updates (non-blocking, uses cache)
@@ -27,7 +63,11 @@ function main() {
     }
     // If we're already inside the yeehaw tmux session, just render the TUI
     if (isInsideYeehawSession()) {
-        render(_jsx(App, {}));
+        render(_jsx(App, {}), {
+            patchConsole: true,
+            incrementalRendering: true,
+            // maxFps: 60,
+        });
         return;
     }
     // We're not inside yeehaw session - need to create/attach

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);
+}

package/dist/lib/config.d.ts

@@ -1,4 +1,4 @@
-import type { Config, Project, Barn, Livestock } from '../types.js';
+import type { Config, Project, Barn, Livestock, Critter } from '../types.js';
 export declare const LOCAL_BARN: Barn;
 export declare function isLocalBarn(barn: Barn): boolean;
 /**
@@ -25,3 +25,15 @@ export declare function getLivestockForBarn(barnName: string): Array<{
     project: Project;
     livestock: Livestock;
 }>;
+/**
+ * Add a critter to a barn
+ */
+export declare function addCritterToBarn(barnName: string, critter: Critter): void;
+/**
+ * Remove a critter from a barn
+ */
+export declare function removeCritterFromBarn(barnName: string, critterName: string): boolean;
+/**
+ * Get a specific critter from a barn
+ */
+export declare function getCritter(barnName: string, critterName: string): Critter | undefined;

package/dist/lib/config.js

@@ -148,3 +148,54 @@ export function getLivestockForBarn(barnName) {
     }
     return result;
 }
+// ============================================================================
+// Critter operations
+// ============================================================================
+/**
+ * Add a critter to a barn
+ */
+export function addCritterToBarn(barnName, critter) {
+    const barn = loadBarn(barnName);
+    if (!barn) {
+        throw new Error(`Barn not found: ${barnName}`);
+    }
+    barn.critters = barn.critters || [];
+    // Check for duplicate
+    if (barn.critters.some(c => c.name === critter.name)) {
+        throw new Error(`Critter "${critter.name}" already exists on barn "${barnName}"`);
+    }
+    barn.critters.push(critter);
+    // Only save to file if it's not the local barn
+    if (barnName !== 'local') {
+        saveBarn(barn);
+    }
+}
+/**
+ * Remove a critter from a barn
+ */
+export function removeCritterFromBarn(barnName, critterName) {
+    const barn = loadBarn(barnName);
+    if (!barn) {
+        throw new Error(`Barn not found: ${barnName}`);
+    }
+    const originalLength = (barn.critters || []).length;
+    barn.critters = (barn.critters || []).filter(c => c.name !== critterName);
+    if (barn.critters.length === originalLength) {
+        return false; // Critter wasn't found
+    }
+    // Only save to file if it's not the local barn
+    if (barnName !== 'local') {
+        saveBarn(barn);
+    }
+    return true;
+}
+/**
+ * Get a specific critter from a barn
+ */
+export function getCritter(barnName, critterName) {
+    const barn = loadBarn(barnName);
+    if (!barn) {
+        return undefined;
+    }
+    return barn.critters?.find(c => c.name === critterName);
+}

package/dist/lib/context.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Build a context string to inject into Claude sessions spawned from Yeehaw.
+ * Includes project name and wiki section titles (not content) to hint at available context.
+ */
+export declare function buildProjectContext(projectName: string): string | null;
+/**
+ * Build context for a livestock-specific session.
+ * Includes project context plus livestock details.
+ */
+export declare function buildLivestockContext(projectName: string, livestockName: string): string | null;

package/dist/lib/context.js

@@ -0,0 +1,63 @@
+import { loadProject } from './config.js';
+/**
+ * Build a context string to inject into Claude sessions spawned from Yeehaw.
+ * Includes project name and wiki section titles (not content) to hint at available context.
+ */
+export function buildProjectContext(projectName) {
+    const project = loadProject(projectName);
+    if (!project) {
+        return null;
+    }
+    const lines = [];
+    lines.push(`You are working on the "${project.name}" project.`);
+    if (project.summary) {
+        lines.push(`Project: ${project.summary}`);
+    }
+    // Add wiki section titles as hints
+    const wikiSections = project.wiki || [];
+    if (wikiSections.length > 0) {
+        lines.push('');
+        lines.push('Yeehaw wiki sections available:');
+        for (const section of wikiSections) {
+            lines.push(`- ${section.title}`);
+        }
+        lines.push('');
+        lines.push('Use mcp__yeehaw__get_wiki_section to fetch relevant context before making architectural decisions.');
+    }
+    return lines.join('\n');
+}
+/**
+ * Build context for a livestock-specific session.
+ * Includes project context plus livestock details.
+ */
+export function buildLivestockContext(projectName, livestockName) {
+    const project = loadProject(projectName);
+    if (!project) {
+        return null;
+    }
+    const livestock = project.livestock?.find(l => l.name === livestockName);
+    if (!livestock) {
+        return buildProjectContext(projectName);
+    }
+    const lines = [];
+    lines.push(`You are working on the "${project.name}" project, in the "${livestock.name}" environment.`);
+    if (project.summary) {
+        lines.push(`Project: ${project.summary}`);
+    }
+    // Add livestock details
+    if (livestock.branch) {
+        lines.push(`Branch: ${livestock.branch}`);
+    }
+    // Add wiki section titles as hints
+    const wikiSections = project.wiki || [];
+    if (wikiSections.length > 0) {
+        lines.push('');
+        lines.push('Yeehaw wiki sections available:');
+        for (const section of wikiSections) {
+            lines.push(`- ${section.title}`);
+        }
+        lines.push('');
+        lines.push('Use mcp__yeehaw__get_wiki_section to fetch relevant context before making architectural decisions.');
+    }
+    return lines.join('\n');
+}

package/dist/lib/critters.d.ts

@@ -0,0 +1,61 @@
+import type { Critter, Barn } from '../types.js';
+/**
+ * Discovered critter from scanning a barn
+ */
+export interface DiscoveredCritter {
+    service: string;
+    suggested_name: string;
+    binary?: string;
+    config_path?: string;
+    status: 'running' | 'stopped';
+}
+/**
+ * Read logs from a critter (via journald or custom path)
+ */
+export declare function readCritterLogs(critter: Critter, barn: Barn, options?: {
+    lines?: number;
+    pattern?: string;
+}): Promise<{
+    content: string;
+    error?: string;
+}>;
+/**
+ * Discover critters (running services) on a barn
+ */
+export declare function discoverCritters(barn: Barn): Promise<{
+    critters: DiscoveredCritter[];
+    error?: string;
+}>;
+/**
+ * Service info from systemctl
+ */
+export interface SystemService {
+    name: string;
+    state: 'running' | 'stopped' | 'unknown';
+    description?: string;
+}
+/**
+ * List systemd services on a barn
+ * @param barn - The barn to query
+ * @param activeOnly - If true, only return running services (default: true)
+ */
+export declare function listSystemServices(barn: Barn, activeOnly?: boolean): Promise<{
+    services: SystemService[];
+    error?: string;
+}>;
+/**
+ * Details extracted from a systemd service file
+ */
+export interface ServiceDetails {
+    service_path: string;
+    config_path?: string;
+    log_path?: string;
+    use_journald: boolean;
+}
+/**
+ * Get details about a systemd service by parsing its unit file
+ */
+export declare function getServiceDetails(barn: Barn, serviceName: string): Promise<{
+    details?: ServiceDetails;
+    error?: string;
+}>;