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,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
+ }