memorix 1.1.7 → 1.1.9

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