@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/ui/autocomplete-controller.js

@@ -0,0 +1,384 @@
+/**
+ * Autocomplete controller for command, file, and agent autocomplete.
+ *
+ * Extracted from TerminalUI — owns all three autocomplete states and their
+ * management methods. Input state is passed in as parameters; accept() returns
+ * new input state instead of mutating directly.
+ */
+import { getStyles } from '../themes/index.js';
+import { getVisibleLength } from './line-utils.js';
+import { MAX_VISIBLE_COMMANDS, } from './terminal-types.js';
+import { filterCommands } from './terminal-autocomplete-utils.js';
+import { getFileMatches, extractAtMention, replaceAtMention, extractDollarMention, replaceDollarMention, } from './file-autocomplete.js';
+export class AutocompleteController {
+    command = {
+        active: false,
+        matches: [],
+        selectedIndex: 0,
+        scrollOffset: 0,
+    };
+    file = {
+        active: false,
+        matches: [],
+        selectedIndex: 0,
+        scrollOffset: 0,
+        partial: '',
+    };
+    agent = {
+        active: false,
+        matches: [],
+        selectedIndex: 0,
+        scrollOffset: 0,
+        partial: '',
+        startPos: 0,
+        lineIndex: 0,
+    };
+    getAgentSuggestions;
+    getCommands;
+    /** Whether any autocomplete is currently active. */
+    isActive() {
+        return this.command.active || this.file.active || this.agent.active;
+    }
+    // ===========================================================================
+    // Update (called when input changes)
+    // ===========================================================================
+    /**
+     * Detect and activate autocomplete based on current input state.
+     * Priority: @ file > $ agent > / command
+     */
+    update(lines, currentLine, cursorPos) {
+        const currentLineContent = lines[currentLine];
+        // Check for @ file path autocomplete first (works on any line)
+        const atMention = extractAtMention(currentLineContent, cursorPos);
+        if (atMention !== null) {
+            // File autocomplete mode - disable other autocompletes
+            this.command.active = false;
+            this.command.matches = [];
+            this.command.selectedIndex = 0;
+            this.command.scrollOffset = 0;
+            this.agent.active = false;
+            this.agent.matches = [];
+            // Enable file autocomplete
+            this.file.active = true;
+            this.file.partial = atMention;
+            this.file.matches = getFileMatches(atMention);
+            if (this.file.selectedIndex >= this.file.matches.length) {
+                this.file.selectedIndex = Math.max(0, this.file.matches.length - 1);
+                this.file.scrollOffset = 0;
+            }
+            return;
+        }
+        // Reset file autocomplete
+        this.file.active = false;
+        this.file.matches = [];
+        this.file.selectedIndex = 0;
+        this.file.scrollOffset = 0;
+        this.file.partial = '';
+        // Check for $ agent autocomplete (anywhere in the current line)
+        if (this.getAgentSuggestions) {
+            const dollarMention = extractDollarMention(currentLineContent, cursorPos);
+            if (dollarMention !== null) {
+                const partial = dollarMention.partial.toLowerCase();
+                const allAgents = this.getAgentSuggestions();
+                // Filter agents by partial match
+                const matches = allAgents.filter(a => a.id.toLowerCase().startsWith(partial) ||
+                    a.displayName.toLowerCase().includes(partial));
+                if (matches.length > 0) {
+                    this.agent.active = true;
+                    this.agent.partial = partial;
+                    this.agent.matches = matches;
+                    this.agent.startPos = dollarMention.startPos;
+                    this.agent.lineIndex = currentLine;
+                    if (this.agent.selectedIndex >= matches.length) {
+                        this.agent.selectedIndex = Math.max(0, matches.length - 1);
+                        this.agent.scrollOffset = 0;
+                    }
+                    // Reset command autocomplete
+                    this.command.active = false;
+                    this.command.matches = [];
+                    return;
+                }
+            }
+        }
+        // Reset agent autocomplete
+        this.agent.active = false;
+        this.agent.matches = [];
+        this.agent.selectedIndex = 0;
+        this.agent.scrollOffset = 0;
+        this.agent.partial = '';
+        this.agent.startPos = 0;
+        this.agent.lineIndex = 0;
+        // Activate command autocomplete when first line starts with /
+        const firstLine = lines[0];
+        if (currentLine === 0 && firstLine.startsWith('/')) {
+            this.command.active = true;
+            const freshCommands = this.getCommands?.() ?? [];
+            this.command.matches = filterCommands(firstLine, freshCommands);
+            // Reset selection if it's out of bounds
+            if (this.command.selectedIndex >= this.command.matches.length) {
+                this.command.selectedIndex = Math.max(0, this.command.matches.length - 1);
+                this.command.scrollOffset = 0;
+            }
+        }
+        else {
+            this.command.active = false;
+            this.command.matches = [];
+            this.command.selectedIndex = 0;
+            this.command.scrollOffset = 0;
+        }
+    }
+    // ===========================================================================
+    // Accept (apply selected autocomplete)
+    // ===========================================================================
+    /**
+     * Apply the selected autocomplete match.
+     * Returns new input state if something was accepted, null otherwise.
+     * Caller must also call update() after applying the result for file autocomplete
+     * (directory selection may trigger continued autocomplete).
+     */
+    accept(lines, currentLine, cursorPos) {
+        // Agent autocomplete takes highest priority
+        if (this.agent.active && this.agent.matches.length > 0) {
+            const selectedAgent = this.agent.matches[this.agent.selectedIndex];
+            const lineIdx = this.agent.lineIndex;
+            const line = lines[lineIdx];
+            const result = replaceDollarMention(line, cursorPos, selectedAgent.id);
+            const newLines = [...lines];
+            newLines[lineIdx] = result.input;
+            this.agent.active = false;
+            this.agent.matches = [];
+            this.agent.selectedIndex = 0;
+            this.agent.scrollOffset = 0;
+            this.agent.partial = '';
+            this.agent.startPos = 0;
+            this.agent.lineIndex = 0;
+            return { lines: newLines, currentLine: lineIdx, cursorPos: result.cursorPos };
+        }
+        // File autocomplete takes priority (works on current line)
+        if (this.file.active && this.file.matches.length > 0) {
+            const selectedFile = this.file.matches[this.file.selectedIndex];
+            const currentLineContent = lines[currentLine];
+            const result = replaceAtMention(currentLineContent, cursorPos, selectedFile.path);
+            const newLines = [...lines];
+            newLines[currentLine] = result.input;
+            this.file.active = false;
+            this.file.matches = [];
+            this.file.selectedIndex = 0;
+            this.file.scrollOffset = 0;
+            this.file.partial = '';
+            return { lines: newLines, currentLine, cursorPos: result.cursorPos };
+        }
+        // Command autocomplete (works on first line only)
+        if (this.command.active && this.command.matches.length > 0) {
+            const selected = this.command.matches[this.command.selectedIndex];
+            const newLines = [...lines];
+            newLines[0] = selected.command;
+            this.command.active = false;
+            this.command.matches = [];
+            this.command.selectedIndex = 0;
+            this.command.scrollOffset = 0;
+            return { lines: newLines, currentLine: 0, cursorPos: selected.command.length };
+        }
+        return null;
+    }
+    // ===========================================================================
+    // Close / Navigate
+    // ===========================================================================
+    close() {
+        this.agent.active = false;
+        this.agent.matches = [];
+        this.agent.selectedIndex = 0;
+        this.agent.scrollOffset = 0;
+        this.agent.partial = '';
+        this.agent.startPos = 0;
+        this.agent.lineIndex = 0;
+        this.file.active = false;
+        this.file.matches = [];
+        this.file.selectedIndex = 0;
+        this.file.scrollOffset = 0;
+        this.file.partial = '';
+        this.command.active = false;
+        this.command.matches = [];
+        this.command.selectedIndex = 0;
+        this.command.scrollOffset = 0;
+    }
+    navigateUp() {
+        if (this.agent.active && this.agent.matches.length > 0) {
+            if (this.agent.selectedIndex > 0) {
+                this.agent.selectedIndex--;
+                if (this.agent.selectedIndex < this.agent.scrollOffset) {
+                    this.agent.scrollOffset = this.agent.selectedIndex;
+                }
+                return true;
+            }
+            return false;
+        }
+        if (this.file.active && this.file.matches.length > 0) {
+            if (this.file.selectedIndex > 0) {
+                this.file.selectedIndex--;
+                if (this.file.selectedIndex < this.file.scrollOffset) {
+                    this.file.scrollOffset = this.file.selectedIndex;
+                }
+                return true;
+            }
+            return false;
+        }
+        if (!this.command.active || this.command.matches.length === 0) {
+            return false;
+        }
+        if (this.command.selectedIndex > 0) {
+            this.command.selectedIndex--;
+            if (this.command.selectedIndex < this.command.scrollOffset) {
+                this.command.scrollOffset = this.command.selectedIndex;
+            }
+            return true;
+        }
+        return false;
+    }
+    navigateDown() {
+        if (this.agent.active && this.agent.matches.length > 0) {
+            if (this.agent.selectedIndex < this.agent.matches.length - 1) {
+                this.agent.selectedIndex++;
+                const maxVisibleIndex = this.agent.scrollOffset + MAX_VISIBLE_COMMANDS - 1;
+                if (this.agent.selectedIndex > maxVisibleIndex) {
+                    this.agent.scrollOffset = this.agent.selectedIndex - MAX_VISIBLE_COMMANDS + 1;
+                }
+                return true;
+            }
+            return false;
+        }
+        if (this.file.active && this.file.matches.length > 0) {
+            if (this.file.selectedIndex < this.file.matches.length - 1) {
+                this.file.selectedIndex++;
+                const maxVisibleIndex = this.file.scrollOffset + MAX_VISIBLE_COMMANDS - 1;
+                if (this.file.selectedIndex > maxVisibleIndex) {
+                    this.file.scrollOffset = this.file.selectedIndex - MAX_VISIBLE_COMMANDS + 1;
+                }
+                return true;
+            }
+            return false;
+        }
+        if (!this.command.active || this.command.matches.length === 0) {
+            return false;
+        }
+        if (this.command.selectedIndex < this.command.matches.length - 1) {
+            this.command.selectedIndex++;
+            const maxVisibleIndex = this.command.scrollOffset + MAX_VISIBLE_COMMANDS - 1;
+            if (this.command.selectedIndex > maxVisibleIndex) {
+                this.command.scrollOffset = this.command.selectedIndex - MAX_VISIBLE_COMMANDS + 1;
+            }
+            return true;
+        }
+        return false;
+    }
+    // ===========================================================================
+    // Build lines (for footer rendering)
+    // ===========================================================================
+    buildCommandLines(termWidth) {
+        if (!this.command.active || this.command.matches.length === 0) {
+            return [];
+        }
+        const s = getStyles();
+        const lines = [];
+        const { matches, selectedIndex, scrollOffset } = this.command;
+        const visible = matches.slice(scrollOffset, scrollOffset + MAX_VISIBLE_COMMANDS);
+        const total = matches.length;
+        if (scrollOffset > 0) {
+            lines.push(s.muted(`  ↑ ${String(scrollOffset)} more above`));
+        }
+        for (let i = 0; i < visible.length; i++) {
+            const cmd = visible[i];
+            const actualIndex = scrollOffset + i;
+            const isSelected = actualIndex === selectedIndex;
+            const prefix = isSelected ? s.primary('❯ ') : '  ';
+            const name = isSelected ? s.primaryBold(cmd.command) : cmd.command;
+            const baseLen = getVisibleLength(prefix) + getVisibleLength(name) + 3;
+            const maxDescLen = termWidth - baseLen - 2;
+            const truncatedDesc = cmd.description.length > maxDescLen
+                ? cmd.description.slice(0, maxDescLen - 1) + '…'
+                : cmd.description;
+            lines.push(`${prefix}${name} ${s.muted('- ' + truncatedDesc)}`);
+        }
+        const belowCount = total - scrollOffset - visible.length;
+        if (belowCount > 0) {
+            lines.push(s.muted(`  ↓ ${String(belowCount)} more below`));
+        }
+        return lines;
+    }
+    buildFileLines(termWidth) {
+        if (!this.file.active || this.file.matches.length === 0) {
+            return [];
+        }
+        const s = getStyles();
+        const lines = [];
+        const { matches, selectedIndex, scrollOffset } = this.file;
+        const visible = matches.slice(scrollOffset, scrollOffset + MAX_VISIBLE_COMMANDS);
+        const total = matches.length;
+        if (scrollOffset > 0) {
+            lines.push(s.muted(`  ↑ ${String(scrollOffset)} more above`));
+        }
+        for (let i = 0; i < visible.length; i++) {
+            const file = visible[i];
+            const actualIndex = scrollOffset + i;
+            const isSelected = actualIndex === selectedIndex;
+            const prefix = isSelected ? s.primary('❯ ') : '  ';
+            const icon = file.isDirectory ? '📁 ' : '📄 ';
+            const name = isSelected ? s.primaryBold(file.path) : file.path;
+            const baseLen = getVisibleLength(prefix) + 3 + getVisibleLength(file.path);
+            if (baseLen > termWidth - 2) {
+                const maxLen = termWidth - getVisibleLength(prefix) - 5;
+                const truncatedPath = file.path.length > maxLen
+                    ? '…' + file.path.slice(-(maxLen - 1))
+                    : file.path;
+                const truncatedName = isSelected ? s.primaryBold(truncatedPath) : truncatedPath;
+                lines.push(`${prefix}${icon}${truncatedName}`);
+            }
+            else {
+                lines.push(`${prefix}${icon}${name}`);
+            }
+        }
+        const belowCount = total - scrollOffset - visible.length;
+        if (belowCount > 0) {
+            lines.push(s.muted(`  ↓ ${String(belowCount)} more below`));
+        }
+        return lines;
+    }
+    buildAgentLines(termWidth) {
+        if (!this.agent.active || this.agent.matches.length === 0) {
+            return [];
+        }
+        const s = getStyles();
+        const lines = [];
+        const { matches, selectedIndex, scrollOffset } = this.agent;
+        const visible = matches.slice(scrollOffset, scrollOffset + MAX_VISIBLE_COMMANDS);
+        const total = matches.length;
+        if (scrollOffset > 0) {
+            lines.push(s.muted(`  ↑ ${String(scrollOffset)} more above`));
+        }
+        for (let i = 0; i < visible.length; i++) {
+            const agentItem = visible[i];
+            const actualIndex = scrollOffset + i;
+            const isSelected = actualIndex === selectedIndex;
+            const prefix = isSelected ? s.primary('❯ ') : '  ';
+            const mascot = agentItem.mascot + ' ';
+            const name = isSelected ? s.primaryBold('$' + agentItem.id) : '$' + agentItem.id;
+            const desc = s.muted(' - ' + agentItem.displayName);
+            const baseLen = getVisibleLength(prefix) + 6 + agentItem.id.length + 3 + agentItem.displayName.length;
+            if (baseLen > termWidth - 2) {
+                const maxDescLen = termWidth - getVisibleLength(prefix) - 6 - agentItem.id.length - 5;
+                const truncatedDesc = agentItem.displayName.length > maxDescLen
+                    ? s.muted(' - ' + agentItem.displayName.slice(0, maxDescLen - 1) + '…')
+                    : desc;
+                lines.push(`${prefix}${mascot}${name}${truncatedDesc}`);
+            }
+            else {
+                lines.push(`${prefix}${mascot}${name}${desc}`);
+            }
+        }
+        const belowCount = total - scrollOffset - visible.length;
+        if (belowCount > 0) {
+            lines.push(s.muted(`  ↓ ${String(belowCount)} more below`));
+        }
+        return lines;
+    }
+}

