@cacinie/cace-timer 1.1.1 → 1.3.2

package/dist/commands/stop.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdStop = cmdStop;
+const data_1 = require("../data");
+const mascot_1 = require("../mascot");
+const utils_1 = require("../utils");
+const i18n_1 = require("../i18n");
+const tui_1 = require("../tui");
+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`);
+        return;
+    }
+    const session = data.current;
+    session.end = new Date().toISOString();
+    const duration = new Date(session.end).getTime() - new Date(session.start).getTime();
+    const durationMinutes = duration / 60000;
+    // Calculate efficiency score
+    const hasEstimate = session.estimatedMinutes && session.estimatedMinutes > 0;
+    let efficiency = -1;
+    if (hasEstimate) {
+        if (durationMinutes < 0.01) {
+            efficiency = 100; // sub-second task = perfect
+        }
+        else {
+            efficiency = Math.min(100, Math.round((session.estimatedMinutes / durationMinutes) * 100));
+        }
+    }
+    // Calculate points
+    const effForPoints = hasEstimate ? efficiency : 50; // default mid efficiency if no estimate
+    const points = (0, data_1.calculatePoints)(durationMinutes, effForPoints);
+    session.pointsEarned = points;
+    // Save reflection: CLI flag > TUI input > none
+    if (options?.reflection) {
+        session.reflection = options.reflection;
+    }
+    else if ((0, tui_1.isInteractiveTerminal)()) {
+        const result = await (0, reflection_1.showReflectionInput)();
+        if (result.text) {
+            session.reflection = result.text;
+        }
+    }
+    // Update score, streak
+    data.score = (data.score || 0) + points;
+    (0, data_1.updateStreak)(data);
+    const level = (0, data_1.scoreToLevel)(data.score);
+    const levelProgress = (0, data_1.pointsToNextLevel)(data.score);
+    data.history.unshift(session);
+    data.current = null;
+    (0, data_1.saveData)(data);
+    console.log();
+    (0, mascot_1.showCaceSmall)((0, i18n_1.t)('cmd.stop.taskComplete'), 'celebrating');
+    console.log();
+    console.log('  ┌─────────────────────────────────┐');
+    console.log(`  │          ${(0, i18n_1.t)('cmd.stop.taskSummary')}            │`);
+    console.log('  └─────────────────────────────────┘');
+    console.log();
+    console.log(`  📌 ${(0, i18n_1.t)('common.task')}: ${session.task}`);
+    console.log(`  🕐 ${(0, i18n_1.t)('common.duration')}: ${(0, utils_1.formatDuration)(duration)}`);
+    if (session.tags.length > 0) {
+        console.log(`  🏷  ${(0, i18n_1.t)('common.tags')}: ${session.tags.join(', ')}`);
+    }
+    if (session.marks.length > 0) {
+        console.log(`  📍 ${(0, i18n_1.t)('common.marks')}: ${session.marks.length} ${(0, i18n_1.t)('cmd.stop.marksCount')}`);
+    }
+    // Efficiency display
+    if (hasEstimate) {
+        let effEmoji = '⭐';
+        let effColor = '\x1b[32m';
+        if (efficiency < 50) {
+            effEmoji = '💀';
+            effColor = '\x1b[31m';
+        }
+        else if (efficiency < 80) {
+            effEmoji = '💪';
+            effColor = '\x1b[33m';
+        }
+        else if (efficiency >= 100) {
+            effEmoji = '🏆';
+        }
+        console.log(`  ${effEmoji} ${(0, i18n_1.t)('cmd.stop.efficiencyScore')}: ${effColor}${efficiency}%\x1b[0m`);
+    }
+    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, 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
+    if (data.streak > 1) {
+        console.log(`  ${(0, i18n_1.t)('score.streakFire', { days: String(data.streak) })}`);
+    }
+    else if (data.streak === 1) {
+        console.log(`  ${(0, i18n_1.t)('score.newStreak')}`);
+    }
+    // Reflection
+    if (session.reflection) {
+        console.log(`  💭 ${session.reflection}`);
+    }
+    console.log();
+}

package/dist/commands/summary.d.ts

@@ -0,0 +1,6 @@
+export declare function cmdSummary(options: {
+    today?: boolean;
+    week?: boolean;
+    month?: boolean;
+    tag?: string;
+}): void;

package/dist/commands/summary.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdSummary = cmdSummary;
+const data_1 = require("../data");
+const mascot_1 = require("../mascot");
+const utils_1 = require("../utils");
+const i18n_1 = require("../i18n");
+function computeDailyHours(sessions, days) {
+    const result = [];
+    const now = new Date();
+    for (let i = days - 1; i >= 0; i--) {
+        const day = new Date(now);
+        day.setDate(now.getDate() - i);
+        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 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', {
+                weekday: 'short',
+                month: 'short',
+                day: 'numeric',
+            }),
+            hours: totalMs / 3600000,
+        });
+    }
+    return result;
+}
+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
+    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);
+    }
+    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());
+    }
+    else if (options.month) {
+        const monthStart = new Date(now.getFullYear(), now.getMonth(), 1).toISOString();
+        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);
+    }
+    // Tag filtering
+    if (options.tag) {
+        sessions = sessions.filter(s => s.tags.includes(options.tag));
+    }
+    console.log();
+    if (sessions.length === 0) {
+        (0, mascot_1.showCaceSmall)((0, i18n_1.t)('cmd.summary.noData'), 'sleepy');
+        console.log();
+        return;
+    }
+    // Compute stats
+    const totalSessions = sessions.length;
+    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
+    const tagMap = new Map();
+    for (const s of sessions) {
+        const dur = new Date(s.end).getTime() - new Date(s.start).getTime();
+        for (const tag of s.tags) {
+            const entry = tagMap.get(tag) || { count: 0, ms: 0 };
+            entry.count++;
+            entry.ms += dur;
+            tagMap.set(tag, entry);
+        }
+    }
+    // Top 5 longest
+    const top5 = [...sessions]
+        .sort((a, b) => {
+        const da = new Date(a.end).getTime() - new Date(a.start).getTime();
+        const db = new Date(b.end).getTime() - new Date(b.start).getTime();
+        return db - da;
+    })
+        .slice(0, 5);
+    // Daily hours bar chart (last 7 days, uses ALL completed sessions not filtered by time)
+    const dailyHours = computeDailyHours(allCompleted, 7);
+    // Render
+    (0, mascot_1.showCaceSmall)((0, i18n_1.t)('cmd.summary.title'), 'happy');
+    console.log();
+    console.log(`  ${(0, i18n_1.t)('cmd.summary.totalSessions')}: ${totalSessions} ${(0, i18n_1.t)('cmd.summary.sessions')}`);
+    console.log(`  ${(0, i18n_1.t)('cmd.summary.totalDuration')}: ${(0, utils_1.formatDuration)(totalDuration)}`);
+    console.log(`  ${(0, i18n_1.t)('cmd.summary.avgDuration')}: ${(0, utils_1.formatDuration)(avgDuration)}`);
+    console.log();
+    // Tag breakdown
+    if (tagMap.size > 0) {
+        console.log(`  ${(0, i18n_1.t)('cmd.summary.tagBreakdown')}:`);
+        for (const [tag, { count, ms }] of tagMap) {
+            const pct = Math.round((count / totalSessions) * 100);
+            const barLen = Math.round(pct / 5); // 20 chars max
+            const bar = '█'.repeat(barLen);
+            const durStr = (0, utils_1.formatDuration)(ms);
+            console.log(`    #${tag}  ${bar} ${count}x (${pct}%) ${durStr}`);
+        }
+        console.log();
+    }
+    // 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);
+    for (const day of dailyHours) {
+        const barWidth = Math.round((day.hours / maxHours) * 20);
+        const bar = '█'.repeat(barWidth);
+        console.log(`    ${day.label} ${bar} ${day.hours.toFixed(1)}h`);
+    }
+    console.log();
+    // Top 5
+    console.log(`  ${(0, i18n_1.t)('cmd.summary.top5')}:`);
+    top5.forEach((s, i) => {
+        const dur = new Date(s.end).getTime() - new Date(s.start).getTime();
+        console.log(`    ${i + 1}. ${s.task} - ${(0, utils_1.formatDuration)(dur)}`);
+    });
+    console.log();
+}

