@chude/memory 4.0.0

package/dist/presentation/cli/formatters/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI Formatters Barrel Export
+ *
+ * Output formatting utilities for CLI commands.
+ */
+export { formatTimestamp, formatRelativeTime, formatAbsoluteTime, } from "./timestamp-formatter.js";
+export { shouldUseColor, bold, dim, green, red, yellow, type ColorOptions, } from "./color.js";
+export { createOutputFormatter, CONTEXT_BUDGET, type OutputMode, type FormatOptions, type ExecutionDetails, type SummaryStats, type OutputFormatter, } from "./output-formatter.js";
+export { createListFormatter, type ListOutputMode, type ListFormatOptions, type ListFormatter, } from "./list-formatter.js";
+export { createStatsFormatter, type StatsOutputMode, type StatsFormatOptions, type StatsFormatter, } from "./stats-formatter.js";
+export { createContextFormatter, type ContextOutputMode, type ContextFormatOptions, type ContextFormatter, } from "./context-formatter.js";
+export { createRelatedFormatter, type RelatedOutputMode, type RelatedFormatOptions, type RelatedFormatter, type RelatedSession, } from "./related-formatter.js";
+export { createShowFormatter, summarizeToolResult, type ShowOutputMode, type SessionDetail, type ShowFormatOptions, type ShowFormatter, } from "./show-formatter.js";
+export { formatError, formatErrorJson, getSuggestion, type ErrorFormatOptions, } from "./error-formatter.js";
+export { formatFrictionDashboard, generateFrictionHtml, } from "./friction-dashboard.js";
+export { stripAnsi, estimateTokens, formatForAi, } from "./ai-formatter.js";
+export { ENVELOPE_SCHEMA_VERSION, QUERY_COMMAND_NAMES, QUERY_RESULT_KINDS, buildEnvelope, buildErrorEnvelope, emitJsonEnvelope, emitJsonErrorEnvelope, type QueryCommandName, type QueryResultKind, type EnvelopeScope, type QueryResultEnvelope, type QueryErrorEnvelope, } from "./envelope.js";

package/dist/presentation/cli/formatters/list-formatter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * List Formatter
+ *
+ * Strategy pattern for formatting session list results.
+ * Supports default, JSON, quiet, and verbose output modes.
+ */
+import type { Session } from "../../../domain/entities/session.js";
+/**
+ * Output mode for list formatter.
+ *
+ * Phase 32 (CLI-03) extension: `brief` produces single-line-per-session
+ * output for AI/script consumption. See {@link BriefListFormatter}.
+ */
+export type ListOutputMode = "default" | "json" | "quiet" | "verbose" | "brief";
+/**
+ * Options for formatting session list.
+ */
+export interface ListFormatOptions {
+    /** Execution time in milliseconds */
+    executionTimeMs?: number;
+    /** List of filters that were applied */
+    filtersApplied?: string[];
+}
+/**
+ * List formatter interface.
+ */
+export interface ListFormatter {
+    /**
+     * Format sessions for display.
+     */
+    formatSessions(sessions: Session[], options?: ListFormatOptions): string;
+    /**
+     * Format an error message.
+     */
+    formatError(error: Error): string;
+    /**
+     * Format empty result message.
+     */
+    formatEmpty(): string;
+}
+/**
+ * Create a list formatter for the given mode.
+ *
+ * @param mode Output mode
+ * @param useColor Whether to use ANSI colors
+ * @returns ListFormatter instance
+ */
+export declare function createListFormatter(mode: ListOutputMode, useColor: boolean): ListFormatter;

