@specforge/mcp 2.0.9 → 2.1.0

package/dist/cli/ui/output.js

@@ -0,0 +1,172 @@
+/**
+ * Output Formatting Utilities
+ *
+ * Provides consistent output formatting for tables, lists, and structured data.
+ */
+import { colors, style, icons } from './colors.js';
+/**
+ * Print a labeled value
+ *
+ * @example
+ * printField('Project', 'my-project');
+ * // Output: Project: my-project
+ */
+export function printField(label, value) {
+    const displayValue = value ?? colors.muted('(not set)');
+    console.log(`${style.label(label)}: ${displayValue}`);
+}
+/**
+ * Print a section header
+ *
+ * @example
+ * printHeader('Configuration');
+ * // Output:
+ * // Configuration
+ * // ─────────────
+ */
+export function printHeader(title) {
+    console.log();
+    console.log(style.label(title));
+    console.log(colors.muted('─'.repeat(title.length)));
+}
+/**
+ * Print a blank line
+ */
+export function printBlank() {
+    console.log();
+}
+/**
+ * Print a list of items
+ *
+ * @example
+ * printList(['Item 1', 'Item 2', 'Item 3']);
+ * // Output:
+ * // • Item 1
+ * // • Item 2
+ * // • Item 3
+ */
+export function printList(items, bullet = icons.bullet) {
+    for (const item of items) {
+        console.log(`  ${bullet} ${item}`);
+    }
+}
+/**
+ * Print a success message
+ *
+ * @example
+ * printSuccess('Configuration saved');
+ * // Output: ✓ Configuration saved
+ */
+export function printSuccess(message) {
+    console.log(`${icons.success} ${message}`);
+}
+/**
+ * Print an error message
+ *
+ * @example
+ * printError('Failed to connect');
+ * // Output: ✗ Failed to connect
+ */
+export function printError(message) {
+    console.error(`${icons.error} ${style.err(message)}`);
+}
+/**
+ * Print a warning message
+ *
+ * @example
+ * printWarning('API key will expire soon');
+ * // Output: ⚠ API key will expire soon
+ */
+export function printWarning(message) {
+    console.error(`${icons.warning} ${style.warn(message)}`);
+}
+/**
+ * Print an info message
+ *
+ * @example
+ * printInfo('Fetching data...');
+ * // Output: ℹ Fetching data...
+ */
+export function printInfo(message) {
+    console.log(`${icons.info} ${message}`);
+}
+/**
+ * Print a key-value table
+ *
+ * @example
+ * printTable({
+ *   'Project': 'my-project',
+ *   'Specification': 'v2.0',
+ *   'Status': 'active',
+ * });
+ */
+export function printTable(data) {
+    const maxKeyLength = Math.max(...Object.keys(data).map(k => k.length));
+    for (const [key, value] of Object.entries(data)) {
+        const paddedKey = key.padEnd(maxKeyLength);
+        const displayValue = value ?? colors.muted('(not set)');
+        console.log(`  ${style.label(paddedKey)}  ${displayValue}`);
+    }
+}
+/**
+ * Print JSON output (for --format json)
+ *
+ * @example
+ * printJson({ project: 'my-project', status: 'active' });
+ */
+export function printJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+/**
+ * Print a command hint
+ *
+ * @example
+ * printHint('specforge-mcp init', 'Initialize project');
+ * // Output: → Run `specforge-mcp init` to initialize project
+ */
+export function printHint(command, description) {
+    console.log(`${icons.arrow} Run ${style.command(command)} to ${description}`);
+}
+/**
+ * Print a URL with description
+ *
+ * @example
+ * printLink('https://specforge.com', 'Visit documentation');
+ * // Output: → Visit documentation: https://specforge.com
+ */
+export function printLink(url, description) {
+    console.log(`${icons.arrow} ${description}: ${style.url(url)}`);
+}
+/**
+ * Format bytes to human readable size
+ */
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return `${(bytes / Math.pow(1024, i)).toFixed(1)} ${units[i]}`;
+}
+/**
+ * Format duration in milliseconds to human readable
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    if (ms < 3600000)
+        return `${Math.floor(ms / 60000)}m ${Math.floor((ms % 60000) / 1000)}s`;
+    const hours = Math.floor(ms / 3600000);
+    const minutes = Math.floor((ms % 3600000) / 60000);
+    return `${hours}h ${minutes}m`;
+}
+/**
+ * Truncate string with ellipsis
+ */
+export function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength - 1) + '…';
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/ui/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/cli/ui/output.ts"],"names":[],"mappings":"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"}

