sanook-cli 0.5.5 → 0.5.8

package/dist/ui/render.js

@@ -4,6 +4,7 @@ import { render } from 'ink';
 import { App } from './app.js';
 import { SetupWizard } from './setup.js';
 import { BrainWizard } from './brain-wizard.js';
+import { PersonaWizard } from './persona-wizard.js';
 import { saveKey, saveGlobalConfig, saveBrainPath } from '../config.js';
 import { BRAND } from '../brand.js';
 // Ink needs raw mode; mounting on a non-TTY stdin (piped/redirected/cron/CI) throws
@@ -16,6 +17,10 @@ function requireInteractiveTTY() {
         process.exit(1);
     }
 }
+/** locale → ค่า language ที่เก็บลง persona ของ second brain (ขั้นที่ 9) */
+function languageForLocale(locale) {
+    return locale === 'en' ? 'English + tech-en' : 'ไทย + tech-en';
+}
 /**
  * Root — โฮสต์ setup wizard → brain wizard → REPL ใน **Ink render เดียว**
  *
@@ -23,10 +28,16 @@ function requireInteractiveTTY() {
  * พอ instance แรก unmount, stdin raw-mode/keypress listener ไม่ reattach กับ instance ที่ 2
  * → พิมพ์ในช่องแชทไม่ได้. รวมเป็น tree เดียว (React สลับ component ภายใน) stdin ต่อเนื่องไม่หลุด.
  */
