@cacinie/cace-timer 1.3.1 → 1.4.2

package/README.md

@@ -12,20 +12,17 @@ npm install -g @cacinie/cace-timer
 ```
 
 ```
-       ╭──────────╮
-       │  ●   ●   │
-       │    ▽     │
-       │   ───    │
-       ╰──┬────┬──╯
-       ╭──┴────┴──╮
-       │  ╔════╗  │
-       │  ║ CACE║  │
-       │  ╚════╝  │
-       ╰────┬┬────╯
-         ╭──┘└──╮
-         │      │
-         ╰──┬┬──╯
-           ╭┘└╮
+           _,
+          //
+       .-'/`--.
+      / //\     \
+     ///  \ h*   \
+    (|:(O')-(O'):|)
+     |:(//   //):|
+     \: \  v  / :/
+      '- `._.' -'
+        / >o< \
+        '-----'
        CACE TIMER
 ```
 
@@ -210,15 +207,37 @@ Consecutive days with at least one completed task. Break a day and the streak re
 
 ## CACE Mascot
 
-CACE has 5 moods that change based on context:
+CACE uses **MINT**, a teal bob-haired girl with delicate round glasses, a slim,
+rounded jaw and 16 expressions. The dashboard and countdown blink gently;
+one-shot commands print immediately. The artwork automatically steps down from
+full to compact, tiny or text-only as the terminal shrinks.
 
-| Mood | Eyes | Mouth | When |
-|------|------|-------|------|
-| Normal | ● ● | ─── | Default display |
-| Happy | ★ ★ | ◡◡◡ | Task completed |
-| Focused | ◆ ◆ | ▬▬▬ | Pomodoro / active task |
-| Celebrating | ◉ ◉ | ▽△▽ | Points earned + arms up |
-| Sleepy | ─ ─ | ～～ | No active task |
+```bash
+tk mascot preview                         # live preview; n/p selects an expression
+tk mascot preview --all --no-tui           # export all 16 expressions
+tk mascot preview --size compact --ascii   # ASCII art without Unicode glyphs
+tk --no-animation                          # static mascot, live timer
+tk --no-tui                                # plain command output
+tk --color never                           # no foreground colours
+tk --theme light                           # light-terminal palette
+```
+
+`--ascii` changes mascot art; task names and translated UI text keep their original
+characters. Colour modes are `auto`, `always` (truecolor for plain output), `256`
+and `never`. Auto mode respects `NO_COLOR`, `TERM=dumb` and redirected output.
+The blessed TUI maps colours to its supported terminal palette. No terminal
+background, shell configuration or Python runtime is required by the application.
+Preview with `--all` or an explicit `--size` is a static export. Add
+`--expression little_smile` (or another expression key) to select one portrait.
+
+Cancel a countdown with q/Esc/Ctrl+C. Cancellation exits 130 and retains the
+active record; use `tk stop` to finish it. Rendering failures exit 1 without
+adding a completed session. SIGTERM exits 143. Normal q/Esc in the dashboard or
+preview exits 0. Normal timer completion rings once in a supported TTY.
+
+For contributors: `npm test`, `npm run test:cli`, and, on POSIX with Python 3,
+`npm run test:pty`. Tests use temporary timer files. See
+[the design and reference](docs/design/mint.md).
 
 ## Data
 
@@ -456,15 +475,27 @@ tk stop
 
 ## CACE 吉祥物
 
-CACE 有 5 种心情，根据场景变化：
+CACE 采用 **MINT 蓝绿短 bob 女孩**：细圆框、大眼、平顺内收的下颌与小圆下巴，
+无鼻子、无手部，共 16 种表情。仪表盘与番茄钟自然眨眼；开始/恢复等一次性命令即时输出。
+终端缩小时自动切换完整、紧凑、迷你或纯文字布局。
+
+```bash
+tk mascot preview                         # 动态预览，n/p 切换表情
+tk mascot preview --all --no-tui           # 静态输出 16 种表情
+tk mascot preview --size compact --ascii   # 纯 ASCII 角色
+tk --no-animation                          # 关闭动画，计时继续
+tk --no-tui                                # 普通命令输出
+tk --color never                           # 无颜色
+tk --theme light                           # 浅色终端配色
+```
+
+`--ascii` 只替换角色字符，任务名和中文文案保留原文。颜色支持 `auto|always|256|never`；
+自动模式尊重 `NO_COLOR`、`TERM=dumb` 和输出重定向。TUI 颜色适配 blessed 支持的终端调色板。
+应用不需要 Python，也不修改终端背景或 shell 配置。
 
-| 心情 | 眼睛 | 嘴巴 | 时机 |
-|------|------|------|------|
-| 正常 | ● ● | ─── | 默认显示 |
-| 开心 | ★ ★ | ◡◡◡ | 任务完成 |
-| 专注 | ◆ ◆ | ▬▬▬ | 番茄钟 / 活跃任务 |
-| 庆祝 | ◉ ◉ | ▽△▽ | 获得积分 + 举手 |
-| 困了 | ─ ─ | ～～ | 无活跃任务 |
+番茄钟中 q/Esc/Ctrl+C 取消并返回 130，当前记录保留，可用 `tk stop` 结束；
+渲染错误返回 1，不写入已完成历史；SIGTERM 返回 143。仪表盘和预览中 q/Esc 正常退出。
+`--all` 或显式 `--size` 为静态导出，可加 `--expression <表情名称>` 指定单张。
 
 ## 数据
 

package/dist/commands/export.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdExport = cmdExport;
+const terminal_1 = require("../terminal");
 const fs = __importStar(require("fs"));
 const data_1 = require("../data");
 const mascot_1 = require("../mascot");
@@ -57,7 +58,7 @@ function cmdExport(options) {
         output = toCsv(sessions);
     }
     else {
-        console.log(`\x1b[33m${(0, i18n_1.t)('cmd.export.unsupportedFormat')}\x1b[0m`);
+        console.log((0, terminal_1.paint)(`${(0, i18n_1.t)('cmd.export.unsupportedFormat')}`, 'yellow'));
         return;
     }
     if (options.output) {
@@ -73,7 +74,7 @@ function cmdExport(options) {
 function toCsv(sessions) {
     const header = 'ID,Task,Start,End,Duration,Tags,Marks\n';
     const rows = sessions
-        .map(s => {
+        .map((s) => {
         const duration = s.end
             ? (0, utils_1.formatDuration)(new Date(s.end).getTime() - new Date(s.start).getTime())
             : 'running';
@@ -97,7 +98,7 @@ function toMarkdown(sessions) {
         const duration = s.end
             ? (0, utils_1.formatDuration)(new Date(s.end).getTime() - new Date(s.start).getTime())
             : (0, i18n_1.t)('common.running');
-        const tags = s.tags.map(tg => '#' + tg).join(' ');
+        const tags = s.tags.map((tg) => '#' + tg).join(' ');
         md += `| ${i + 1} | ${s.task} | ${(0, utils_1.formatTime)(s.start)} | ${duration} | ${tags} |\n`;
     });
     return md;

package/dist/commands/help.js

@@ -66,6 +66,11 @@ function cmdHelp() {
     console.log(`     ${(0, i18n_1.t)('cmd.help.focusDesc')}`);
     console.log();
     console.log(`  ${(0, i18n_1.t)('cmd.help.lang')}`);
+    console.log(`  ${(0, i18n_1.t)('cmd.help.display')}`);
+    console.log('     --no-animation  --no-tui  --ascii');
+    console.log('     --color auto|always|256|never  --theme dark|light');
+    console.log('  tk mascot preview [--all] [--expression <name>] [--size full|compact|tiny]');
+    console.log(`     ${(0, i18n_1.t)('mascot.help')}`);
     console.log();
     console.log(`  ${(0, i18n_1.t)('cmd.help.help')}`);
     console.log(`     ${(0, i18n_1.t)('cmd.help.helpDesc')}`);

package/dist/commands/mark.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdMark = cmdMark;
+const terminal_1 = require("../terminal");
 const data_1 = require("../data");
 const mascot_1 = require("../mascot");
 const utils_1 = require("../utils");
@@ -8,7 +9,7 @@ const i18n_1 = require("../i18n");
 async function cmdMark(note) {
     const data = (0, data_1.loadData)();
     if (!data.current) {
-        console.log(`\x1b[33m⚠ ${(0, i18n_1.t)('cmd.mark.noActive')}\x1b[0m`);
+        console.log((0, terminal_1.paint)(`⚠ ${(0, i18n_1.t)('cmd.mark.noActive')}`, 'yellow'));
         return;
     }
     const mark = {

package/dist/commands/mascot.d.ts

@@ -0,0 +1,5 @@
+export declare function cmdMascot(options: {
+    all?: boolean;
+    expression?: string;
+    size?: string;
+}): Promise<void>;

package/dist/commands/mascot.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdMascot = cmdMascot;
+const blessed_1 = __importDefault(require("blessed"));
+const mint_1 = require("../mascot/assets/mint");
+const frames_1 = require("../mascot/frames");
+const terminal_1 = require("../terminal");
+const i18n_1 = require("../i18n");
+const tui_1 = require("../tui");
+const surface_1 = require("../tui/surface");
+const animation_1 = require("../tui/animation");
+const lifecycle_1 = require("../tui/lifecycle");
+async function cmdMascot(options) {
+    if (options.expression && !mint_1.EXPRESSIONS.some((item) => item.key === options.expression)) {
+        throw new Error((0, i18n_1.t)('mascot.invalidExpression', { names: mint_1.EXPRESSIONS.map((item) => item.key).join(', ') }));
+    }
+    if (options.size && !['full', 'compact', 'tiny'].includes(options.size)) {
+        throw new Error((0, i18n_1.t)('mascot.invalidSize'));
+    }
+    const display = (0, terminal_1.getDisplay)();
+    if (options.all || options.size || !(0, tui_1.isInteractiveTerminal)()) {
+        const selected = options.all
+            ? mint_1.EXPRESSIONS
+            : mint_1.EXPRESSIONS.filter((item) => item.key === (options.expression ?? 'little_smile'));
+        for (const item of selected) {
+            console.log(`${item.key} / ${item[(0, i18n_1.getLocale)()]}`);
+            console.log((0, frames_1.renderFrame)((0, frames_1.getFrame)({
+                expression: item.key,
+                size: (options.size ?? 'full'),
+                ascii: display.ascii,
+            }), display));
+            console.log();
+        }
+        return;
+    }
+    await new Promise((resolve, reject) => {
+        const screen = blessed_1.default.screen({ smartCSR: true, title: 'CACE / MINT', fullUnicode: true });
+        const surface = (0, surface_1.createSurface)(screen);
+        let loop = undefined;
+        let index = Math.max(0, mint_1.EXPRESSIONS.findIndex((item) => item.key === options.expression));
+        let settled = false;
+        const disposeSignals = (0, lifecycle_1.installSignalCleanup)(screen);
+        screen.once('destroy', () => {
+            loop?.dispose();
+            disposeSignals();
+        });
+        const finish = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            loop?.dispose();
+            (0, lifecycle_1.destroyScreen)(screen);
+            if (error !== undefined)
+                reject(error);
+            else
+                resolve();
+        };
+        screen.key(['escape', 'q'], () => finish());
+        screen.key(['C-c'], () => process.emit('SIGINT'));
+        screen.key(['right', 'n', 'space'], () => {
+            index = (index + 1) % mint_1.EXPRESSIONS.length;
+            loop?.refresh();
+        });
+        screen.key(['left', 'p'], () => {
+            index = (index + mint_1.EXPRESSIONS.length - 1) % mint_1.EXPRESSIONS.length;
+            loop?.refresh();
+        });
+        screen.on('resize', () => loop?.refresh());
+        loop = (0, animation_1.startRefreshLoop)((elapsed) => {
+            const item = mint_1.EXPRESSIONS[index];
+            surface.render(item.key, elapsed, [`C A C E  /  M I N T`, `${index + 1}/16  ${item[(0, i18n_1.getLocale)()]}`, item.key], (0, i18n_1.t)('mascot.controls'));
+        }, finish, display.animation ? 100 : 1000);
+    });
+}

package/dist/commands/pomodoro.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdPomodoro = cmdPomodoro;
+const terminal_1 = require("../terminal");
 const data_1 = require("../data");
 const mascot_1 = require("../mascot");
 const utils_1 = require("../utils");
@@ -9,19 +10,23 @@ const tui_1 = require("../tui");
 const countdown_1 = require("../tui/countdown");
 function getRandomEncouragement() {
     const keys = [
-        'cmd.focus.encourage1', 'cmd.focus.encourage2', 'cmd.focus.encourage3',
-        'cmd.focus.encourage4', 'cmd.focus.encourage5', 'cmd.focus.encourage6',
+        'cmd.focus.encourage1',
+        'cmd.focus.encourage2',
+        'cmd.focus.encourage3',
+        'cmd.focus.encourage4',
+        'cmd.focus.encourage5',
+        'cmd.focus.encourage6',
     ];
     return (0, i18n_1.t)(keys[Math.floor(Math.random() * keys.length)]);
 }
 function normalizeTags(rawTag) {
     if (Array.isArray(rawTag)) {
-        return rawTag.flatMap(tg => tg.split(',').map(s => s.trim())).filter(Boolean);
+        return rawTag.flatMap((tg) => tg.split(',').map((s) => s.trim())).filter(Boolean);
     }
     if (typeof rawTag === 'string') {
         return rawTag
             .split(',')
-            .map(s => s.trim())
+            .map((s) => s.trim())
             .filter(Boolean);
     }
     return [];
@@ -33,18 +38,19 @@ function formatMsAsClock(ms) {
     return `${min.toString().padStart(2, '0')}:${sec.toString().padStart(2, '0')}`;
 }
 function runCountdown(totalMs) {
-    return new Promise(resolve => {
+    return new Promise((resolve) => {
         const startTime = Date.now();
         const barWidth = 20;
         const interval = setInterval(() => {
             const elapsed = Date.now() - startTime;
-            const remaining = Math.max(0, totalMs - elapsed);
             const progress = Math.min(1, elapsed / totalMs);
             const filled = Math.floor(progress * barWidth);
             const bar = '█'.repeat(filled) + '░'.repeat(barWidth - filled);
             const elapsedStr = formatMsAsClock(elapsed);
             const totalStr = formatMsAsClock(totalMs);
-            process.stdout.write(`\r  [${bar}] ${elapsedStr} / ${totalStr}   `);
+            if (process.stdout.isTTY && process.env.TERM !== 'dumb') {
+                process.stdout.write(`\r  [${bar}] ${elapsedStr} / ${totalStr}   `);
+            }
             if (elapsed >= totalMs) {
                 clearInterval(interval);
                 process.stdout.write('\n');
@@ -66,7 +72,7 @@ function runCountdown(totalMs) {
 async function cmdPomodoro(task, options) {
     const data = (0, data_1.loadData)();
     if (data.current) {
-        console.log(`\x1b[33m⚠ ${(0, i18n_1.t)('common.alreadyActive')}\x1b[0m`);
+        console.log((0, terminal_1.paint)(`⚠ ${(0, i18n_1.t)('common.alreadyActive')}`, 'yellow'));
         return;
     }
     const workMin = options.work ?? 25;
@@ -94,14 +100,15 @@ async function cmdPomodoro(task, options) {
         console.log(`  ${getRandomEncouragement()}`);
         if ((0, tui_1.isInteractiveTerminal)()) {
             // TUI countdown with mascot
-            await new Promise(resolve => {
-                (0, countdown_1.showCountdown)({
-                    totalMs: workMin * 60 * 1000,
-                    label: `${(0, i18n_1.t)('cmd.pomodoro.round', { round: String(round), total: String(rounds) })} [${(0, i18n_1.t)('cmd.pomodoro.workPhase')}]`,
-                    mascots: [mascot_1.CACE_FOCUSED, mascot_1.CACE_HAPPY],
-                    onDone: resolve,
-                });
+            const completed = await (0, countdown_1.showCountdown)({
+                totalMs: workMin * 60 * 1000,
+                label: `${task} / ${(0, i18n_1.t)('cmd.pomodoro.round', { round: String(round), total: String(rounds) })}`,
             });
+            if (!completed) {
+                console.log((0, i18n_1.t)('tui.cancelled'));
+                process.exitCode = 130;
+                return;
+            }
         }
         else {
             await runCountdown(workMin * 60 * 1000);
@@ -112,7 +119,8 @@ async function cmdPomodoro(task, options) {
         data.current = null;
         totalWorkMs += workMin * 60 * 1000;
         (0, data_1.saveData)(data);
-        process.stdout.write('\x07'); // bell
+        if (process.stdout.isTTY && process.env.TERM !== 'dumb')
+            process.stdout.write('\x07');
         (0, mascot_1.showCaceSmall)((0, i18n_1.t)('cmd.pomodoro.workDone'), 'happy');
         console.log();
         if (round < rounds) {
@@ -120,7 +128,8 @@ async function cmdPomodoro(task, options) {
             console.log(`  ${(0, i18n_1.t)('cmd.pomodoro.breakTime')}`);
             await runCountdown(breakMin * 60 * 1000);
             totalBreakMs += breakMin * 60 * 1000;
-            process.stdout.write('\x07');
+            if (process.stdout.isTTY && process.env.TERM !== 'dumb')
+                process.stdout.write('\x07');
             (0, mascot_1.showCaceSmall)((0, i18n_1.t)('cmd.pomodoro.breakDone'), 'normal');
             console.log();
         }

package/dist/commands/resume.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdResume = cmdResume;
+const terminal_1 = require("../terminal");
 const data_1 = require("../data");
 const mascot_1 = require("../mascot");
 const utils_1 = require("../utils");
@@ -8,7 +9,7 @@ const i18n_1 = require("../i18n");
 async function cmdResume(options) {
     const data = (0, data_1.loadData)();
     if (data.current) {
-        console.log(`\x1b[33m⚠ ${(0, i18n_1.t)('common.alreadyActive')}\x1b[0m`);
+        console.log((0, terminal_1.paint)(`⚠ ${(0, i18n_1.t)('common.alreadyActive')}`, 'yellow'));
         return;
     }
     if (data.history.length === 0) {
@@ -22,7 +23,7 @@ async function cmdResume(options) {
         source = data.history[0];
     }
     else if (options.id) {
-        source = data.history.find(s => s.id === options.id);
+        source = data.history.find((s) => s.id === options.id);
     }
     if (!source) {
         console.log();

package/dist/commands/start.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdStart = cmdStart;
+const terminal_1 = require("../terminal");
 const data_1 = require("../data");
 const mascot_1 = require("../mascot");
 const utils_1 = require("../utils");
@@ -8,19 +9,19 @@ const i18n_1 = require("../i18n");
 async function cmdStart(task, options) {
     const data = (0, data_1.loadData)();
     if (data.current) {
-        console.log(`\x1b[33m⚠ ${(0, i18n_1.t)('common.alreadyActive')}\x1b[0m`);
+        console.log((0, terminal_1.paint)(`⚠ ${(0, i18n_1.t)('common.alreadyActive')}`, 'yellow'));
         return;
     }
     // Normalize tags: support --tag dev --tag api and --tag dev,api
     let tags = [];
     const rawTag = options.tag;
     if (Array.isArray(rawTag)) {
-        tags = rawTag.flatMap(tag => tag.split(',').map(s => s.trim())).filter(Boolean);
+        tags = rawTag.flatMap((tag) => tag.split(',').map((s) => s.trim())).filter(Boolean);
     }
     else if (typeof rawTag === 'string') {
         tags = rawTag
             .split(',')
-            .map(s => s.trim())
+            .map((s) => s.trim())
             .filter(Boolean);
     }
     const session = {

package/dist/commands/stop.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdStop = cmdStop;
+const terminal_1 = require("../terminal");
 const data_1 = require("../data");
 const mascot_1 = require("../mascot");
 const utils_1 = require("../utils");
@@ -10,7 +11,7 @@ const reflection_1 = require("../tui/reflection");
 async function cmdStop(options) {
     const data = (0, data_1.loadData)();
     if (!data.current) {
-        console.log(`\x1b[33m⚠ ${(0, i18n_1.t)('cmd.stop.noActive')}\x1b[0m`);
+        console.log((0, terminal_1.paint)(`⚠ ${(0, i18n_1.t)('cmd.stop.noActive')}`, 'yellow'));
         return;
     }
     const session = data.current;
@@ -68,25 +69,25 @@ async function cmdStop(options) {
     // Efficiency display
     if (hasEstimate) {
         let effEmoji = '⭐';
-        let effColor = '\x1b[32m';
+        let effColor = 'green';
         if (efficiency < 50) {
             effEmoji = '💀';
-            effColor = '\x1b[31m';
+            effColor = 'red';
         }
         else if (efficiency < 80) {
             effEmoji = '💪';
-            effColor = '\x1b[33m';
+            effColor = 'yellow';
         }
         else if (efficiency >= 100) {
             effEmoji = '🏆';
         }
-        console.log(`  ${effEmoji} ${(0, i18n_1.t)('cmd.stop.efficiencyScore')}: ${effColor}${efficiency}%\x1b[0m`);
+        console.log(`  ${effEmoji} ${(0, i18n_1.t)('cmd.stop.efficiencyScore')}: ${(0, terminal_1.paint)(`${efficiency}%`, effColor)}`);
     }
     else {
         console.log(`  ⏱  ${(0, i18n_1.t)('cmd.stop.noEstimate')}`);
     }
     // Points & Level
-    console.log(`  \x1b[33m${(0, i18n_1.t)('score.earned', { points: String(points) })}\x1b[0m`);
+    console.log((0, terminal_1.paint)(`  ${(0, i18n_1.t)('score.earned', { points: String(points) })}`, 'yellow'));
     console.log(`  ${(0, i18n_1.t)('cmd.status.level', { level: String(level), score: String(data.score) })}`);
     console.log(`  ${(0, i18n_1.t)('score.progress', { current: String(levelProgress.current), needed: String(levelProgress.needed) })}`);
     // Streak

package/dist/commands/summary.js

@@ -14,7 +14,7 @@ function computeDailyHours(sessions, days) {
         day.setHours(0, 0, 0, 0);
         const dayEnd = new Date(day);
         dayEnd.setDate(dayEnd.getDate() + 1);
-        const daySessions = sessions.filter(s => s.start >= day.toISOString() && s.start < dayEnd.toISOString());
+        const daySessions = sessions.filter((s) => s.start >= day.toISOString() && s.start < dayEnd.toISOString());
         const totalMs = daySessions.reduce((acc, s) => acc + (new Date(s.end).getTime() - new Date(s.start).getTime()), 0);
         result.push({
             label: day.toLocaleDateString((0, i18n_2.getLocale)() === 'zh' ? 'zh-CN' : 'en-US', {
@@ -30,33 +30,33 @@ function computeDailyHours(sessions, days) {
 const i18n_2 = require("../i18n");
 function cmdSummary(options) {
     const data = (0, data_1.loadData)();
-    const allCompleted = data.history.filter(s => s.end); // all completed, for daily chart
+    const allCompleted = data.history.filter((s) => s.end); // all completed, for daily chart
     let sessions = allCompleted;
     // Time filtering
     const now = new Date();
     if (options.today) {
         const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate()).toISOString();
-        sessions = sessions.filter(s => s.start >= todayStart);
+        sessions = sessions.filter((s) => s.start >= todayStart);
     }
     else if (options.week) {
         // Start from Monday
         const dayOfWeek = now.getDay(); // 0=Sun, 1=Mon...
         const mondayOffset = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
         const weekStart = new Date(now.getFullYear(), now.getMonth(), now.getDate() - mondayOffset);
-        sessions = sessions.filter(s => s.start >= weekStart.toISOString());
+        sessions = sessions.filter((s) => s.start >= weekStart.toISOString());
     }
     else if (options.month) {
         const monthStart = new Date(now.getFullYear(), now.getMonth(), 1).toISOString();
-        sessions = sessions.filter(s => s.start >= monthStart);
+        sessions = sessions.filter((s) => s.start >= monthStart);
     }
     else {
         // Default to today
         const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate()).toISOString();
-        sessions = sessions.filter(s => s.start >= todayStart);
+        sessions = sessions.filter((s) => s.start >= todayStart);
     }
     // Tag filtering
     if (options.tag) {
-        sessions = sessions.filter(s => s.tags.includes(options.tag));
+        sessions = sessions.filter((s) => s.tags.includes(options.tag));
     }
     console.log();
     if (sessions.length === 0) {
@@ -66,7 +66,7 @@ function cmdSummary(options) {
     }
     // Compute stats
     const totalSessions = sessions.length;
-    const durations = sessions.map(s => new Date(s.end).getTime() - new Date(s.start).getTime());
+    const durations = sessions.map((s) => new Date(s.end).getTime() - new Date(s.start).getTime());
     const totalDuration = durations.reduce((a, b) => a + b, 0);
     const avgDuration = totalDuration / totalSessions;
     // Tag distribution
@@ -111,7 +111,7 @@ function cmdSummary(options) {
     }
     // Daily bar chart
     console.log(`  ${(0, i18n_1.t)('cmd.summary.dailyHours')} (${(0, i18n_1.t)('cmd.summary.dailyHoursLabel')}):`);
-    const maxHours = Math.max(...dailyHours.map(d => d.hours), 1);
+    const maxHours = Math.max(...dailyHours.map((d) => d.hours), 1);
     for (const day of dailyHours) {
         const barWidth = Math.round((day.hours / maxHours) * 20);
         const bar = '█'.repeat(barWidth);

package/dist/commands/sync.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdSync = cmdSync;
+const terminal_1 = require("../terminal");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const data_1 = require("../data");
@@ -41,14 +42,14 @@ const mascot_1 = require("../mascot");
 const i18n_1 = require("../i18n");
 function cmdSync(filePath) {
     if (!filePath || filePath.trim() === '') {
-        console.log(`\x1b[33m${(0, i18n_1.t)('cmd.sync.emptyPath')}\x1b[0m`);
+        console.log((0, terminal_1.paint)(`${(0, i18n_1.t)('cmd.sync.emptyPath')}`, 'yellow'));
         return;
     }
     const data = (0, data_1.loadData)();
     const absPath = path.resolve(filePath);
     const parentDir = path.dirname(absPath);
     if (!fs.existsSync(parentDir)) {
-        console.log(`\x1b[33m${(0, i18n_1.t)('cmd.sync.dirNotExist', { dir: parentDir })}\x1b[0m`);
+        console.log((0, terminal_1.paint)(`${(0, i18n_1.t)('cmd.sync.dirNotExist', { dir: parentDir })}`, 'yellow'));
         return;
     }
     data.syncPath = absPath;

package/dist/data.js

@@ -128,7 +128,6 @@ function pointsToNextLevel(score) {
     for (let i = 1; i < level; i++) {
         totalForCurrent += i * 20;
     }
-    const totalForNext = totalForCurrent + level * 20;
     return {
         current: score - totalForCurrent,
         needed: level * 20,

package/dist/i18n.js

@@ -29,6 +29,17 @@ function resolveLocale(cliFlag, storedLang) {
 // ---- String maps ----
 const strings = {
     zh: {
+        'tui.ready': '准备好开始了。',
+        'tui.streak': '连续 {days} 天',
+        'tui.quit': 'q/Esc 退出 · Ctrl+C 中断',
+        'tui.cancel': 'q/Esc/Ctrl+C 取消',
+        'tui.oneThing': '一次专注一件事。',
+        'tui.cancelled': '计时已取消；当前记录保留，可用 tk stop 结束。',
+        'mascot.controls': 'q 退出 · n/p 切换表情',
+        'mascot.help': '查看 MINT 的 16 种表情与眨眼动画',
+        'mascot.invalidExpression': '表情名称可选：{names}',
+        'mascot.invalidSize': '尺寸可选：full、compact、tiny',
+        'cmd.help.display': '显示设置（仅本次运行；--ascii 只替换角色字符）：',
         // Greetings
         'greeting.lateNight': '夜深了',
         'greeting.morning': '早上好',
@@ -214,6 +225,17 @@ const strings = {
         'error.useHelp': '使用 tk help 查看帮助',
     },
     en: {
+        'tui.ready': 'Ready when you are.',
+        'tui.streak': '{days} day streak',
+        'tui.quit': 'q/Esc quit | Ctrl+C interrupt',
+        'tui.cancel': 'q/Esc/Ctrl+C cancel',
+        'tui.oneThing': 'One thing at a time.',
+        'tui.cancelled': 'Timer cancelled; the active record is kept. Use tk stop to finish it.',
+        'mascot.controls': 'q quit | n/p switch expression',
+        'mascot.help': 'Preview all 16 MINT expressions and blinking',
+        'mascot.invalidExpression': 'Choose an expression: {names}',
+        'mascot.invalidSize': 'Choose a size: full, compact, tiny',
+        'cmd.help.display': 'Display options (this run only; --ascii changes mascot art):',
         // Greetings
         'greeting.lateNight': 'Late night',
         'greeting.morning': 'Good morning',
@@ -385,7 +407,7 @@ const strings = {
         'mascot.encourage3': 'CACE: Hang in there!',
         'mascot.focused': '😤 Focused...',
         'mascot.celebrating': '🎉 Awesome!',
-        'mascot.disappointed': '😴 Don\'t worry, try again tomorrow!',
+        'mascot.disappointed': "😴 Don't worry, try again tomorrow!",
         // Status enhancements
         'cmd.status.level': '📊 Lv.{level} | {score} pts',
         'cmd.status.streak': '{fire} {days} day streak',