package/dist/cli/ui/spinner.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Loading Spinner Utilities
+ *
+ * Wraps ora spinner with consistent styling and error handling.
+ */
+import { Ora } from 'ora';
+/**
+ * Spinner instance type
+ */
+export type Spinner = Ora;
+/**
+ * Create a new spinner with consistent styling
+ *
+ * @param text - Initial spinner text
+ * @returns Spinner instance
+ *
+ * @example
+ * ```typescript
+ * const spinner = createSpinner('Loading...');
+ * spinner.start();
+ *
+ * try {
+ *   await doAsyncWork();
+ *   spinner.succeed('Done!');
+ * } catch (error) {
+ *   spinner.fail('Failed');
+ * }
+ * ```
+ */
+export declare function createSpinner(text: string): Spinner;
+/**
+ * Run an async function with a spinner
+ *
+ * Automatically handles success/failure states.
+ *
+ * @param text - Spinner text while running
+ * @param fn - Async function to run
+ * @param successText - Text to show on success (optional)
+ * @returns Result of the async function
+ *
+ * @example
+ * ```typescript
+ * const data = await withSpinner(
+ *   'Fetching tickets...',
+ *   async () => await api.getTickets(),
+ *   'Tickets loaded'
+ * );
+ * ```
+ */
+export declare function withSpinner<T>(text: string, fn: () => Promise<T>, successText?: string): Promise<T>;
+/**
+ * Run multiple async operations with progress
+ *
+ * @param operations - Array of operations with labels
+ * @returns Array of results
+ *
+ * @example
+ * ```typescript
+ * const results = await withProgress([
+ *   { label: 'Loading config', fn: loadConfig },
+ *   { label: 'Fetching data', fn: fetchData },
+ *   { label: 'Processing', fn: process },
+ * ]);
+ * ```
+ */
+export declare function withProgress<T>(operations: Array<{
+    label: string;
+    fn: () => Promise<T>;
+}>): Promise<T[]>;
+/**
+ * Create a manual spinner for custom control
+ *
+ * @param text - Initial text
+ * @returns Object with spinner control methods
+ *
+ * @example
+ * ```typescript
+ * const { start, update, succeed, fail } = manualSpinner('Loading');
+ *
+ * start();
+ * update('Loading step 1...');
+ * update('Loading step 2...');
+ * succeed('All loaded');
+ * ```
+ */
+export declare function manualSpinner(text: string): {
+    start: () => Ora;
+    stop: () => Ora;
+    update: (newText: string) => void;
+    succeed: (finalText?: string) => void;
+    fail: (finalText?: string) => void;
+    warn: (finalText?: string) => void;
+    info: (finalText?: string) => void;
+};
+/**
+ * Check if spinners should be disabled (non-TTY)
+ */
+export declare function shouldDisableSpinner(): boolean;
+/**
+ * Simple progress indicator for non-TTY environments
+ *
+ * @param text - Progress text
+ */
+export declare function progressLog(text: string): void;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/cli/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG/B;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC;AAE1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,GACzD,OAAO,CAAC,CAAC,EAAE,CAAC,CAad;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM;;;sBAMpB,MAAM;0BAGF,MAAM;uBAGT,MAAM;uBAGN,MAAM;uBAGN,MAAM;EAI5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO9C"}

package/dist/cli/ui/spinner.js