-export function Root({ needsSetup, appProps }) {
+export function Root({ needsSetup, appProps, clearScreen }) {
     const [phase, setPhase] = useState(needsSetup ? 'setup' : 'app');
     const [model, setModel] = useState(appProps.initialModel);
     const [brainNote, setBrainNote] = useState(undefined);
+    const [locale, setLocale] = useState('th');
+    // เข้า REPL: เคลียร์จอที่เต็มไปด้วย wizard ก่อน → banner "Sanook AI" เด้งบนจอว่าง
+    const enterApp = () => {
+        clearScreen?.();
+        setPhase('app');
+    };
     if (phase === 'setup') {
         const onComplete = (r) => {
             void (async () => {
@@ -39,7 +50,11 @@ export function Root({ needsSetup, appProps }) {
                     permissionMode: r.permissionMode,
                 });
                 setModel(r.model);
-                setPhase(r.createBrain ? 'brain' : 'app');
+                setLocale(r.locale);
+                if (r.createBrain)
+                    setPhase('brain');
+                else
+                    enterApp();
             })();
         };
         return _jsx(SetupWizard, { onComplete: onComplete });
@@ -48,25 +63,42 @@ export function Root({ needsSetup, appProps }) {
         const onComplete = (a) => {
             void (async () => {
                 const { scaffoldBrain, BRAIN_DEFAULTS, expandHome, wireBrainMcp } = await import('../brain.js');
+                const { linkBrainToProject } = await import('../brain-link.js');
+                const { seedPersonaMemory } = await import('../memory.js');
                 const today = new Date().toISOString().slice(0, 10);
                 const target = expandHome(a.path);
+                const language = languageForLocale(locale);
                 try {
                     const res = await scaffoldBrain(target, {
                         ...BRAIN_DEFAULTS,
                         ownerName: a.ownerName,
                         aiName: a.aiName,
                         autonomy: a.autonomy,
+                        language,
                         today,
                     });
                     await saveBrainPath(target);
                     const wired = await wireBrainMcp(target).catch(() => 'skip');
+                    const linked = await linkBrainToProject({ brainPath: target, cwd: process.cwd(), today }).catch(() => null);
+                    // เซฟ persona/identity ที่เก็บใน wizard ลง durable memory (owner ground-truth) → agent จำได้ทันที
+                    const seeded = await seedPersonaMemory({
+                        ownerName: a.ownerName,
+                        aiName: a.aiName,
+                        language,
+                        autonomy: a.autonomy,
+                        defaults: { ownerName: BRAIN_DEFAULTS.ownerName, aiName: BRAIN_DEFAULTS.aiName },
+                    }).catch(() => 0);
+                    const linkNote = linked?.projectRelDir
+                        ? ` · project ${linked.projectRelDir} · ${linked.memoryCreated ? 'created' : 'linked'} ${BRAND.memoryFileName}`
+                        : '';
+                    const memNote = seeded ? ` · จำ persona ${seeded} ข้อ` : '';
                     setBrainNote(`✅ second-brain — ${target} · สร้าง ${res.created.length} ไฟล์ · ` +
-                        `${wired === 'added' ? 'wire filesystem MCP เข้า vault แล้ว' : 'MCP เดิมอยู่แล้ว (ไม่ทับ)'} · เปิดใน Obsidian: Open folder as vault`);
+                        `${wired === 'added' ? 'wire filesystem MCP เข้า vault แล้ว' : 'MCP เดิมอยู่แล้ว (ไม่ทับ)'}${linkNote}${memNote} · เปิดใน Obsidian: Open folder as vault`);
                 }
                 catch (e) {
                     setBrainNote(`⚠ สร้าง second-brain ไม่สำเร็จ: ${e.message} — ลองใหม่ด้วย ${'`'}sanook brain init${'`'}`);
                 }
-                setPhase('app');
+                enterApp();
             })();
         };
         return _jsx(BrainWizard, { onComplete: onComplete });
@@ -77,7 +109,17 @@ export function Root({ needsSetup, appProps }) {
 /** เปิดแอป: wizard (ถ้า first-run) → REPL — Ink render ครั้งเดียว (fix: พิมพ์ในช่องแชทไม่ได้) */
 export function startApp(props) {
     requireInteractiveTTY();
-    render(_jsx(Root, { ...props }));
+    // background, best-effort: weekly memory + vault consolidation (auto-maintain). Non-blocking so the
+    // REPL opens instantly; the consolidated store is ready for the next turn. Runs only when due + enabled.
+    void import('../auto-maintain.js').then((m) => m.maybeStartupMaintain()).catch(() => { });
+    let instance;
+    // \x1b[2J เคลียร์จอ · \x1b[3J เคลียร์ scrollback · \x1b[H cursor กลับมุมซ้ายบน
+    // instance.clear() ลบ frame ล่าสุดที่ Ink จำไว้ → App วาดใหม่จากบนสุดไม่เหลือเศษ wizard
+    const clearScreen = () => {
+        process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
+        instance?.clear();
+    };
+    instance = render(_jsx(Root, { ...props, clearScreen: clearScreen }));
 }
 /** เปิด REPL ตรงๆ (ไม่ผ่าน wizard) — เก็บไว้เผื่อ caller อื่น */
 export function startRepl(appProps) {
@@ -92,6 +134,8 @@ export function startBrainSetup() {
         const onComplete = (a) => {
             void (async () => {
                 const { scaffoldBrain, BRAIN_DEFAULTS, expandHome, wireBrainMcp } = await import('../brain.js');
+                const { linkBrainToProject } = await import('../brain-link.js');
+                const { seedPersonaMemory } = await import('../memory.js');
                 const today = new Date().toISOString().slice(0, 10);
                 const target = expandHome(a.path);
                 const res = await scaffoldBrain(target, {
@@ -103,9 +147,18 @@ export function startBrainSetup() {
                 });
                 await saveBrainPath(target);
                 const wired = await wireBrainMcp(target).catch(() => 'skip');
+                const linked = await linkBrainToProject({ brainPath: target, cwd: process.cwd(), today }).catch(() => null);
+                await seedPersonaMemory({
+                    ownerName: a.ownerName,
+                    aiName: a.aiName,
+                    autonomy: a.autonomy,
+                    defaults: { ownerName: BRAIN_DEFAULTS.ownerName, aiName: BRAIN_DEFAULTS.aiName },
+                }).catch(() => 0);
                 unmount();
+                const linkLine = linked?.projectRelDir ? `\n   linked repo → ${linked.projectRelDir} · ${BRAND.memoryFileName} in cwd` : '';
                 process.stdout.write(`\n✅ second-brain — ${target}\n   สร้าง ${res.created.length} · ข้าม ${res.skipped.length} (มีอยู่แล้ว ไม่ทับ)` +
                     `\n   ${wired === 'added' ? 'wire filesystem MCP เข้า vault แล้ว (agent อ่าน/เขียนได้)' : 'MCP: มี server เดิมอยู่แล้ว (ไม่ทับ)'}` +
+                    `${linkLine}` +
                     `\n   เปิดใน Obsidian: Open folder as vault\n`);
                 resolve();
             })();
@@ -114,3 +167,32 @@ export function startBrainSetup() {
         unmount = instance.unmount;
     });
 }
+/** standalone `sanook persona` (interactive): ถามชุดคำถาม persona → seed auto-memory + เขียนโปรไฟล์ลง vault */
+export function startPersonaSetup() {
+    requireInteractiveTTY();
+    return new Promise((resolve) => {
+        let unmount = () => { };
+        void (async () => {
+            const { loadPersonaAnswers, persistPersonaAnswers } = await import('../memory.js');
+            const initialAnswers = await loadPersonaAnswers().catch(() => ({}));
+            const onComplete = (answers) => {
+                void (async () => {
+                    const { memoryWritten, vaultWritten, brainPath } = await persistPersonaAnswers(answers);
+                    unmount();
+                    const memLine = memoryWritten > 0
+                        ? `   จำเข้า memory แล้ว ${memoryWritten} ข้อ (protected — agent อ่านทุก session)`
+                        : `   ไม่มีข้อมูลใหม่ที่ต้องจำ (ข้ามหมด/ตรงกับของเดิม)`;
+                    const vaultLine = vaultWritten
+                        ? `\n   เขียนโปรไฟล์ลง vault → ${brainPath}/Shared/User-Persona/persona.md`
+                        : brainPath
+                            ? `\n   ⚠ ข้ามการเขียนโปรไฟล์ลง vault (ไม่พบโฟลเดอร์ Shared/User-Persona — รัน \`${BRAND.cliName} brain init\` เพื่อ scaffold ใหม่)`
+                            : `\n   (ยังไม่มี second-brain — รัน \`${BRAND.cliName} brain init\` เพื่อเก็บโปรไฟล์ลง vault ด้วย)`;
+                    process.stdout.write(`\n✅ บันทึก Persona เรียบร้อย\n${memLine}${vaultLine}\n`);
+                    resolve();
+                })();
+            };
+            const instance = render(_jsx(PersonaWizard, { onComplete: onComplete, initialAnswers: initialAnswers }));
+            unmount = instance.unmount;
+        })();
+    });
+}

package/dist/ui/tool-activity.js

@@ -0,0 +1,118 @@
+// ============================================================================
+// src/ui/tool-activity.ts — turns a tool call's INPUT into a human-friendly activity:
+// a clear one-line title ("แก้ไฟล์ src/app.tsx", "$ npm test") plus, for code edits, a
+// colored diff (green + additions, red - deletions). Computed at tool-call time so the
+// REPL shows in detail what the agent is doing in real time — not after the fact.
+// ============================================================================
+import { editDiffSegments } from '../diff.js';
+// PER-SIDE diff cap (removed and added counted separately) — a two-sided edit can still yield up to
+// ~2×this rows, so the overall per-row height bound is enforced by ActivityRow (MAX_ROW_DIFF_LINES).
+// diffLines/additionLines append a correct "…(+N บรรทัด)" sentinel per side when exceeded.
+const MAX_DIFF_LINES = 10;
+function str(v) {
+    return typeof v === 'string' ? v : '';
+}
+function basenameish(p) {
+    return p.length > 52 ? `…${p.slice(-51)}` : p;
+}
+/** structured edit diff (old → new) with common prefix/suffix trimmed — green +, red -.
+ * Built on the shared core in src/diff.ts so the algorithm doesn't drift from renderEditDiff. */
+export function diffLines(oldStr, newStr, max = MAX_DIFF_LINES) {
+    const seg = editDiffSegments(oldStr, newStr, max);
+    const out = [];
+    for (const l of seg.removed)
+        out.push({ sign: '-', text: l });
+    if (seg.moreRemoved)
+        out.push({ sign: ' ', text: `…(-${seg.moreRemoved} บรรทัด)` });
+    for (const l of seg.added)
+        out.push({ sign: '+', text: l });
+    if (seg.moreAdded)
+        out.push({ sign: ' ', text: `…(+${seg.moreAdded} บรรทัด)` });
+    return out;
+}
+/** whole-content as additions (new file write) — all green. Drops the trailing empty line of a
+ * file ending in \n so the green-line count matches the title's countLines() (no spurious blank). */
+function additionLines(content, max = MAX_DIFF_LINES) {
+    if (content === '')
+        return []; // empty write → no diff body (title already shows "+0 บรรทัด")
+    const all = content.split('\n');
+    if (content.endsWith('\n'))
+        all.pop();
+    const out = all.slice(0, max).map((text) => ({ sign: '+', text }));
+    if (all.length > max)
+        out.push({ sign: ' ', text: `…(+${all.length - max} บรรทัด)` });
+    return out;
+}
+function countLines(s) {
+    if (s === '')
+        return 0;
+    const lines = s.split('\n');
+    if (s.endsWith('\n'))
+        lines.pop();
+    return lines.length;
+}
+/** map a tool name + its input into a friendly title (+ optional colored diff) */
+export function describeToolCall(name, input) {
+    const i = (input ?? {});
+    switch (name) {
+        case 'edit_file': {
+            const path = basenameish(str(i.path));
+            const all = i.replace_all ? ' (ทุกที่)' : '';
+            return { title: `✎ แก้ไฟล์ ${path}${all}`, diff: diffLines(str(i.old_string), str(i.new_string)) };
+        }
+        case 'write_file': {
+            const path = basenameish(str(i.path));
+            const content = str(i.content);
+            return { title: `✚ เขียนไฟล์ ${path} (+${countLines(content)} บรรทัด)`, diff: additionLines(content) };
+        }
+        case 'run_bash':
+            return { title: `$ ${str(i.cmd)}` };
+        case 'run_python':
+            return { title: i.path ? `▶ python ${str(i.path)}` : `▶ รัน python (${str(i.code).length} ตัวอักษร)` };
+        case 'run_rust':
+            return { title: i.path ? `▶ rust ${str(i.path)}` : `▶ รัน rust (${str(i.code).length} ตัวอักษร)` };
+        case 'read_file':
+            return { title: `📖 อ่านไฟล์ ${basenameish(str(i.path))}` };
+        case 'list_dir':
+            return { title: `📁 ดูโฟลเดอร์ ${basenameish(str(i.path) || '.')}` };
+        case 'glob':
+            return { title: `🔎 ค้นไฟล์ ${str(i.pattern)}` };
+        case 'grep':
+            return { title: `🔎 ค้นโค้ด "${str(i.pattern)}"` };
+        case 'git_status':
+            return { title: 'git status' };
+        case 'git_diff':
+            return { title: 'git diff' };
+        case 'git_log':
+            return { title: 'git log' };
+        case 'git_commit':
+            return { title: `⎇ git commit -m "${str(i.message).slice(0, 60)}"` };
+        case 'remember':
+            return { title: `🧠 จำ: ${str(i.fact).slice(0, 60)}` };
+        case 'recall':
+            return { title: `🧠 ค้นความจำ "${str(i.query)}"` };
+        case 'create_skill':
+            return { title: `✨ สร้าง skill ${str(i.name)}` };
+        case 'find_skills':
+            return { title: `✨ หา skill "${str(i.query)}"` };
+        case 'skill':
+            return { title: `✨ เปิด skill ${str(i.name)}` };
+        case 'web_fetch':
+            return { title: `🌐 โหลด ${str(i.url).slice(0, 60)}` };
+        case 'task':
+            return { title: `🤖 มอบงานให้ sub-agent: ${str(i.prompt || i.task).slice(0, 50)}` };
+        case 'schedule_task':
+            return { title: `⏰ ตั้งเวลา: ${str(i.when)} → ${str(i.task).slice(0, 40)}` };
+        default: {
+            const detail = pickDetail(i);
+            return { title: detail ? `${name} ${detail}` : name };
+        }
+    }
+}
+function pickDetail(i) {
+    for (const key of ['path', 'query', 'pattern', 'name', 'url', 'id']) {
+        if (typeof i[key] === 'string' && i[key])
+            return String(i[key]).slice(0, 60);
+    }
+    return '';
+}

package/dist/ui/tool-trail.js

@@ -1,4 +1,5 @@
 import { inspect } from 'node:util';
+import { describeToolCall } from './tool-activity.js';
 export const TOOL_TRAIL_LIMIT = 6;
 function clip(text, width) {
     if (width <= 0)
@@ -40,7 +41,10 @@ export function updateToolTrailOnEvent(items, event, nextId) {
     if (event.type === 'tool-call') {
         const name = event.tool?.trim() || 'tool';
         return {
-            items: trimItems([...items, { detail: compactToolDetail(event.detail), id: nextId, name, status: 'running' }]),
+            items: trimItems([
+                ...items,
+                { detail: compactToolDetail(event.detail), id: nextId, name, status: 'running', activity: describeToolCall(name, event.detail) },
+            ]),
             nextId: nextId + 1,
         };
     }
@@ -75,15 +79,23 @@ function statusSummary(items) {
     const error = items.filter((item) => item.status === 'error').length;
     return [`${done} done`, running ? `${running} running` : '', error ? `${error} error` : ''].filter(Boolean).join(' / ');
 }
+/** the 2 header lines (title + view/status meta) shared by string + rich rendering */
+export function toolTrailHeader(items, mode) {
+    return [`Sanook tool trail (${items.length})`, `view: ${mode} | ${statusSummary(items)} | Ctrl+T / /trail`];
+}
+/** width budget for a rich activity row (mirrors toolTrailLines clipping) */
+export function toolTrailWidth(columns) {
+    return Math.max(24, Math.min(Math.max(30, columns - 4), 96));
+}
 export function toolTrailLines(items, columns, mode = 'expanded') {
     if (mode === 'hidden')
         return [];
     if (!items.length)
         return [];
-    const width = Math.max(24, Math.min(Math.max(30, columns - 4), 96));
+    const width = toolTrailWidth(columns);
     const nameWidth = Math.max(8, Math.min(24, Math.floor(width * 0.34)));
     const detailWidth = Math.max(0, width - nameWidth - 18);
-    const lines = [`Sanook tool trail (${items.length})`, `view: ${mode} | ${statusSummary(items)} | Ctrl+T / /trail`];
+    const lines = toolTrailHeader(items, mode);
     if (mode === 'compact') {
         lines.push(`tools: ${items.map((item) => `${markerForStatus(item.status)}${item.name}`).join(' ')}`);
         return lines.map((line) => clip(line, width));

package/dist/usage-cli.js

@@ -0,0 +1,160 @@
+import { BRAND } from './brand.js';
+import { takeValue } from './cli-option-values.js';
+import { aggregateUsageEvents, loadUsageEvents, usageEventsPath } from './usage-ledger.js';
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function shiftDays(days) {
+    const d = new Date();
+    d.setDate(d.getDate() - days);
+    return d.toISOString().slice(0, 10);
+}
+export function parseUsageArgs(args) {
+    if (args.includes('-h') || args.includes('--help'))
+        return null;
+    let mode = 'daily';
+    let since;
+    let until;
+    let days = 30;
+    let json = false;
+    let noColor = false;
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--json')
+            json = true;
+        else if (arg === '--no-color')
+            noColor = true;
+        else if (arg === '--since') {
+            const picked = takeValue(args, i);
+            if (!picked.value || !DATE_RE.test(picked.value))
+                return null;
+            since = picked.value;
+            i = picked.nextIndex;
+        }
+        else if (arg.startsWith('--since=')) {
+            since = arg.slice('--since='.length);
+            if (!DATE_RE.test(since))
+                return null;
+        }
+        else if (arg === '--until') {
+            const picked = takeValue(args, i);
+            if (!picked.value || !DATE_RE.test(picked.value))
+                return null;
+            until = picked.value;
+            i = picked.nextIndex;
+        }
+        else if (arg.startsWith('--until=')) {
+            until = arg.slice('--until='.length);
+            if (!DATE_RE.test(until))
+                return null;
+        }
+        else if (arg === '--days') {
+            const picked = takeValue(args, i);
+            const n = Number(picked.value);
+            if (!Number.isInteger(n) || n <= 0)
+                return null;
+            days = n;
+            i = picked.nextIndex;
+        }
+        else if (arg.startsWith('--days=')) {
+            const n = Number(arg.slice('--days='.length));
+            if (!Number.isInteger(n) || n <= 0)
+                return null;
+            days = n;
+        }
+        else if (!arg.startsWith('-'))
+            positional.push(arg);
+        else
+            return null;
+    }
+    if (positional[0]) {
+        if (!['daily', 'weekly', 'monthly', 'session'].includes(positional[0]))
+            return null;
+        mode = positional[0];
+    }
+    if (!since)
+        since = shiftDays(days - 1);
+    if (!until)
+        until = new Date().toISOString().slice(0, 10);
+    return { mode, since, until, days, json, noColor };
+}
+function fmt(n) {
+    return n.toLocaleString('en-US');
+}
+function fmtCost(n) {
+    return n > 0 ? `$${n.toFixed(2)}` : '$0.00';
+}
+function renderTable(title, rows, wide) {
+    if (!rows.length) {
+        return [
+            `╭${'─'.repeat(Math.max(42, title.length + 4))}╮`,
+            `│ ${title.padEnd(Math.max(40, title.length + 2))} │`,
+            `╰${'─'.repeat(Math.max(42, title.length + 4))}╯`,
+            '',
+            `(no usage recorded — run ${BRAND.cliName} and complete a turn first)`,
+            `ledger: ${usageEventsPath()}`,
+        ].join('\n');
+    }
+    const lines = [];
+    lines.push(`╭${'─'.repeat(title.length + 4)}╮`);
+    lines.push(`│ ${title} │`);
+    lines.push(`╰${'─'.repeat(title.length + 4)}╯`);
+    lines.push('');
+    if (wide) {
+        lines.push('┌────────────┬─────────┬──────────────────┬─────────┬─────────┬────────────┬────────────┐');
+        lines.push('│ Period     │ Turns   │ Models           │ Input   │ Output  │ Cache R/W  │ Cost (USD) │');
+        lines.push('├────────────┼─────────┼──────────────────┼─────────┼─────────┼────────────┼────────────┤');
+        for (const row of rows) {
+            const models = row.models.join(' ').slice(0, 16).padEnd(16);
+            const cache = `${fmt(row.cacheReadTokens)}/${fmt(row.cacheWriteTokens)}`.padStart(10);
+            lines.push(`│ ${row.label.padEnd(10)} │ ${String(row.turns).padStart(7)} │ ${models} │ ${fmt(row.inputTokens).padStart(7)} │ ${fmt(row.outputTokens).padStart(7)} │ ${cache} │ ${fmtCost(row.costUsd).padStart(10)} │`);
+        }
+        lines.push('└────────────┴─────────┴──────────────────┴─────────┴─────────┴────────────┴────────────┘');
+    }
+    else {
+        lines.push('┌────────────┬──────────────────┬─────────┬─────────┬────────────┐');
+        lines.push('│ Period     │ Models           │ Input   │ Output  │ Cost (USD) │');
+        lines.push('├────────────┼──────────────────┼─────────┼─────────┼────────────┤');
+        for (const row of rows) {
+            const models = row.models.join(' ').slice(0, 16).padEnd(16);
+            lines.push(`│ ${row.label.padEnd(10)} │ ${models} │ ${fmt(row.inputTokens).padStart(7)} │ ${fmt(row.outputTokens).padStart(7)} │ ${fmtCost(row.costUsd).padStart(10)} │`);
+        }
+        lines.push('└────────────┴──────────────────┴─────────┴─────────┴────────────┘');
+    }
+    const totalCost = rows.reduce((sum, row) => sum + row.costUsd, 0);
+    const totalTokens = rows.reduce((sum, row) => sum + row.totalTokens, 0);
+    lines.push('');
+    lines.push(`totals: ${fmt(totalTokens)} tokens · ${fmtCost(totalCost)} estimated · ledger: ${usageEventsPath()}`);
+    return lines.join('\n');
+}
+export async function renderUsageReport(options) {
+    const events = await loadUsageEvents({ since: options.since, until: options.until });
+    const rows = aggregateUsageEvents(events, options.mode);
+    if (options.json) {
+        return JSON.stringify({
+            agent: BRAND.cliName,
+            mode: options.mode,
+            since: options.since,
+            until: options.until,
+            events: events.length,
+            rows,
+            ledger: usageEventsPath(),
+        }, null, 2);
+    }
+    const title = options.mode === 'daily'
+        ? `${BRAND.productName} Usage Report — Daily`
+        : options.mode === 'weekly'
+            ? `${BRAND.productName} Usage Report — Weekly`
+            : options.mode === 'monthly'
+                ? `${BRAND.productName} Usage Report — Monthly`
+                : `${BRAND.productName} Usage Report — Sessions`;
+    const wide = (process.stdout.columns ?? 100) >= 100;
+    return renderTable(title, rows, wide);
+}
+export function usageHelpText() {
+    return [
+        `ใช้: ${BRAND.cliName} usage [daily|weekly|monthly|session] [--days N] [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--json]`,
+        '',
+        'บันทึก token/cost ทุก agent turn ลง ~/.sanook/usage/events.jsonl (ccusage-style local ledger).',
+        'ปิดได้ด้วย SANOOK_DISABLE_USAGE=1',
+    ].join('\n');
+}

package/dist/usage-ledger.js

@@ -0,0 +1,169 @@
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { appHomePath, BRAND, usageLedgerEnabled } from './brand.js';
+const USAGE_DIR_NAME = 'usage';
+export function usageDirPath() {
+    return appHomePath(USAGE_DIR_NAME);
+}
+export function usageEventsPath() {
+    return join(usageDirPath(), 'events.jsonl');
+}
+function localDate(iso) {
+    const d = new Date(iso);
+    if (!Number.isFinite(d.getTime()))
+        return iso.slice(0, 10);
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+function num(value) {
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+}
+/** Parse Codex JSONL turn.completed usage payloads into AI SDK Usage shape. */
+export function usageFromCodexPayload(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const u = raw;
+    const input = num(u.input_tokens ?? u.inputTokens ?? u.prompt_tokens ?? u.promptTokens);
+    const output = num(u.output_tokens ?? u.outputTokens ?? u.completion_tokens ?? u.completionTokens);
+    const cacheRead = num(u.cache_read_input_tokens ?? u.cached_input_tokens ?? u.cacheReadInputTokens ?? u.cachedInputTokens);
+    if (!input && !output && !cacheRead)
+        return null;
+    return { inputTokens: input, outputTokens: output, cachedInputTokens: cacheRead };
+}
+export async function appendUsageEvent(event) {
+    if (!usageLedgerEnabled())
+        return;
+    await mkdir(usageDirPath(), { recursive: true });
+    await appendFile(usageEventsPath(), `${JSON.stringify(event)}\n`, { mode: 0o600 });
+}
+export function recordAgentUsage(options) {
+    if (!usageLedgerEnabled())
+        return;
+    const snap = options.cost.snapshot();
+    const ts = new Date().toISOString();
+    const event = {
+        id: randomUUID(),
+        ts,
+        date: localDate(ts),
+        sessionId: options.sessionId,
+        source: options.source ?? 'headless',
+        model: options.model,
+        cwd: options.cwd,
+        inputTokens: snap.inputTokens,
+        outputTokens: snap.outputTokens,
+        cacheReadTokens: snap.cacheReadTokens,
+        cacheWriteTokens: snap.cacheWriteTokens,
+        totalTokens: snap.totalTokens,
+        costUsd: snap.hasPricing ? snap.costUsd : null,
+        priced: snap.hasPricing,
+    };
+    void appendUsageEvent(event).catch(() => { });
+}
+export async function loadUsageEvents(options = {}) {
+    let raw = '';
+    try {
+        raw = await readFile(usageEventsPath(), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const since = options.since;
+    const until = options.until;
+    const out = [];
+    for (const line of raw.split('\n')) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            const parsed = JSON.parse(t);
+            if (!parsed?.ts || typeof parsed.model !== 'string')
+                continue;
+            const date = parsed.date || localDate(parsed.ts);
+            if (since && date < since)
+                continue;
+            if (until && date > until)
+                continue;
+            out.push({ ...parsed, date });
+        }
+        catch {
+            // skip malformed line
+        }
+    }
+    return out;
+}
+function mergeModels(map, model) {
+    const label = model.includes(':') ? model.split(':').slice(1).join(':') : model;
+    map.set(label, (map.get(label) ?? 0) + 1);
+}
+function topModels(map) {
+    return [...map.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 3)
+        .map(([model]) => `• ${model}`);
+}
+function weekKey(date) {
+    const d = new Date(`${date}T12:00:00`);
+    const day = d.getDay();
+    const diff = day === 0 ? -6 : 1 - day;
+    d.setDate(d.getDate() + diff);
+    return localDate(d.toISOString());
+}
+function monthKey(date) {
+    return date.slice(0, 7);
+}
+export function aggregateUsageEvents(events, mode) {
+    const groups = new Map();
+    for (const event of events) {
+        const key = mode === 'daily'
+            ? event.date
+            : mode === 'weekly'
+                ? weekKey(event.date)
+                : mode === 'monthly'
+                    ? monthKey(event.date)
+                    : event.sessionId ?? `turn:${event.id}`;
+        const bucket = groups.get(key) ?? { models: new Map(), events: [] };
+        mergeModels(bucket.models, event.model);
+        bucket.events.push(event);
+        groups.set(key, bucket);
+    }
+    return [...groups.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([key, bucket]) => {
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let cacheReadTokens = 0;
+        let cacheWriteTokens = 0;
+        let costUsd = 0;
+        for (const event of bucket.events) {
+            inputTokens += event.inputTokens;
+            outputTokens += event.outputTokens;
+            cacheReadTokens += event.cacheReadTokens;
+            cacheWriteTokens += event.cacheWriteTokens;
+            costUsd += event.costUsd ?? 0;
+        }
+        const label = mode === 'session'
+            ? key.startsWith('turn:')
+                ? `${key.slice(5, 18)}…`
+                : key.slice(0, 24)
+            : key;
+        return {
+            key,
+            label,
+            models: topModels(bucket.models),
+            turns: bucket.events.length,
+            inputTokens,
+            outputTokens,
+            cacheReadTokens,
+            cacheWriteTokens,
+            totalTokens: inputTokens + outputTokens + cacheReadTokens + cacheWriteTokens,
+            costUsd,
+        };
+    });
+}
+export function formatUsageLedgerHint() {
+    return `ดูประวัติ token ทั้งหมด: ${BRAND.cliName} usage daily`;
+}