@proletariat/cli 0.1.4 → 0.3.0

package/dist/lib/styles.d.ts

@@ -0,0 +1,98 @@
+/**
+ * CLI Output Style Guide
+ *
+ * Centralized styling for consistent CLI output across all commands.
+ * Avoids chalk.gray which is nearly invisible on dark terminals.
+ */
+import chalk from 'chalk';
+/**
+ * Text styles for different semantic purposes
+ */
+export declare const styles: {
+    /** Main title/header - bold cyan */
+    title: chalk.Chalk;
+    /** Section header - bold white */
+    header: chalk.Chalk;
+    /** Subheader - white */
+    subheader: chalk.Chalk;
+    /** Success messages - green */
+    success: chalk.Chalk;
+    /** Warning messages - yellow */
+    warning: chalk.Chalk;
+    /** Error messages - red */
+    error: chalk.Chalk;
+    /** Info messages - blue */
+    info: chalk.Chalk;
+    /** Primary content - white (default terminal color) */
+    primary: chalk.Chalk;
+    /** Secondary/muted content - dim white (visible but subdued) */
+    muted: chalk.Chalk;
+    /** Highlighted/emphasized - bold */
+    emphasis: chalk.Chalk;
+    /** Code/IDs - cyan */
+    code: chalk.Chalk;
+    /** Added/new items - green */
+    added: chalk.Chalk;
+    /** Removed/deleted items - red */
+    removed: chalk.Chalk;
+    /** Modified/changed items - yellow */
+    modified: chalk.Chalk;
+    priorityUrgent: chalk.Chalk;
+    priorityHigh: chalk.Chalk;
+    priorityMedium: chalk.Chalk;
+    priorityLow: chalk.Chalk;
+    columnBacklog: chalk.Chalk;
+    columnInProgress: chalk.Chalk;
+    columnReview: chalk.Chalk;
+    columnBlocked: chalk.Chalk;
+    columnDone: chalk.Chalk;
+    columnDefault: chalk.Chalk;
+};
+/**
+ * Format a priority badge
+ */
+export declare function formatPriority(priority?: string): string;
+/**
+ * Get color for a column name
+ */
+export declare function getColumnStyle(column: string): chalk.Chalk;
+/**
+ * Get emoji for a column
+ */
+export declare function getColumnEmoji(column: string): string;
+/**
+ * Format a divider line
+ */
+export declare function divider(width?: number): string;
+/**
+ * Get color for a priority group header
+ */
+export declare function getPriorityStyle(priority: string): chalk.Chalk;
+/**
+ * Get label for a priority group header
+ */
+export declare function getPriorityLabel(priority: string): string;
+/**
+ * Format a category badge
+ */
+export declare function formatCategory(category?: string): string;
+/**
+ * Format a ticket ID
+ */
+export declare function formatTicketId(id: string): string;
+/**
+ * Format a timestamp for display
+ */
+export declare function formatTimestamp(): string;
+/**
+ * Standard message prefixes
+ */
+export declare const prefix: {
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+    sync: string;
+    export: string;
+    watch: string;
+};

package/dist/lib/styles.js

