memorix 1.1.7 → 1.1.8

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 (174) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/CLAUDE.md +6 -1
  3. package/README.md +21 -0
  4. package/README.zh-CN.md +21 -0
  5. package/TEAM.md +86 -86
  6. package/dist/cli/index.js +730 -150
  7. package/dist/cli/index.js.map +1 -1
  8. package/dist/dashboard/static/index.html +201 -201
  9. package/dist/dashboard/static/style.css +3584 -3584
  10. package/dist/index.js +15 -8
  11. package/dist/index.js.map +1 -1
  12. package/dist/memcode-runtime/CHANGELOG.md +13 -0
  13. package/dist/memcode-runtime/package.json +4 -4
  14. package/dist/sdk.js +15 -8
  15. package/dist/sdk.js.map +1 -1
  16. package/docs/AGENT_OPERATOR_PLAYBOOK.md +18 -0
  17. package/docs/DESIGN_DECISIONS.md +357 -357
  18. package/docs/SETUP.md +10 -0
  19. package/docs/dev-log/progress.txt +35 -26
  20. package/package.json +1 -1
  21. package/src/audit/index.ts +156 -156
  22. package/src/cli/commands/agent-integrations.ts +623 -0
  23. package/src/cli/commands/audit-list.ts +89 -89
  24. package/src/cli/commands/background.ts +659 -659
  25. package/src/cli/commands/cleanup.ts +255 -255
  26. package/src/cli/commands/doctor.ts +23 -0
  27. package/src/cli/commands/formation.ts +48 -48
  28. package/src/cli/commands/git-hook-install.ts +111 -111
  29. package/src/cli/commands/handoff.ts +66 -66
  30. package/src/cli/commands/hooks-status.ts +63 -63
  31. package/src/cli/commands/ingest-commit.ts +153 -153
  32. package/src/cli/commands/ingest-image.ts +73 -73
  33. package/src/cli/commands/ingest-log.ts +180 -180
  34. package/src/cli/commands/ingest.ts +44 -44
  35. package/src/cli/commands/integrate-shared.ts +15 -15
  36. package/src/cli/commands/lock.ts +96 -96
  37. package/src/cli/commands/message.ts +121 -121
  38. package/src/cli/commands/poll.ts +70 -70
  39. package/src/cli/commands/purge-all-memory.ts +85 -85
  40. package/src/cli/commands/purge-project-memory.ts +83 -83
  41. package/src/cli/commands/reasoning.ts +132 -132
  42. package/src/cli/commands/repair.ts +60 -0
  43. package/src/cli/commands/retention.ts +108 -108
  44. package/src/cli/commands/serve-shared.ts +118 -118
  45. package/src/cli/commands/setup.ts +3 -3
  46. package/src/cli/commands/skills.ts +123 -123
  47. package/src/cli/commands/task.ts +192 -192
  48. package/src/cli/commands/transfer.ts +73 -73
  49. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  50. package/src/cli/index.ts +3 -1
  51. package/src/cli/tui/ChatView.tsx +234 -234
  52. package/src/cli/tui/CommandBar.tsx +312 -312
  53. package/src/cli/tui/ContextRail.tsx +118 -118
  54. package/src/cli/tui/HeaderBar.tsx +72 -72
  55. package/src/cli/tui/LogoBanner.tsx +51 -51
  56. package/src/cli/tui/Panels.tsx +632 -632
  57. package/src/cli/tui/Sidebar.tsx +179 -179
  58. package/src/cli/tui/chat-service.ts +742 -742
  59. package/src/cli/tui/data.ts +547 -547
  60. package/src/cli/tui/index.ts +41 -41
  61. package/src/cli/tui/markdown-render.tsx +371 -371
  62. package/src/cli/tui/theme.ts +178 -178
  63. package/src/cli/tui/use-mouse.ts +157 -157
  64. package/src/cli/tui/useNavigation.ts +56 -56
  65. package/src/cli/update-checker.ts +211 -211
  66. package/src/cli/version.ts +7 -7
  67. package/src/cli/workbench.ts +1 -1
  68. package/src/codegraph/context-pack.ts +5 -1
  69. package/src/codegraph/lite-provider.ts +5 -1
  70. package/src/codegraph/project-context.ts +5 -1
  71. package/src/compact/token-budget.ts +74 -74
  72. package/src/config/behavior.ts +59 -59
  73. package/src/dashboard/project-classification.ts +64 -64
  74. package/src/dashboard/static/index.html +201 -201
  75. package/src/dashboard/static/style.css +3584 -3584
  76. package/src/embedding/fastembed-provider.ts +142 -142
  77. package/src/embedding/transformers-provider.ts +111 -111
  78. package/src/git/extractor.ts +209 -209
  79. package/src/git/hooks-path.ts +85 -85
  80. package/src/git/noise-filter.ts +210 -210
  81. package/src/hooks/installers/index.ts +4 -4
  82. package/src/hooks/official-skills.ts +1 -1
  83. package/src/hooks/pattern-detector.ts +173 -173
  84. package/src/hooks/rules/memorix-agent-rules.md +2 -2
  85. package/src/hooks/significance-filter.ts +250 -250
  86. package/src/llm/memory-manager.ts +328 -328
  87. package/src/llm/provider.ts +885 -885
  88. package/src/llm/quality.ts +248 -248
  89. package/src/memory/attribution-guard.ts +249 -249
  90. package/src/memory/auto-relations.ts +107 -107
  91. package/src/memory/consolidation.ts +302 -302
  92. package/src/memory/disclosure-policy.ts +141 -141
  93. package/src/memory/entity-extractor.ts +197 -197
  94. package/src/memory/formation/evaluate.ts +217 -217
  95. package/src/memory/formation/extract.ts +361 -361
  96. package/src/memory/formation/index.ts +417 -417
  97. package/src/memory/formation/resolve.ts +344 -344
  98. package/src/memory/formation/types.ts +315 -315
  99. package/src/memory/freshness.ts +122 -122
  100. package/src/memory/graph.ts +197 -197
  101. package/src/memory/refs.ts +94 -94
  102. package/src/memory/retention.ts +433 -433
  103. package/src/memory/secret-filter.ts +79 -79
  104. package/src/memory/session.ts +523 -523
  105. package/src/multimodal/image-loader.ts +143 -143
  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/spawn-helper.ts +286 -286
  116. package/src/orchestrate/adapters/types.ts +77 -77
  117. package/src/orchestrate/capability-router.ts +284 -284
  118. package/src/orchestrate/context-compact.ts +188 -188
  119. package/src/orchestrate/cost-tracker.ts +219 -219
  120. package/src/orchestrate/error-recovery.ts +191 -191
  121. package/src/orchestrate/evidence.ts +140 -140
  122. package/src/orchestrate/ledger.ts +110 -110
  123. package/src/orchestrate/memorix-bridge.ts +380 -380
  124. package/src/orchestrate/output-budget.ts +80 -80
  125. package/src/orchestrate/permission.ts +152 -152
  126. package/src/orchestrate/pipeline-trace.ts +131 -131
  127. package/src/orchestrate/prompt-builder.ts +155 -155
  128. package/src/orchestrate/ring-buffer.ts +37 -37
  129. package/src/orchestrate/task-graph.ts +389 -389
  130. package/src/orchestrate/verify-gate.ts +219 -219
  131. package/src/orchestrate/worktree.ts +232 -232
  132. package/src/project/aliases.ts +374 -374
  133. package/src/project/detector.ts +268 -268
  134. package/src/rules/adapters/claude-code.ts +99 -99
  135. package/src/rules/adapters/codex.ts +97 -97
  136. package/src/rules/adapters/copilot.ts +124 -124
  137. package/src/rules/adapters/cursor.ts +114 -114
  138. package/src/rules/adapters/kiro.ts +126 -126
  139. package/src/rules/adapters/trae.ts +56 -56
  140. package/src/rules/adapters/windsurf.ts +83 -83
  141. package/src/rules/syncer.ts +235 -235
  142. package/src/sdk.ts +327 -327
  143. package/src/search/intent-detector.ts +289 -289
  144. package/src/search/query-expansion.ts +52 -52
  145. package/src/server/formation-timeout.ts +27 -27
  146. package/src/skills/mini-skills.ts +386 -386
  147. package/src/store/chat-store.ts +119 -119
  148. package/src/store/file-lock.ts +100 -100
  149. package/src/store/graph-store.ts +249 -249
  150. package/src/store/mini-skill-store.ts +349 -349
  151. package/src/store/obs-store.ts +255 -255
  152. package/src/store/persistence-json.ts +212 -212
  153. package/src/store/persistence.ts +291 -291
  154. package/src/store/project-affinity.ts +195 -195
  155. package/src/store/session-store.ts +259 -259
  156. package/src/store/sqlite-store.ts +339 -339
  157. package/src/team/event-bus.ts +76 -76
  158. package/src/team/file-locks.ts +173 -173
  159. package/src/team/handoff.ts +167 -167
  160. package/src/team/messages.ts +203 -203
  161. package/src/team/poll.ts +132 -132
  162. package/src/team/tasks.ts +211 -211
  163. package/src/wiki/generator.ts +237 -237
  164. package/src/wiki/knowledge-graph.ts +334 -334
  165. package/src/wiki/types.ts +85 -85
  166. package/src/workspace/mcp-adapters/codex.ts +191 -191
  167. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  168. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  169. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  170. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  171. package/src/workspace/mcp-adapters/trae.ts +134 -134
  172. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  173. package/src/workspace/sanitizer.ts +60 -60
  174. 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
+ }