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,371 +1,371 @@
1
- /**
2
- * Lightweight Markdown renderer for Ink TUI.
3
- *
4
- * Parses markdown text and renders it using Ink's <Text> component
5
- * with bold/italic/color support. No external dependencies.
6
- *
7
- * Supported:
8
- * - **bold** → <Text bold>
9
- * - *italic* → <Text italic>
10
- * - `inline code` → <Text color="cyan">
11
- * - # ## ### headings → <Text bold color="brand">
12
- * - - unordered lists → bullet + indent
13
- * - 1. ordered lists → number + indent
14
- * - > blockquotes → <Text color="muted"> with │ prefix
15
- * - [obs:N] citation links → <Text color="brand">
16
- * - --- horizontal rules → ─── separator
17
- */
18
-
19
- import React from 'react';
20
- import { Box, Text } from 'ink';
21
-
22
- // ── Inline markdown tokenizer ────────────────────────────────────
23
-
24
- interface InlineToken {
25
- type: 'text' | 'bold' | 'italic' | 'code' | 'citation';
26
- content: string;
27
- }
28
-
29
- function tokenizeInline(text: string): InlineToken[] {
30
- const tokens: InlineToken[] = [];
31
- let i = 0;
32
-
33
- while (i < text.length) {
34
- // **bold**
35
- if (text[i] === '*' && text[i + 1] === '*') {
36
- const end = text.indexOf('**', i + 2);
37
- if (end !== -1) {
38
- tokens.push({ type: 'bold', content: text.slice(i + 2, end) });
39
- i = end + 2;
40
- continue;
41
- }
42
- }
43
-
44
- // *italic* (but not **)
45
- if (text[i] === '*' && text[i + 1] !== '*' && i > 0 && text[i - 1] !== '*') {
46
- const end = text.indexOf('*', i + 1);
47
- if (end !== -1 && text[end + 1] !== '*') {
48
- tokens.push({ type: 'italic', content: text.slice(i + 1, end) });
49
- i = end + 1;
50
- continue;
51
- }
52
- }
53
-
54
- // `inline code`
55
- if (text[i] === '`') {
56
- const end = text.indexOf('`', i + 1);
57
- if (end !== -1) {
58
- tokens.push({ type: 'code', content: text.slice(i + 1, end) });
59
- i = end + 1;
60
- continue;
61
- }
62
- }
63
-
64
- // [obs:N] citation
65
- const citationMatch = text.slice(i).match(/^\[obs:(\d+)\]/);
66
- if (citationMatch) {
67
- tokens.push({ type: 'citation', content: citationMatch[0] });
68
- i += citationMatch[0].length;
69
- continue;
70
- }
71
-
72
- // Accumulate plain text
73
- let plain = '';
74
- while (i < text.length) {
75
- if (
76
- (text[i] === '*' && text[i + 1] === '*') ||
77
- (text[i] === '*' && text[i + 1] !== '*') ||
78
- text[i] === '`' ||
79
- text.slice(i).startsWith('[obs:')
80
- ) break;
81
- plain += text[i];
82
- i++;
83
- }
84
- if (plain) tokens.push({ type: 'text', content: plain });
85
- }
86
-
87
- return tokens;
88
- }
89
-
90
- // ── Block-level parser ───────────────────────────────────────────
91
-
92
- interface BlockNode {
93
- type: 'heading' | 'paragraph' | 'list' | 'blockquote' | 'hr' | 'code_block';
94
- level?: number; // heading level 1-3
95
- items?: string[]; // list items
96
- ordered?: boolean; // ordered list?
97
- content?: string; // paragraph/heading/blockquote content
98
- language?: string; // code block language
99
- }
100
-
101
- function parseBlocks(text: string): BlockNode[] {
102
- const lines = text.split('\n');
103
- const blocks: BlockNode[] = [];
104
- let i = 0;
105
-
106
- while (i < lines.length) {
107
- const line = lines[i];
108
-
109
- // Horizontal rule
110
- if (/^-{3,}$/.test(line.trim()) || /^\*{3,}$/.test(line.trim())) {
111
- blocks.push({ type: 'hr' });
112
- i++;
113
- continue;
114
- }
115
-
116
- // Heading
117
- const headingMatch = line.match(/^(#{1,3})\s+(.+)/);
118
- if (headingMatch) {
119
- blocks.push({
120
- type: 'heading',
121
- level: headingMatch[1].length,
122
- content: headingMatch[2],
123
- });
124
- i++;
125
- continue;
126
- }
127
-
128
- // Code block (fenced)
129
- if (line.trim().startsWith('```')) {
130
- const lang = line.trim().slice(3).trim();
131
- const codeLines: string[] = [];
132
- i++;
133
- while (i < lines.length && !lines[i].trim().startsWith('```')) {
134
- codeLines.push(lines[i]);
135
- i++;
136
- }
137
- i++; // skip closing ```
138
- blocks.push({
139
- type: 'code_block',
140
- language: lang || undefined,
141
- content: codeLines.join('\n'),
142
- });
143
- continue;
144
- }
145
-
146
- // Blockquote
147
- if (line.startsWith('>')) {
148
- const quoteLines: string[] = [];
149
- while (i < lines.length && lines[i].startsWith('>')) {
150
- quoteLines.push(lines[i].replace(/^>\s?/, ''));
151
- i++;
152
- }
153
- blocks.push({ type: 'blockquote', content: quoteLines.join('\n') });
154
- continue;
155
- }
156
-
157
- // Unordered list
158
- if (/^[-*]\s+/.test(line.trimStart())) {
159
- const items: string[] = [];
160
- while (i < lines.length && /^[-*]\s+/.test(lines[i].trimStart())) {
161
- items.push(lines[i].trimStart().replace(/^[-*]\s+/, ''));
162
- i++;
163
- }
164
- blocks.push({ type: 'list', ordered: false, items });
165
- continue;
166
- }
167
-
168
- // Ordered list
169
- if (/^\d+\.\s+/.test(line.trimStart())) {
170
- const items: string[] = [];
171
- while (i < lines.length && /^\d+\.\s+/.test(lines[i].trimStart())) {
172
- items.push(lines[i].trimStart().replace(/^\d+\.\s+/, ''));
173
- i++;
174
- }
175
- blocks.push({ type: 'list', ordered: true, items });
176
- continue;
177
- }
178
-
179
- // Empty line — skip
180
- if (line.trim() === '') {
181
- i++;
182
- continue;
183
- }
184
-
185
- // Paragraph — accumulate consecutive non-empty lines
186
- const paraLines: string[] = [];
187
- while (i < lines.length && lines[i].trim() !== '' && !lines[i].startsWith('#') && !lines[i].startsWith('>') && !lines[i].startsWith('```') && !/^[-*]\s+/.test(lines[i].trimStart()) && !/^\d+\.\s+/.test(lines[i].trimStart())) {
188
- paraLines.push(lines[i]);
189
- i++;
190
- }
191
- if (paraLines.length > 0) {
192
- blocks.push({ type: 'paragraph', content: paraLines.join(' ') });
193
- }
194
- }
195
-
196
- return blocks;
197
- }
198
-
199
- // ── Colors ───────────────────────────────────────────────────────
200
-
201
- const COLORS = {
202
- brand: '#6C9BD2',
203
- heading: '#89B4FA',
204
- code: '#94E2D5',
205
- codeBlock: '#6C7086',
206
- quote: '#585B70',
207
- citation: '#6C9BD2',
208
- bullet: '#89B4FA',
209
- hr: '#45475A',
210
- text: '#CAD3F5',
211
- };
212
-
213
- // ── Rendering ────────────────────────────────────────────────────
214
-
215
- function renderInlineTokens(tokens: InlineToken[]): React.ReactElement[] {
216
- return tokens.map((token, idx) => {
217
- switch (token.type) {
218
- case 'bold':
219
- return <Text key={idx} bold>{token.content}</Text>;
220
- case 'italic':
221
- return <Text key={idx} italic>{token.content}</Text>;
222
- case 'code':
223
- return <Text key={idx} color={COLORS.code}>{token.content}</Text>;
224
- case 'citation':
225
- return <Text key={idx} color={COLORS.citation} bold>{token.content}</Text>;
226
- default:
227
- return <Text key={idx}>{token.content}</Text>;
228
- }
229
- });
230
- }
231
-
232
- function renderBlock(block: BlockNode, key: number, maxWidth: number): React.ReactElement {
233
- switch (block.type) {
234
- case 'heading':
235
- return (
236
- <Text key={key} bold color={COLORS.heading} wrap="truncate-end">
237
- {'#'.repeat(block.level ?? 1) + ' '}
238
- {renderInlineTokens(tokenizeInline(block.content ?? ''))}
239
- </Text>
240
- );
241
-
242
- case 'paragraph': {
243
- // CJK-aware wrapping: split text by display width, render each line
244
- const lines = cjkAwareLines(block.content ?? '', maxWidth);
245
- return (
246
- <Box key={key} flexDirection="column">
247
- {lines.map((ln, i) => (
248
- <Text key={i}>{renderInlineTokens(tokenizeInline(ln))}</Text>
249
- ))}
250
- </Box>
251
- );
252
- }
253
-
254
- case 'blockquote': {
255
- const lines = cjkAwareLines(block.content ?? '', maxWidth - 2);
256
- return (
257
- <Box key={key} flexDirection="column">
258
- {lines.map((ln, i) => (
259
- <Text key={i} color={COLORS.quote}>{'│ '}{ln}</Text>
260
- ))}
261
- </Box>
262
- );
263
- }
264
-
265
- case 'hr':
266
- return (
267
- <Text key={key} color={COLORS.hr}>{'─'.repeat(Math.min(40, maxWidth))}</Text>
268
- );
269
-
270
- case 'list': {
271
- const items = block.items ?? [];
272
- const prefixLen = block.ordered ? 3 : 2;
273
- return (
274
- <React.Fragment key={key}>
275
- {items.map((item, idx) => {
276
- const lines = cjkAwareLines(item, maxWidth - prefixLen);
277
- return (
278
- <Box key={idx} flexDirection="column">
279
- {lines.map((ln, li) => (
280
- <Text key={li}>
281
- {li === 0 && <Text color={COLORS.bullet}>{block.ordered ? `${idx + 1}. ` : '• '}</Text>}
282
- {li > 0 && <Text>{' '.repeat(prefixLen)}</Text>}
283
- {renderInlineTokens(tokenizeInline(ln))}
284
- </Text>
285
- ))}
286
- </Box>
287
- );
288
- })}
289
- </React.Fragment>
290
- );
291
- }
292
-
293
- case 'code_block': {
294
- const lines = cjkAwareLines(block.content ?? '', maxWidth);
295
- return (
296
- <Box key={key} flexDirection="column">
297
- {lines.map((ln, i) => (
298
- <Text key={i} color={COLORS.codeBlock}>{ln}</Text>
299
- ))}
300
- </Box>
301
- );
302
- }
303
-
304
- default:
305
- return <Text key={key} />;
306
- }
307
- }
308
-
309
- interface MarkdownProps {
310
- children: string;
311
- /** Max display width for CJK-aware line wrapping. Defaults to 80. */
312
- maxWidth?: number;
313
- }
314
-
315
- /** Measure display width counting CJK chars as 2 columns. */
316
- function displayWidth(str: string): number {
317
- let w = 0;
318
- for (const ch of str) {
319
- const cp = ch.codePointAt(0)!;
320
- if ((cp >= 0x4E00 && cp <= 0x9FFF) || (cp >= 0x3040 && cp <= 0x30FF) ||
321
- (cp >= 0xAC00 && cp <= 0xD7AF) || (cp >= 0xFF01 && cp <= 0xFF60) ||
322
- (cp >= 0x3400 && cp <= 0x4DBF)) {
323
- w += 2;
324
- } else {
325
- w += 1;
326
- }
327
- }
328
- return w;
329
- }
330
-
331
- /** Split text into lines respecting CJK double-width characters. */
332
- function cjkAwareLines(text: string, maxCols: number): string[] {
333
- if (maxCols < 4) return [text];
334
- const lines: string[] = [];
335
- let line = '';
336
- let lineW = 0;
337
- for (const ch of text) {
338
- if (ch === '\n') {
339
- lines.push(line);
340
- line = '';
341
- lineW = 0;
342
- continue;
343
- }
344
- const cw = displayWidth(ch);
345
- if (lineW + cw > maxCols && line.length > 0) {
346
- lines.push(line);
347
- line = ch;
348
- lineW = cw;
349
- } else {
350
- line += ch;
351
- lineW += cw;
352
- }
353
- }
354
- if (line) lines.push(line);
355
- return lines.length > 0 ? lines : [''];
356
- }
357
-
358
- /**
359
- * Render markdown text in the terminal using Ink components.
360
- * Uses CJK-aware line wrapping instead of Ink's wrap="wrap"
361
- * which doesn't understand double-width CJK characters.
362
- */
363
- export function Markdown({ children, maxWidth = 80 }: MarkdownProps): React.ReactElement {
364
- const blocks = parseBlocks(children);
365
-
366
- return (
367
- <React.Fragment>
368
- {blocks.map((block, idx) => renderBlock(block, idx, maxWidth))}
369
- </React.Fragment>
370
- );
371
- }
1
+ /**
2
+ * Lightweight Markdown renderer for Ink TUI.
3
+ *
4
+ * Parses markdown text and renders it using Ink's <Text> component
5
+ * with bold/italic/color support. No external dependencies.
6
+ *
7
+ * Supported:
8
+ * - **bold** → <Text bold>
9
+ * - *italic* → <Text italic>
10
+ * - `inline code` → <Text color="cyan">
11
+ * - # ## ### headings → <Text bold color="brand">
12
+ * - - unordered lists → bullet + indent
13
+ * - 1. ordered lists → number + indent
14
+ * - > blockquotes → <Text color="muted"> with │ prefix
15
+ * - [obs:N] citation links → <Text color="brand">
16
+ * - --- horizontal rules → ─── separator
17
+ */
18
+
19
+ import React from 'react';
20
+ import { Box, Text } from 'ink';
21
+
22
+ // ── Inline markdown tokenizer ────────────────────────────────────
23
+
24
+ interface InlineToken {
25
+ type: 'text' | 'bold' | 'italic' | 'code' | 'citation';
26
+ content: string;
27
+ }
28
+
29
+ function tokenizeInline(text: string): InlineToken[] {
30
+ const tokens: InlineToken[] = [];
31
+ let i = 0;
32
+
33
+ while (i < text.length) {
34
+ // **bold**
35
+ if (text[i] === '*' && text[i + 1] === '*') {
36
+ const end = text.indexOf('**', i + 2);
37
+ if (end !== -1) {
38
+ tokens.push({ type: 'bold', content: text.slice(i + 2, end) });
39
+ i = end + 2;
40
+ continue;
41
+ }
42
+ }
43
+
44
+ // *italic* (but not **)
45
+ if (text[i] === '*' && text[i + 1] !== '*' && i > 0 && text[i - 1] !== '*') {
46
+ const end = text.indexOf('*', i + 1);
47
+ if (end !== -1 && text[end + 1] !== '*') {
48
+ tokens.push({ type: 'italic', content: text.slice(i + 1, end) });
49
+ i = end + 1;
50
+ continue;
51
+ }
52
+ }
53
+
54
+ // `inline code`
55
+ if (text[i] === '`') {
56
+ const end = text.indexOf('`', i + 1);
57
+ if (end !== -1) {
58
+ tokens.push({ type: 'code', content: text.slice(i + 1, end) });
59
+ i = end + 1;
60
+ continue;
61
+ }
62
+ }
63
+
64
+ // [obs:N] citation
65
+ const citationMatch = text.slice(i).match(/^\[obs:(\d+)\]/);
66
+ if (citationMatch) {
67
+ tokens.push({ type: 'citation', content: citationMatch[0] });
68
+ i += citationMatch[0].length;
69
+ continue;
70
+ }
71
+
72
+ // Accumulate plain text
73
+ let plain = '';
74
+ while (i < text.length) {
75
+ if (
76
+ (text[i] === '*' && text[i + 1] === '*') ||
77
+ (text[i] === '*' && text[i + 1] !== '*') ||
78
+ text[i] === '`' ||
79
+ text.slice(i).startsWith('[obs:')
80
+ ) break;
81
+ plain += text[i];
82
+ i++;
83
+ }
84
+ if (plain) tokens.push({ type: 'text', content: plain });
85
+ }
86
+
87
+ return tokens;
88
+ }
89
+
90
+ // ── Block-level parser ───────────────────────────────────────────
91
+
92
+ interface BlockNode {
93
+ type: 'heading' | 'paragraph' | 'list' | 'blockquote' | 'hr' | 'code_block';
94
+ level?: number; // heading level 1-3
95
+ items?: string[]; // list items
96
+ ordered?: boolean; // ordered list?
97
+ content?: string; // paragraph/heading/blockquote content
98
+ language?: string; // code block language
99
+ }
100
+
101
+ function parseBlocks(text: string): BlockNode[] {
102
+ const lines = text.split('\n');
103
+ const blocks: BlockNode[] = [];
104
+ let i = 0;
105
+
106
+ while (i < lines.length) {
107
+ const line = lines[i];
108
+
109
+ // Horizontal rule
110
+ if (/^-{3,}$/.test(line.trim()) || /^\*{3,}$/.test(line.trim())) {
111
+ blocks.push({ type: 'hr' });
112
+ i++;
113
+ continue;
114
+ }
115
+
116
+ // Heading
117
+ const headingMatch = line.match(/^(#{1,3})\s+(.+)/);
118
+ if (headingMatch) {
119
+ blocks.push({
120
+ type: 'heading',
121
+ level: headingMatch[1].length,
122
+ content: headingMatch[2],
123
+ });
124
+ i++;
125
+ continue;
126
+ }
127
+
128
+ // Code block (fenced)
129
+ if (line.trim().startsWith('```')) {
130
+ const lang = line.trim().slice(3).trim();
131
+ const codeLines: string[] = [];
132
+ i++;
133
+ while (i < lines.length && !lines[i].trim().startsWith('```')) {
134
+ codeLines.push(lines[i]);
135
+ i++;
136
+ }
137
+ i++; // skip closing ```
138
+ blocks.push({
139
+ type: 'code_block',
140
+ language: lang || undefined,
141
+ content: codeLines.join('\n'),
142
+ });
143
+ continue;
144
+ }
145
+
146
+ // Blockquote
147
+ if (line.startsWith('>')) {
148
+ const quoteLines: string[] = [];
149
+ while (i < lines.length && lines[i].startsWith('>')) {
150
+ quoteLines.push(lines[i].replace(/^>\s?/, ''));
151
+ i++;
152
+ }
153
+ blocks.push({ type: 'blockquote', content: quoteLines.join('\n') });
154
+ continue;
155
+ }
156
+
157
+ // Unordered list
158
+ if (/^[-*]\s+/.test(line.trimStart())) {
159
+ const items: string[] = [];
160
+ while (i < lines.length && /^[-*]\s+/.test(lines[i].trimStart())) {
161
+ items.push(lines[i].trimStart().replace(/^[-*]\s+/, ''));
162
+ i++;
163
+ }
164
+ blocks.push({ type: 'list', ordered: false, items });
165
+ continue;
166
+ }
167
+
168
+ // Ordered list
169
+ if (/^\d+\.\s+/.test(line.trimStart())) {
170
+ const items: string[] = [];
171
+ while (i < lines.length && /^\d+\.\s+/.test(lines[i].trimStart())) {
172
+ items.push(lines[i].trimStart().replace(/^\d+\.\s+/, ''));
173
+ i++;
174
+ }
175
+ blocks.push({ type: 'list', ordered: true, items });
176
+ continue;
177
+ }
178
+
179
+ // Empty line — skip
180
+ if (line.trim() === '') {
181
+ i++;
182
+ continue;
183
+ }
184
+
185
+ // Paragraph — accumulate consecutive non-empty lines
186
+ const paraLines: string[] = [];
187
+ while (i < lines.length && lines[i].trim() !== '' && !lines[i].startsWith('#') && !lines[i].startsWith('>') && !lines[i].startsWith('```') && !/^[-*]\s+/.test(lines[i].trimStart()) && !/^\d+\.\s+/.test(lines[i].trimStart())) {
188
+ paraLines.push(lines[i]);
189
+ i++;
190
+ }
191
+ if (paraLines.length > 0) {
192
+ blocks.push({ type: 'paragraph', content: paraLines.join(' ') });
193
+ }
194
+ }
195
+
196
+ return blocks;
197
+ }
198
+
199
+ // ── Colors ───────────────────────────────────────────────────────
200
+
201
+ const COLORS = {
202
+ brand: '#6C9BD2',
203
+ heading: '#89B4FA',
204
+ code: '#94E2D5',
205
+ codeBlock: '#6C7086',
206
+ quote: '#585B70',
207
+ citation: '#6C9BD2',
208
+ bullet: '#89B4FA',
209
+ hr: '#45475A',
210
+ text: '#CAD3F5',
211
+ };
212
+
213
+ // ── Rendering ────────────────────────────────────────────────────
214
+
215
+ function renderInlineTokens(tokens: InlineToken[]): React.ReactElement[] {
216
+ return tokens.map((token, idx) => {
217
+ switch (token.type) {
218
+ case 'bold':
219
+ return <Text key={idx} bold>{token.content}</Text>;
220
+ case 'italic':
221
+ return <Text key={idx} italic>{token.content}</Text>;
222
+ case 'code':
223
+ return <Text key={idx} color={COLORS.code}>{token.content}</Text>;
224
+ case 'citation':
225
+ return <Text key={idx} color={COLORS.citation} bold>{token.content}</Text>;
226
+ default:
227
+ return <Text key={idx}>{token.content}</Text>;
228
+ }
229
+ });
230
+ }
231
+
232
+ function renderBlock(block: BlockNode, key: number, maxWidth: number): React.ReactElement {
233
+ switch (block.type) {
234
+ case 'heading':
235
+ return (
236
+ <Text key={key} bold color={COLORS.heading} wrap="truncate-end">
237
+ {'#'.repeat(block.level ?? 1) + ' '}
238
+ {renderInlineTokens(tokenizeInline(block.content ?? ''))}
239
+ </Text>
240
+ );
241
+
242
+ case 'paragraph': {
243
+ // CJK-aware wrapping: split text by display width, render each line
244
+ const lines = cjkAwareLines(block.content ?? '', maxWidth);
245
+ return (
246
+ <Box key={key} flexDirection="column">
247
+ {lines.map((ln, i) => (
248
+ <Text key={i}>{renderInlineTokens(tokenizeInline(ln))}</Text>
249
+ ))}
250
+ </Box>
251
+ );
252
+ }
253
+
254
+ case 'blockquote': {
255
+ const lines = cjkAwareLines(block.content ?? '', maxWidth - 2);
256
+ return (
257
+ <Box key={key} flexDirection="column">
258
+ {lines.map((ln, i) => (
259
+ <Text key={i} color={COLORS.quote}>{'│ '}{ln}</Text>
260
+ ))}
261
+ </Box>
262
+ );
263
+ }
264
+
265
+ case 'hr':
266
+ return (
267
+ <Text key={key} color={COLORS.hr}>{'─'.repeat(Math.min(40, maxWidth))}</Text>
268
+ );
269
+
270
+ case 'list': {
271
+ const items = block.items ?? [];
272
+ const prefixLen = block.ordered ? 3 : 2;
273
+ return (
274
+ <React.Fragment key={key}>
275
+ {items.map((item, idx) => {
276
+ const lines = cjkAwareLines(item, maxWidth - prefixLen);
277
+ return (
278
+ <Box key={idx} flexDirection="column">
279
+ {lines.map((ln, li) => (
280
+ <Text key={li}>
281
+ {li === 0 && <Text color={COLORS.bullet}>{block.ordered ? `${idx + 1}. ` : '• '}</Text>}
282
+ {li > 0 && <Text>{' '.repeat(prefixLen)}</Text>}
283
+ {renderInlineTokens(tokenizeInline(ln))}
284
+ </Text>
285
+ ))}
286
+ </Box>
287
+ );
288
+ })}
289
+ </React.Fragment>
290
+ );
291
+ }
292
+
293
+ case 'code_block': {
294
+ const lines = cjkAwareLines(block.content ?? '', maxWidth);
295
+ return (
296
+ <Box key={key} flexDirection="column">
297
+ {lines.map((ln, i) => (
298
+ <Text key={i} color={COLORS.codeBlock}>{ln}</Text>
299
+ ))}
300
+ </Box>
301
+ );
302
+ }
303
+
304
+ default:
305
+ return <Text key={key} />;
306
+ }
307
+ }
308
+
309
+ interface MarkdownProps {
310
+ children: string;
311
+ /** Max display width for CJK-aware line wrapping. Defaults to 80. */
312
+ maxWidth?: number;
313
+ }
314
+
315
+ /** Measure display width counting CJK chars as 2 columns. */
316
+ function displayWidth(str: string): number {
317
+ let w = 0;
318
+ for (const ch of str) {
319
+ const cp = ch.codePointAt(0)!;
320
+ if ((cp >= 0x4E00 && cp <= 0x9FFF) || (cp >= 0x3040 && cp <= 0x30FF) ||
321
+ (cp >= 0xAC00 && cp <= 0xD7AF) || (cp >= 0xFF01 && cp <= 0xFF60) ||
322
+ (cp >= 0x3400 && cp <= 0x4DBF)) {
323
+ w += 2;
324
+ } else {
325
+ w += 1;
326
+ }
327
+ }
328
+ return w;
329
+ }
330
+
331
+ /** Split text into lines respecting CJK double-width characters. */
332
+ function cjkAwareLines(text: string, maxCols: number): string[] {
333
+ if (maxCols < 4) return [text];
334
+ const lines: string[] = [];
335
+ let line = '';
336
+ let lineW = 0;
337
+ for (const ch of text) {
338
+ if (ch === '\n') {
339
+ lines.push(line);
340
+ line = '';
341
+ lineW = 0;
342
+ continue;
343
+ }
344
+ const cw = displayWidth(ch);
345
+ if (lineW + cw > maxCols && line.length > 0) {
346
+ lines.push(line);
347
+ line = ch;
348
+ lineW = cw;
349
+ } else {
350
+ line += ch;
351
+ lineW += cw;
352
+ }
353
+ }
354
+ if (line) lines.push(line);
355
+ return lines.length > 0 ? lines : [''];
356
+ }
357
+
358
+ /**
359
+ * Render markdown text in the terminal using Ink components.
360
+ * Uses CJK-aware line wrapping instead of Ink's wrap="wrap"
361
+ * which doesn't understand double-width CJK characters.
362
+ */
363
+ export function Markdown({ children, maxWidth = 80 }: MarkdownProps): React.ReactElement {
364
+ const blocks = parseBlocks(children);
365
+
366
+ return (
367
+ <React.Fragment>
368
+ {blocks.map((block, idx) => renderBlock(block, idx, maxWidth))}
369
+ </React.Fragment>
370
+ );
371
+ }