package/dist/commands/sync.d.ts

@@ -0,0 +1 @@
+export declare function cmdSync(filePath: string): void;

package/dist/commands/sync.js

@@ -0,0 +1,62 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdSync = cmdSync;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const data_1 = require("../data");
+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`);
+        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`);
+        return;
+    }
+    data.syncPath = absPath;
+    (0, data_1.saveData)(data);
+    console.log();
+    (0, mascot_1.showCaceSmall)((0, i18n_1.t)('cmd.sync.configured'));
+    console.log();
+    console.log(`  ${(0, i18n_1.t)('cmd.sync.syncPath', { path: absPath })}`);
+    console.log(`  ${(0, i18n_1.t)('cmd.sync.syncTip')}`);
+    console.log();
+}

package/dist/data.d.ts

@@ -0,0 +1,18 @@
+import { TimeKeeperData } from './types';
+export declare function getDataFile(): string;
+export declare function setDataFile(p: string): void;
+export declare function loadData(): TimeKeeperData;
+export declare function saveData(data: TimeKeeperData): void;
+/** Calculate points earned for a completed session */
+export declare function calculatePoints(durationMinutes: number, efficiency: number): number;
+/** Convert total score to level (1-99) */
+export declare function scoreToLevel(score: number): number;
+/** Points needed for next level */
+export declare function pointsToNextLevel(score: number): {
+    current: number;
+    needed: number;
+};
+/** Update streak based on today's date. Call on session completion. */
+export declare function updateStreak(data: TimeKeeperData): void;
+/** Get today's date as YYYY-MM-DD */
+export declare function getTodayStr(): string;