package/dist/presentation/cli/formatters/output-formatter.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Output Formatter
+ *
+ * Strategy pattern for formatting search results.
+ * Supports default, JSON, quiet, and verbose output modes.
+ * JSON mode supports hybrid search metadata envelope (additive, backward-compatible).
+ */
+import type { SearchResult } from "../../../domain/value-objects/search-result.js";
+/**
+ * Context budget for Claude consumption (50K characters).
+ */
+export declare const CONTEXT_BUDGET = 50000;
+/**
+ * Output mode enum.
+ *
+ * Phase 32 (CLI-03) extension: `brief` produces single-line-per-record
+ * output for AI/script consumption. See {@link BriefOutputFormatter}.
+ */
+export type OutputMode = "default" | "json" | "quiet" | "verbose" | "brief";
+/**
+ * Execution details for verbose mode.
+ */
+export interface ExecutionDetails {
+    timeMs?: number;
+    ftsQuery?: string;
+    filtersApplied?: string[];
+}
+/**
+ * Hybrid search metadata for output formatting.
+ * Re-exported from HybridSearchService for formatter consumption.
+ */
+export interface SearchMetaInfo {
+    /** The effective search mode used */
+    mode: string;
+    /** Reason for the mode selection */
+    modeReason: string;
+    /** Whether the search degraded from requested mode */
+    degraded: boolean;
+    /** Reason for degradation, if any */
+    degradationReason?: string | undefined;
+    /** Fraction of messages with embeddings (0-1) */
+    embeddingCoverage: number;
+    /** System capabilities for this search */
+    capabilities: {
+        fts: boolean;
+        vector: boolean;
+        hybrid: boolean;
+    };
+    /** Total search time in milliseconds */
+    timingMs: number;
+}
+/**
+ * Options for formatting results.
+ */
+export interface FormatOptions {
+    query?: string | undefined;
+    executionDetails?: ExecutionDetails | undefined;
+    contextBudget?: number | undefined;
+    /** Hybrid search metadata (additive: when absent, output is backward-compatible) */
+    searchMeta?: SearchMetaInfo | undefined;
+}
+/**
+ * Summary statistics.
+ */
+export interface SummaryStats {
+    found: number;
+    shown: number;
+    truncated?: boolean;
+}
+/**
+ * Output formatter interface.
+ */
+export interface OutputFormatter {
+    formatResults(results: SearchResult[], options?: FormatOptions): string;
+    formatError(error: Error): string;
+    formatSummary(stats: SummaryStats): string;
+}
+/**
+ * Create an output formatter for the given mode.
+ *
+ * @param mode Output mode
+ * @param useColor Whether to use ANSI colors
+ * @returns OutputFormatter instance
+ */
+export declare function createOutputFormatter(mode: OutputMode, useColor: boolean): OutputFormatter;
+/**
+ * Extract highlight positions from a snippet containing <mark> tags.
+ *
+ * Parses <mark>...</mark> tags and returns offset/length pairs
+ * relative to the clean (tag-free) text.
+ *
+ * @param snippet Raw snippet with <mark> tags
+ * @returns Array of { offset, length } highlight positions
+ */
+export declare function extractHighlights(snippet: string): Array<{
+    offset: number;
+    length: number;
+}>;

package/dist/presentation/cli/formatters/related-formatter.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Related Formatter
+ *
+ * Strategy pattern for formatting related sessions output.
+ * Supports default, brief, detailed, JSON, quiet, and verbose output modes.
+ */
+import type { Session } from "../../../domain/entities/session.js";
+/**
+ * Output mode for related formatter.
+ */
+export type RelatedOutputMode = "default" | "json" | "brief" | "detailed" | "quiet" | "verbose";
+/**
+ * A session with its relationship weight and hop count.
+ */
+export interface RelatedSession {
+    session: Session;
+    weight: number;
+    hops: number;
+}
+/**
+ * Options for formatting related sessions.
+ */
+export interface RelatedFormatOptions {
+    /** The source ID used for the query */
+    sourceId: string;
+    /** Execution time in milliseconds */
+    executionTimeMs?: number;
+}
+/**
+ * Related formatter interface.
+ */
+export interface RelatedFormatter {
+    /**
+     * Format related sessions for display.
+     */
+    formatRelated(sessions: RelatedSession[], options?: RelatedFormatOptions): string;
+    /**
+     * Format an error message.
+     */
+    formatError(error: Error): string;
+    /**
+     * Format empty result message (no relationships found for ID).
+     */
+    formatEmpty(sourceId: string): string;
+    /**
+     * Format message when links table is empty.
+     */
+    formatNoLinks(): string;
+}
+/**
+ * Create a related formatter for the given mode.
+ *
+ * @param mode Output mode
+ * @param useColor Whether to use ANSI colors
+ * @returns RelatedFormatter instance
+ */
+export declare function createRelatedFormatter(mode: RelatedOutputMode, useColor: boolean): RelatedFormatter;

