@task-mcp/cli 1.0.11 → 1.0.12

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 (2) hide show
  1. package/package.json +3 -3
  2. package/src/ansi.ts +49 -452
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@task-mcp/cli",
3
- "version": "1.0.11",
3
+ "version": "1.0.12",
4
4
  "description": "Zero-dependency CLI for task-mcp with Bun native visualization",
5
5
  "type": "module",
6
6
  "bin": {
@@ -30,8 +30,8 @@
30
30
  "directory": "packages/cli"
31
31
  },
32
32
  "dependencies": {
33
- "@task-mcp/mcp-server": "^1.0.10",
34
- "@task-mcp/shared": "^1.0.9"
33
+ "@task-mcp/mcp-server": "^1.0.11",
34
+ "@task-mcp/shared": "^1.0.10"
35
35
  },
36
36
  "devDependencies": {
37
37
  "@types/bun": "^1.1.14",
package/src/ansi.ts CHANGED
@@ -1,453 +1,50 @@
1
1
  /**
2
- * Zero-dependency ANSI utilities for terminal visualization
3
- * Uses Bun native APIs where available, falls back to raw ANSI codes
4
- */
5
-
6
- // ANSI escape codes
7
- const ESC = "\x1b[";
8
- const RESET = `${ESC}0m`;
9
-
10
- // Color codes (foreground)
11
- const FG = {
12
- black: 30,
13
- red: 31,
14
- green: 32,
15
- yellow: 33,
16
- blue: 34,
17
- magenta: 35,
18
- cyan: 36,
19
- white: 37,
20
- gray: 90,
21
- brightRed: 91,
22
- brightGreen: 92,
23
- brightYellow: 93,
24
- brightBlue: 94,
25
- brightMagenta: 95,
26
- brightCyan: 96,
27
- brightWhite: 97,
28
- } as const;
29
-
30
- // Style codes
31
- const STYLE = {
32
- bold: 1,
33
- dim: 2,
34
- italic: 3,
35
- underline: 4,
36
- inverse: 7,
37
- strikethrough: 9,
38
- } as const;
39
-
40
- type ColorName = keyof typeof FG;
41
- type StyleName = keyof typeof STYLE;
42
-
43
- /**
44
- * Apply color to text
45
- */
46
- export function color(text: string, colorName: ColorName): string {
47
- return `${ESC}${FG[colorName]}m${text}${RESET}`;
48
- }
49
-
50
- /**
51
- * Apply style to text
52
- */
53
- export function style(text: string, styleName: StyleName): string {
54
- return `${ESC}${STYLE[styleName]}m${text}${RESET}`;
55
- }
56
-
57
- /**
58
- * Combine color and style
59
- */
60
- export function styled(text: string, colorName: ColorName, styleName?: StyleName): string {
61
- if (styleName) {
62
- return `${ESC}${STYLE[styleName]};${FG[colorName]}m${text}${RESET}`;
63
- }
64
- return color(text, colorName);
65
- }
66
-
67
- // Convenience color functions
68
- export const c = {
69
- red: (t: string) => color(t, "red"),
70
- green: (t: string) => color(t, "green"),
71
- yellow: (t: string) => color(t, "yellow"),
72
- blue: (t: string) => color(t, "blue"),
73
- cyan: (t: string) => color(t, "cyan"),
74
- magenta: (t: string) => color(t, "magenta"),
75
- gray: (t: string) => color(t, "gray"),
76
- white: (t: string) => color(t, "white"),
77
- bold: (t: string) => style(t, "bold"),
78
- dim: (t: string) => style(t, "dim"),
79
-
80
- // Semantic colors
81
- success: (t: string) => color(t, "green"),
82
- error: (t: string) => color(t, "red"),
83
- warning: (t: string) => color(t, "yellow"),
84
- info: (t: string) => color(t, "cyan"),
85
- muted: (t: string) => color(t, "gray"),
86
- };
87
-
88
- // Box drawing characters (Unicode)
89
- export const BOX = {
90
- // Single line
91
- topLeft: "┌",
92
- topRight: "┐",
93
- bottomLeft: "└",
94
- bottomRight: "┘",
95
- horizontal: "─",
96
- vertical: "│",
97
-
98
- // T-junctions
99
- tTop: "┬",
100
- tBottom: "┴",
101
- tLeft: "├",
102
- tRight: "┤",
103
- cross: "┼",
104
-
105
- // Double line
106
- dTopLeft: "╔",
107
- dTopRight: "╗",
108
- dBottomLeft: "╚",
109
- dBottomRight: "╝",
110
- dHorizontal: "═",
111
- dVertical: "║",
112
-
113
- // Rounded
114
- rTopLeft: "╭",
115
- rTopRight: "╮",
116
- rBottomLeft: "╰",
117
- rBottomRight: "╯",
118
- } as const;
119
-
120
- /**
121
- * Create a horizontal line
122
- */
123
- export function hline(width: number, char: string = BOX.horizontal): string {
124
- return char.repeat(width);
125
- }
126
-
127
- /**
128
- * Create a box around text
129
- */
130
- export function box(content: string, options: {
131
- padding?: number;
132
- borderColor?: ColorName;
133
- title?: string;
134
- rounded?: boolean;
135
- } = {}): string {
136
- const { padding = 1, borderColor = "cyan", title, rounded = true } = options;
137
-
138
- const lines = content.split("\n");
139
- const maxLen = Math.max(...lines.map(l => displayWidth(stripAnsi(l))), title ? title.length + 2 : 0);
140
- const innerWidth = maxLen + padding * 2;
141
-
142
- const tl = rounded ? BOX.rTopLeft : BOX.topLeft;
143
- const tr = rounded ? BOX.rTopRight : BOX.topRight;
144
- const bl = rounded ? BOX.rBottomLeft : BOX.bottomLeft;
145
- const br = rounded ? BOX.rBottomRight : BOX.bottomRight;
146
- const h = BOX.horizontal;
147
- const v = BOX.vertical;
148
-
149
- const applyBorder = (s: string) => color(s, borderColor);
150
-
151
- // Top border with optional title
152
- let top: string;
153
- if (title) {
154
- const titlePart = ` ${title} `;
155
- const remaining = innerWidth - titlePart.length;
156
- const leftPad = Math.floor(remaining / 2);
157
- const rightPad = remaining - leftPad;
158
- top = applyBorder(tl + h.repeat(leftPad)) + c.bold(titlePart) + applyBorder(h.repeat(rightPad) + tr);
159
- } else {
160
- top = applyBorder(tl + h.repeat(innerWidth) + tr);
161
- }
162
-
163
- // Padding lines
164
- const padLine = applyBorder(v) + " ".repeat(innerWidth) + applyBorder(v);
165
- const paddingLines = Array(padding).fill(padLine);
166
-
167
- // Content lines
168
- const contentLines = lines.map(line => {
169
- const lineWidth = displayWidth(stripAnsi(line));
170
- const padRight = innerWidth - lineWidth - padding;
171
- return applyBorder(v) + " ".repeat(padding) + line + " ".repeat(Math.max(0, padRight)) + applyBorder(v);
172
- });
173
-
174
- // Bottom border
175
- const bottom = applyBorder(bl + h.repeat(innerWidth) + br);
176
-
177
- return [top, ...paddingLines, ...contentLines, ...paddingLines, bottom].join("\n");
178
- }
179
-
180
- /**
181
- * Strip ANSI codes from string (for length calculation)
182
- */
183
- export function stripAnsi(str: string): string {
184
- return str.replace(/\x1b\[[0-9;]*m/g, "");
185
- }
186
-
187
- /**
188
- * Check if a character is a wide character (CJK, emoji, etc.)
189
- * Wide characters take 2 columns in terminal
190
- */
191
- function isWideChar(char: string): boolean {
192
- const code = char.codePointAt(0) ?? 0;
193
-
194
- // CJK ranges
195
- if (
196
- (code >= 0x1100 && code <= 0x115F) || // Hangul Jamo
197
- (code >= 0x2E80 && code <= 0x9FFF) || // CJK
198
- (code >= 0xAC00 && code <= 0xD7AF) || // Hangul Syllables
199
- (code >= 0xF900 && code <= 0xFAFF) || // CJK Compatibility
200
- (code >= 0xFE10 && code <= 0xFE1F) || // Vertical forms
201
- (code >= 0xFE30 && code <= 0xFE6F) || // CJK Compatibility Forms
202
- (code >= 0xFF00 && code <= 0xFF60) || // Fullwidth Forms
203
- (code >= 0xFFE0 && code <= 0xFFE6) || // Fullwidth Signs
204
- (code >= 0x20000 && code <= 0x2FFFF) // CJK Extension B+
205
- ) {
206
- return true;
207
- }
208
- return false;
209
- }
210
-
211
- /**
212
- * Get display width of a string (CJK = 2, ASCII = 1)
213
- */
214
- export function displayWidth(str: string): number {
215
- const stripped = stripAnsi(str);
216
- let width = 0;
217
- for (const char of stripped) {
218
- width += isWideChar(char) ? 2 : 1;
219
- }
220
- return width;
221
- }
222
-
223
- /**
224
- * Pad string to width (accounting for ANSI codes and wide characters)
225
- */
226
- export function pad(str: string, width: number, align: "left" | "right" | "center" = "left"): string {
227
- const len = displayWidth(str);
228
- const diff = width - len;
229
- if (diff <= 0) return str;
230
-
231
- switch (align) {
232
- case "right":
233
- return " ".repeat(diff) + str;
234
- case "center":
235
- const left = Math.floor(diff / 2);
236
- return " ".repeat(left) + str + " ".repeat(diff - left);
237
- default:
238
- return str + " ".repeat(diff);
239
- }
240
- }
241
-
242
- /**
243
- * Truncate string to max display width
244
- */
245
- export function truncate(str: string, maxLen: number, suffix = "..."): string {
246
- const stripped = stripAnsi(str);
247
- if (displayWidth(stripped) <= maxLen) return str;
248
-
249
- // Truncate by display width
250
- const suffixWidth = displayWidth(suffix);
251
- let width = 0;
252
- let result = "";
253
-
254
- for (const char of stripped) {
255
- const charWidth = isWideChar(char) ? 2 : 1;
256
- if (width + charWidth > maxLen - suffixWidth) break;
257
- result += char;
258
- width += charWidth;
259
- }
260
-
261
- return result + suffix;
262
- }
263
-
264
- /**
265
- * Create a simple table
266
- */
267
- export interface TableColumn {
268
- header: string;
269
- key: string;
270
- width?: number;
271
- align?: "left" | "right" | "center";
272
- format?: (value: unknown) => string;
273
- }
274
-
275
- export function table<T extends Record<string, unknown>>(
276
- data: T[],
277
- columns: TableColumn[],
278
- options: {
279
- headerColor?: ColorName;
280
- borderColor?: ColorName;
281
- } = {}
282
- ): string {
283
- const { headerColor = "cyan", borderColor = "gray" } = options;
284
-
285
- // Calculate column widths using display width
286
- const widths = columns.map(col => {
287
- const headerWidth = displayWidth(col.header);
288
- const maxDataWidth = Math.max(
289
- ...data.map(row => {
290
- const val = col.format ? col.format(row[col.key]) : String(row[col.key] ?? "");
291
- return displayWidth(val);
292
- }),
293
- 0
294
- );
295
- return col.width ?? Math.max(headerWidth, maxDataWidth);
296
- });
297
-
298
- const border = color(BOX.vertical, borderColor);
299
- const hBorder = color(BOX.horizontal, borderColor);
300
-
301
- // Header
302
- const headerRow = columns
303
- .map((col, i) => color(pad(col.header, widths[i], col.align), headerColor))
304
- .join(` ${border} `);
305
-
306
- // Separator
307
- const separator = widths.map(w => hBorder.repeat(w)).join(color(`─${BOX.cross}─`, borderColor));
308
-
309
- // Data rows
310
- const dataRows = data.map(row =>
311
- columns
312
- .map((col, i) => {
313
- const val = col.format ? col.format(row[col.key]) : String(row[col.key] ?? "");
314
- return pad(truncate(val, widths[i]), widths[i], col.align);
315
- })
316
- .join(` ${border} `)
317
- );
318
-
319
- return [headerRow, separator, ...dataRows].join("\n");
320
- }
321
-
322
- /**
323
- * Create a progress bar
324
- */
325
- export function progressBar(
326
- current: number,
327
- total: number,
328
- options: {
329
- width?: number;
330
- filled?: string;
331
- empty?: string;
332
- showPercent?: boolean;
333
- filledColor?: ColorName;
334
- emptyColor?: ColorName;
335
- } = {}
336
- ): string {
337
- const {
338
- width = 20,
339
- filled = "█",
340
- empty = "░",
341
- showPercent = true,
342
- filledColor = "green",
343
- emptyColor = "gray",
344
- } = options;
345
-
346
- const percent = total > 0 ? Math.round((current / total) * 100) : 0;
347
- const filledCount = Math.round((percent / 100) * width);
348
- const emptyCount = width - filledCount;
349
-
350
- const bar = color(filled.repeat(filledCount), filledColor) + color(empty.repeat(emptyCount), emptyColor);
351
-
352
- return showPercent ? `${bar} ${percent}%` : bar;
353
- }
354
-
355
- /**
356
- * Status icons
357
- */
358
- export const icons = {
359
- // Status
360
- pending: c.yellow("○"),
361
- in_progress: c.blue("◐"),
362
- completed: c.green("✓"),
363
- blocked: c.red("✗"),
364
- cancelled: c.gray("⊘"),
365
-
366
- // Priority
367
- critical: c.red("!!!"),
368
- high: c.yellow("!!"),
369
- medium: c.blue("!"),
370
- low: c.gray("·"),
371
-
372
- // Misc
373
- arrow: c.cyan("→"),
374
- bullet: c.gray("•"),
375
- check: c.green("✓"),
376
- cross: c.red("✗"),
377
- warning: c.yellow("⚠"),
378
- info: c.cyan("ℹ"),
379
- };
380
-
381
- /**
382
- * Place multiple boxes side by side
383
- * Each box is a multi-line string
384
- */
385
- export function sideBySide(boxes: string[], gap: number = 2): string {
386
- // Split each box into lines
387
- const boxLines = boxes.map(b => b.split("\n"));
388
-
389
- // Find max height
390
- const maxHeight = Math.max(...boxLines.map(lines => lines.length));
391
-
392
- // Find width of each box (using first line as reference)
393
- const boxWidths = boxLines.map(lines => {
394
- return Math.max(...lines.map(l => displayWidth(l)));
395
- });
396
-
397
- // Pad each box to max height
398
- const paddedBoxLines = boxLines.map((lines, i) => {
399
- const width = boxWidths[i];
400
- while (lines.length < maxHeight) {
401
- lines.push(" ".repeat(width));
402
- }
403
- // Ensure each line is padded to box width
404
- return lines.map(line => {
405
- const lineWidth = displayWidth(line);
406
- if (lineWidth < width) {
407
- return line + " ".repeat(width - lineWidth);
408
- }
409
- return line;
410
- });
411
- });
412
-
413
- // Combine lines horizontally
414
- const result: string[] = [];
415
- const gapStr = " ".repeat(gap);
416
-
417
- for (let i = 0; i < maxHeight; i++) {
418
- const lineParts = paddedBoxLines.map(lines => lines[i] ?? "");
419
- result.push(lineParts.join(gapStr));
420
- }
421
-
422
- return result.join("\n");
423
- }
424
-
425
- /**
426
- * ASCII art text (simple implementation)
427
- */
428
- export function banner(text: string): string {
429
- // Simple block letters for "TASK MCP"
430
- const letters: Record<string, string[]> = {
431
- T: ["████", " ██ ", " ██ ", " ██ ", " ██ "],
432
- A: [" ██ ", "████", "██ █", "████", "██ █"],
433
- S: ["████", "██ ", "████", " ██", "████"],
434
- K: ["██ █", "███ ", "██ ", "███ ", "██ █"],
435
- M: ["█ █", "██ ██", "█ █ █", "█ █", "█ █"],
436
- C: ["████", "██ ", "██ ", "██ ", "████"],
437
- P: ["████", "██ █", "████", "██ ", "██ "],
438
- " ": [" ", " ", " ", " ", " "],
439
- };
440
-
441
- const chars = text.toUpperCase().split("");
442
- const lines: string[] = ["", "", "", "", ""];
443
-
444
- for (const char of chars) {
445
- const letterLines = letters[char] ?? letters[" "];
446
- for (let i = 0; i < 5; i++) {
447
- lines[i] += (letterLines[i] ?? "") + " ";
448
- }
449
- }
450
-
451
- return lines.map(l => c.cyan(l)).join("\n");
452
- }
453
-
2
+ * Re-export terminal UI utilities from shared package
3
+ * This file exists for backward compatibility
4
+ */
5
+
6
+ export {
7
+ // Colors and styles
8
+ color,
9
+ style,
10
+ styled,
11
+ c,
12
+ // Box drawing
13
+ BOX,
14
+ box,
15
+ drawBox,
16
+ hline,
17
+ // String utilities
18
+ stripAnsi,
19
+ displayWidth,
20
+ visibleLength,
21
+ pad,
22
+ padEnd,
23
+ padStart,
24
+ center,
25
+ truncateStr,
26
+ // Progress bar
27
+ progressBar,
28
+ type ProgressBarOptions,
29
+ // Layout
30
+ sideBySide,
31
+ sideBySideArrays,
32
+ type BoxOptions,
33
+ // Tables
34
+ table,
35
+ renderTable,
36
+ type TableColumn,
37
+ // Formatters
38
+ statusColors,
39
+ statusIcons,
40
+ icons,
41
+ formatStatus,
42
+ priorityColors,
43
+ formatPriority,
44
+ formatDependencies,
45
+ // Banner
46
+ banner,
47
+ } from "@task-mcp/shared";
48
+
49
+ // Alias for CLI compatibility
50
+ export { truncateStr as truncate } from "@task-mcp/shared";