memorix 1.4.3 → 1.4.5

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 (158) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +20 -6
  3. package/README.zh-CN.md +16 -3
  4. package/TEAM.md +86 -86
  5. package/assets/star-history-dark.svg +8 -8
  6. package/assets/star-history-light.svg +8 -8
  7. package/assets/star-history.json +16 -2
  8. package/dist/cli/index.js +539 -233
  9. package/dist/cli/memcode.js +0 -0
  10. package/dist/index.js +72 -15
  11. package/dist/maintenance-runner.js +9 -7
  12. package/dist/media-audio-runner.js +9 -7
  13. package/dist/media-video-runner.js +9 -7
  14. package/dist/memcode/index.js +9 -7
  15. package/dist/memcode-runtime/CHANGELOG.md +34 -0
  16. package/dist/sdk.js +71 -14
  17. package/dist/types.d.ts +1 -1
  18. package/dist/vector-backfill-runner.js +9 -7
  19. package/docs/AGENT_OPERATOR_PLAYBOOK.md +6 -5
  20. package/docs/API_REFERENCE.md +9 -5
  21. package/docs/CONFIGURATION.md +15 -5
  22. package/docs/DESIGN_DECISIONS.md +357 -357
  23. package/docs/DEVELOPMENT.md +2 -2
  24. package/docs/INTEGRATIONS.md +9 -2
  25. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +4 -3
  26. package/docs/MEMCODE.md +1 -1
  27. package/docs/MODULES.md +1 -1
  28. package/docs/README.md +1 -1
  29. package/docs/SETUP.md +12 -4
  30. package/docs/hooks-architecture.md +2 -1
  31. package/llms-full.txt +7 -6
  32. package/llms.txt +2 -2
  33. package/package.json +1 -1
  34. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  35. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  36. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  37. package/plugins/copilot/memorix/plugin.json +1 -1
  38. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  39. package/plugins/omp/memorix/package.json +1 -1
  40. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  41. package/plugins/pi/memorix/package.json +1 -1
  42. package/server.json +2 -2
  43. package/src/audit/index.ts +156 -156
  44. package/src/cli/commands/agent-integrations.ts +7 -1
  45. package/src/cli/commands/audit-list.ts +89 -89
  46. package/src/cli/commands/formation.ts +48 -48
  47. package/src/cli/commands/git-hook-install.ts +111 -111
  48. package/src/cli/commands/handoff.ts +54 -54
  49. package/src/cli/commands/hooks-install.ts +2 -0
  50. package/src/cli/commands/hooks-preview.ts +5 -0
  51. package/src/cli/commands/hooks-status.ts +63 -63
  52. package/src/cli/commands/ingest.ts +44 -44
  53. package/src/cli/commands/integrate-shared.ts +15 -15
  54. package/src/cli/commands/integrate.ts +2 -0
  55. package/src/cli/commands/lock.ts +82 -82
  56. package/src/cli/commands/media-image.ts +27 -0
  57. package/src/cli/commands/media.ts +8 -1
  58. package/src/cli/commands/memory.ts +44 -34
  59. package/src/cli/commands/message.ts +104 -104
  60. package/src/cli/commands/operator-shared.ts +62 -18
  61. package/src/cli/commands/poll.ts +58 -58
  62. package/src/cli/commands/purge-all-memory.ts +85 -85
  63. package/src/cli/commands/purge-project-memory.ts +83 -83
  64. package/src/cli/commands/reasoning.ts +118 -118
  65. package/src/cli/commands/setup.ts +57 -2
  66. package/src/cli/commands/skills.ts +114 -114
  67. package/src/cli/commands/task.ts +167 -167
  68. package/src/cli/commands/transfer.ts +47 -47
  69. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  70. package/src/cli/commands/uninstall.ts +20 -0
  71. package/src/cli/tui/ChatView.tsx +234 -234
  72. package/src/cli/tui/CommandBar.tsx +312 -312
  73. package/src/cli/tui/ContextRail.tsx +118 -118
  74. package/src/cli/tui/HeaderBar.tsx +72 -72
  75. package/src/cli/tui/LogoBanner.tsx +51 -51
  76. package/src/cli/tui/Sidebar.tsx +179 -179
  77. package/src/cli/tui/index.ts +41 -41
  78. package/src/cli/tui/markdown-render.tsx +371 -371
  79. package/src/cli/tui/use-mouse.ts +157 -157
  80. package/src/cli/tui/useNavigation.ts +56 -56
  81. package/src/cli/version.ts +7 -7
  82. package/src/cli/workbench.ts +1 -1
  83. package/src/dashboard/project-classification.ts +64 -64
  84. package/src/git/hooks-path.ts +85 -85
  85. package/src/hooks/installers/index.ts +43 -2
  86. package/src/hooks/pattern-detector.ts +173 -173
  87. package/src/hooks/significance-filter.ts +250 -250
  88. package/src/hooks/types.ts +2 -0
  89. package/src/integrations/registry.ts +9 -0
  90. package/src/llm/memory-manager.ts +328 -328
  91. package/src/llm/provider.ts +885 -885
  92. package/src/llm/quality.ts +248 -248
  93. package/src/media/minimax.ts +9 -1
  94. package/src/memory/attribution-guard.ts +249 -249
  95. package/src/memory/disclosure-policy.ts +135 -135
  96. package/src/memory/entity-extractor.ts +197 -197
  97. package/src/memory/formation/evaluate.ts +217 -217
  98. package/src/memory/formation/extract.ts +361 -361
  99. package/src/memory/formation/index.ts +417 -417
  100. package/src/memory/formation/resolve.ts +344 -344
  101. package/src/memory/formation/types.ts +315 -315
  102. package/src/memory/freshness.ts +122 -122
  103. package/src/memory/graph.ts +197 -197
  104. package/src/memory/refs.ts +94 -94
  105. package/src/memory/secret-filter.ts +79 -79
  106. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  107. package/src/orchestrate/adapters/claude.ts +111 -111
  108. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  109. package/src/orchestrate/adapters/codex.ts +41 -41
  110. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  111. package/src/orchestrate/adapters/gemini.ts +42 -42
  112. package/src/orchestrate/adapters/index.ts +73 -73
  113. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  114. package/src/orchestrate/adapters/opencode.ts +47 -47
  115. package/src/orchestrate/adapters/types.ts +77 -77
  116. package/src/orchestrate/capability-router.ts +284 -284
  117. package/src/orchestrate/context-compact.ts +188 -188
  118. package/src/orchestrate/cost-tracker.ts +219 -219
  119. package/src/orchestrate/error-recovery.ts +191 -191
  120. package/src/orchestrate/evidence.ts +140 -140
  121. package/src/orchestrate/ledger.ts +110 -110
  122. package/src/orchestrate/memorix-bridge.ts +343 -343
  123. package/src/orchestrate/output-budget.ts +80 -80
  124. package/src/orchestrate/permission.ts +152 -152
  125. package/src/orchestrate/pipeline-trace.ts +131 -131
  126. package/src/orchestrate/prompt-builder.ts +155 -155
  127. package/src/orchestrate/ring-buffer.ts +37 -37
  128. package/src/orchestrate/task-graph.ts +389 -389
  129. package/src/project/aliases.ts +374 -374
  130. package/src/rules/adapters/trae.ts +56 -56
  131. package/src/rules/syncer.ts +235 -235
  132. package/src/search/query-expansion.ts +52 -52
  133. package/src/server/formation-timeout.ts +27 -27
  134. package/src/server.ts +23 -1
  135. package/src/skills/mini-skills.ts +386 -386
  136. package/src/store/chat-store.ts +119 -119
  137. package/src/store/graph-store.ts +249 -249
  138. package/src/store/mini-skill-store.ts +349 -349
  139. package/src/store/persistence-json.ts +212 -212
  140. package/src/store/persistence.ts +291 -291
  141. package/src/store/project-affinity.ts +195 -195
  142. package/src/team/event-bus.ts +76 -76
  143. package/src/team/file-locks.ts +173 -173
  144. package/src/team/handoff.ts +161 -161
  145. package/src/team/messages.ts +203 -203
  146. package/src/team/poll.ts +132 -132
  147. package/src/team/tasks.ts +211 -211
  148. package/src/types.ts +1 -1
  149. package/src/workspace/mcp-adapters/codex.ts +191 -191
  150. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  151. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  152. package/src/workspace/mcp-adapters/dsh.ts +147 -0
  153. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  154. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  155. package/src/workspace/mcp-adapters/trae.ts +134 -134
  156. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  157. package/src/workspace/sanitizer.ts +60 -60
  158. package/dist/memcode-runtime/docs/images/exy.png +0 -0
@@ -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
+ }