devflow-kit 1.8.2 → 2.0.0

package/dist/hud/components/git-branch.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function gitBranch(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=git-branch.d.ts.map

package/dist/hud/components/model.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function model(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=model.d.ts.map

package/dist/hud/components/release-info.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function releaseInfo(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=release-info.d.ts.map

package/dist/hud/components/session-cost.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function sessionCost(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=session-cost.d.ts.map

package/dist/hud/components/session-duration.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function sessionDuration(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=session-duration.d.ts.map

package/dist/hud/components/todo-progress.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function todoProgress(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=todo-progress.d.ts.map

package/dist/hud/components/usage-quota.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function usageQuota(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=usage-quota.d.ts.map

package/dist/hud/components/version-badge.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function versionBadge(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=version-badge.d.ts.map

package/dist/hud/components/worktree-count.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentResult, GatherContext } from '../types.js';
-export default function worktreeCount(ctx: GatherContext): Promise<ComponentResult | null>;
-//# sourceMappingURL=worktree-count.d.ts.map

package/dist/hud/config.d.ts

@@ -1,10 +0,0 @@
-import type { HudConfig, ComponentId } from './types.js';
-/**
- * All 14 HUD components in display order.
- */
-export declare const HUD_COMPONENTS: readonly ComponentId[];
-export declare function getConfigPath(): string;
-export declare function loadConfig(): HudConfig;
-export declare function saveConfig(config: HudConfig): void;
-export declare function resolveComponents(config: HudConfig): ComponentId[];
-//# sourceMappingURL=config.d.ts.map

package/dist/hud/credentials.d.ts

@@ -1,17 +0,0 @@
-export interface OAuthCredentials {
-    accessToken: string;
-    subscriptionType?: string;
-}
-/** Resolve the Claude config directory, respecting CLAUDE_CONFIG_DIR. */
-export declare function getClaudeDir(): string;
-/** Read OAuth credentials from ~/.claude/.credentials.json. Injectable claudeDir for tests. */
-export declare function readCredentialsFile(claudeDir?: string): OAuthCredentials | null;
-/** Read OAuth token from macOS Keychain. Returns null on non-darwin or failure. */
-export declare function readKeychainToken(): Promise<string | null>;
-/**
- * Get OAuth credentials using platform-appropriate strategy.
- * macOS: Keychain first, then file fallback. Other platforms: file only.
- * Hybrid: if Keychain has token but no subscriptionType, merge from file.
- */
-export declare function getCredentials(): Promise<OAuthCredentials | null>;
-//# sourceMappingURL=credentials.d.ts.map

package/dist/hud/credentials.js

@@ -1,99 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { homedir } from 'node:os';
-import { execFile } from 'node:child_process';
-const KEYCHAIN_TIMEOUT = 3000; // 3s
-const DEBUG = !!process.env.DEVFLOW_HUD_DEBUG;
-function debugLog(msg, data) {
-    if (!DEBUG)
-        return;
-    const entry = { ts: new Date().toISOString(), source: 'credentials', msg, ...data };
-    fs.appendFileSync('/tmp/hud-debug.log', JSON.stringify(entry) + '\n');
-}
-/** Resolve the Claude config directory, respecting CLAUDE_CONFIG_DIR. */
-export function getClaudeDir() {
-    return (process.env.CLAUDE_CONFIG_DIR ||
-        path.join(process.env.HOME || homedir(), '.claude'));
-}
-/** Read OAuth credentials from ~/.claude/.credentials.json. Injectable claudeDir for tests. */
-export function readCredentialsFile(claudeDir) {
-    try {
-        const dir = claudeDir ?? getClaudeDir();
-        const filePath = path.join(dir, '.credentials.json');
-        const raw = fs.readFileSync(filePath, 'utf-8');
-        const creds = JSON.parse(raw);
-        const oauth = creds.claudeAiOauth;
-        const accessToken = oauth?.accessToken;
-        if (typeof accessToken !== 'string' || !accessToken)
-            return null;
-        const subscriptionType = typeof oauth?.subscriptionType === 'string' ? oauth.subscriptionType : undefined;
-        debugLog('credentials file read', { filePath, hasSubscriptionType: !!subscriptionType });
-        return { accessToken, subscriptionType };
-    }
-    catch {
-        return null;
-    }
-}
-/** Read OAuth token from macOS Keychain. Returns null on non-darwin or failure. */
-export function readKeychainToken() {
-    if (process.platform !== 'darwin')
-        return Promise.resolve(null);
-    return new Promise((resolve) => {
-        execFile('/usr/bin/security', ['find-generic-password', '-s', 'Claude Code-credentials', '-w'], { timeout: KEYCHAIN_TIMEOUT }, (err, stdout) => {
-            if (err || !stdout.trim()) {
-                debugLog('keychain read failed', { error: err?.message });
-                resolve(null);
-                return;
-            }
-            try {
-                const parsed = JSON.parse(stdout.trim());
-                const oauth = parsed.claudeAiOauth;
-                const token = oauth?.accessToken;
-                if (typeof token === 'string' && token) {
-                    debugLog('keychain token found');
-                    resolve(token);
-                }
-                else {
-                    debugLog('keychain: no accessToken in parsed data');
-                    resolve(null);
-                }
-            }
-            catch {
-                // Keychain value might be the raw token string
-                const trimmed = stdout.trim();
-                if (trimmed.length > 20) {
-                    debugLog('keychain: raw token string');
-                    resolve(trimmed);
-                }
-                else {
-                    debugLog('keychain: unparseable value');
-                    resolve(null);
-                }
-            }
-        });
-    });
-}
-/**
- * Get OAuth credentials using platform-appropriate strategy.
- * macOS: Keychain first, then file fallback. Other platforms: file only.
- * Hybrid: if Keychain has token but no subscriptionType, merge from file.
- */
-export async function getCredentials() {
-    const fileCreds = readCredentialsFile();
-    if (process.platform !== 'darwin') {
-        debugLog('non-darwin: file credentials only', { found: !!fileCreds });
-        return fileCreds;
-    }
-    // macOS: try Keychain first
-    const keychainToken = await readKeychainToken();
-    if (keychainToken) {
-        // Merge subscriptionType from file if Keychain doesn't have it
-        const subscriptionType = fileCreds?.subscriptionType;
-        debugLog('using keychain token', { hasSubscriptionType: !!subscriptionType });
-        return { accessToken: keychainToken, subscriptionType };
-    }
-    // Fallback to file
-    debugLog('keychain failed, falling back to file', { found: !!fileCreds });
-    return fileCreds;
-}
-//# sourceMappingURL=credentials.js.map

package/dist/hud/git.d.ts

@@ -1,7 +0,0 @@
-import type { GitStatus } from './types.js';
-/**
- * Gather git status for the given working directory.
- * Returns null if not in a git repo or on error.
- */
-export declare function gatherGitStatus(cwd: string): Promise<GitStatus | null>;
-//# sourceMappingURL=git.d.ts.map

package/dist/hud/index.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/hud/render.d.ts

@@ -1,7 +0,0 @@
-import type { GatherContext } from './types.js';
-/**
- * Render all enabled components into a multi-line HUD string.
- * Components that return null are excluded. Empty lines are skipped.
- */
-export declare function render(ctx: GatherContext): Promise<string>;
-//# sourceMappingURL=render.d.ts.map

package/dist/hud/stdin.d.ts

@@ -1,6 +0,0 @@
-import type { StdinData } from './types.js';
-/**
- * Read and parse JSON from stdin. Returns empty object on parse failure.
- */
-export declare function readStdin(): Promise<StdinData>;
-//# sourceMappingURL=stdin.d.ts.map

package/dist/hud/transcript.d.ts

@@ -1,7 +0,0 @@
-import type { TranscriptData } from './types.js';
-/**
- * Parse a Claude Code session transcript (JSONL) to extract tool/agent activity and todo progress.
- * Returns null if the file doesn't exist or can't be parsed.
- */
-export declare function parseTranscript(transcriptPath: string): Promise<TranscriptData | null>;
-//# sourceMappingURL=transcript.d.ts.map

package/dist/hud/types.d.ts

@@ -1,116 +0,0 @@
-/**
- * StdinData — the JSON that Claude Code pipes to statusLine commands.
- */
-export interface StdinData {
-    model?: {
-        display_name?: string;
-        id?: string;
-    };
-    cwd?: string;
-    context_window?: {
-        context_window_size?: number;
-        current_usage?: {
-            input_tokens?: number;
-            output_tokens?: number;
-        };
-        used_percentage?: number;
-    };
-    cost?: {
-        total_cost_usd?: number;
-    };
-    session_id?: string;
-    transcript_path?: string;
-}
-/**
- * Component IDs — the 14 HUD components.
- */
-export type ComponentId = 'directory' | 'gitBranch' | 'gitAheadBehind' | 'diffStats' | 'model' | 'contextUsage' | 'versionBadge' | 'sessionDuration' | 'usageQuota' | 'todoProgress' | 'configCounts' | 'sessionCost' | 'releaseInfo' | 'worktreeCount';
-/**
- * HUD config persisted to ~/.devflow/hud.json.
- */
-export interface HudConfig {
-    enabled: boolean;
-    detail: boolean;
-}
-/**
- * Component render result.
- */
-export interface ComponentResult {
-    text: string;
-    raw: string;
-}
-/**
- * Component function signature.
- */
-export type ComponentFn = (ctx: GatherContext) => Promise<ComponentResult | null>;
-/**
- * Git status data gathered from the working directory.
- */
-export interface GitStatus {
-    branch: string;
-    dirty: boolean;
-    staged: boolean;
-    ahead: number;
-    behind: number;
-    filesChanged: number;
-    additions: number;
-    deletions: number;
-    lastTag: string | null;
-    commitsSinceTag: number;
-    worktreeCount: number;
-}
-/**
- * Transcript data parsed from session JSONL.
- */
-export interface TranscriptData {
-    tools: Array<{
-        name: string;
-        status: 'running' | 'completed';
-        target?: string;
-        description?: string;
-    }>;
-    agents: Array<{
-        name: string;
-        model?: string;
-        status: 'running' | 'completed';
-        description?: string;
-    }>;
-    todos: {
-        completed: number;
-        total: number;
-    };
-    skills: string[];
-}
-/**
- * Usage API data.
- */
-export interface UsageData {
-    fiveHourPercent: number | null;
-    sevenDayPercent: number | null;
-}
-/**
- * Config counts data for the configCounts component.
- */
-export interface ConfigCountsData {
-    claudeMdFiles: number;
-    rules: number;
-    mcpServers: number;
-    hooks: number;
-}
-/**
- * Gather context passed to all component render functions.
- */
-export interface GatherContext {
-    stdin: StdinData;
-    git: GitStatus | null;
-    transcript: TranscriptData | null;
-    usage: UsageData | null;
-    configCounts: ConfigCountsData | null;
-    config: HudConfig & {
-        components: ComponentId[];
-    };
-    devflowDir: string;
-    sessionStartTime: number | null;
-    terminalWidth: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/hud/usage-api.d.ts

@@ -1,7 +0,0 @@
-import type { UsageData } from './types.js';
-/**
- * Fetch usage quota data from the Anthropic API.
- * Uses caching with backoff for rate limiting. Returns null on failure.
- */
-export declare function fetchUsageData(): Promise<UsageData | null>;
-//# sourceMappingURL=usage-api.d.ts.map

package/dist/hud/usage-api.js

@@ -1,84 +0,0 @@
-import * as fs from 'node:fs';
-import { readCache, writeCache, readCacheStale } from './cache.js';
-import { getCredentials } from './credentials.js';
-const USAGE_CACHE_KEY = 'usage';
-const USAGE_CACHE_TTL = 5 * 60 * 1000; // 5 minutes
-const USAGE_FAIL_TTL = 15 * 1000; // 15 seconds
-const API_TIMEOUT = 1_500; // Must fit within 2s overall HUD timeout
-const BACKOFF_CACHE_KEY = 'usage-backoff';
-const DEBUG = !!process.env.DEVFLOW_HUD_DEBUG;
-function debugLog(msg, data) {
-    if (!DEBUG)
-        return;
-    const entry = { ts: new Date().toISOString(), source: 'usage-api', msg, ...data };
-    fs.appendFileSync('/tmp/hud-debug.log', JSON.stringify(entry) + '\n');
-}
-/**
- * Fetch usage quota data from the Anthropic API.
- * Uses caching with backoff for rate limiting. Returns null on failure.
- */
-export async function fetchUsageData() {
-    // Check backoff
-    const backoff = readCache(BACKOFF_CACHE_KEY);
-    if (backoff && Date.now() < backoff.retryAfter) {
-        debugLog('skipped: backoff active', { retryAfter: backoff.retryAfter });
-        return readCacheStale(USAGE_CACHE_KEY);
-    }
-    // Check cache
-    const cached = readCache(USAGE_CACHE_KEY);
-    if (cached)
-        return cached;
-    const creds = await getCredentials();
-    if (!creds) {
-        debugLog('no OAuth credentials found');
-        return null;
-    }
-    const token = creds.accessToken;
-    try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), API_TIMEOUT);
-        debugLog('fetching usage', { timeout: API_TIMEOUT });
-        const response = await fetch('https://api.anthropic.com/api/oauth/usage', {
-            headers: {
-                Authorization: `Bearer ${token}`,
-                'Content-Type': 'application/json',
-                'anthropic-beta': 'oauth-2025-04-20',
-            },
-            signal: controller.signal,
-        });
-        clearTimeout(timeout);
-        if (response.status === 429) {
-            const retryAfter = parseInt(response.headers.get('Retry-After') || '60', 10);
-            const delay = Math.min(retryAfter * 1000, 5 * 60 * 1000);
-            writeCache(BACKOFF_CACHE_KEY, { retryAfter: Date.now() + delay, delay }, delay);
-            debugLog('rate limited (429)', { retryAfter, delay });
-            return readCacheStale(USAGE_CACHE_KEY);
-        }
-        if (!response.ok) {
-            debugLog('non-200 response', { status: response.status, statusText: response.statusText });
-            writeCache(USAGE_CACHE_KEY, null, USAGE_FAIL_TTL);
-            return readCacheStale(USAGE_CACHE_KEY);
-        }
-        const body = (await response.json());
-        const fiveHour = body.five_hour;
-        const sevenDay = body.seven_day;
-        const data = {
-            fiveHourPercent: typeof fiveHour?.utilization === 'number'
-                ? Math.round(Math.max(0, Math.min(100, fiveHour.utilization)))
-                : null,
-            sevenDayPercent: typeof sevenDay?.utilization === 'number'
-                ? Math.round(Math.max(0, Math.min(100, sevenDay.utilization)))
-                : null,
-        };
-        debugLog('usage fetched', { fiveHour: data.fiveHourPercent, sevenDay: data.sevenDayPercent });
-        writeCache(USAGE_CACHE_KEY, data, USAGE_CACHE_TTL);
-        return data;
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        debugLog('fetch failed', { error: message });
-        writeCache(USAGE_CACHE_KEY, null, USAGE_FAIL_TTL);
-        return readCacheStale(USAGE_CACHE_KEY);
-    }
-}
-//# sourceMappingURL=usage-api.js.map

package/dist/plugins.d.ts

@@ -1,46 +0,0 @@
-/**
- * Shared plugin registry — single source of truth for all CLI commands.
- */
-/**
- * Plugin definition with metadata
- */
-export interface PluginDefinition {
-    name: string;
-    description: string;
-    commands: string[];
-    agents: string[];
-    skills: string[];
-    /** Optional plugins are not installed by default — require explicit --plugin flag */
-    optional?: boolean;
-}
-/**
- * Available DevFlow plugins
- */
-export declare const DEVFLOW_PLUGINS: PluginDefinition[];
-/**
- * Deprecated command names from old installations.
- * Used during init to clean up stale command files on upgrade.
- */
-export declare const LEGACY_COMMAND_NAMES: string[];
-/**
- * Deprecated skill names from old installations (prefixed with devflow-).
- * Used during uninstall to clean up legacy installs.
- */
-export declare const LEGACY_SKILL_NAMES: string[];
-/**
- * Derive unique skill names from all plugins.
- */
-export declare function getAllSkillNames(): string[];
-/**
- * Derive unique agent names from all plugins.
- */
-export declare function getAllAgentNames(): string[];
-/**
- * Build maps of unique assets to their source plugin (first plugin that declares them).
- * This ensures each skill/agent is copied only once during installation.
- */
-export declare function buildAssetMaps(plugins: PluginDefinition[]): {
-    skillsMap: Map<string, string>;
-    agentsMap: Map<string, string>;
-};
-//# sourceMappingURL=plugins.d.ts.map