memorix 1.6.1 → 1.6.3

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 (122) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/TEAM.md +86 -86
  3. package/dist/cli/index.js +2582 -1845
  4. package/dist/index.js +1355 -683
  5. package/dist/maintenance-runner.js +1621 -1096
  6. package/dist/media-audio-runner.js +1612 -1088
  7. package/dist/media-video-runner.js +1612 -1088
  8. package/dist/memcode-runtime/CHANGELOG.md +35 -0
  9. package/dist/sdk.js +2007 -1396
  10. package/dist/vector-backfill-runner.js +1610 -1086
  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 +51 -5
  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 +18 -11
  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 +29 -7
  37. package/src/cli/commands/serve-shared.ts +49 -6
  38. package/src/cli/commands/serve.ts +4 -0
  39. package/src/cli/commands/skills.ts +114 -114
  40. package/src/cli/commands/task.ts +167 -167
  41. package/src/cli/commands/transfer.ts +47 -47
  42. package/src/cli/index.ts +406 -406
  43. package/src/cli/tui/ChatView.tsx +234 -234
  44. package/src/cli/tui/CommandBar.tsx +312 -312
  45. package/src/cli/tui/ContextRail.tsx +118 -118
  46. package/src/cli/tui/HeaderBar.tsx +72 -72
  47. package/src/cli/tui/LogoBanner.tsx +51 -51
  48. package/src/cli/tui/index.ts +41 -41
  49. package/src/cli/version.ts +7 -7
  50. package/src/cli/workbench.ts +1 -1
  51. package/src/dashboard/project-classification.ts +64 -64
  52. package/src/embedding/api-provider.ts +503 -27
  53. package/src/embedding/provider.ts +20 -3
  54. package/src/git/hooks-path.ts +85 -85
  55. package/src/hooks/lifecycle.ts +1 -0
  56. package/src/hooks/pattern-detector.ts +173 -173
  57. package/src/hooks/significance-filter.ts +250 -250
  58. package/src/llm/memory-manager.ts +328 -328
  59. package/src/llm/quality.ts +248 -248
  60. package/src/memory/attribution-guard.ts +249 -249
  61. package/src/memory/disclosure-policy.ts +135 -135
  62. package/src/memory/entity-extractor.ts +197 -197
  63. package/src/memory/formation/evaluate.ts +217 -217
  64. package/src/memory/freshness.ts +122 -122
  65. package/src/memory/graph.ts +197 -197
  66. package/src/memory/observations.ts +68 -18
  67. package/src/memory/refs.ts +94 -94
  68. package/src/memory/secret-filter.ts +79 -79
  69. package/src/memory/session.ts +13 -3
  70. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  71. package/src/orchestrate/adapters/claude.ts +111 -111
  72. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  73. package/src/orchestrate/adapters/codex.ts +41 -41
  74. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  75. package/src/orchestrate/adapters/gemini.ts +42 -42
  76. package/src/orchestrate/adapters/index.ts +73 -73
  77. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  78. package/src/orchestrate/adapters/opencode.ts +47 -47
  79. package/src/orchestrate/adapters/types.ts +77 -77
  80. package/src/orchestrate/capability-router.ts +284 -284
  81. package/src/orchestrate/cost-tracker.ts +219 -219
  82. package/src/orchestrate/error-recovery.ts +191 -191
  83. package/src/orchestrate/evidence.ts +140 -140
  84. package/src/orchestrate/ledger.ts +110 -110
  85. package/src/orchestrate/memorix-bridge.ts +343 -343
  86. package/src/orchestrate/output-budget.ts +80 -80
  87. package/src/orchestrate/permission.ts +152 -152
  88. package/src/orchestrate/pipeline-trace.ts +131 -131
  89. package/src/orchestrate/prompt-builder.ts +155 -155
  90. package/src/orchestrate/ring-buffer.ts +37 -37
  91. package/src/orchestrate/task-graph.ts +389 -389
  92. package/src/project/aliases.ts +374 -374
  93. package/src/project/launch-root.ts +115 -0
  94. package/src/rules/adapters/trae.ts +56 -56
  95. package/src/rules/syncer.ts +235 -235
  96. package/src/runtime/isolated-maintenance.ts +12 -1
  97. package/src/sdk.ts +12 -8
  98. package/src/search/query-expansion.ts +52 -52
  99. package/src/server/formation-timeout.ts +27 -27
  100. package/src/server.ts +38 -5
  101. package/src/skills/mini-skills.ts +386 -386
  102. package/src/store/chat-store.ts +119 -119
  103. package/src/store/graph-store.ts +249 -249
  104. package/src/store/mini-skill-store.ts +349 -349
  105. package/src/store/obs-store.ts +2 -2
  106. package/src/store/orama-store.ts +21 -3
  107. package/src/store/persistence-json.ts +212 -212
  108. package/src/store/persistence.ts +291 -291
  109. package/src/store/project-affinity.ts +195 -195
  110. package/src/store/sqlite-db.ts +2 -0
  111. package/src/store/sqlite-store.ts +19 -4
  112. package/src/team/event-bus.ts +76 -76
  113. package/src/team/handoff.ts +161 -161
  114. package/src/team/poll.ts +132 -132
  115. package/src/workspace/mcp-adapters/codex.ts +191 -191
  116. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  117. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  118. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  119. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  120. package/src/workspace/mcp-adapters/trae.ts +134 -134
  121. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  122. 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
+ }