@@ -0,0 +1,195 @@
+/**
+ * CLI Output Style Guide
+ *
+ * Centralized styling for consistent CLI output across all commands.
+ * Avoids chalk.gray which is nearly invisible on dark terminals.
+ */
+import chalk from 'chalk';
+/**
+ * Text styles for different semantic purposes
+ */
+export const styles = {
+    // === Headers & Titles ===
+    /** Main title/header - bold cyan */
+    title: chalk.bold.cyan,
+    /** Section header - bold white */
+    header: chalk.bold.white,
+    /** Subheader - white */
+    subheader: chalk.white,
+    // === Status Indicators ===
+    /** Success messages - green */
+    success: chalk.green,
+    /** Warning messages - yellow */
+    warning: chalk.yellow,
+    /** Error messages - red */
+    error: chalk.red,
+    /** Info messages - blue */
+    info: chalk.blue,
+    // === Content ===
+    /** Primary content - white (default terminal color) */
+    primary: chalk.white,
+    /** Secondary/muted content - dim white (visible but subdued) */
+    muted: chalk.dim,
+    /** Highlighted/emphasized - bold */
+    emphasis: chalk.bold,
+    /** Code/IDs - cyan */
+    code: chalk.cyan,
+    // === Semantic Colors ===
+    /** Added/new items - green */
+    added: chalk.green,
+    /** Removed/deleted items - red */
+    removed: chalk.red,
+    /** Modified/changed items - yellow */
+    modified: chalk.yellow,
+    // === Priority Colors ===
+    priorityUrgent: chalk.red.bold,
+    priorityHigh: chalk.red,
+    priorityMedium: chalk.yellow,
+    priorityLow: chalk.dim,
+    // === Column Colors (for board view) ===
+    columnBacklog: chalk.blue,
+    columnInProgress: chalk.yellow,
+    columnReview: chalk.magenta,
+    columnBlocked: chalk.red,
+    columnDone: chalk.green,
+    columnDefault: chalk.white,
+};
+/**
+ * Format a priority badge
+ */
+export function formatPriority(priority) {
+    if (!priority)
+        return '';
+    switch (priority) {
+        // New P0-P3 format
+        case 'P0':
+            return styles.priorityUrgent(`[${priority}]`);
+        case 'P1':
+            return styles.priorityHigh(`[${priority}]`);
+        case 'P2':
+            return styles.priorityMedium(`[${priority}]`);
+        case 'P3':
+            return styles.priorityLow(`[${priority}]`);
+        // Legacy format (for backwards compatibility during display)
+        case 'URGENT':
+            return styles.priorityUrgent('[P0]');
+        case 'HIGH':
+            return styles.priorityHigh('[P1]');
+        case 'MEDIUM':
+            return styles.priorityMedium('[P2]');
+        case 'LOW':
+            return styles.priorityLow('[P3]');
+        default:
+            return styles.muted(`[${priority}]`);
+    }
+}
+/**
+ * Get color for a column name
+ */
+export function getColumnStyle(column) {
+    // Check for backlog-type columns
+    if (column.includes('BL') || column === 'Backlog' || column === 'Ready') {
+        return styles.columnBacklog;
+    }
+    switch (column) {
+        case 'In Progress':
+            return styles.columnInProgress;
+        case 'In Review':
+        case 'Review':
+            return styles.columnReview;
+        case 'Blocked':
+            return styles.columnBlocked;
+        case 'Done':
+        case 'Merged':
+        case 'Published':
+            return styles.columnDone;
+        case 'Dropped':
+            return styles.muted;
+        default:
+            return styles.columnDefault;
+    }
+}
+/**
+ * Get emoji for a column
+ */
+export function getColumnEmoji(column) {
+    const emojis = {
+        'Backlog': '📥',
+        'In Progress': '🚀',
+        'In Review': '👀',
+        'Review': '👀',
+        'Blocked': '🚧',
+        'Done': '✅',
+        'SHIP BL': '🚢',
+        'GROW BL': '📈',
+        'SUPPORT BL': '🛟',
+        'BIZOPS BL': '⚙️',
+        'STRATEGY BL': '🎯',
+        'Ready': '📥',
+        'Merged': '🔀',
+        'Published': '🚀',
+        'Dropped': '🗑️',
+    };
+    return emojis[column] || '📋';
+}
+/**
+ * Format a divider line
+ */
+export function divider(width = 50) {
+    return styles.muted('─'.repeat(width));
+}
+/**
+ * Get color for a priority group header
+ */
+export function getPriorityStyle(priority) {
+    switch (priority) {
+        case 'P0':
+            return styles.priorityUrgent;
+        case 'P1':
+            return styles.priorityHigh;
+        case 'P2':
+            return styles.priorityMedium;
+        case 'P3':
+            return styles.priorityLow;
+        default:
+            return styles.muted;
+    }
+}
+/**
+ * Get label for a priority group header
+ */
+export function getPriorityLabel(priority) {
+    return priority;
+}
+/**
+ * Format a category badge
+ */
+export function formatCategory(category) {
+    if (!category)
+        return '';
+    return styles.code(`[${category}]`);
+}
+/**
+ * Format a ticket ID
+ */
+export function formatTicketId(id) {
+    return styles.code(id);
+}
+/**
+ * Format a timestamp for display
+ */
+export function formatTimestamp() {
+    return styles.muted(`[${new Date().toLocaleTimeString()}]`);
+}
+/**
+ * Standard message prefixes
+ */
+export const prefix = {
+    success: styles.success('✅'),
+    error: styles.error('❌'),
+    warning: styles.warning('⚠️'),
+    info: styles.info('ℹ️'),
+    sync: '📥',
+    export: '📤',
+    watch: '👀',
+};

