memorix 1.2.2 → 1.2.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 (139) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/TEAM.md +86 -86
  3. package/dist/cli/index.js +34 -18
  4. package/dist/cli/index.js.map +1 -1
  5. package/dist/index.js +17 -8
  6. package/dist/index.js.map +1 -1
  7. package/dist/maintenance-runner.js.map +1 -1
  8. package/dist/memcode-runtime/CHANGELOG.md +7 -0
  9. package/dist/sdk.js +17 -8
  10. package/dist/sdk.js.map +1 -1
  11. package/docs/DESIGN_DECISIONS.md +357 -357
  12. package/docs/dev-log/progress.txt +18 -8
  13. package/package.json +1 -1
  14. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  15. package/src/audit/index.ts +156 -156
  16. package/src/cli/commands/audit-list.ts +89 -89
  17. package/src/cli/commands/background.ts +659 -659
  18. package/src/cli/commands/formation.ts +48 -48
  19. package/src/cli/commands/git-hook-install.ts +111 -111
  20. package/src/cli/commands/handoff.ts +54 -54
  21. package/src/cli/commands/hooks-status.ts +63 -63
  22. package/src/cli/commands/ingest-commit.ts +153 -153
  23. package/src/cli/commands/ingest-image.ts +66 -66
  24. package/src/cli/commands/ingest-log.ts +180 -180
  25. package/src/cli/commands/ingest.ts +44 -44
  26. package/src/cli/commands/integrate-shared.ts +15 -15
  27. package/src/cli/commands/lock.ts +82 -82
  28. package/src/cli/commands/message.ts +104 -104
  29. package/src/cli/commands/poll.ts +58 -58
  30. package/src/cli/commands/purge-all-memory.ts +85 -85
  31. package/src/cli/commands/purge-project-memory.ts +83 -83
  32. package/src/cli/commands/reasoning.ts +118 -118
  33. package/src/cli/commands/serve-shared.ts +118 -118
  34. package/src/cli/commands/session.ts +15 -7
  35. package/src/cli/commands/skills.ts +114 -114
  36. package/src/cli/commands/task.ts +167 -167
  37. package/src/cli/commands/transfer.ts +47 -47
  38. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  39. package/src/cli/tui/ChatView.tsx +234 -234
  40. package/src/cli/tui/CommandBar.tsx +312 -312
  41. package/src/cli/tui/ContextRail.tsx +118 -118
  42. package/src/cli/tui/HeaderBar.tsx +72 -72
  43. package/src/cli/tui/LogoBanner.tsx +51 -51
  44. package/src/cli/tui/Sidebar.tsx +179 -179
  45. package/src/cli/tui/index.ts +41 -41
  46. package/src/cli/tui/markdown-render.tsx +371 -371
  47. package/src/cli/tui/session-service.ts +3 -2
  48. package/src/cli/tui/use-mouse.ts +157 -157
  49. package/src/cli/tui/useNavigation.ts +56 -56
  50. package/src/cli/update-checker.ts +211 -211
  51. package/src/cli/version.ts +7 -7
  52. package/src/cli/workbench.ts +1 -1
  53. package/src/compact/token-budget.ts +74 -74
  54. package/src/dashboard/project-classification.ts +64 -64
  55. package/src/embedding/fastembed-provider.ts +142 -142
  56. package/src/embedding/transformers-provider.ts +111 -111
  57. package/src/git/extractor.ts +209 -209
  58. package/src/git/hooks-path.ts +85 -85
  59. package/src/hooks/pattern-detector.ts +173 -173
  60. package/src/hooks/significance-filter.ts +250 -250
  61. package/src/llm/memory-manager.ts +328 -328
  62. package/src/llm/provider.ts +885 -885
  63. package/src/llm/quality.ts +248 -248
  64. package/src/memory/attribution-guard.ts +249 -249
  65. package/src/memory/disclosure-policy.ts +135 -135
  66. package/src/memory/entity-extractor.ts +197 -197
  67. package/src/memory/formation/evaluate.ts +217 -217
  68. package/src/memory/formation/extract.ts +361 -361
  69. package/src/memory/formation/index.ts +417 -417
  70. package/src/memory/formation/resolve.ts +344 -344
  71. package/src/memory/formation/types.ts +315 -315
  72. package/src/memory/freshness.ts +122 -122
  73. package/src/memory/graph.ts +197 -197
  74. package/src/memory/refs.ts +94 -94
  75. package/src/memory/secret-filter.ts +79 -79
  76. package/src/memory/session.ts +24 -9
  77. package/src/multimodal/image-loader.ts +143 -143
  78. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  79. package/src/orchestrate/adapters/claude.ts +111 -111
  80. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  81. package/src/orchestrate/adapters/codex.ts +41 -41
  82. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  83. package/src/orchestrate/adapters/gemini.ts +42 -42
  84. package/src/orchestrate/adapters/index.ts +73 -73
  85. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  86. package/src/orchestrate/adapters/opencode.ts +47 -47
  87. package/src/orchestrate/adapters/spawn-helper.ts +286 -286
  88. package/src/orchestrate/adapters/types.ts +77 -77
  89. package/src/orchestrate/capability-router.ts +284 -284
  90. package/src/orchestrate/context-compact.ts +188 -188
  91. package/src/orchestrate/cost-tracker.ts +219 -219
  92. package/src/orchestrate/error-recovery.ts +191 -191
  93. package/src/orchestrate/evidence.ts +140 -140
  94. package/src/orchestrate/ledger.ts +110 -110
  95. package/src/orchestrate/memorix-bridge.ts +343 -343
  96. package/src/orchestrate/output-budget.ts +80 -80
  97. package/src/orchestrate/permission.ts +152 -152
  98. package/src/orchestrate/pipeline-trace.ts +131 -131
  99. package/src/orchestrate/prompt-builder.ts +155 -155
  100. package/src/orchestrate/ring-buffer.ts +37 -37
  101. package/src/orchestrate/task-graph.ts +389 -389
  102. package/src/orchestrate/worktree.ts +232 -232
  103. package/src/project/aliases.ts +374 -374
  104. package/src/project/detector.ts +268 -268
  105. package/src/rules/adapters/claude-code.ts +99 -99
  106. package/src/rules/adapters/codex.ts +97 -97
  107. package/src/rules/adapters/copilot.ts +124 -124
  108. package/src/rules/adapters/cursor.ts +114 -114
  109. package/src/rules/adapters/kiro.ts +126 -126
  110. package/src/rules/adapters/trae.ts +56 -56
  111. package/src/rules/adapters/windsurf.ts +83 -83
  112. package/src/rules/syncer.ts +235 -235
  113. package/src/sdk.ts +299 -299
  114. package/src/search/intent-detector.ts +289 -289
  115. package/src/search/query-expansion.ts +52 -52
  116. package/src/server/formation-timeout.ts +27 -27
  117. package/src/server.ts +7 -2
  118. package/src/skills/mini-skills.ts +386 -386
  119. package/src/store/chat-store.ts +119 -119
  120. package/src/store/graph-store.ts +249 -249
  121. package/src/store/mini-skill-store.ts +349 -349
  122. package/src/store/persistence-json.ts +212 -212
  123. package/src/store/persistence.ts +291 -291
  124. package/src/store/project-affinity.ts +195 -195
  125. package/src/team/event-bus.ts +76 -76
  126. package/src/team/file-locks.ts +173 -173
  127. package/src/team/handoff.ts +161 -161
  128. package/src/team/messages.ts +203 -203
  129. package/src/team/poll.ts +132 -132
  130. package/src/team/tasks.ts +211 -211
  131. package/src/workspace/mcp-adapters/codex.ts +191 -191
  132. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  133. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  134. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  135. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  136. package/src/workspace/mcp-adapters/trae.ts +134 -134
  137. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  138. package/src/workspace/sanitizer.ts +60 -60
  139. package/src/workspace/workflow-sync.ts +131 -131
@@ -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
+ }