package/dist/data.js

@@ -0,0 +1,161 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDataFile = getDataFile;
+exports.setDataFile = setDataFile;
+exports.loadData = loadData;
+exports.saveData = saveData;
+exports.calculatePoints = calculatePoints;
+exports.scoreToLevel = scoreToLevel;
+exports.pointsToNextLevel = pointsToNextLevel;
+exports.updateStreak = updateStreak;
+exports.getTodayStr = getTodayStr;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// ============ Data Management ============
+let DATA_FILE = path.join(os.homedir(), '.cace-timer.json');
+function getDataFile() {
+    return DATA_FILE;
+}
+function setDataFile(p) {
+    DATA_FILE = p;
+}
+function ensureDefaults(data) {
+    return {
+        score: data.score ?? 0,
+        streak: data.streak ?? 0,
+        lastActiveDate: data.lastActiveDate,
+        syncPath: data.syncPath,
+        lang: data.lang,
+        current: data.current ?? null,
+        history: data.history ?? [],
+    };
+}
+function loadData() {
+    try {
+        if (fs.existsSync(DATA_FILE)) {
+            const content = fs.readFileSync(DATA_FILE, 'utf-8');
+            return ensureDefaults(JSON.parse(content));
+        }
+    }
+    catch {
+        // Ignore errors, return default
+    }
+    return ensureDefaults({});
+}
+function saveData(data) {
+    try {
+        fs.writeFileSync(DATA_FILE, JSON.stringify(data, null, 2));
+    }
+    catch (e) {
+        throw new Error(`Failed to save data to ${DATA_FILE}: ${e.message}`);
+    }
+    // Sync to external path if set
+    if (data.syncPath && fs.existsSync(path.dirname(data.syncPath))) {
+        try {
+            fs.writeFileSync(data.syncPath, JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            process.stderr.write(`Warning: sync to ${data.syncPath} failed: ${e.message}\n`);
+        }
+    }
+}
+// ============ Scoring & Streak ============
+/** Calculate points earned for a completed session */
+function calculatePoints(durationMinutes, efficiency) {
+    let points = 10; // base points
+    if (efficiency >= 80)
+        points += 5; // efficiency bonus
+    if (efficiency >= 100)
+        points += 5; // perfect bonus
+    if (durationMinutes >= 25)
+        points += 5; // deep work bonus (25+ min)
+    return points;
+}
+/** Convert total score to level (1-99) */
+function scoreToLevel(score) {
+    // Each level needs progressively more points: Lv.N needs N*20 total
+    // Lv.1 = 0pts, Lv.2 = 20pts, Lv.3 = 60pts, Lv.4 = 120pts...
+    if (score <= 0)
+        return 1;
+    let level = 1;
+    let totalNeeded = 0;
+    while (level < 99) {
+        totalNeeded += level * 20;
+        if (score < totalNeeded)
+            break;
+        level++;
+    }
+    return level;
+}
+/** Points needed for next level */
+function pointsToNextLevel(score) {
+    const level = scoreToLevel(score);
+    let totalForCurrent = 0;
+    for (let i = 1; i < level; i++) {
+        totalForCurrent += i * 20;
+    }
+    const totalForNext = totalForCurrent + level * 20;
+    return {
+        current: score - totalForCurrent,
+        needed: level * 20,
+    };
+}
+/** Update streak based on today's date. Call on session completion. */
+function updateStreak(data) {
+    const today = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
+    if (!data.lastActiveDate) {
+        data.streak = 1;
+        data.lastActiveDate = today;
+        return;
+    }
+    if (data.lastActiveDate === today)
+        return; // already active today
+    const last = new Date(data.lastActiveDate);
+    const now = new Date(today);
+    const diffDays = Math.floor((now.getTime() - last.getTime()) / 86400000);
+    if (diffDays === 1) {
+        data.streak++;
+    }
+    else if (diffDays > 1) {
+        data.streak = 1;
+    }
+    data.lastActiveDate = today;
+}
+/** Get today's date as YYYY-MM-DD */
+function getTodayStr() {
+    return new Date().toISOString().split('T')[0];
+}

package/dist/i18n.d.ts

@@ -0,0 +1,7 @@
+export type Locale = 'zh' | 'en';
+export type LocaleStrings = Record<string, string>;
+export declare function setLocale(locale: Locale): void;
+export declare function getLocale(): Locale;
+export declare function detectLocale(): Locale;
+export declare function resolveLocale(cliFlag?: string, storedLang?: string): Locale;
+export declare function t(key: string, params?: Record<string, string | number>): string;