package/dist/presentation/cli/formatters/show-formatter.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Show Formatter
+ *
+ * Strategy pattern for formatting session detail with conversation thread display.
+ * Supports default, JSON, quiet, verbose, and tools output modes.
+ */
+import type { Session } from "../../../domain/entities/session.js";
+import type { Message } from "../../../domain/entities/message.js";
+import type { ToolUse } from "../../../domain/entities/tool-use.js";
+/**
+ * Output mode for show formatter.
+ *
+ * Phase 32 (CLI-03) extension: `brief` produces single-line session
+ * header for AI/script consumption. See {@link BriefShowFormatter}.
+ */
+export type ShowOutputMode = "default" | "json" | "quiet" | "verbose" | "tools" | "brief";
+/**
+ * Session detail containing session, messages, and tool uses.
+ */
+export interface SessionDetail {
+    session: Session;
+    messages: Message[];
+    toolUses: Map<string, ToolUse>;
+}
+/**
+ * Options for formatting session detail.
+ */
+export interface ShowFormatOptions {
+    /** Execution time in milliseconds */
+    executionTimeMs?: number;
+}
+/**
+ * Show formatter interface.
+ */
+export interface ShowFormatter {
+    /**
+     * Format session detail for display.
+     */
+    formatSession(detail: SessionDetail, options?: ShowFormatOptions): string;
+    /**
+     * Format an error message.
+     */
+    formatError(error: Error): string;
+    /**
+     * Format session not found message.
+     */
+    formatNotFound(sessionId: string): string;
+}
+/**
+ * Create a show formatter for the given mode.
+ *
+ * @param mode Output mode
+ * @param useColor Whether to use ANSI colors
+ * @returns ShowFormatter instance
+ */
+export declare function createShowFormatter(mode: ShowOutputMode, useColor: boolean): ShowFormatter;
+/**
+ * Summarize a tool result for inline display.
+ *
+ * @param tool Tool use to summarize
+ * @returns Brief summary string
+ */
+export declare function summarizeToolResult(tool: ToolUse): string;

package/dist/presentation/cli/formatters/stats-formatter.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Stats Formatter
+ *
+ * Strategy pattern for formatting stats results.
+ * Supports default, JSON, quiet, and verbose output modes.
+ */
+import type { StatsResult } from "../../../domain/ports/services.js";
+/**
+ * Output mode for stats formatting.
+ *
+ * Phase 32 (CLI-03) extension: `brief` produces top-line counters only,
+ * bounded to <=5 lines (W5 / Pitfall 4 Option A). See
+ * {@link BriefStatsFormatter}.
+ */
+export type StatsOutputMode = "default" | "json" | "quiet" | "verbose" | "brief";
+/**
+ * Hook status summary for stats display.
+ */
+export interface HooksSummary {
+    /** Hooks are installed in Claude Code */
+    installed: boolean;
+    /** Auto-sync is enabled in config */
+    autoSync: boolean;
+    /** Number of sessions not yet synced */
+    pendingSessions: number;
+}
+/**
+ * Extended stats result with optional hook summary.
+ */
+export interface ExtendedStatsResult extends StatsResult {
+    hooks?: HooksSummary;
+}
+/**
+ * Options for formatting stats.
+ */
+export interface StatsFormatOptions {
+    executionTimeMs?: number;
+}
+/**
+ * Stats formatter interface.
+ */
+export interface StatsFormatter {
+    formatStats(stats: ExtendedStatsResult, options?: StatsFormatOptions): string;
+    formatError(error: Error): string;
+    formatEmpty(): string;
+}
+/**
+ * Create a stats formatter for the given mode.
+ *
+ * @param mode Output mode
+ * @param useColor Whether to use ANSI colors
+ * @returns StatsFormatter instance
+ */
+export declare function createStatsFormatter(mode: StatsOutputMode, useColor: boolean): StatsFormatter;