package/dist/lib/themes.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Default workspace directory for persistent agents (fallback if no theme)
+ */
+export declare const DEFAULT_AGENTS_DIR = "staff";
+/**
+ * Default directory for ephemeral agents (fallback if no theme)
+ */
+export declare const TEMP_AGENTS_DIR = "temp";
+/**
+ * Default theme for ephemeral agent name generation
+ */
+export declare const DEFAULT_EPHEMERAL_THEME = "billionaires";
+/**
+ * Adjectives for ephemeral agent name generation
+ * ~100 short, positive adjectives for readable agent names
+ */
+export declare const AGENT_ADJECTIVES: string[];
+/**
+ * Validate an agent name
+ * Agent names must be alphanumeric with optional hyphens/underscores (case-insensitive for uniqueness)
+ */
+export declare function isValidAgentName(name: string): boolean;
+/**
+ * Normalize a name to valid agent name format:
+ * - Trim whitespace
+ * - Replace spaces with dashes
+ * - Remove any invalid characters
+ * Note: Preserves case - uniqueness is enforced case-insensitively elsewhere
+ */
+export declare function normalizeAgentName(name: string): string;
+/**
+ * Get the canonical (lowercase) form of a name for uniqueness comparisons
+ */
+export declare function canonicalAgentName(name: string): string;
+/**
+ * Get suggested agent names (for interactive selection when no theme)
+ */
+export declare function getSuggestedAgentNames(): string[];
+export interface BuiltinThemeDefinition {
+    id: string;
+    name: string;
+    displayName: string;
+    description: string;
+    names: string[];
+    /** Directory for persistent/staff agents (default: 'staff') */
+    persistentDir: string;
+    /** Directory for ephemeral/temp agents (default: 'temp') */
+    ephemeralDir: string;
+}
+export declare const BUILTIN_THEMES: BuiltinThemeDefinition[];
+/**
+ * Ensure built-in themes are seeded in the database
+ * Called lazily when themes are first used
+ */
+export declare function ensureBuiltinThemes(workspacePath: string): void;
+/**
+ * Get a built-in theme by ID (from constants, not database)
+ */
+export declare function getBuiltinTheme(themeId: string): BuiltinThemeDefinition | undefined;
+/**
+ * Check if a theme ID is a built-in theme
+ */
+export declare function isBuiltinTheme(themeId: string): boolean;
+/**
+ * Get the persistent agents directory name for a theme
+ * Falls back to DEFAULT_AGENTS_DIR if theme not found
+ */
+export declare function getThemePersistentDir(themeId?: string): string;
+/**
+ * Get the ephemeral agents directory name for a theme
+ * Falls back to TEMP_AGENTS_DIR if theme not found
+ */
+export declare function getThemeEphemeralDir(themeId?: string): string;
+/**
+ * Get both directory names for a theme
+ */
+export declare function getThemeDirectories(themeId?: string): {
+    persistentDir: string;
+    ephemeralDir: string;
+};
+/**
+ * Pick a random adjective from the list
+ */
+export declare function pickAdjective(): string;
+/**
+ * Pick a random theme name from a specific theme
+ */
+export declare function pickThemeName(themeId: string): string;
+/**
+ * Pick a random theme name from any available theme
+ */
+export declare function pickRandomThemeName(): {
+    themeName: string;
+    themeId: string;
+};
+/**
+ * Options for ephemeral agent name generation
+ */
+export interface GenerateEphemeralNameOptions {
+    themeId?: string;
+    /**
+     * Optional callback to check if a candidate name conflicts with external resources.
+     * Returns { conflict: true, reason: string } if there's a conflict, or { conflict: false } if not.
+     * This allows checking for tmux sessions, directories, etc. that aren't in the database.
+     */
+    checkExternalConflict?: (name: string) => {
+        conflict: boolean;
+        reason?: string;
+    };
+    /**
+     * Optional callback for logging/messaging when conflicts are detected
+     */
+    onConflictSkipped?: (name: string, reason: string) => void;
+}
+/**
+ * Generate a unique ephemeral agent name.
+ * Format: {adjective}-{theme_name}-{number}
+ * Example: "bold-bezos-1", "keen-camry-2"
+ *
+ * @param existingNames - Set of existing agent names (for uniqueness checking)
+ * @param options - Optional configuration for name generation
+ */
+export declare function generateEphemeralAgentName(existingNames: Set<string>, options?: GenerateEphemeralNameOptions | string): string;
+/**
+ * Check if a name looks like an ephemeral agent name.
+ * Ephemeral names follow pattern: {adjective}-{name}-{number}
+ */
+export declare function isEphemeralAgentName(name: string): boolean;