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.
- package/CHANGELOG.md +13 -0
- package/CLAUDE.md +6 -1
- package/README.md +21 -0
- package/README.zh-CN.md +21 -0
- package/TEAM.md +86 -86
- package/dist/cli/index.js +730 -150
- package/dist/cli/index.js.map +1 -1
- package/dist/dashboard/static/index.html +201 -201
- package/dist/dashboard/static/style.css +3584 -3584
- package/dist/index.js +15 -8
- package/dist/index.js.map +1 -1
- package/dist/memcode-runtime/CHANGELOG.md +13 -0
- package/dist/memcode-runtime/package.json +4 -4
- package/dist/sdk.js +15 -8
- package/dist/sdk.js.map +1 -1
- package/docs/AGENT_OPERATOR_PLAYBOOK.md +18 -0
- package/docs/DESIGN_DECISIONS.md +357 -357
- package/docs/SETUP.md +10 -0
- package/docs/dev-log/progress.txt +35 -26
- package/package.json +1 -1
- package/src/audit/index.ts +156 -156
- package/src/cli/commands/agent-integrations.ts +623 -0
- package/src/cli/commands/audit-list.ts +89 -89
- package/src/cli/commands/background.ts +659 -659
- package/src/cli/commands/cleanup.ts +255 -255
- package/src/cli/commands/doctor.ts +23 -0
- package/src/cli/commands/formation.ts +48 -48
- package/src/cli/commands/git-hook-install.ts +111 -111
- package/src/cli/commands/handoff.ts +66 -66
- package/src/cli/commands/hooks-status.ts +63 -63
- package/src/cli/commands/ingest-commit.ts +153 -153
- package/src/cli/commands/ingest-image.ts +73 -73
- package/src/cli/commands/ingest-log.ts +180 -180
- package/src/cli/commands/ingest.ts +44 -44
- package/src/cli/commands/integrate-shared.ts +15 -15
- package/src/cli/commands/lock.ts +96 -96
- package/src/cli/commands/message.ts +121 -121
- package/src/cli/commands/poll.ts +70 -70
- package/src/cli/commands/purge-all-memory.ts +85 -85
- package/src/cli/commands/purge-project-memory.ts +83 -83
- package/src/cli/commands/reasoning.ts +132 -132
- package/src/cli/commands/repair.ts +60 -0
- package/src/cli/commands/retention.ts +108 -108
- package/src/cli/commands/serve-shared.ts +118 -118
- package/src/cli/commands/setup.ts +3 -3
- package/src/cli/commands/skills.ts +123 -123
- package/src/cli/commands/task.ts +192 -192
- package/src/cli/commands/transfer.ts +73 -73
- package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
- package/src/cli/index.ts +3 -1
- package/src/cli/tui/ChatView.tsx +234 -234
- package/src/cli/tui/CommandBar.tsx +312 -312
- package/src/cli/tui/ContextRail.tsx +118 -118
- package/src/cli/tui/HeaderBar.tsx +72 -72
- package/src/cli/tui/LogoBanner.tsx +51 -51
- package/src/cli/tui/Panels.tsx +632 -632
- package/src/cli/tui/Sidebar.tsx +179 -179
- package/src/cli/tui/chat-service.ts +742 -742
- package/src/cli/tui/data.ts +547 -547
- package/src/cli/tui/index.ts +41 -41
- package/src/cli/tui/markdown-render.tsx +371 -371
- package/src/cli/tui/theme.ts +178 -178
- package/src/cli/tui/use-mouse.ts +157 -157
- package/src/cli/tui/useNavigation.ts +56 -56
- package/src/cli/update-checker.ts +211 -211
- package/src/cli/version.ts +7 -7
- package/src/cli/workbench.ts +1 -1
- package/src/codegraph/context-pack.ts +5 -1
- package/src/codegraph/lite-provider.ts +5 -1
- package/src/codegraph/project-context.ts +5 -1
- package/src/compact/token-budget.ts +74 -74
- package/src/config/behavior.ts +59 -59
- package/src/dashboard/project-classification.ts +64 -64
- package/src/dashboard/static/index.html +201 -201
- package/src/dashboard/static/style.css +3584 -3584
- package/src/embedding/fastembed-provider.ts +142 -142
- package/src/embedding/transformers-provider.ts +111 -111
- package/src/git/extractor.ts +209 -209
- package/src/git/hooks-path.ts +85 -85
- package/src/git/noise-filter.ts +210 -210
- package/src/hooks/installers/index.ts +4 -4
- package/src/hooks/official-skills.ts +1 -1
- package/src/hooks/pattern-detector.ts +173 -173
- package/src/hooks/rules/memorix-agent-rules.md +2 -2
- package/src/hooks/significance-filter.ts +250 -250
- package/src/llm/memory-manager.ts +328 -328
- package/src/llm/provider.ts +885 -885
- package/src/llm/quality.ts +248 -248
- package/src/memory/attribution-guard.ts +249 -249
- package/src/memory/auto-relations.ts +107 -107
- package/src/memory/consolidation.ts +302 -302
- package/src/memory/disclosure-policy.ts +141 -141
- package/src/memory/entity-extractor.ts +197 -197
- package/src/memory/formation/evaluate.ts +217 -217
- package/src/memory/formation/extract.ts +361 -361
- package/src/memory/formation/index.ts +417 -417
- package/src/memory/formation/resolve.ts +344 -344
- package/src/memory/formation/types.ts +315 -315
- package/src/memory/freshness.ts +122 -122
- package/src/memory/graph.ts +197 -197
- package/src/memory/refs.ts +94 -94
- package/src/memory/retention.ts +433 -433
- package/src/memory/secret-filter.ts +79 -79
- package/src/memory/session.ts +523 -523
- package/src/multimodal/image-loader.ts +143 -143
- package/src/orchestrate/adapters/claude-stream.ts +192 -192
- package/src/orchestrate/adapters/claude.ts +111 -111
- package/src/orchestrate/adapters/codex-stream.ts +134 -134
- package/src/orchestrate/adapters/codex.ts +41 -41
- package/src/orchestrate/adapters/gemini-stream.ts +166 -166
- package/src/orchestrate/adapters/gemini.ts +42 -42
- package/src/orchestrate/adapters/index.ts +73 -73
- package/src/orchestrate/adapters/opencode-stream.ts +143 -143
- package/src/orchestrate/adapters/opencode.ts +47 -47
- package/src/orchestrate/adapters/spawn-helper.ts +286 -286
- package/src/orchestrate/adapters/types.ts +77 -77
- package/src/orchestrate/capability-router.ts +284 -284
- package/src/orchestrate/context-compact.ts +188 -188
- package/src/orchestrate/cost-tracker.ts +219 -219
- package/src/orchestrate/error-recovery.ts +191 -191
- package/src/orchestrate/evidence.ts +140 -140
- package/src/orchestrate/ledger.ts +110 -110
- package/src/orchestrate/memorix-bridge.ts +380 -380
- package/src/orchestrate/output-budget.ts +80 -80
- package/src/orchestrate/permission.ts +152 -152
- package/src/orchestrate/pipeline-trace.ts +131 -131
- package/src/orchestrate/prompt-builder.ts +155 -155
- package/src/orchestrate/ring-buffer.ts +37 -37
- package/src/orchestrate/task-graph.ts +389 -389
- package/src/orchestrate/verify-gate.ts +219 -219
- package/src/orchestrate/worktree.ts +232 -232
- package/src/project/aliases.ts +374 -374
- package/src/project/detector.ts +268 -268
- package/src/rules/adapters/claude-code.ts +99 -99
- package/src/rules/adapters/codex.ts +97 -97
- package/src/rules/adapters/copilot.ts +124 -124
- package/src/rules/adapters/cursor.ts +114 -114
- package/src/rules/adapters/kiro.ts +126 -126
- package/src/rules/adapters/trae.ts +56 -56
- package/src/rules/adapters/windsurf.ts +83 -83
- package/src/rules/syncer.ts +235 -235
- package/src/sdk.ts +327 -327
- package/src/search/intent-detector.ts +289 -289
- package/src/search/query-expansion.ts +52 -52
- package/src/server/formation-timeout.ts +27 -27
- package/src/skills/mini-skills.ts +386 -386
- package/src/store/chat-store.ts +119 -119
- package/src/store/file-lock.ts +100 -100
- package/src/store/graph-store.ts +249 -249
- package/src/store/mini-skill-store.ts +349 -349
- package/src/store/obs-store.ts +255 -255
- package/src/store/persistence-json.ts +212 -212
- package/src/store/persistence.ts +291 -291
- package/src/store/project-affinity.ts +195 -195
- package/src/store/session-store.ts +259 -259
- package/src/store/sqlite-store.ts +339 -339
- package/src/team/event-bus.ts +76 -76
- package/src/team/file-locks.ts +173 -173
- package/src/team/handoff.ts +167 -167
- package/src/team/messages.ts +203 -203
- package/src/team/poll.ts +132 -132
- package/src/team/tasks.ts +211 -211
- package/src/wiki/generator.ts +237 -237
- package/src/wiki/knowledge-graph.ts +334 -334
- package/src/wiki/types.ts +85 -85
- package/src/workspace/mcp-adapters/codex.ts +191 -191
- package/src/workspace/mcp-adapters/copilot.ts +105 -105
- package/src/workspace/mcp-adapters/cursor.ts +53 -53
- package/src/workspace/mcp-adapters/kiro.ts +64 -64
- package/src/workspace/mcp-adapters/opencode.ts +123 -123
- package/src/workspace/mcp-adapters/trae.ts +134 -134
- package/src/workspace/mcp-adapters/windsurf.ts +91 -91
- package/src/workspace/sanitizer.ts +60 -60
- 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
|
+
}
|