package/dist/presentation/cli/formatters/text-width.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Text Width Utilities
+ *
+ * Width-aware string measurement, truncation, and padding.
+ * Uses string-width for accurate display width calculation that accounts
+ * for CJK double-width characters, emoji, and ANSI escape codes.
+ */
+/**
+ * Measure the visual display width of a string.
+ * Accounts for CJK double-width characters, emoji, and ANSI escape codes.
+ */
+export declare function measureWidth(text: string): number;
+/**
+ * Truncate a string to fit within a maximum visual width.
+ * Appends "..." if truncation occurs. Returns original string if it fits.
+ */
+export declare function truncateToWidth(text: string, maxWidth: number): string;
+/**
+ * Pad a string with spaces to reach a target visual width.
+ * If the string is already at or beyond the target, return it unchanged.
+ */
+export declare function padToWidth(text: string, targetWidth: number): string;
+/**
+ * Get the current terminal width, falling back to 80 columns.
+ * Returns 80 in non-TTY environments (piped output, CI).
+ */
+export declare function getTerminalWidth(): number;
+/**
+ * Truncate text to fit within the terminal width minus a prefix.
+ * Derives the available width from the actual prefix string to avoid
+ * coupling between indent characters and a hardcoded number.
+ *
+ * @param text The text to potentially truncate
+ * @param prefix The literal prefix string (e.g., "   ") used to compute available width
+ * @param minWidth Minimum width to allow (prevents degenerate truncation on tiny terminals)
+ */
+export declare function truncateForTerminal(text: string, prefix: string, minWidth?: number): string;

package/dist/presentation/cli/formatters/timestamp-formatter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Timestamp Formatter
+ *
+ * Formats timestamps with both relative and absolute components.
+ * Uses Intl.RelativeTimeFormat for localized relative time display.
+ */
+/**
+ * Format a date as relative time (e.g., "2 days ago", "yesterday").
+ *
+ * Automatically selects the appropriate unit:
+ * - < 1 hour: minutes
+ * - < 1 day: hours
+ * - < 1 week: days
+ * - < 1 month: weeks
+ * - >= 1 month: months
+ *
+ * @param date Date to format
+ * @param reference Reference date (defaults to now)
+ * @returns Relative time string
+ */
+export declare function formatRelativeTime(date: Date, reference?: Date): string;
+/**
+ * Format a date as absolute time (YYYY-MM-DD HH:mm).
+ *
+ * @param date Date to format
+ * @returns Absolute time string
+ */
+export declare function formatAbsoluteTime(date: Date): string;
+/**
+ * Format a timestamp with both relative and absolute components.
+ *
+ * Output format: "2 days ago (2026-01-27 14:30)"
+ *
+ * @param date Date to format
+ * @param reference Reference date for relative calculation (defaults to now)
+ * @returns Combined timestamp string
+ */
+export declare function formatTimestamp(date: Date, reference?: Date): string;

package/dist/presentation/cli/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+/**
+ * Memory CLI Entry Point
+ *
+ * Cross-project context persistence for Claude Code sessions.
+ * Provides commands for syncing, searching, and retrieving session context.
+ */
+import { Command } from "commander";
+declare const program: Command;
+export { program };