@compilr-dev/cli 0.5.0 → 0.5.2

package/dist/auth/storage.js

@@ -0,0 +1,118 @@
+/**
+ * Auth Storage Module
+ *
+ * Manages persistent storage of authentication credentials.
+ * File: ~/.compilr-dev/auth.json
+ *
+ * Security:
+ * - File permissions set to 0600 (owner read/write only)
+ * - Tokens are JWTs from Supabase Auth
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// =============================================================================
+// Constants
+// =============================================================================
+const CONFIG_DIR = path.join(os.homedir(), '.compilr-dev');
+const AUTH_FILE = path.join(CONFIG_DIR, 'auth.json');
+// =============================================================================
+// Storage Operations
+// =============================================================================
+/**
+ * Load auth data from disk.
+ * Returns null if file doesn't exist or is invalid.
+ */
+export function loadAuthData() {
+    try {
+        if (!fs.existsSync(AUTH_FILE)) {
+            return null;
+        }
+        const data = fs.readFileSync(AUTH_FILE, 'utf-8');
+        const parsed = JSON.parse(data);
+        // Validate required fields
+        if (typeof parsed.version !== 'number' ||
+            typeof parsed.user !== 'object' ||
+            !parsed.user ||
+            typeof parsed.session !== 'object' ||
+            !parsed.session) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        // File doesn't exist or is corrupted
+        return null;
+    }
+}
+/**
+ * Save auth data to disk with secure permissions.
+ */
+export function saveAuthData(data) {
+    // Ensure config directory exists
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    // Write with restrictive permissions
+    fs.writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2), {
+        encoding: 'utf-8',
+        mode: 0o600, // Owner read/write only
+    });
+    // Verify permissions (fix if system ignored mode)
+    try {
+        fs.chmodSync(AUTH_FILE, 0o600);
+    }
+    catch {
+        // Ignore chmod errors (e.g., on Windows)
+    }
+}
+/**
+ * Clear auth data (logout).
+ */
+export function clearAuthData() {
+    try {
+        if (fs.existsSync(AUTH_FILE)) {
+            fs.unlinkSync(AUTH_FILE);
+        }
+    }
+    catch {
+        // Ignore errors during cleanup
+    }
+}
+/**
+ * Update just the session tokens (after refresh).
+ */
+export function updateSession(session) {
+    const data = loadAuthData();
+    if (!data) {
+        return false;
+    }
+    data.session = session;
+    saveAuthData(data);
+    return true;
+}
+/**
+ * Check if auth data exists (quick check without loading).
+ */
+export function hasAuthData() {
+    return fs.existsSync(AUTH_FILE);
+}
+/**
+ * Check if stored auth file has insecure permissions.
+ * Returns warning message if insecure, null if OK.
+ */
+export function checkAuthFilePermissions() {
+    try {
+        if (!fs.existsSync(AUTH_FILE)) {
+            return null;
+        }
+        const stats = fs.statSync(AUTH_FILE);
+        const mode = stats.mode & 0o777; // Get permission bits
+        // Check if group or others have any access
+        if (mode & 0o077) {
+            return `Warning: Auth file has insecure permissions (${mode.toString(8)}). Consider running: chmod 600 ${AUTH_FILE}`;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/changelog/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Changelog Module
+ *
+ * Exports release data and helper functions.
+ */
+import { type Release } from './releases.js';
+export { RELEASES, type Release, type ReleaseChange } from './releases.js';
+/**
+ * Get the latest release entry.
+ */
+export declare function getLatestRelease(): Release | undefined;
+/**
+ * Get startup highlights for a given version.
+ * Returns the highlights array if the version matches a known release, or the latest release highlights.
+ */
+export declare function getStartupHighlights(version: string): string[];

package/dist/changelog/index.js

@@ -0,0 +1,24 @@
+/**
+ * Changelog Module
+ *
+ * Exports release data and helper functions.
+ */
+import { RELEASES } from './releases.js';
+export { RELEASES } from './releases.js';
+/**
+ * Get the latest release entry.
+ */
+export function getLatestRelease() {
+    return RELEASES[0];
+}
+/**
+ * Get startup highlights for a given version.
+ * Returns the highlights array if the version matches a known release, or the latest release highlights.
+ */
+export function getStartupHighlights(version) {
+    const match = RELEASES.find((r) => r.version === version);
+    if (match)
+        return match.highlights;
+    // Fallback to latest
+    return RELEASES[0]?.highlights ?? [];
+}

package/dist/changelog/releases.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Release Data
+ *
+ * Single source of truth for all release notes.
+ * Newest releases first.
+ */
+export interface ReleaseChange {
+    category: 'added' | 'changed' | 'fixed';
+    text: string;
+}
+export interface Release {
+    version: string;
+    date: string;
+    highlights: string[];
+    changes: ReleaseChange[];
+}
+export declare const RELEASES: Release[];

package/dist/changelog/releases.js

@@ -0,0 +1,63 @@
+/**
+ * Release Data
+ *
+ * Single source of truth for all release notes.
+ * Newest releases first.
+ */
+// =============================================================================
+// Release Data (newest first)
+// =============================================================================
+export const RELEASES = [
+    {
+        version: '0.5.0',
+        date: '2026-02-16',
+        highlights: [
+            'Status bar navigation',
+            '/changelog command',
+            'Release notes on startup',
+        ],
+        changes: [
+            { category: 'added', text: 'Status bar navigation (down arrow to footer)' },
+            { category: 'added', text: '/changelog command with browsable overlay' },
+            { category: 'added', text: 'Background agent count indicator' },
+            { category: 'added', text: 'Release notes on startup screen' },
+            { category: 'changed', text: 'Pending indicator hint updated to [↓]' },
+            { category: 'changed', text: 'Background execution tutorial updated' },
+        ],
+    },
+    {
+        version: '0.4.0',
+        date: '2026-01-20',
+        highlights: [
+            'Multi-agent teams',
+            '/filter command',
+            'Background execution',
+        ],
+        changes: [
+            { category: 'added', text: 'Multi-agent team support ($arch, $pm, $qa, etc.)' },
+            { category: 'added', text: '/filter command for tool filtering' },
+            { category: 'added', text: 'Background agent execution ($agent msg &)' },
+            { category: 'added', text: 'Task ownership and handoff between agents' },
+            { category: 'added', text: '/team dashboard with agent status' },
+            { category: 'changed', text: 'Footer shows active team agent' },
+            { category: 'fixed', text: 'Session restoration across project switches' },
+        ],
+    },
+    {
+        version: '0.3.0',
+        date: '2025-12-15',
+        highlights: [
+            'Plan mode',
+            'Permission system',
+            'Onboarding wizard',
+        ],
+        changes: [
+            { category: 'added', text: 'Plan mode for structured AI responses' },
+            { category: 'added', text: 'Permission system for tool execution' },
+            { category: 'added', text: '/init onboarding wizard' },
+            { category: 'added', text: 'Meta-tools for 62% token reduction' },
+            { category: 'changed', text: 'Improved context management with ContextManager' },
+            { category: 'fixed', text: 'Ghost lines in overlay rendering' },
+        ],
+    },
+];

package/dist/commands-v2/handlers/auth.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Auth Command Handlers
+ *
+ * CLI authentication via device flow.
+ * Commands: /login, /logout, /whoami
+ */
+import type { CommandHandlerV2 } from '../types.js';
+import { openBrowser } from '../../utils/open-browser.js';
+export { openBrowser };
+export declare const authCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/auth.js

@@ -0,0 +1,118 @@
+/**
+ * Auth Command Handlers
+ *
+ * CLI authentication via device flow.
+ * Commands: /login, /logout, /whoami
+ */
+import { getAuthManager } from '../../auth/index.js';
+import { LoginOverlayV2 } from '../../ui/overlay/impl/login-overlay-v2.js';
+import { openBrowser } from '../../utils/open-browser.js';
+// Re-export for any existing consumers
+export { openBrowser };
+// =============================================================================
+// /login Command
+// =============================================================================
+const loginCommand = {
+    name: 'login',
+    aliases: ['signin'],
+    description: 'Log in to compilr.dev',
+    details: 'Authenticate via browser using the device flow. Opens compilr.dev where you can log in or create an account. The CLI receives your credentials automatically.',
+    examples: [
+        { code: '/login', description: 'Start the login flow' },
+    ],
+    async execute(_args, ctx) {
+        const auth = getAuthManager();
+        // Check if already logged in
+        if (await auth.isAuthenticated()) {
+            const user = await auth.getUser();
+            ctx.ui.print({ type: 'info', message: `Already logged in as ${user.email}` });
+            ctx.ui.print({ type: 'info', message: 'Use /logout to sign out first.' });
+            return true;
+        }
+        const loginOverlay = new LoginOverlayV2();
+        const result = await ctx.ui.showOverlay(loginOverlay);
+        if (result?.success) {
+            await auth.sendForcedHeartbeat();
+            await auth.startSession();
+            ctx.ui.print({ type: 'success', message: `Logged in as ${result.email ?? ''}` });
+        }
+        else {
+            ctx.ui.print({ type: 'error', message: 'Login cancelled or failed.' });
+        }
+        return true;
+    },
+};
+// =============================================================================
+// /logout Command
+// =============================================================================
+const logoutCommand = {
+    name: 'logout',
+    aliases: ['signout'],
+    description: 'Log out of compilr.dev',
+    details: 'Sign out and clear stored credentials.',
+    examples: [
+        { code: '/logout', description: 'Sign out' },
+    ],
+    execute(_args, ctx) {
+        const auth = getAuthManager();
+        if (!auth.hasStoredAuth()) {
+            ctx.ui.print({ type: 'info', message: 'Not logged in.' });
+            return Promise.resolve(true);
+        }
+        auth.logout();
+        ctx.ui.print({ type: 'success', message: 'Logged out successfully.' });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// /whoami Command
+// =============================================================================
+const whoamiCommand = {
+    name: 'whoami',
+    aliases: ['me', 'account'],
+    description: 'Show current user info',
+    details: 'Display the currently logged in user and account details.',
+    examples: [
+        { code: '/whoami', description: 'Show account info' },
+    ],
+    async execute(_args, ctx) {
+        const auth = getAuthManager();
+        if (!await auth.isAuthenticated()) {
+            ctx.ui.print({ type: 'info', message: 'Not logged in. Use /login to authenticate.' });
+            return true;
+        }
+        const user = await auth.getUser();
+        const profile = auth.getProfile();
+        const lines = [
+            '',
+            `  Email:        ${user.email}`,
+            `  Account:      ${user.accountType}`,
+            `  Member since: ${user.createdAt.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' })}`,
+            `  User ID:      ${user.id.slice(0, 8)}...`,
+        ];
+        if (profile) {
+            lines.push('');
+            lines.push(`  Provider:     ${profile.default_provider}`);
+            lines.push(`  Model:        ${profile.default_model}`);
+            lines.push(`  Telemetry:    ${profile.telemetry_enabled ? 'enabled' : 'disabled'}`);
+            if (profile.total_sessions > 0) {
+                lines.push('');
+                lines.push(`  Sessions:     ${String(profile.total_sessions)}`);
+                lines.push(`  Messages:     ${String(profile.total_messages)}`);
+            }
+        }
+        lines.push('');
+        lines.push('  Profile: https://compilr.dev/profile');
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return true;
+    },
+};
+// =============================================================================
+// Export
+// =============================================================================
+export const authCommands = [
+    loginCommand,
+    logoutCommand,
+    whoamiCommand,
+];

package/dist/commands-v2/handlers/background.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Background Agent Command Handlers
+ *
+ * Commands for managing background agents and pending requests.
+ *
+ * Phase 3b: Pending Requests System
+ * Phase 3c: Background Status & Control
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const pendingCommand: CommandHandlerV2;
+export declare const bgCommand: CommandHandlerV2;
+export declare const fgCommand: CommandHandlerV2;
+export declare const killCommand: CommandHandlerV2;
+export declare const backgroundCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/background.js

@@ -0,0 +1,276 @@
+/**
+ * Background Agent Command Handlers
+ *
+ * Commands for managing background agents and pending requests.
+ *
+ * Phase 3b: Pending Requests System
+ * Phase 3c: Background Status & Control
+ */
+import { getStyles } from '../../themes/index.js';
+import { PendingOverlayV2, BackgroundOverlayV2 } from '../../ui/overlay/index.js';
+import { AskUserSimpleOverlayV2 } from '../../ui/overlay/impl/ask-user-simple-overlay-v2.js';
+import { AskUserOverlayV2 } from '../../ui/overlay/impl/ask-user-overlay-v2.js';
+import { getPendingRequestsManager } from '../../multi-agent/index.js';
+// =============================================================================
+// Pending Command
+// =============================================================================
+export const pendingCommand = {
+    name: 'pending',
+    aliases: ['p'],
+    description: 'View and respond to pending requests from background agents',
+    details: 'Background agents may need your approval for permissions or answers to questions. This command shows all pending requests and lets you approve or deny them.',
+    examples: [
+        { code: '/pending', description: 'Open the pending requests overlay' },
+        { code: '/p', description: 'Shortcut alias' },
+    ],
+    interactions: [
+        '↑/↓ to select a request',
+        'a to approve permission requests',
+        'r/Enter to respond to questions',
+        'd to deny/skip',
+        'Esc to close',
+    ],
+    async execute(_args, ctx) {
+        const pendingManager = getPendingRequestsManager();
+        // Loop: re-open pending overlay after each question if more requests remain
+        let keepGoing = true;
+        while (keepGoing) {
+            const overlay = new PendingOverlayV2();
+            const result = await ctx.ui.showOverlay(overlay);
+            if (!result || result.type === 'closed') {
+                break;
+            }
+            // Handle 'respond' result - show the standard overlay for the question
+            const request = result.request;
+            const context = request.context;
+            const toolType = context?.toolType;
+            const originalInput = context?.originalInput;
+            if (toolType === 'ask_user_simple' && originalInput) {
+                const input = originalInput;
+                const questionOverlay = new AskUserSimpleOverlayV2({
+                    question: input.question,
+                    options: input.options,
+                    allowCustom: input.allowCustom,
+                });
+                const questionResult = await ctx.ui.showOverlay(questionOverlay);
+                if (questionResult) {
+                    pendingManager.respond(request.id, {
+                        approved: !questionResult.skipped,
+                        overlayResult: questionResult,
+                    });
+                }
+                else {
+                    pendingManager.respond(request.id, {
+                        approved: false,
+                        overlayResult: { answer: '', skipped: true },
+                    });
+                }
+            }
+            else if (toolType === 'ask_user' && originalInput) {
+                const input = originalInput;
+                const questionOverlay = new AskUserOverlayV2({
+                    questions: input.questions,
+                    context: input.context,
+                });
+                const questionResult = await ctx.ui.showOverlay(questionOverlay);
+                if (questionResult) {
+                    pendingManager.respond(request.id, {
+                        approved: true,
+                        overlayResult: questionResult,
+                    });
+                }
+                else {
+                    pendingManager.respond(request.id, {
+                        approved: false,
+                        overlayResult: {
+                            answers: {},
+                            skipped: input.questions.map((q) => q.id),
+                        },
+                    });
+                }
+            }
+            // Auto-close if no more requests, otherwise loop back to pending overlay
+            keepGoing = pendingManager.getCount() > 0;
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Background Status Command
+// =============================================================================
+export const bgCommand = {
+    name: 'bg',
+    aliases: ['background'],
+    description: 'View status of background agents',
+    details: 'Shows all running background agents and their status. You can bring an agent to the foreground or kill it from this view.',
+    examples: [
+        { code: '/bg', description: 'Show background agents status' },
+        { code: '/background', description: 'Full command name' },
+    ],
+    interactions: [
+        '↑/↓ to select an agent',
+        'f to bring to foreground',
+        'k to kill the agent',
+        'Esc to close',
+    ],
+    async execute(_args, ctx) {
+        const s = getStyles();
+        // If the foreground agent is busy (agent running), /bg sends it to background
+        if (ctx.ui.isAgentRunning() && ctx.sendForegroundToBackground) {
+            const demoted = ctx.sendForegroundToBackground();
+            if (demoted) {
+                ctx.ui.print({
+                    type: 'info',
+                    message: `$${demoted} sent to background (still running)`,
+                });
+            }
+            return true;
+        }
+        // Check if background session management is available
+        if (!ctx.getBackgroundSessions) {
+            ctx.ui.print({
+                type: 'warning',
+                message: 'Background agent management not available in this session.',
+            });
+            return true;
+        }
+        const overlay = new BackgroundOverlayV2({
+            getSessions: ctx.getBackgroundSessions,
+        });
+        const result = await ctx.ui.showOverlay(overlay);
+        // Handle foreground request
+        if (result && result.type === 'foreground') {
+            if (ctx.bringToForeground) {
+                const success = await ctx.bringToForeground(result.agentId);
+                if (success) {
+                    ctx.ui.print({
+                        type: 'info',
+                        message: `Switched to $${result.agentId} in foreground`,
+                    });
+                }
+                else {
+                    ctx.ui.print({
+                        type: 'warning',
+                        message: `Could not bring $${result.agentId} to foreground`,
+                    });
+                }
+            }
+        }
+        // Handle kill request
+        if (result && result.type === 'kill') {
+            if (ctx.killBackgroundAgent) {
+                const success = ctx.killBackgroundAgent(result.agentId);
+                if (success) {
+                    ctx.ui.print({
+                        type: 'info',
+                        message: s.warning(`Killed background agent $${result.agentId}`),
+                    });
+                }
+                else {
+                    ctx.ui.print({
+                        type: 'warning',
+                        message: `Could not kill $${result.agentId} - agent not found`,
+                    });
+                }
+            }
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Foreground Command
+// =============================================================================
+export const fgCommand = {
+    name: 'fg',
+    aliases: ['foreground'],
+    description: 'Bring a background agent to the foreground',
+    details: 'Switches focus to a background agent, making it the active foreground agent. The previously active agent continues running in the background.',
+    examples: [
+        { code: '/fg arch', description: 'Bring $arch to the foreground' },
+        { code: '/fg dev', description: 'Bring $dev to the foreground' },
+    ],
+    async execute(args, ctx) {
+        const agentId = args.trim().replace(/^\$/, ''); // Remove $ prefix if present
+        if (!agentId) {
+            ctx.ui.print({
+                type: 'warning',
+                message: 'Usage: /fg <agent> - e.g., /fg arch or /fg $dev',
+            });
+            return true;
+        }
+        if (!ctx.bringToForeground) {
+            ctx.ui.print({
+                type: 'warning',
+                message: 'Background agent management not available in this session.',
+            });
+            return true;
+        }
+        const success = await ctx.bringToForeground(agentId);
+        if (success) {
+            ctx.ui.print({
+                type: 'info',
+                message: `Switched to $${agentId} in foreground`,
+            });
+        }
+        else {
+            ctx.ui.print({
+                type: 'warning',
+                message: `Could not bring $${agentId} to foreground - agent not found or not running in background`,
+            });
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Kill Command
+// =============================================================================
+export const killCommand = {
+    name: 'kill',
+    description: 'Kill a background agent',
+    details: 'Cancels a running background agent. Any pending requests from this agent will be rejected.',
+    examples: [
+        { code: '/kill arch', description: 'Kill the $arch background agent' },
+        { code: '/kill dev', description: 'Kill the $dev background agent' },
+    ],
+    execute(args, ctx) {
+        const s = getStyles();
+        const agentId = args.trim().replace(/^\$/, ''); // Remove $ prefix if present
+        if (!agentId) {
+            ctx.ui.print({
+                type: 'warning',
+                message: 'Usage: /kill <agent> - e.g., /kill arch or /kill $dev',
+            });
+            return Promise.resolve(true);
+        }
+        if (!ctx.killBackgroundAgent) {
+            ctx.ui.print({
+                type: 'warning',
+                message: 'Background agent management not available in this session.',
+            });
+            return Promise.resolve(true);
+        }
+        const success = ctx.killBackgroundAgent(agentId);
+        if (success) {
+            ctx.ui.print({
+                type: 'info',
+                message: s.warning(`Killed background agent $${agentId}`),
+            });
+        }
+        else {
+            ctx.ui.print({
+                type: 'warning',
+                message: `Could not kill $${agentId} - agent not found or not running in background`,
+            });
+        }
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Export
+// =============================================================================
+export const backgroundCommands = [
+    pendingCommand,
+    bgCommand,
+    fgCommand,
+    killCommand,
+];