package/dist/ui/base/index.d.ts

@@ -16,7 +16,7 @@ export { OverlayLifecycle, setupOverlay } from './overlay-lifecycle.js';
 export type { KeyHandler } from './overlay-lifecycle.js';
 export { BaseOverlay } from './overlay-base.js';
 export { BaseScreen, ScreenStack, stay, pushScreen, popScreen, closeOverlay, } from './screen-stack.js';
-export { renderBorder, wrapText, truncate, truncateAnsi, normalizeText, padToHeight, emptyLines, } from './render-utils.js';
+export { renderBorder, wrapText, truncate, truncateAnsi, normalizeText, padToHeight, emptyLines, renderProgressBar, formatTokens, } from './render-utils.js';
 export { TabbedListOverlay } from './tabbed-list-overlay.js';
 export type { TabbedListConfig, TabbedListState } from './tabbed-list-overlay.js';
 export { BaseOverlayV2 } from './overlay-base-v2.js';

package/dist/ui/base/index.js

@@ -21,7 +21,7 @@ export { BaseOverlay } from './overlay-base.js';
 // Screen stack for multi-screen overlays
 export { BaseScreen, ScreenStack, stay, pushScreen, popScreen, closeOverlay, } from './screen-stack.js';
 // Render utilities
-export { renderBorder, wrapText, truncate, truncateAnsi, normalizeText, padToHeight, emptyLines, } from './render-utils.js';
+export { renderBorder, wrapText, truncate, truncateAnsi, normalizeText, padToHeight, emptyLines, renderProgressBar, formatTokens, } from './render-utils.js';
 // Tabbed list overlay base
 export { TabbedListOverlay } from './tabbed-list-overlay.js';
 // V2 Overlay base classes (new Overlay interface)

