memorix 1.4.6 → 1.5.1

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 (119) hide show
  1. package/CHANGELOG.md +38 -0
  2. package/TEAM.md +86 -86
  3. package/dist/cli/index.js +225 -70
  4. package/dist/cli/memcode.js +0 -0
  5. package/dist/index.js +225 -70
  6. package/dist/maintenance-runner.js +183 -38
  7. package/dist/media-audio-runner.js +183 -38
  8. package/dist/media-video-runner.js +183 -38
  9. package/dist/memcode-runtime/CHANGELOG.md +38 -0
  10. package/dist/sdk.js +224 -69
  11. package/dist/types.d.ts +2 -0
  12. package/dist/vector-backfill-runner.js +183 -38
  13. package/docs/CONFIGURATION.md +12 -0
  14. package/docs/DESIGN_DECISIONS.md +357 -357
  15. package/package.json +1 -1
  16. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  17. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  18. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  19. package/plugins/copilot/memorix/plugin.json +1 -1
  20. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  21. package/plugins/omp/memorix/package.json +1 -1
  22. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  23. package/plugins/pi/memorix/package.json +1 -1
  24. package/server.json +2 -2
  25. package/src/audit/index.ts +156 -156
  26. package/src/cli/commands/formation.ts +48 -48
  27. package/src/cli/commands/git-hook-install.ts +111 -111
  28. package/src/cli/commands/handoff.ts +54 -54
  29. package/src/cli/commands/hooks-status.ts +63 -63
  30. package/src/cli/commands/ingest.ts +44 -44
  31. package/src/cli/commands/integrate-shared.ts +15 -15
  32. package/src/cli/commands/lock.ts +82 -82
  33. package/src/cli/commands/message.ts +104 -104
  34. package/src/cli/commands/poll.ts +58 -58
  35. package/src/cli/commands/reasoning.ts +118 -118
  36. package/src/cli/commands/skills.ts +114 -114
  37. package/src/cli/commands/task.ts +167 -167
  38. package/src/cli/commands/transfer.ts +47 -47
  39. package/src/cli/index.ts +406 -406
  40. package/src/cli/tui/ChatView.tsx +234 -234
  41. package/src/cli/tui/CommandBar.tsx +312 -312
  42. package/src/cli/tui/ContextRail.tsx +118 -118
  43. package/src/cli/tui/HeaderBar.tsx +72 -72
  44. package/src/cli/tui/LogoBanner.tsx +51 -51
  45. package/src/cli/tui/index.ts +41 -41
  46. package/src/cli/version.ts +7 -7
  47. package/src/cli/workbench.ts +1 -1
  48. package/src/config.ts +23 -2
  49. package/src/dashboard/project-classification.ts +64 -64
  50. package/src/embedding/api-provider.ts +105 -22
  51. package/src/embedding/provider.ts +2 -0
  52. package/src/git/hooks-path.ts +85 -85
  53. package/src/hooks/pattern-detector.ts +173 -173
  54. package/src/hooks/significance-filter.ts +250 -250
  55. package/src/llm/memory-manager.ts +328 -328
  56. package/src/llm/provider.ts +17 -8
  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/formation/extract.ts +6 -3
  63. package/src/memory/formation/index.ts +2 -1
  64. package/src/memory/formation/resolve.ts +10 -6
  65. package/src/memory/formation/types.ts +3 -1
  66. package/src/memory/freshness.ts +122 -122
  67. package/src/memory/graph.ts +197 -197
  68. package/src/memory/long-term.ts +7 -1
  69. package/src/memory/refs.ts +94 -94
  70. package/src/memory/secret-filter.ts +79 -79
  71. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  72. package/src/orchestrate/adapters/claude.ts +111 -111
  73. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  74. package/src/orchestrate/adapters/codex.ts +41 -41
  75. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  76. package/src/orchestrate/adapters/gemini.ts +42 -42
  77. package/src/orchestrate/adapters/index.ts +73 -73
  78. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  79. package/src/orchestrate/adapters/opencode.ts +47 -47
  80. package/src/orchestrate/adapters/types.ts +77 -77
  81. package/src/orchestrate/capability-router.ts +284 -284
  82. package/src/orchestrate/cost-tracker.ts +219 -219
  83. package/src/orchestrate/error-recovery.ts +191 -191
  84. package/src/orchestrate/evidence.ts +140 -140
  85. package/src/orchestrate/ledger.ts +110 -110
  86. package/src/orchestrate/memorix-bridge.ts +343 -343
  87. package/src/orchestrate/output-budget.ts +80 -80
  88. package/src/orchestrate/permission.ts +152 -152
  89. package/src/orchestrate/pipeline-trace.ts +131 -131
  90. package/src/orchestrate/prompt-builder.ts +155 -155
  91. package/src/orchestrate/ring-buffer.ts +37 -37
  92. package/src/orchestrate/task-graph.ts +389 -389
  93. package/src/project/aliases.ts +374 -374
  94. package/src/rules/adapters/trae.ts +56 -56
  95. package/src/rules/syncer.ts +235 -235
  96. package/src/search/query-expansion.ts +52 -52
  97. package/src/server/formation-timeout.ts +27 -27
  98. package/src/server.ts +14 -10
  99. package/src/skills/mini-skills.ts +386 -386
  100. package/src/store/chat-store.ts +119 -119
  101. package/src/store/graph-store.ts +249 -249
  102. package/src/store/mini-skill-store.ts +349 -349
  103. package/src/store/orama-store.ts +6 -4
  104. package/src/store/persistence-json.ts +212 -212
  105. package/src/store/persistence.ts +291 -291
  106. package/src/store/project-affinity.ts +195 -195
  107. package/src/team/event-bus.ts +76 -76
  108. package/src/team/handoff.ts +161 -161
  109. package/src/team/poll.ts +132 -132
  110. package/src/timeout.ts +67 -0
  111. package/src/types.ts +2 -0
  112. package/src/workspace/mcp-adapters/codex.ts +191 -191
  113. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  114. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  115. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  116. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  117. package/src/workspace/mcp-adapters/trae.ts +134 -134
  118. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  119. package/src/workspace/sanitizer.ts +60 -60
