memorix 1.6.1 → 1.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/TEAM.md +86 -86
  3. package/dist/cli/index.js +1574 -1063
  4. package/dist/index.js +588 -107
  5. package/dist/maintenance-runner.js +565 -84
  6. package/dist/media-audio-runner.js +565 -84
  7. package/dist/media-video-runner.js +565 -84
  8. package/dist/memcode-runtime/CHANGELOG.md +22 -0
  9. package/dist/sdk.js +621 -111
  10. package/dist/vector-backfill-runner.js +565 -84
  11. package/docs/DESIGN_DECISIONS.md +357 -357
  12. package/docs/PERFORMANCE.md +15 -0
  13. package/package.json +2 -1
  14. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  15. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  16. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  17. package/plugins/copilot/memorix/plugin.json +1 -1
  18. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  19. package/plugins/omp/memorix/package.json +1 -1
  20. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  21. package/plugins/pi/memorix/package.json +1 -1
  22. package/server.json +2 -2
  23. package/src/audit/index.ts +156 -156
  24. package/src/cli/commands/background.ts +34 -2
  25. package/src/cli/commands/formation.ts +48 -48
  26. package/src/cli/commands/git-hook-install.ts +111 -111
  27. package/src/cli/commands/handoff.ts +54 -54
  28. package/src/cli/commands/hooks-status.ts +63 -63
  29. package/src/cli/commands/ingest.ts +44 -44
  30. package/src/cli/commands/integrate-shared.ts +15 -15
  31. package/src/cli/commands/lock.ts +82 -82
  32. package/src/cli/commands/message.ts +104 -104
  33. package/src/cli/commands/operator-shared.ts +6 -3
  34. package/src/cli/commands/poll.ts +58 -58
  35. package/src/cli/commands/reasoning.ts +118 -118
  36. package/src/cli/commands/serve-http.ts +4 -0
  37. package/src/cli/commands/skills.ts +114 -114
  38. package/src/cli/commands/task.ts +167 -167
  39. package/src/cli/commands/transfer.ts +47 -47
  40. package/src/cli/index.ts +406 -406
  41. package/src/cli/tui/ChatView.tsx +234 -234
  42. package/src/cli/tui/CommandBar.tsx +312 -312
  43. package/src/cli/tui/ContextRail.tsx +118 -118
  44. package/src/cli/tui/HeaderBar.tsx +72 -72
  45. package/src/cli/tui/LogoBanner.tsx +51 -51
  46. package/src/cli/tui/index.ts +41 -41
  47. package/src/cli/version.ts +7 -7
  48. package/src/cli/workbench.ts +1 -1
  49. package/src/dashboard/project-classification.ts +64 -64
  50. package/src/embedding/api-provider.ts +503 -27
  51. package/src/embedding/provider.ts +20 -3
  52. package/src/git/hooks-path.ts +85 -85
  53. package/src/hooks/lifecycle.ts +1 -0
  54. package/src/hooks/pattern-detector.ts +173 -173
  55. package/src/hooks/significance-filter.ts +250 -250
  56. package/src/llm/memory-manager.ts +328 -328
  57. package/src/llm/quality.ts +248 -248
  58. package/src/memory/attribution-guard.ts +249 -249
  59. package/src/memory/disclosure-policy.ts +135 -135
  60. package/src/memory/entity-extractor.ts +197 -197
  61. package/src/memory/formation/evaluate.ts +217 -217
  62. package/src/memory/freshness.ts +122 -122
  63. package/src/memory/graph.ts +197 -197
  64. package/src/memory/observations.ts +68 -18
  65. package/src/memory/refs.ts +94 -94
  66. package/src/memory/secret-filter.ts +79 -79
  67. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  68. package/src/orchestrate/adapters/claude.ts +111 -111
  69. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  70. package/src/orchestrate/adapters/codex.ts +41 -41
  71. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  72. package/src/orchestrate/adapters/gemini.ts +42 -42
  73. package/src/orchestrate/adapters/index.ts +73 -73
  74. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  75. package/src/orchestrate/adapters/opencode.ts +47 -47
  76. package/src/orchestrate/adapters/types.ts +77 -77
  77. package/src/orchestrate/capability-router.ts +284 -284
  78. package/src/orchestrate/cost-tracker.ts +219 -219
  79. package/src/orchestrate/error-recovery.ts +191 -191
  80. package/src/orchestrate/evidence.ts +140 -140
  81. package/src/orchestrate/ledger.ts +110 -110
  82. package/src/orchestrate/memorix-bridge.ts +343 -343
  83. package/src/orchestrate/output-budget.ts +80 -80
  84. package/src/orchestrate/permission.ts +152 -152
  85. package/src/orchestrate/pipeline-trace.ts +131 -131
  86. package/src/orchestrate/prompt-builder.ts +155 -155
  87. package/src/orchestrate/ring-buffer.ts +37 -37
  88. package/src/orchestrate/task-graph.ts +389 -389
  89. package/src/project/aliases.ts +374 -374
  90. package/src/rules/adapters/trae.ts +56 -56
  91. package/src/rules/syncer.ts +235 -235
  92. package/src/sdk.ts +12 -8
  93. package/src/search/query-expansion.ts +52 -52
  94. package/src/server/formation-timeout.ts +27 -27
  95. package/src/skills/mini-skills.ts +386 -386
  96. package/src/store/chat-store.ts +119 -119
  97. package/src/store/graph-store.ts +249 -249
  98. package/src/store/mini-skill-store.ts +349 -349
  99. package/src/store/orama-store.ts +21 -3
  100. package/src/store/persistence-json.ts +212 -212
  101. package/src/store/persistence.ts +291 -291
  102. package/src/store/project-affinity.ts +195 -195
  103. package/src/team/event-bus.ts +76 -76
  104. package/src/team/handoff.ts +161 -161
  105. package/src/team/poll.ts +132 -132
  106. package/src/workspace/mcp-adapters/codex.ts +191 -191
  107. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  108. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  109. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  110. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  111. package/src/workspace/mcp-adapters/trae.ts +134 -134
  112. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  113. package/src/workspace/sanitizer.ts +60 -60