package/dist/ui/base/overlay-base-v2.d.ts

@@ -63,12 +63,22 @@ export declare abstract class BaseOverlayV2<TState = unknown, TResult = void> im
     protected termWidth: number;
     /** Minimum height for stable rendering (prevents visual jitter) */
     protected minHeight: number;
+    /** Callback to request re-render from async operations */
+    protected renderCallback: (() => void) | null;
     /**
      * Create a new overlay instance.
      *
      * @param initialState - Initial state
      */
     constructor(initialState: TState);
+    /**
+     * Set the render callback. Called by TerminalUI when mounting.
+     */
+    setRenderCallback(callback: () => void): void;
+    /**
+     * Request a re-render. Call from async operations.
+     */
+    protected requestRender(): void;
     /**
      * Get current state.
      */

package/dist/ui/base/overlay-base-v2.js

@@ -60,6 +60,8 @@ export class BaseOverlayV2 {
     termWidth = 80;
     /** Minimum height for stable rendering (prevents visual jitter) */
     minHeight = 0;
+    /** Callback to request re-render from async operations */
+    renderCallback = null;
     /**
      * Create a new overlay instance.
      *
@@ -68,6 +70,18 @@ export class BaseOverlayV2 {
     constructor(initialState) {
         this.state = initialState;
     }
+    /**
+     * Set the render callback. Called by TerminalUI when mounting.
+     */
+    setRenderCallback(callback) {
+        this.renderCallback = callback;
+    }
+    /**
+     * Request a re-render. Call from async operations.
+     */
+    requestRender() {
+        this.renderCallback?.();
+    }
     // ===========================================================================
     // Overlay Interface Implementation
     // ===========================================================================

package/dist/ui/base/render-utils.d.ts

@@ -6,3 +6,22 @@
  */
 export { renderBorder, wrapText, truncatePlain, truncateAnsi, normalizeText, padToHeight, emptyLines, padToWidth, } from '@compilr-dev/ui-core/utils';
 export { truncatePlain as truncate } from '@compilr-dev/ui-core/utils';
+import type { ThemeStyleFunctions } from '../../themes/index.js';
+/**
+ * Render a progress bar with color coding.
+ *
+ * Color thresholds: >0.8 = error, >0.6 = warning, else success.
+ *
+ * @param ratio - Fill ratio (0-1, clamped)
+ * @param width - Width of the bar in characters
+ * @param s - Theme style functions for coloring
+ * @returns Colored bar string (no percentage text appended — caller adds if needed)
+ *
+ * @example
+ * ```ts
+ * const bar = renderProgressBar(0.75, 20, styles);
+ * // Returns: "████████████████░░░░" (colored based on ratio)
+ * ```
+ */
+export declare function renderProgressBar(ratio: number, width: number, s: ThemeStyleFunctions): string;
+export { formatTokens } from '../../utils/format-tokens.js';

package/dist/ui/base/render-utils.js

@@ -9,3 +9,28 @@ export { renderBorder, wrapText, truncatePlain, truncateAnsi, normalizeText, pad
 // (ui-core's truncate in ansi.ts is ANSI-aware with '...' suffix,
 //  CLI expects plain text truncate with '…' suffix)
 export { truncatePlain as truncate } from '@compilr-dev/ui-core/utils';
+/**
+ * Render a progress bar with color coding.
+ *
+ * Color thresholds: >0.8 = error, >0.6 = warning, else success.
+ *
+ * @param ratio - Fill ratio (0-1, clamped)
+ * @param width - Width of the bar in characters
+ * @param s - Theme style functions for coloring
+ * @returns Colored bar string (no percentage text appended — caller adds if needed)
+ *
+ * @example
+ * ```ts
+ * const bar = renderProgressBar(0.75, 20, styles);
+ * // Returns: "████████████████░░░░" (colored based on ratio)
+ * ```
+ */
+export function renderProgressBar(ratio, width, s) {
+    const clamped = Math.max(0, Math.min(1, ratio));
+    const filled = Math.round(clamped * width);
+    const empty = width - filled;
+    const colorFn = clamped > 0.8 ? s.error : clamped > 0.6 ? s.warning : s.success;
+    return colorFn('█'.repeat(filled)) + s.muted('░'.repeat(empty));
+}
+// Re-export formatTokens from utils for backward compatibility
+export { formatTokens } from '../../utils/format-tokens.js';

package/dist/ui/base/tabbed-list-overlay-v2.d.ts

@@ -50,12 +50,27 @@ export interface TabbedListConfigV2<TItem> {
     /** Custom no-results message */
     noResultsMessage?: string;
     /** Custom footer hints */
-    footerHints?: (searchMode: boolean) => string;
+    footerHints?: (searchMode: boolean, activeTabId?: string) => string;
     /**
      * Render preview content for the selected item.
      * Displayed between the list and footer.
      */
     renderSelectedPreview?: (item: TItem, styles: ThemeStyleFunctions) => string[];
+    /**
+     * Render sub-header content below the tab bar.
+     * Useful for showing status info like API key status.
+     */
+    renderSubHeader?: (tabId: string, styles: ThemeStyleFunctions) => string[];
+    /**
+     * Handle custom key presses before default handling.
+     * Return { handled: true, render: boolean } to consume the key.
+     * Return { handled: false } to let default handling proceed.
+     */
+    handleCustomKey?: (key: Buffer, tabId: string) => {
+        handled: boolean;
+        render?: boolean;
+        pushScreen?: BaseScreen;
+    };
 }
 /**
  * State for TabbedListOverlayV2.

package/dist/ui/base/tabbed-list-overlay-v2.js

@@ -91,6 +91,12 @@ class ListScreenV2 extends BaseScreen {
         const tabHint = s.muted(`(${this.tabFeature.renderHints()})`);
         lines.push(`  ${tabBar}  ${tabHint}`);
         lines.push('');
+        // Sub-header (if provided) - e.g., API key status
+        if (this.config.renderSubHeader) {
+            const tabId = this.tabFeature.getCurrentTabId(this.state);
+            const subHeaderLines = this.config.renderSubHeader(tabId, s);
+            lines.push(...subHeaderLines);
+        }
         // Search box (if in search mode)
         if (this.state.searchMode) {
             const query = this.state.searchQuery;
@@ -143,7 +149,8 @@ class ListScreenV2 extends BaseScreen {
     }
     getFooterHints() {
         if (this.config.footerHints) {
-            return this.config.footerHints(this.state.searchMode);
+            const activeTab = this.config.tabs[this.state.currentTab];
+            return this.config.footerHints(this.state.searchMode, activeTab.id);
         }
         if (this.state.searchMode) {
             return 'Type to filter · ↑↓/jk Navigate · Enter Details · Esc Exit search';
@@ -179,6 +186,17 @@ class ListScreenV2 extends BaseScreen {
             return { action: 'stay', render: false };
         }
         // Not in search mode
+        // Custom key handling (before default handling)
+        if (this.config.handleCustomKey) {
+            const tabId = this.tabFeature.getCurrentTabId(this.state);
+            const customResult = this.config.handleCustomKey(data, tabId);
+            if (customResult.handled) {
+                if (customResult.pushScreen) {
+                    return { action: 'push', screen: customResult.pushScreen };
+                }
+                return { action: 'stay', render: customResult.render ?? false };
+            }
+        }
         if (isSlash(data)) {
             this.state.searchMode = true;
             return { action: 'stay', render: true };

package/dist/ui/constants/labels.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared Label Constants
+ *
+ * Centralized display labels for domain types used across multiple overlays.
+ */
+import type { ArtifactType } from '../../multi-agent/index.js';
+import type { DocumentType, PlanStatus } from '../../db/schema.js';
+export declare const ARTIFACT_TYPE_LABELS: Record<ArtifactType, string>;
+export declare const DOC_TYPE_LABELS: Record<DocumentType, string>;
+/** Icon-only labels for compact display (e.g., list views) */
+export declare const PLAN_STATUS_ICONS: Record<PlanStatus, string>;
+/** Icon + text labels for detailed display (e.g., detail views) */
+export declare const PLAN_STATUS_LABELS: Record<PlanStatus, string>;
+export declare const PLAN_STATUS_COLORS: Record<PlanStatus, 'muted' | 'warning' | 'primary' | 'success' | 'error'>;

package/dist/ui/constants/labels.js

@@ -0,0 +1,51 @@
+/**
+ * Shared Label Constants
+ *
+ * Centralized display labels for domain types used across multiple overlays.
+ */
+// =============================================================================
+// Artifact Labels
+// =============================================================================
+export const ARTIFACT_TYPE_LABELS = {
+    'design': 'DESIGN',
+    'plan': 'PLAN',
+    'review': 'REVIEW',
+    'decision': 'DECISION',
+    'note': 'NOTE',
+};
+// =============================================================================
+// Document Labels
+// =============================================================================
+export const DOC_TYPE_LABELS = {
+    'prd': 'PRD',
+    'architecture': 'ARCH',
+    'design': 'DESIGN',
+    'notes': 'NOTES',
+    'plan': 'PLAN',
+};
+// =============================================================================
+// Plan Status Labels
+// =============================================================================
+/** Icon-only labels for compact display (e.g., list views) */
+export const PLAN_STATUS_ICONS = {
+    'draft': '○',
+    'approved': '◐',
+    'in_progress': '◑',
+    'completed': '●',
+    'abandoned': '✗',
+};
+/** Icon + text labels for detailed display (e.g., detail views) */
+export const PLAN_STATUS_LABELS = {
+    'draft': '○ Draft',
+    'approved': '◐ Approved',
+    'in_progress': '◑ In Progress',
+    'completed': '● Completed',
+    'abandoned': '✗ Abandoned',
+};
+export const PLAN_STATUS_COLORS = {
+    'draft': 'muted',
+    'approved': 'warning',
+    'in_progress': 'primary',
+    'completed': 'success',
+    'abandoned': 'error',
+};