@@ -0,0 +1,148 @@
+/**
+ * Loading Spinner Utilities
+ *
+ * Wraps ora spinner with consistent styling and error handling.
+ */
+import ora from 'ora';
+import { icons } from './colors.js';
+/**
+ * Create a new spinner with consistent styling
+ *
+ * @param text - Initial spinner text
+ * @returns Spinner instance
+ *
+ * @example
+ * ```typescript
+ * const spinner = createSpinner('Loading...');
+ * spinner.start();
+ *
+ * try {
+ *   await doAsyncWork();
+ *   spinner.succeed('Done!');
+ * } catch (error) {
+ *   spinner.fail('Failed');
+ * }
+ * ```
+ */
+export function createSpinner(text) {
+    return ora({
+        text,
+        color: 'cyan',
+        spinner: 'dots',
+    });
+}
+/**
+ * Run an async function with a spinner
+ *
+ * Automatically handles success/failure states.
+ *
+ * @param text - Spinner text while running
+ * @param fn - Async function to run
+ * @param successText - Text to show on success (optional)
+ * @returns Result of the async function
+ *
+ * @example
+ * ```typescript
+ * const data = await withSpinner(
+ *   'Fetching tickets...',
+ *   async () => await api.getTickets(),
+ *   'Tickets loaded'
+ * );
+ * ```
+ */
+export async function withSpinner(text, fn, successText) {
+    const spinner = createSpinner(text);
+    spinner.start();
+    try {
+        const result = await fn();
+        spinner.succeed(successText || text.replace(/\.{3}$/, ''));
+        return result;
+    }
+    catch (error) {
+        spinner.fail(text.replace(/\.{3}$/, ' failed'));
+        throw error;
+    }
+}
+/**
+ * Run multiple async operations with progress
+ *
+ * @param operations - Array of operations with labels
+ * @returns Array of results
+ *
+ * @example
+ * ```typescript
+ * const results = await withProgress([
+ *   { label: 'Loading config', fn: loadConfig },
+ *   { label: 'Fetching data', fn: fetchData },
+ *   { label: 'Processing', fn: process },
+ * ]);
+ * ```
+ */
+export async function withProgress(operations) {
+    const results = [];
+    for (let i = 0; i < operations.length; i++) {
+        const { label, fn } = operations[i];
+        const progress = `[${i + 1}/${operations.length}]`;
+        const text = `${progress} ${label}...`;
+        const result = await withSpinner(text, fn);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Create a manual spinner for custom control
+ *
+ * @param text - Initial text
+ * @returns Object with spinner control methods
+ *
+ * @example
+ * ```typescript
+ * const { start, update, succeed, fail } = manualSpinner('Loading');
+ *
+ * start();
+ * update('Loading step 1...');
+ * update('Loading step 2...');
+ * succeed('All loaded');
+ * ```
+ */
+export function manualSpinner(text) {
+    const spinner = createSpinner(text);
+    return {
+        start: () => spinner.start(),
+        stop: () => spinner.stop(),
+        update: (newText) => {
+            spinner.text = newText;
+        },
+        succeed: (finalText) => {
+            spinner.succeed(finalText);
+        },
+        fail: (finalText) => {
+            spinner.fail(finalText);
+        },
+        warn: (finalText) => {
+            spinner.warn(finalText);
+        },
+        info: (finalText) => {
+            spinner.info(finalText);
+        },
+    };
+}
+/**
+ * Check if spinners should be disabled (non-TTY)
+ */
+export function shouldDisableSpinner() {
+    return !process.stdout.isTTY;
+}
+/**
+ * Simple progress indicator for non-TTY environments
+ *
+ * @param text - Progress text
+ */
+export function progressLog(text) {
+    if (process.stdout.isTTY) {
+        // In TTY, use spinner instead
+        return;
+    }
+    console.log(`${icons.running} ${text}`);
+}
+//# sourceMappingURL=spinner.js.map

package/dist/cli/ui/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../../src/cli/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,GAAY,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAU,KAAK,EAAE,MAAM,aAAa,CAAC;AAO5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,GAAG,CAAC;QACT,IAAI;QACJ,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,EAAoB,EACpB,WAAoB;IAEpB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAA0D;IAE1D,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QACnD,MAAM,IAAI,GAAG,GAAG,QAAQ,IAAI,KAAK,KAAK,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEpC,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE;QAC1B,MAAM,EAAE,CAAC,OAAe,EAAE,EAAE;YAC1B,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,CAAC,SAAkB,EAAE,EAAE;YAC9B,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,EAAE,CAAC,SAAkB,EAAE,EAAE;YAC3B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,EAAE,CAAC,SAAkB,EAAE,EAAE;YAC3B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,EAAE,CAAC,SAAkB,EAAE,EAAE;YAC3B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACzB,8BAA8B;QAC9B,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/cli/ui/time.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Time Utilities
+ *
+ * Formatting utilities for time display in CLI output.
+ */
+/**
+ * Format ISO timestamp to relative time string
+ *
+ * Examples:
+ * - "just now" (< 1 minute)
+ * - "5m ago" (minutes)
+ * - "2h ago" (hours)
+ * - "3 days ago" (days)
+ * - "2 weeks ago" (weeks)
+ * - "1 month ago" (months)
+ * - "1 year ago" (years)
+ *
+ * @param isoString ISO 8601 timestamp string
+ * @returns Human-readable relative time
+ */
+export declare function formatRelativeTime(isoString: string): string;
+/**
+ * Format duration between two timestamps
+ *
+ * @param startIso Start timestamp (ISO 8601)
+ * @param endIso End timestamp (ISO 8601), defaults to now
+ * @returns Human-readable duration string
+ */
+export declare function formatDuration(startIso: string, endIso?: string): string;
+/**
+ * Format a timestamp for display
+ *
+ * @param isoString ISO 8601 timestamp string
+ * @param format Output format: 'relative', 'short', 'long'
+ * @returns Formatted time string
+ */
+export declare function formatTimestamp(isoString: string, format?: 'relative' | 'short' | 'long'): string;
+/**
+ * Check if a timestamp is within a given time window
+ *
+ * @param isoString ISO 8601 timestamp string
+ * @param windowMs Time window in milliseconds
+ * @returns True if within window
+ */
+export declare function isWithinTimeWindow(isoString: string, windowMs: number): boolean;
+/**
+ * Get "time ago" for session display
+ * Similar to formatRelativeTime but more compact
+ *
+ * @param isoString ISO 8601 timestamp string
+ * @returns Compact relative time (e.g., "2h 15m ago")
+ */
+export declare function formatTimeAgo(isoString: string): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/cli/ui/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAgD5D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BxE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,UAAU,GAAG,OAAO,GAAG,MAAmB,GACjD,MAAM,CA6BR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK/E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA0BvD"}

package/dist/cli/ui/time.js

@@ -0,0 +1,173 @@
+/**
+ * Time Utilities
+ *
+ * Formatting utilities for time display in CLI output.
+ */
+/**
+ * Time unit thresholds in milliseconds
+ */
+const MS_PER_MINUTE = 60 * 1000;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+const MS_PER_WEEK = 7 * MS_PER_DAY;
+const MS_PER_MONTH = 30 * MS_PER_DAY;
+const MS_PER_YEAR = 365 * MS_PER_DAY;
+/**
+ * Format ISO timestamp to relative time string
+ *
+ * Examples:
+ * - "just now" (< 1 minute)
+ * - "5m ago" (minutes)
+ * - "2h ago" (hours)
+ * - "3 days ago" (days)
+ * - "2 weeks ago" (weeks)
+ * - "1 month ago" (months)
+ * - "1 year ago" (years)
+ *
+ * @param isoString ISO 8601 timestamp string
+ * @returns Human-readable relative time
+ */
+export function formatRelativeTime(isoString) {
+    const date = new Date(isoString);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    // Handle future dates
+    if (diffMs < 0) {
+        return 'in the future';
+    }
+    // Just now (< 1 minute)
+    if (diffMs < MS_PER_MINUTE) {
+        return 'just now';
+    }
+    // Minutes
+    if (diffMs < MS_PER_HOUR) {
+        const minutes = Math.floor(diffMs / MS_PER_MINUTE);
+        return `${minutes}m ago`;
+    }
+    // Hours
+    if (diffMs < MS_PER_DAY) {
+        const hours = Math.floor(diffMs / MS_PER_HOUR);
+        return `${hours}h ago`;
+    }
+    // Days
+    if (diffMs < MS_PER_WEEK) {
+        const days = Math.floor(diffMs / MS_PER_DAY);
+        return days === 1 ? '1 day ago' : `${days} days ago`;
+    }
+    // Weeks
+    if (diffMs < MS_PER_MONTH) {
+        const weeks = Math.floor(diffMs / MS_PER_WEEK);
+        return weeks === 1 ? '1 week ago' : `${weeks} weeks ago`;
+    }
+    // Months
+    if (diffMs < MS_PER_YEAR) {
+        const months = Math.floor(diffMs / MS_PER_MONTH);
+        return months === 1 ? '1 month ago' : `${months} months ago`;
+    }
+    // Years
+    const years = Math.floor(diffMs / MS_PER_YEAR);
+    return years === 1 ? '1 year ago' : `${years} years ago`;
+}
+/**
+ * Format duration between two timestamps
+ *
+ * @param startIso Start timestamp (ISO 8601)
+ * @param endIso End timestamp (ISO 8601), defaults to now
+ * @returns Human-readable duration string
+ */
+export function formatDuration(startIso, endIso) {
+    const start = new Date(startIso);
+    const end = endIso ? new Date(endIso) : new Date();
+    const diffMs = end.getTime() - start.getTime();
+    if (diffMs < 0) {
+        return '0m';
+    }
+    const days = Math.floor(diffMs / MS_PER_DAY);
+    const hours = Math.floor((diffMs % MS_PER_DAY) / MS_PER_HOUR);
+    const minutes = Math.floor((diffMs % MS_PER_HOUR) / MS_PER_MINUTE);
+    if (days > 0) {
+        return `${days}d ${hours}h`;
+    }
+    if (hours > 0) {
+        return `${hours}h ${minutes}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m`;
+    }
+    return 'just started';
+}
+/**
+ * Format a timestamp for display
+ *
+ * @param isoString ISO 8601 timestamp string
+ * @param format Output format: 'relative', 'short', 'long'
+ * @returns Formatted time string
+ */
+export function formatTimestamp(isoString, format = 'relative') {
+    const date = new Date(isoString);
+    switch (format) {
+        case 'relative':
+            return formatRelativeTime(isoString);
+        case 'short':
+            // e.g., "Jan 15, 2:30 PM"
+            return date.toLocaleString('en-US', {
+                month: 'short',
+                day: 'numeric',
+                hour: 'numeric',
+                minute: '2-digit',
+            });
+        case 'long':
+            // e.g., "January 15, 2024 at 2:30 PM"
+            return date.toLocaleString('en-US', {
+                year: 'numeric',
+                month: 'long',
+                day: 'numeric',
+                hour: 'numeric',
+                minute: '2-digit',
+            });
+        default:
+            return formatRelativeTime(isoString);
+    }
+}
+/**
+ * Check if a timestamp is within a given time window
+ *
+ * @param isoString ISO 8601 timestamp string
+ * @param windowMs Time window in milliseconds
+ * @returns True if within window
+ */
+export function isWithinTimeWindow(isoString, windowMs) {
+    const date = new Date(isoString);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    return diffMs >= 0 && diffMs <= windowMs;
+}
+/**
+ * Get "time ago" for session display
+ * Similar to formatRelativeTime but more compact
+ *
+ * @param isoString ISO 8601 timestamp string
+ * @returns Compact relative time (e.g., "2h 15m ago")
+ */
+export function formatTimeAgo(isoString) {
+    const date = new Date(isoString);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    if (diffMs < 0) {
+        return 'in the future';
+    }
+    if (diffMs < MS_PER_MINUTE) {
+        return 'just now';
+    }
+    const days = Math.floor(diffMs / MS_PER_DAY);
+    const hours = Math.floor((diffMs % MS_PER_DAY) / MS_PER_HOUR);
+    const minutes = Math.floor((diffMs % MS_PER_HOUR) / MS_PER_MINUTE);
+    if (days > 0) {
+        return `${days}d ${hours}h ago`;
+    }
+    if (hours > 0) {
+        return `${hours}h ${minutes}m ago`;
+    }
+    return `${minutes}m ago`;
+}
+//# sourceMappingURL=time.js.map

package/dist/cli/ui/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/cli/ui/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC;AAChC,MAAM,WAAW,GAAG,EAAE,GAAG,aAAa,CAAC;AACvC,MAAM,UAAU,GAAG,EAAE,GAAG,WAAW,CAAC;AACpC,MAAM,WAAW,GAAG,CAAC,GAAG,UAAU,CAAC;AACnC,MAAM,YAAY,GAAG,EAAE,GAAG,UAAU,CAAC;AACrC,MAAM,WAAW,GAAG,GAAG,GAAG,UAAU,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAE9C,sBAAsB;IACtB,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAM,GAAG,aAAa,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,UAAU;IACV,IAAI,MAAM,GAAG,WAAW,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;QACnD,OAAO,GAAG,OAAO,OAAO,CAAC;IAC3B,CAAC;IAED,QAAQ;IACR,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAC/C,OAAO,GAAG,KAAK,OAAO,CAAC;IACzB,CAAC;IAED,OAAO;IACP,IAAI,MAAM,GAAG,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;QAC7C,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,CAAC;IACvD,CAAC;IAED,QAAQ;IACR,IAAI,MAAM,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAC/C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC;IAC3D,CAAC;IAED,SAAS;IACT,IAAI,MAAM,GAAG,WAAW,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;QACjD,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,aAAa,CAAC;IAC/D,CAAC;IAED,QAAQ;IACR,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IAC/C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,MAAe;IAC9D,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAE/C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,WAAW,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,aAAa,CAAC,CAAC;IAEnE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,CAAC;IACjC,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,OAAO,GAAG,CAAC;IACvB,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,SAAwC,UAAU;IAElD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IAEjC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAEvC,KAAK,OAAO;YACV,0BAA0B;YAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;gBAClC,KAAK,EAAE,OAAO;gBACd,GAAG,EAAE,SAAS;gBACd,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QAEL,KAAK,MAAM;YACT,sCAAsC;YACtC,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;gBAClC,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,MAAM;gBACb,GAAG,EAAE,SAAS;gBACd,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QAEL;YACE,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAgB;IACpE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9C,OAAO,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,QAAQ,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAE9C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,MAAM,GAAG,aAAa,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,WAAW,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,aAAa,CAAC,CAAC;IAEnE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,KAAK,KAAK,OAAO,CAAC;IAClC,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,KAAK,OAAO,OAAO,CAAC;IACrC,CAAC;IAED,OAAO,GAAG,OAAO,OAAO,CAAC;AAC3B,CAAC"}