@@ -1,312 +1,312 @@
1
- /**
2
- * Bottom input bar with slash-command palette.
3
- *
4
- * Modern design: brand-colored prompt, Unicode palette styling,
5
- * status symbols. Commands palette floats as an overlay above
6
- * the input line using position="absolute" — does not push
7
- * content down.
8
- */
9
-
10
- import React, { useState, useEffect, useRef } from 'react';
11
- import { Box, Text, useInput } from 'ink';
12
- import { COLORS, SLASH_COMMANDS, SEP, SYMBOLS, COMMAND_BAR_ROWS } from './theme.js';
13
- import type { SlashCommand } from './theme.js';
14
-
15
- export interface PaletteItem {
16
- name: string;
17
- description: string;
18
- alias?: string;
19
- }
20
-
21
- interface CommandBarProps {
22
- onSubmit: (input: string) => void;
23
- onExit: () => void;
24
- disabled?: boolean;
25
- disabledHint?: string;
26
- onFocusChange?: (focused: boolean) => void;
27
- prefixLabel?: string;
28
- placeholder?: string;
29
- contentWidth?: number;
30
- /** Called when palette visibility changes (for scroll key handoff) */
31
- onPaletteChange?: (visible: boolean) => void;
32
- /** Called with palette items when they change (for overlay rendering) */
33
- onPaletteItems?: (items: PaletteItem[], selectedIndex: number) => void;
34
- /** Characters that are view-level shortcuts for the current tab.
35
- * When the command bar is empty, these chars must not be captured
36
- * as input — they belong to the view (e.g. 'f' for Graph filter). */
37
- blockedFirstChars?: string[];
38
- }
39
-
40
- function fit(text: string, max: number): string {
41
- if (max <= 0) return '';
42
- if (text.length <= max) return text.padEnd(max);
43
- if (max === 1) return '…';
44
- return `${text.slice(0, max - 1)}…`;
45
- }
46
-
47
- /** Check if a character is fullwidth (CJK, emoji, etc.) — occupies 2 terminal columns */
48
- function isFullwidth(ch: string): boolean {
49
- if (!ch) return false;
50
- const cp = ch.codePointAt(0)!;
51
- // CJK Unified Ideographs
52
- if (cp >= 0x4E00 && cp <= 0x9FFF) return true;
53
- // CJK Extension A
54
- if (cp >= 0x3400 && cp <= 0x4DBF) return true;
55
- // CJK Compatibility Ideographs
56
- if (cp >= 0xF900 && cp <= 0xFAFF) return true;
57
- // CJK Extension B-I
58
- if (cp >= 0x20000 && cp <= 0x2FA1F) return true;
59
- // Halfwidth and Fullwidth Forms (fullwidth letters/digits)
60
- if (cp >= 0xFF01 && cp <= 0xFF60) return true;
61
- // Hangul Syllables
62
- if (cp >= 0xAC00 && cp <= 0xD7AF) return true;
63
- // Katakana / Hiragana
64
- if (cp >= 0x3040 && cp <= 0x30FF) return true;
65
- // CJK Symbols and Punctuation
66
- if (cp >= 0x3000 && cp <= 0x303F) return true;
67
- // Most emoji are fullwidth
68
- if (cp >= 0x1F600 && cp <= 0x1F9FF) return true;
69
- return false;
70
- }
71
-
72
- /** Calculate terminal display width of a string */
73
- function displayWidth(text: string): number {
74
- let width = 0;
75
- for (const ch of text) {
76
- width += isFullwidth(ch) ? 2 : 1;
77
- }
78
- return width;
79
- }
80
-
81
- function previousCursorPos(text: string, cursorPos: number): number {
82
- let start = 0;
83
- for (const ch of text) {
84
- const end = start + ch.length;
85
- if (end >= cursorPos) return start;
86
- start = end;
87
- }
88
- return 0;
89
- }
90
-
91
- function nextCursorPos(text: string, cursorPos: number): number {
92
- let start = 0;
93
- for (const ch of text) {
94
- const end = start + ch.length;
95
- if (start >= cursorPos) return end;
96
- if (end > cursorPos) return end;
97
- start = end;
98
- }
99
- return text.length;
100
- }
101
-
102
- function getCharacterAt(text: string, cursorPos: number): string {
103
- const codePoint = text.codePointAt(cursorPos);
104
- return codePoint === undefined ? '' : String.fromCodePoint(codePoint);
105
- }
106
-
107
- export function CommandBar({
108
- onSubmit,
109
- onExit,
110
- disabled = false,
111
- disabledHint = 'Action view active',
112
- onFocusChange,
113
- prefixLabel = '[cmd]',
114
- placeholder = 'type to search or use /command',
115
- contentWidth = 80,
116
- onPaletteChange,
117
- onPaletteItems,
118
- blockedFirstChars,
119
- }: CommandBarProps): React.ReactElement {
120
- const [input, setInput] = useState('');
121
- const [cursorPos, setCursorPos] = useState(0);
122
- const [paletteIndex, setPaletteIndex] = useState(0);
123
-
124
- // Notify parent about input focus state for keyboard priority model
125
- const hasFocus = !disabled && input.length > 0;
126
- useEffect(() => { onFocusChange?.(hasFocus); }, [hasFocus, onFocusChange]);
127
-
128
- const showPalette = !disabled && input.startsWith('/') && !input.includes(' ');
129
- const filteredCommands: SlashCommand[] = showPalette
130
- ? SLASH_COMMANDS.filter((command) =>
131
- command.name.startsWith(input.toLowerCase()) ||
132
- (command.alias && command.alias.startsWith(input.toLowerCase())),
133
- )
134
- : [];
135
- const clampedIndex = Math.min(paletteIndex, Math.max(0, filteredCommands.length - 1));
136
-
137
- // Notify parent when palette visibility changes
138
- useEffect(() => { onPaletteChange?.(showPalette && filteredCommands.length > 0); }, [showPalette, filteredCommands.length, onPaletteChange]);
139
-
140
- // Notify parent about palette items for overlay rendering
141
- useEffect(() => {
142
- if (showPalette && filteredCommands.length > 0) {
143
- onPaletteItems?.(filteredCommands.map(c => ({ name: c.name, description: c.description, alias: c.alias })), clampedIndex);
144
- } else {
145
- onPaletteItems?.([], 0);
146
- }
147
- }, [showPalette, filteredCommands.length, clampedIndex, onPaletteItems]);
148
-
149
- useInput((ch, key) => {
150
- if (key.ctrl && ch === 'c') {
151
- onExit();
152
- return;
153
- }
154
-
155
- if (disabled) {
156
- return;
157
- }
158
-
159
- // View-level shortcut keys (e.g. 'f' for Graph filter, 'k' for
160
- // knowledge jump) must not seed the command bar on first press.
161
- // Only block these specific chars when the bar is empty; all other
162
- // keys pass through so users can type normal text from an empty bar.
163
- const isRegularChar = ch && ch.length === 1 && !key.ctrl && !key.meta
164
- && ch.charCodeAt(0) >= 32;
165
- if (isRegularChar && !hasFocus && ch !== '/' && blockedFirstChars?.includes(ch)) {
166
- return;
167
- }
168
-
169
- if (key.escape) {
170
- if (showPalette || input) {
171
- setInput('');
172
- setCursorPos(0);
173
- }
174
- return;
175
- }
176
-
177
- if (showPalette && filteredCommands.length > 0) {
178
- if (key.upArrow) {
179
- setPaletteIndex(Math.max(0, clampedIndex - 1));
180
- return;
181
- }
182
- if (key.downArrow) {
183
- setPaletteIndex(Math.min(filteredCommands.length - 1, clampedIndex + 1));
184
- return;
185
- }
186
- }
187
-
188
- if (key.tab && showPalette && filteredCommands.length > 0) {
189
- const selected = filteredCommands[clampedIndex];
190
- if (selected) {
191
- const nextInput = `${selected.name} `;
192
- setInput(nextInput);
193
- setCursorPos(nextInput.length);
194
- setPaletteIndex(0);
195
- }
196
- return;
197
- }
198
-
199
- if (key.return) {
200
- if (showPalette && filteredCommands.length > 0) {
201
- const selected = filteredCommands[clampedIndex];
202
- if (selected) {
203
- // Enter on palette = auto-complete command name + space
204
- // (like Tab), so user can type arguments before executing.
205
- // If only one match and it's an arg-less command, execute directly.
206
- const argLessCommands = new Set(['/home', '/h', '/recent', '/v', '/doctor', '/d', '/project', '/p', '/background', '/bg', '/dashboard', '/dash', '/integrate', '/setup', '/configure', '/config', '/cleanup', '/ingest', '/help', '/?', '/exit', '/quit', '/q', '/clear', '/cc', '/new', '/cn', '/resume', '/cr', '/wiki', '/knowledge', '/memory', '/workbench', '/graph']);
207
- if (filteredCommands.length === 1 && argLessCommands.has(selected.name)) {
208
- setInput('');
209
- setCursorPos(0);
210
- setPaletteIndex(0);
211
- onSubmit(selected.name);
212
- } else {
213
- const nextInput = `${selected.name} `;
214
- setInput(nextInput);
215
- setCursorPos(nextInput.length);
216
- setPaletteIndex(0);
217
- }
218
- }
219
- } else if (input.trim()) {
220
- const submitted = input;
221
- setInput('');
222
- setCursorPos(0);
223
- setPaletteIndex(0);
224
- onSubmit(submitted);
225
- }
226
- return;
227
- }
228
-
229
- if (key.backspace || ch === '\x7F') {
230
- if (cursorPos > 0) {
231
- const prevPos = previousCursorPos(input, cursorPos);
232
- setInput((prev) => prev.slice(0, prevPos) + prev.slice(cursorPos));
233
- setCursorPos(prevPos);
234
- setPaletteIndex(0);
235
- }
236
- return;
237
- }
238
-
239
- if (key.delete) {
240
- if (cursorPos >= input.length) {
241
- if (cursorPos > 0) {
242
- const prevPos = previousCursorPos(input, cursorPos);
243
- setInput((prev) => prev.slice(0, prevPos) + prev.slice(cursorPos));
244
- setCursorPos(prevPos);
245
- setPaletteIndex(0);
246
- }
247
- } else {
248
- const nextPos = nextCursorPos(input, cursorPos);
249
- setInput((prev) => prev.slice(0, cursorPos) + prev.slice(nextPos));
250
- setPaletteIndex(0);
251
- }
252
- return;
253
- }
254
-
255
- if (key.leftArrow) {
256
- setCursorPos((prev) => previousCursorPos(input, prev));
257
- return;
258
- }
259
-
260
- if (key.rightArrow) {
261
- setCursorPos((prev) => nextCursorPos(input, prev));
262
- return;
263
- }
264
-
265
- if (ch && !key.ctrl && !key.meta) {
266
- const nextPos = cursorPos + ch.length;
267
- setInput((prev) => prev.slice(0, cursorPos) + ch + prev.slice(cursorPos));
268
- setCursorPos(nextPos);
269
- setPaletteIndex(0);
270
- }
271
- });
272
-
273
- const currentChar = getCharacterAt(input, cursorPos);
274
- const afterCursor = currentChar ? input.slice(cursorPos + currentChar.length) : '';
275
-
276
- return (
277
- <Box flexDirection="column">
278
- <Box
279
- borderStyle="single"
280
- borderColor={input.startsWith('/') ? COLORS.brand : COLORS.border}
281
- borderTop={true}
282
- borderBottom={false}
283
- borderLeft={false}
284
- borderRight={false}
285
- paddingX={1}
286
- marginX={1}
287
- >
288
- {disabled ? (
289
- <>
290
- <Text color={COLORS.brand} bold>[action]</Text>
291
- <Text color={COLORS.border}> </Text>
292
- <Text color={COLORS.muted}>{disabledHint}</Text>
293
- </>
294
- ) : (
295
- <>
296
- <Text color={COLORS.brand} bold>{prefixLabel}</Text>
297
- <Text color={COLORS.border}> </Text>
298
- <Text color={COLORS.brand} bold>{`${SYMBOLS.arrow} `}</Text>
299
- <Text color={COLORS.text}>{input.slice(0, cursorPos)}</Text>
300
- {currentChar && isFullwidth(currentChar) ? (
301
- <Text backgroundColor={COLORS.brand} color={COLORS.bg}>{currentChar}</Text>
302
- ) : (
303
- <Text backgroundColor={COLORS.brand} color={COLORS.bg}>{currentChar || ' '}</Text>
304
- )}
305
- <Text color={COLORS.text}>{afterCursor}</Text>
306
- {!input && <Text color={COLORS.muted}> {placeholder}</Text>}
307
- </>
308
- )}
309
- </Box>
310
- </Box>
311
- );
312
- }
1
+ /**
2
+ * Bottom input bar with slash-command palette.
3
+ *
4
+ * Modern design: brand-colored prompt, Unicode palette styling,
5
+ * status symbols. Commands palette floats as an overlay above
6
+ * the input line using position="absolute" — does not push
7
+ * content down.
8
+ */
9
+
10
+ import React, { useState, useEffect, useRef } from 'react';
11
+ import { Box, Text, useInput } from 'ink';
12
+ import { COLORS, SLASH_COMMANDS, SEP, SYMBOLS, COMMAND_BAR_ROWS } from './theme.js';
13
+ import type { SlashCommand } from './theme.js';
14
+
15
+ export interface PaletteItem {
16
+ name: string;
17
+ description: string;
18
+ alias?: string;
19
+ }
20
+
21
+ interface CommandBarProps {
22
+ onSubmit: (input: string) => void;
23
+ onExit: () => void;
24
+ disabled?: boolean;
25
+ disabledHint?: string;
26
+ onFocusChange?: (focused: boolean) => void;
27
+ prefixLabel?: string;
28
+ placeholder?: string;
29
+ contentWidth?: number;
30
+ /** Called when palette visibility changes (for scroll key handoff) */
31
+ onPaletteChange?: (visible: boolean) => void;
32
+ /** Called with palette items when they change (for overlay rendering) */
33
+ onPaletteItems?: (items: PaletteItem[], selectedIndex: number) => void;
34
+ /** Characters that are view-level shortcuts for the current tab.
35
+ * When the command bar is empty, these chars must not be captured
36
+ * as input — they belong to the view (e.g. 'f' for Graph filter). */
37
+ blockedFirstChars?: string[];
38
+ }
39
+
40
+ function fit(text: string, max: number): string {
41
+ if (max <= 0) return '';
42
+ if (text.length <= max) return text.padEnd(max);
43
+ if (max === 1) return '…';
44
+ return `${text.slice(0, max - 1)}…`;
45
+ }
46
+
47
+ /** Check if a character is fullwidth (CJK, emoji, etc.) — occupies 2 terminal columns */
48
+ function isFullwidth(ch: string): boolean {
49
+ if (!ch) return false;
50
+ const cp = ch.codePointAt(0)!;
51
+ // CJK Unified Ideographs
52
+ if (cp >= 0x4E00 && cp <= 0x9FFF) return true;
53
+ // CJK Extension A
54
+ if (cp >= 0x3400 && cp <= 0x4DBF) return true;
55
+ // CJK Compatibility Ideographs
56
+ if (cp >= 0xF900 && cp <= 0xFAFF) return true;
57
+ // CJK Extension B-I
58
+ if (cp >= 0x20000 && cp <= 0x2FA1F) return true;
59
+ // Halfwidth and Fullwidth Forms (fullwidth letters/digits)
60
+ if (cp >= 0xFF01 && cp <= 0xFF60) return true;
61
+ // Hangul Syllables
62
+ if (cp >= 0xAC00 && cp <= 0xD7AF) return true;
63
+ // Katakana / Hiragana
64
+ if (cp >= 0x3040 && cp <= 0x30FF) return true;
65
+ // CJK Symbols and Punctuation
66
+ if (cp >= 0x3000 && cp <= 0x303F) return true;
67
+ // Most emoji are fullwidth
68
+ if (cp >= 0x1F600 && cp <= 0x1F9FF) return true;
69
+ return false;
70
+ }
71
+
72
+ /** Calculate terminal display width of a string */
73
+ function displayWidth(text: string): number {
74
+ let width = 0;
75
+ for (const ch of text) {
76
+ width += isFullwidth(ch) ? 2 : 1;
77
+ }
78
+ return width;
79
+ }
80
+
81
+ function previousCursorPos(text: string, cursorPos: number): number {
82
+ let start = 0;
83
+ for (const ch of text) {
84
+ const end = start + ch.length;
85
+ if (end >= cursorPos) return start;
86
+ start = end;
87
+ }
88
+ return 0;
89
+ }
90
+
91
+ function nextCursorPos(text: string, cursorPos: number): number {
92
+ let start = 0;
93
+ for (const ch of text) {
94
+ const end = start + ch.length;
95
+ if (start >= cursorPos) return end;
96
+ if (end > cursorPos) return end;
97
+ start = end;
98
+ }
99
+ return text.length;
100
+ }
101
+
102
+ function getCharacterAt(text: string, cursorPos: number): string {
103
+ const codePoint = text.codePointAt(cursorPos);
104
+ return codePoint === undefined ? '' : String.fromCodePoint(codePoint);
105
+ }
106
+
107
+ export function CommandBar({
108
+ onSubmit,
109
+ onExit,
110
+ disabled = false,
111
+ disabledHint = 'Action view active',
112
+ onFocusChange,
113
+ prefixLabel = '[cmd]',
114
+ placeholder = 'type to search or use /command',
115
+ contentWidth = 80,
116
+ onPaletteChange,
117
+ onPaletteItems,
118
+ blockedFirstChars,
119
+ }: CommandBarProps): React.ReactElement {
120
+ const [input, setInput] = useState('');
121
+ const [cursorPos, setCursorPos] = useState(0);
122
+ const [paletteIndex, setPaletteIndex] = useState(0);
123
+
124
+ // Notify parent about input focus state for keyboard priority model
125
+ const hasFocus = !disabled && input.length > 0;
126
+ useEffect(() => { onFocusChange?.(hasFocus); }, [hasFocus, onFocusChange]);
127
+
128
+ const showPalette = !disabled && input.startsWith('/') && !input.includes(' ');
129
+ const filteredCommands: SlashCommand[] = showPalette
130
+ ? SLASH_COMMANDS.filter((command) =>
131
+ command.name.startsWith(input.toLowerCase()) ||
132
+ (command.alias && command.alias.startsWith(input.toLowerCase())),
133
+ )
134
+ : [];
135
+ const clampedIndex = Math.min(paletteIndex, Math.max(0, filteredCommands.length - 1));
136
+
137
+ // Notify parent when palette visibility changes
138
+ useEffect(() => { onPaletteChange?.(showPalette && filteredCommands.length > 0); }, [showPalette, filteredCommands.length, onPaletteChange]);
139
+
140
+ // Notify parent about palette items for overlay rendering
141
+ useEffect(() => {
142
+ if (showPalette && filteredCommands.length > 0) {
143
+ onPaletteItems?.(filteredCommands.map(c => ({ name: c.name, description: c.description, alias: c.alias })), clampedIndex);
144
+ } else {
145
+ onPaletteItems?.([], 0);
146
+ }
147
+ }, [showPalette, filteredCommands.length, clampedIndex, onPaletteItems]);
148
+
149
+ useInput((ch, key) => {
150
+ if (key.ctrl && ch === 'c') {
151
+ onExit();
152
+ return;
153
+ }
154
+
155
+ if (disabled) {
156
+ return;
157
+ }
158
+
159
+ // View-level shortcut keys (e.g. 'f' for Graph filter, 'k' for
160
+ // knowledge jump) must not seed the command bar on first press.
161
+ // Only block these specific chars when the bar is empty; all other
162
+ // keys pass through so users can type normal text from an empty bar.
163
+ const isRegularChar = ch && ch.length === 1 && !key.ctrl && !key.meta
164
+ && ch.charCodeAt(0) >= 32;
165
+ if (isRegularChar && !hasFocus && ch !== '/' && blockedFirstChars?.includes(ch)) {
166
+ return;
167
+ }
168
+
169
+ if (key.escape) {
170
+ if (showPalette || input) {
171
+ setInput('');
172
+ setCursorPos(0);
173
+ }
174
+ return;
175
+ }
176
+
177
+ if (showPalette && filteredCommands.length > 0) {
178
+ if (key.upArrow) {
179
+ setPaletteIndex(Math.max(0, clampedIndex - 1));
180
+ return;
181
+ }
182
+ if (key.downArrow) {
183
+ setPaletteIndex(Math.min(filteredCommands.length - 1, clampedIndex + 1));
184
+ return;
185
+ }
186
+ }
187
+
188
+ if (key.tab && showPalette && filteredCommands.length > 0) {
189
+ const selected = filteredCommands[clampedIndex];
190
+ if (selected) {
191
+ const nextInput = `${selected.name} `;
192
+ setInput(nextInput);
193
+ setCursorPos(nextInput.length);
194
+ setPaletteIndex(0);
195
+ }
196
+ return;
197
+ }
198
+
199
+ if (key.return) {
200
+ if (showPalette && filteredCommands.length > 0) {
201
+ const selected = filteredCommands[clampedIndex];
202
+ if (selected) {
203
+ // Enter on palette = auto-complete command name + space
204
+ // (like Tab), so user can type arguments before executing.
205
+ // If only one match and it's an arg-less command, execute directly.
206
+ const argLessCommands = new Set(['/home', '/h', '/recent', '/v', '/doctor', '/d', '/project', '/p', '/background', '/bg', '/dashboard', '/dash', '/integrate', '/setup', '/configure', '/config', '/cleanup', '/ingest', '/help', '/?', '/exit', '/quit', '/q', '/clear', '/cc', '/new', '/cn', '/resume', '/cr', '/wiki', '/knowledge', '/memory', '/workbench', '/graph']);
207
+ if (filteredCommands.length === 1 && argLessCommands.has(selected.name)) {
208
+ setInput('');
209
+ setCursorPos(0);
210
+ setPaletteIndex(0);
211
+ onSubmit(selected.name);
212
+ } else {
213
+ const nextInput = `${selected.name} `;
214
+ setInput(nextInput);
215
+ setCursorPos(nextInput.length);
216
+ setPaletteIndex(0);
217
+ }
218
+ }
219
+ } else if (input.trim()) {
220
+ const submitted = input;
221
+ setInput('');
222
+ setCursorPos(0);
223
+ setPaletteIndex(0);
224
+ onSubmit(submitted);
225
+ }
226
+ return;
227
+ }
228
+
229
+ if (key.backspace || ch === '\x7F') {
230
+ if (cursorPos > 0) {
231
+ const prevPos = previousCursorPos(input, cursorPos);
232
+ setInput((prev) => prev.slice(0, prevPos) + prev.slice(cursorPos));
233
+ setCursorPos(prevPos);
234
+ setPaletteIndex(0);
235
+ }
236
+ return;
237
+ }
238
+
239
+ if (key.delete) {
240
+ if (cursorPos >= input.length) {
241
+ if (cursorPos > 0) {
242
+ const prevPos = previousCursorPos(input, cursorPos);
243
+ setInput((prev) => prev.slice(0, prevPos) + prev.slice(cursorPos));
244
+ setCursorPos(prevPos);
245
+ setPaletteIndex(0);
246
+ }
247
+ } else {
248
+ const nextPos = nextCursorPos(input, cursorPos);
249
+ setInput((prev) => prev.slice(0, cursorPos) + prev.slice(nextPos));
250
+ setPaletteIndex(0);
251
+ }
252
+ return;
253
+ }
254
+
255
+ if (key.leftArrow) {
256
+ setCursorPos((prev) => previousCursorPos(input, prev));
257
+ return;
258
+ }
259
+
260
+ if (key.rightArrow) {
261
+ setCursorPos((prev) => nextCursorPos(input, prev));
262
+ return;
263
+ }
264
+
265
+ if (ch && !key.ctrl && !key.meta) {
266
+ const nextPos = cursorPos + ch.length;
267
+ setInput((prev) => prev.slice(0, cursorPos) + ch + prev.slice(cursorPos));
268
+ setCursorPos(nextPos);
269
+ setPaletteIndex(0);
270
+ }
271
+ });
272
+
273
+ const currentChar = getCharacterAt(input, cursorPos);
274
+ const afterCursor = currentChar ? input.slice(cursorPos + currentChar.length) : '';
275
+
276
+ return (
277
+ <Box flexDirection="column">
278
+ <Box
279
+ borderStyle="single"
280
+ borderColor={input.startsWith('/') ? COLORS.brand : COLORS.border}
281
+ borderTop={true}
282
+ borderBottom={false}
283
+ borderLeft={false}
284
+ borderRight={false}
285
+ paddingX={1}
286
+ marginX={1}
287
+ >
288
+ {disabled ? (
289
+ <>
290
+ <Text color={COLORS.brand} bold>[action]</Text>
291
+ <Text color={COLORS.border}> </Text>
292
+ <Text color={COLORS.muted}>{disabledHint}</Text>
293
+ </>
294
+ ) : (
295
+ <>
296
+ <Text color={COLORS.brand} bold>{prefixLabel}</Text>
297
+ <Text color={COLORS.border}> </Text>
298
+ <Text color={COLORS.brand} bold>{`${SYMBOLS.arrow} `}</Text>
299
+ <Text color={COLORS.text}>{input.slice(0, cursorPos)}</Text>
300
+ {currentChar && isFullwidth(currentChar) ? (
301
+ <Text backgroundColor={COLORS.brand} color={COLORS.bg}>{currentChar}</Text>
302
+ ) : (
303
+ <Text backgroundColor={COLORS.brand} color={COLORS.bg}>{currentChar || ' '}</Text>
304
+ )}
305
+ <Text color={COLORS.text}>{afterCursor}</Text>
306
+ {!input && <Text color={COLORS.muted}> {placeholder}</Text>}
307
+ </>
308
+ )}
309
+ </Box>
310
+ </Box>
311
+ );
312
+ }