@@ -1,234 +1,234 @@
1
- import React, { useRef, useEffect, useCallback, useImperativeHandle, forwardRef } from 'react';
2
- import { Box, Text, useInput, useStdout } from 'ink';
3
- import { ScrollView, type ScrollViewRef } from 'ink-scroll-view';
4
- import Spinner from 'ink-spinner';
5
- import { COLORS, SEP, SYMBOLS, computeLayoutWidths } from './theme.js';
6
- import type { ProjectInfo } from './data.js';
7
- import type { ChatSource } from './chat-service.js';
8
-
9
- export interface ChatTranscriptMessage {
10
- role: 'user' | 'assistant';
11
- content: string;
12
- sources?: ChatSource[];
13
- error?: boolean;
14
- timestamp?: string;
15
- meta?: {
16
- usedLLM?: boolean;
17
- searchMode?: string;
18
- llmModel?: string;
19
- warning?: string;
20
- };
21
- }
22
-
23
- interface ChatViewProps {
24
- project: ProjectInfo | null;
25
- messages: ChatTranscriptMessage[];
26
- loading: boolean;
27
- contentWidth?: number;
28
- viewportHeight?: number;
29
- threadId?: string;
30
- keyboardScrollEnabled?: boolean;
31
- }
32
-
33
- function separator(width: number): string {
34
- return SEP.thin.repeat(Math.max(12, Math.min(width, 72)));
35
- }
36
-
37
- function truncate(text: string, max: number): string {
38
- if (text.length <= max) return text;
39
- return `${text.slice(0, max - 1)}…`;
40
- }
41
-
42
- /** Measure the display width of a string, counting CJK characters as 2 columns. */
43
- function displayWidth(str: string): number {
44
- let w = 0;
45
- for (const ch of str) {
46
- const cp = ch.codePointAt(0)!;
47
- // CJK Unified Ideographs + CJK Extension + Katakana + Hangul + fullwidth forms
48
- if ((cp >= 0x4E00 && cp <= 0x9FFF) || (cp >= 0x3040 && cp <= 0x30FF) ||
49
- (cp >= 0xAC00 && cp <= 0xD7AF) || (cp >= 0xFF01 && cp <= 0xFF60) ||
50
- (cp >= 0x3400 && cp <= 0x4DBF)) {
51
- w += 2;
52
- } else {
53
- w += 1;
54
- }
55
- }
56
- return w;
57
- }
58
-
59
- /** Split text into lines respecting CJK double-width characters.
60
- * Ink's wrap="wrap" doesn't understand CJK width, causing garbled text. */
61
- function cjkAwareLines(text: string, maxCols: number): string[] {
62
- if (maxCols < 4) return [text];
63
- const lines: string[] = [];
64
- let line = '';
65
- let lineW = 0;
66
- for (const ch of text) {
67
- if (ch === '\n') {
68
- lines.push(line);
69
- line = '';
70
- lineW = 0;
71
- continue;
72
- }
73
- const cw = displayWidth(ch);
74
- if (lineW + cw > maxCols && line.length > 0) {
75
- lines.push(line);
76
- line = ch;
77
- lineW = cw;
78
- } else {
79
- line += ch;
80
- lineW += cw;
81
- }
82
- }
83
- if (line) lines.push(line);
84
- return lines.length > 0 ? lines : [''];
85
- }
86
-
87
- function MessageBlock({ message, width }: { message: ChatTranscriptMessage; width: number }): React.ReactElement {
88
- const heading = message.role === 'user' ? 'You' : 'Memorix';
89
- const headingColor = message.role === 'user'
90
- ? COLORS.brand
91
- : message.error
92
- ? COLORS.error
93
- : COLORS.assistant;
94
-
95
- return (
96
- <Box flexDirection="column" marginBottom={0}>
97
- <Box>
98
- <Text color={headingColor} bold wrap="truncate-end">{heading}</Text>
99
- {message.meta?.usedLLM && message.role === 'assistant' && (
100
- <Text color={COLORS.muted} wrap="truncate-end"> {SYMBOLS.pill(message.meta.llmModel || 'LLM')}</Text>
101
- )}
102
- {message.meta?.searchMode && message.role === 'assistant' && (
103
- <Text color={COLORS.textDim} wrap="truncate-end">{` ${SYMBOLS.pill(message.meta.searchMode)}`}</Text>
104
- )}
105
- </Box>
106
- <Box flexDirection="column">
107
- {cjkAwareLines(message.content, Math.max(20, width - 4)).map((ln, i) => (
108
- <Text key={i} color={message.error ? COLORS.error : COLORS.text}>{ln}</Text>
109
- ))}
110
- </Box>
111
- {message.meta?.warning && !message.error && (
112
- <Text color={COLORS.warning} wrap="truncate-end">{message.meta.warning}</Text>
113
- )}
114
- {message.sources && message.sources.length > 0 && (
115
- <Box flexDirection="column">
116
- <Text color={COLORS.muted} wrap="truncate-end">Sources</Text>
117
- {message.sources.slice(0, 3).map((source) => (
118
- <Text key={source.id} color={COLORS.textDim} wrap="truncate-end">
119
- {` [obs:${source.id}] ${truncate(source.title, Math.max(20, width - 16))}`}
120
- </Text>
121
- ))}
122
- </Box>
123
- )}
124
- </Box>
125
- );
126
- }
127
-
128
- export interface ChatViewRef {
129
- scrollBy: (offset: number) => void;
130
- }
131
-
132
- export const ChatView = forwardRef<ChatViewRef, ChatViewProps>(function ChatView(
133
- { project, messages, loading, contentWidth: _contentWidth, viewportHeight, threadId, keyboardScrollEnabled = true },
134
- ref,
135
- ): React.ReactElement {
136
- const scrollRef = useRef<ScrollViewRef>(null);
137
- const { stdout } = useStdout();
138
-
139
- // Compute responsive content width from terminal size (shared with App.tsx)
140
- const termWidth = stdout?.columns || 80;
141
- const { contentWidth } = computeLayoutWidths(termWidth);
142
-
143
- // Expose scrollBy to parent for centralized mouse handling
144
- useImperativeHandle(ref, () => ({
145
- scrollBy: (offset: number) => scrollRef.current?.scrollBy(offset),
146
- }), []);
147
-
148
- // Auto-scroll to bottom when new messages arrive
149
- useEffect(() => {
150
- if (scrollRef.current && messages.length > 0) {
151
- // Small delay to let ink-scroll-view measure new content
152
- const timer = setTimeout(() => {
153
- scrollRef.current?.remeasure();
154
- // Scroll to bottom: use getBottomOffset
155
- const bottom = scrollRef.current?.getBottomOffset?.() ?? 0;
156
- if (bottom > 0) {
157
- scrollRef.current?.scrollTo?.(bottom);
158
- }
159
- }, 50);
160
- return () => clearTimeout(timer);
161
- }
162
- }, [messages.length, loading]);
163
-
164
- // Handle terminal resize
165
- useEffect(() => {
166
- const handleResize = () => scrollRef.current?.remeasure();
167
- stdout?.on('resize', handleResize);
168
- return () => { stdout?.off('resize', handleResize); };
169
- }, [stdout]);
170
-
171
- // Capture up/down keys for scrolling when in chat view
172
- useInput(useCallback((_ch: string, key: any) => {
173
- if (!scrollRef.current) return;
174
- if (key.upArrow) {
175
- scrollRef.current.scrollBy(-3);
176
- } else if (key.downArrow) {
177
- scrollRef.current.scrollBy(3);
178
- } else if (key.pageUp) {
179
- const vh = scrollRef.current.getViewportHeight?.() ?? 10;
180
- scrollRef.current.scrollBy(-(vh - 2));
181
- } else if (key.pageDown) {
182
- const vh = scrollRef.current.getViewportHeight?.() ?? 10;
183
- scrollRef.current.scrollBy(vh - 2);
184
- }
185
- }, []), { isActive: keyboardScrollEnabled });
186
-
187
- // Reserve 2 rows for header ("Conversation" + separator), 1 for loading
188
- const headerRows = 2;
189
- const loadingRows = loading ? 1 : 0;
190
- const scrollHeight = viewportHeight ? Math.max(4, viewportHeight - headerRows - loadingRows) : 20;
191
-
192
- const threadLabel = threadId && threadId !== 'default' ? ` (${threadId})` : '';
193
-
194
- if (messages.length === 0) {
195
- return (
196
- <Box flexDirection="column" paddingX={1}>
197
- <Text color={COLORS.brand} bold>Memory Chat{threadLabel}</Text>
198
- <Text color={COLORS.border}>{separator(contentWidth - 4)}</Text>
199
- <Text color={COLORS.text}>Ask Memorix about project decisions, bugs, rationale, or recent changes.</Text>
200
- <Text color={COLORS.textDim}>{project ? `Project: ${project.name}` : 'Open inside a git project to query its memory graph.'}</Text>
201
- <Box marginTop={1} flexDirection="column">
202
- <Text color={COLORS.muted}>Try asking</Text>
203
- <Text color={COLORS.textDim}> {SYMBOLS.arrow} Why did we choose this architecture?</Text>
204
- <Text color={COLORS.textDim}> {SYMBOLS.arrow} What changed in auth recently?</Text>
205
- <Text color={COLORS.textDim}> {SYMBOLS.arrow} Summarize known issues around embeddings</Text>
206
- <Text color={COLORS.textDim}> {SYMBOLS.arrow} /search timeout bug</Text>
207
- </Box>
208
- </Box>
209
- );
210
- }
211
-
212
- return (
213
- <Box flexDirection="column" paddingX={1}>
214
- <Text color={COLORS.brand} bold>Conversation{threadLabel}</Text>
215
- <Text color={COLORS.border}>{separator(contentWidth - 4)}</Text>
216
- <Box height={scrollHeight} flexDirection="column">
217
- <ScrollView ref={scrollRef}>
218
- {messages.map((message, index) => (
219
- <MessageBlock
220
- key={`${message.role}-${index}-${message.timestamp || index}`}
221
- message={message}
222
- width={contentWidth}
223
- />
224
- ))}
225
- {loading && (
226
- <Box>
227
- <Text color={COLORS.brand}><Spinner type="dots" />{' '}Thinking…</Text>
228
- </Box>
229
- )}
230
- </ScrollView>
231
- </Box>
232
- </Box>
233
- );
234
- });
1
+ import React, { useRef, useEffect, useCallback, useImperativeHandle, forwardRef } from 'react';
2
+ import { Box, Text, useInput, useStdout } from 'ink';
3
+ import { ScrollView, type ScrollViewRef } from 'ink-scroll-view';
4
+ import Spinner from 'ink-spinner';
5
+ import { COLORS, SEP, SYMBOLS, computeLayoutWidths } from './theme.js';
6
+ import type { ProjectInfo } from './data.js';
7
+ import type { ChatSource } from './chat-service.js';
8
+
9
+ export interface ChatTranscriptMessage {
10
+ role: 'user' | 'assistant';
11
+ content: string;
12
+ sources?: ChatSource[];
13
+ error?: boolean;
14
+ timestamp?: string;
15
+ meta?: {
16
+ usedLLM?: boolean;
17
+ searchMode?: string;
18
+ llmModel?: string;
19
+ warning?: string;
20
+ };
21
+ }
22
+
23
+ interface ChatViewProps {
24
+ project: ProjectInfo | null;
25
+ messages: ChatTranscriptMessage[];
26
+ loading: boolean;
27
+ contentWidth?: number;
28
+ viewportHeight?: number;
29
+ threadId?: string;
30
+ keyboardScrollEnabled?: boolean;
31
+ }
32
+
33
+ function separator(width: number): string {
34
+ return SEP.thin.repeat(Math.max(12, Math.min(width, 72)));
35
+ }
36
+
37
+ function truncate(text: string, max: number): string {
38
+ if (text.length <= max) return text;
39
+ return `${text.slice(0, max - 1)}…`;
40
+ }
41
+
42
+ /** Measure the display width of a string, counting CJK characters as 2 columns. */
43
+ function displayWidth(str: string): number {
44
+ let w = 0;
45
+ for (const ch of str) {
46
+ const cp = ch.codePointAt(0)!;
47
+ // CJK Unified Ideographs + CJK Extension + Katakana + Hangul + fullwidth forms
48
+ if ((cp >= 0x4E00 && cp <= 0x9FFF) || (cp >= 0x3040 && cp <= 0x30FF) ||
49
+ (cp >= 0xAC00 && cp <= 0xD7AF) || (cp >= 0xFF01 && cp <= 0xFF60) ||
50
+ (cp >= 0x3400 && cp <= 0x4DBF)) {
51
+ w += 2;
52
+ } else {
53
+ w += 1;
54
+ }
55
+ }
56
+ return w;
57
+ }
58
+
59
+ /** Split text into lines respecting CJK double-width characters.
60
+ * Ink's wrap="wrap" doesn't understand CJK width, causing garbled text. */
61
+ function cjkAwareLines(text: string, maxCols: number): string[] {
62
+ if (maxCols < 4) return [text];
63
+ const lines: string[] = [];
64
+ let line = '';
65
+ let lineW = 0;
66
+ for (const ch of text) {
67
+ if (ch === '\n') {
68
+ lines.push(line);
69
+ line = '';
70
+ lineW = 0;
71
+ continue;
72
+ }
73
+ const cw = displayWidth(ch);
74
+ if (lineW + cw > maxCols && line.length > 0) {
75
+ lines.push(line);
76
+ line = ch;
77
+ lineW = cw;
78
+ } else {
79
+ line += ch;
80
+ lineW += cw;
81
+ }
82
+ }
83
+ if (line) lines.push(line);
84
+ return lines.length > 0 ? lines : [''];
85
+ }
86
+
87
+ function MessageBlock({ message, width }: { message: ChatTranscriptMessage; width: number }): React.ReactElement {
88
+ const heading = message.role === 'user' ? 'You' : 'Memorix';
89
+ const headingColor = message.role === 'user'
90
+ ? COLORS.brand
91
+ : message.error
92
+ ? COLORS.error
93
+ : COLORS.assistant;
94
+
95
+ return (
96
+ <Box flexDirection="column" marginBottom={0}>
97
+ <Box>
98
+ <Text color={headingColor} bold wrap="truncate-end">{heading}</Text>
99
+ {message.meta?.usedLLM && message.role === 'assistant' && (
100
+ <Text color={COLORS.muted} wrap="truncate-end"> {SYMBOLS.pill(message.meta.llmModel || 'LLM')}</Text>
101
+ )}
102
+ {message.meta?.searchMode && message.role === 'assistant' && (
103
+ <Text color={COLORS.textDim} wrap="truncate-end">{` ${SYMBOLS.pill(message.meta.searchMode)}`}</Text>
104
+ )}
105
+ </Box>
106
+ <Box flexDirection="column">
107
+ {cjkAwareLines(message.content, Math.max(20, width - 4)).map((ln, i) => (
108
+ <Text key={i} color={message.error ? COLORS.error : COLORS.text}>{ln}</Text>
109
+ ))}
110
+ </Box>
111
+ {message.meta?.warning && !message.error && (
112
+ <Text color={COLORS.warning} wrap="truncate-end">{message.meta.warning}</Text>
113
+ )}
114
+ {message.sources && message.sources.length > 0 && (
115
+ <Box flexDirection="column">
116
+ <Text color={COLORS.muted} wrap="truncate-end">Sources</Text>
117
+ {message.sources.slice(0, 3).map((source) => (
118
+ <Text key={source.id} color={COLORS.textDim} wrap="truncate-end">
119
+ {` [obs:${source.id}] ${truncate(source.title, Math.max(20, width - 16))}`}
120
+ </Text>
121
+ ))}
122
+ </Box>
123
+ )}
124
+ </Box>
125
+ );
126
+ }
127
+
128
+ export interface ChatViewRef {
129
+ scrollBy: (offset: number) => void;
130
+ }
131
+
132
+ export const ChatView = forwardRef<ChatViewRef, ChatViewProps>(function ChatView(
133
+ { project, messages, loading, contentWidth: _contentWidth, viewportHeight, threadId, keyboardScrollEnabled = true },
134
+ ref,
135
+ ): React.ReactElement {
136
+ const scrollRef = useRef<ScrollViewRef>(null);
137
+ const { stdout } = useStdout();
138
+
139
+ // Compute responsive content width from terminal size (shared with App.tsx)
140
+ const termWidth = stdout?.columns || 80;
141
+ const { contentWidth } = computeLayoutWidths(termWidth);
142
+
143
+ // Expose scrollBy to parent for centralized mouse handling
144
+ useImperativeHandle(ref, () => ({
145
+ scrollBy: (offset: number) => scrollRef.current?.scrollBy(offset),
146
+ }), []);
147
+
148
+ // Auto-scroll to bottom when new messages arrive
149
+ useEffect(() => {
150
+ if (scrollRef.current && messages.length > 0) {
151
+ // Small delay to let ink-scroll-view measure new content
152
+ const timer = setTimeout(() => {
153
+ scrollRef.current?.remeasure();
154
+ // Scroll to bottom: use getBottomOffset
155
+ const bottom = scrollRef.current?.getBottomOffset?.() ?? 0;
156
+ if (bottom > 0) {
157
+ scrollRef.current?.scrollTo?.(bottom);
158
+ }
159
+ }, 50);
160
+ return () => clearTimeout(timer);
161
+ }
162
+ }, [messages.length, loading]);
163
+
164
+ // Handle terminal resize
165
+ useEffect(() => {
166
+ const handleResize = () => scrollRef.current?.remeasure();
167
+ stdout?.on('resize', handleResize);
168
+ return () => { stdout?.off('resize', handleResize); };
169
+ }, [stdout]);
170
+
171
+ // Capture up/down keys for scrolling when in chat view
172
+ useInput(useCallback((_ch: string, key: any) => {
173
+ if (!scrollRef.current) return;
174
+ if (key.upArrow) {
175
+ scrollRef.current.scrollBy(-3);
176
+ } else if (key.downArrow) {
177
+ scrollRef.current.scrollBy(3);
178
+ } else if (key.pageUp) {
179
+ const vh = scrollRef.current.getViewportHeight?.() ?? 10;
180
+ scrollRef.current.scrollBy(-(vh - 2));
181
+ } else if (key.pageDown) {
182
+ const vh = scrollRef.current.getViewportHeight?.() ?? 10;
183
+ scrollRef.current.scrollBy(vh - 2);
184
+ }
185
+ }, []), { isActive: keyboardScrollEnabled });
186
+
187
+ // Reserve 2 rows for header ("Conversation" + separator), 1 for loading
188
+ const headerRows = 2;
189
+ const loadingRows = loading ? 1 : 0;
190
+ const scrollHeight = viewportHeight ? Math.max(4, viewportHeight - headerRows - loadingRows) : 20;
191
+
192
+ const threadLabel = threadId && threadId !== 'default' ? ` (${threadId})` : '';
193
+
194
+ if (messages.length === 0) {
195
+ return (
196
+ <Box flexDirection="column" paddingX={1}>
197
+ <Text color={COLORS.brand} bold>Memory Chat{threadLabel}</Text>
198
+ <Text color={COLORS.border}>{separator(contentWidth - 4)}</Text>
199
+ <Text color={COLORS.text}>Ask Memorix about project decisions, bugs, rationale, or recent changes.</Text>
200
+ <Text color={COLORS.textDim}>{project ? `Project: ${project.name}` : 'Open inside a git project to query its memory graph.'}</Text>
201
+ <Box marginTop={1} flexDirection="column">
202
+ <Text color={COLORS.muted}>Try asking</Text>
203
+ <Text color={COLORS.textDim}> {SYMBOLS.arrow} Why did we choose this architecture?</Text>
204
+ <Text color={COLORS.textDim}> {SYMBOLS.arrow} What changed in auth recently?</Text>
205
+ <Text color={COLORS.textDim}> {SYMBOLS.arrow} Summarize known issues around embeddings</Text>
206
+ <Text color={COLORS.textDim}> {SYMBOLS.arrow} /search timeout bug</Text>
207
+ </Box>
208
+ </Box>
209
+ );
210
+ }
211
+
212
+ return (
213
+ <Box flexDirection="column" paddingX={1}>
214
+ <Text color={COLORS.brand} bold>Conversation{threadLabel}</Text>
215
+ <Text color={COLORS.border}>{separator(contentWidth - 4)}</Text>
216
+ <Box height={scrollHeight} flexDirection="column">
217
+ <ScrollView ref={scrollRef}>
218
+ {messages.map((message, index) => (
219
+ <MessageBlock
220
+ key={`${message.role}-${index}-${message.timestamp || index}`}
221
+ message={message}
222
+ width={contentWidth}
223
+ />
224
+ ))}
225
+ {loading && (
226
+ <Box>
227
+ <Text color={COLORS.brand}><Spinner type="dots" />{' '}Thinking…</Text>
228
+ </Box>
229
+ )}
230
+ </ScrollView>
231
+ </Box>
232
+ </Box>
233
+ );
234
+ });