sanook-cli 0.5.5 → 0.5.8

package/README.th.md

@@ -2,15 +2,15 @@
 
 # Sanook CLI
 
-**AI coding agent ใน terminal ที่ "จำงานข้ามวันได้" — open-source**
+**AI coding agent ใน terminal ที่จำงานข้าม session ได้ — open-source**
 
-ใส่ API key ของคุณเอง (BYOK) · 9 providers · MCP · มี **"สมองที่สอง" (second brain)** ที่ทำให้ AI จำ context ข้าม session ได้ — สิ่งที่ Claude Code / Codex / Gemini CLI ลืมทุกครั้งที่ปิด terminal
+<sub>BYOK · 9 providers · MCP · Obsidian second brain · gateway & cron</sub>
 
-[![npm](https://img.shields.io/npm/v/sanook-cli.svg?color=2563eb)](https://www.npmjs.com/package/sanook-cli)
-[![downloads](https://img.shields.io/npm/dm/sanook-cli.svg?color=2563eb)](https://www.npmjs.com/package/sanook-cli)
-[![License](https://img.shields.io/badge/license-Apache--2.0-22c55e.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/sanook-cli.svg?style=flat-square&color=111827&labelColor=1f2937)](https://www.npmjs.com/package/sanook-cli)
+[![downloads](https://img.shields.io/npm/dm/sanook-cli.svg?style=flat-square&color=111827&labelColor=1f2937)](https://www.npmjs.com/package/sanook-cli)
+[![License](https://img.shields.io/badge/license-Apache--2.0-22c55e?style=flat-square&labelColor=1f2937)](LICENSE)
 
-🇬🇧 [Read in English](README.md)
+🇬🇧 [Read in English](README.md) · รายละเอียด memory / second brain อัปเดตใน [README ภาษาอังกฤษ § Memory](README.md#memory--second-brain)
 
 </div>
 
@@ -31,9 +31,11 @@ prompt → LLM → เรียก tool → ผลลัพธ์ → loop →
 ติดตั้งแบบ **global** (ต้องมี `-g`) — ต้องมี **Node ≥ 22** (เช็กด้วย `node -v`):
 
 ```bash
-npm install -g sanook-cli
+npm install -g sanook-cli       # หรือ: npx sanook-cli
 ```
 
+ช่องทางติดตั้งหลายแพลตฟอร์ม (curl · PowerShell · Homebrew · WinGet) ดูตารางใน [README หลัก](README.md#quickstart) — ตอนนี้ใช้ได้จริงคือ **npm/npx**, ช่องทางอื่น scaffold ไว้แล้วรอ setup ครั้งเดียว (`docs/INSTALL_INFRA.md`)
+
 > ⚠️ **`'sanook' is not recognized` / command not found?**
 > แปลว่าลงแบบ local — `npm i sanook-cli` (ไม่มี `-g`) มันลงในโฟลเดอร์ปัจจุบัน **ไม่เข้า PATH** คำสั่ง `sanook` เลยหาไม่เจอ
 > แก้: ลงใหม่ด้วย `npm install -g sanook-cli` · หรือเรียกผ่าน **`npx sanook`** (ใช้ตัวที่ลง local ไปแล้วได้เลย)
@@ -44,6 +46,8 @@ npm install -g sanook-cli
 ```bash
 sanook setup                    # เลือก provider + model และเสนอสร้าง second brain
 sanook model                    # กลับมาเปลี่ยน provider/model ภายหลัง
+sanook persona                  # ตอบคำถามสั้นๆ ให้ AI รู้จักคุณ (เก็บลง memory + second brain)
+sanook dashboard                # เปิด web admin UI (terminal/skills/memory/usage/install)
 sanook auth add anthropic --api-key sk-ant-... --use
 
 # macOS / Linux
@@ -132,7 +136,10 @@ Microsoft Teams ตอนนี้รองรับ proactive delivery/cron ผ
 
 - **BYOK + 9 providers** — Anthropic, Google, OpenAI, xAI, Mistral, Groq, Ollama, LM Studio, Codex
 - **Familiar CLI** — `sanook setup`, `sanook model`, `sanook auth`, `sanook chat -q`, `sanook gateway`, `sanook status`, `sanook sessions`, `sanook dump`, `sanook tools`, `sanook send`
-- **Second brain** — `sanook brain init` สร้าง workspace Obsidian ให้ AI จำงานข้ามวัน
+- **Second brain** — `sanook brain init` สร้าง workspace Obsidian ให้ AI จำงานข้ามวัน · ทุกโฟลเดอร์มี `_Index.md` บอกหน้าที่ + มี `Vault Structure Map.md` รวมทั้งหมด
+- **Persona** — `sanook persona` ตอบคำถาม (A/B/C/D + พิมพ์เอง) ให้ AI รู้จักคุณ แล้วเก็บเป็น protected memory + โปรไฟล์ใน vault (`Shared/User-Persona/persona.md`)
+- **Self-improvement** — ตรวจงานที่สั่งซ้ำ แล้วสร้าง skill ให้อัตโนมัติเมื่อถึง threshold (แจ้งใน terminal + เห็นใน Dashboard) · ปิดด้วย `SANOOK_DISABLE_SELF_IMPROVE=1`
+- **Dashboard** — `sanook dashboard` เปิด web admin UI (loopback): web terminal (agent console + raw shell), skills, memory, usage, self-improve, install
 - **Startup cockpit** — เปิด `sanook` แล้วเห็น wordmark, service routes (Code, Brain, Connect, Ship), และสัญญาณ readiness จริงของ second-brain, MCP, skills, git branch ทันที
 - **Web grounding** — `sanook web status` แยก local brain search ออกจาก true internet search, ตรวจ MCP web/search/fetch ที่ตั้งไว้, และโชว์ policy เรื่อง citation + prompt-injection จากเว็บ
 - **Tools** — อ่าน/เขียน/แก้ไฟล์ · รัน bash/Python/Rust แบบ approval-gated · git · grep/glob พร้อม permission gate

package/dist/auto-maintain.js

@@ -0,0 +1,113 @@
+// ============================================================================
+// src/auto-maintain.ts — "second brain ดูแลตัวเอง" — งาน maintenance ที่เคยต้องสั่งเอง
+// (sanook brain consolidate / distill) ให้ทำอัตโนมัติ:
+//   • startup: ถ้าครบ ~1 สัปดาห์ → consolidate memory + vault (dedup, archive stale, index) แบบ background
+//   • exit / headless turn: distill บทสนทนา → durable memory (knowledge compound เอง)
+// ทั้งหมด best-effort (ไม่ทำให้ flow ล้ม) และ "ไม่ลบของ" — ใช้ archive (กู้คืนได้) ไม่ใช่ delete.
+// ปิดได้: config `autoMaintain=false` หรือ env SANOOK_DISABLE_AUTO_MAINTAIN=1.
+// ============================================================================
+import { readFile, writeFile } from 'node:fs/promises';
+import { appHomePath, envFlag, persistenceEnabled } from './brand.js';
+import { loadConfig } from './config.js';
+const STATE_FILE = 'auto-maintain.json';
+/** วิ่ง vault/memory consolidation อย่างมากสัปดาห์ละครั้ง — กัน startup ทำงานหนักทุกครั้ง */
+const CONSOLIDATE_INTERVAL_MS = 7 * 24 * 60 * 60 * 1000;
+/** distill เก็บได้สูงสุดกี่ fact ต่อ session — กัน memory ท่วมจาก session เดียว */
+const MAX_DISTILL_FACTS = 8;
+/**
+ * auto-maintenance เปิดโดย default. ปิดเมื่อ:
+ *  - persistence ปิด (ไม่มีที่เก็บ memory อยู่แล้ว)
+ *  - env SANOOK_DISABLE_AUTO_MAINTAIN=1
+ *  - config autoMaintain === false (ผู้ใช้ตั้งปิดเอง)
+ */
+export async function autoMaintainEnabled() {
+    if (!persistenceEnabled())
+        return false;
+    if (envFlag('SANOOK_DISABLE_AUTO_MAINTAIN'))
+        return false;
+    try {
+        const cfg = await loadConfig({});
+        return cfg.autoMaintain !== false;
+    }
+    catch {
+        return true; // อ่าน config ไม่ได้ → default on
+    }
+}
+async function readState() {
+    try {
+        const raw = await readFile(appHomePath(STATE_FILE), 'utf8');
+        const v = JSON.parse(raw);
+        return { lastConsolidate: typeof v.lastConsolidate === 'number' ? v.lastConsolidate : 0 };
+    }
+    catch {
+        return { lastConsolidate: 0 };
+    }
+}
+async function writeState(state) {
+    try {
+        await writeFile(appHomePath(STATE_FILE), `${JSON.stringify(state, null, 2)}\n`);
+    }
+    catch {
+        /* best-effort — ไม่ critical ถ้าเขียน state ไม่ได้ */
+    }
+}
+/** true ถ้าถึงกำหนด consolidate รอบถัดไปแล้ว (เปิด + ครบ interval) — แยกไว้ให้ test ได้ */
+export async function isConsolidationDue(now = Date.now()) {
+    if (!(await autoMaintainEnabled()))
+        return false;
+    const { lastConsolidate } = await readState();
+    return now - lastConsolidate >= CONSOLIDATE_INTERVAL_MS;
+}
+/**
+ * เรียกตอน REPL เริ่ม (background, fire-and-forget): ถ้าครบสัปดาห์ → consolidate memory + vault
+ * (dedup, archive stale ตาม decay, รัน retrieval ข้ามเพื่อความเร็ว) แล้วจดเวลาไว้. คืน status สั้น
+ * ถ้ารัน, null ถ้าข้าม/ปิด. ไม่ throw (best-effort) เพื่อไม่กระทบการเปิด REPL.
+ */
+export async function maybeStartupMaintain(now = Date.now()) {
+    if (!(await isConsolidationDue(now)))
+        return null;
+    // จดเวลา "ก่อน" รัน — กัน REPL หลายตัว/รันซ้อนยิง consolidate พร้อมกัน (จดทันทีถือว่า claim รอบนี้)
+    await writeState({ lastConsolidate: now });
+    try {
+        const cfg = await loadConfig({});
+        const { runBrainConsolidate } = await import('./brain-consolidate.js');
+        const report = await runBrainConsolidate({
+            brainPath: cfg.brainPath,
+            apply: true,
+            archive: true, // ย้าย stale → archive (กู้คืนได้) ไม่ลบ
+            memory: true,
+            runRetrieval: false, // ข้าม retrieval eval ตอน startup เพื่อความเร็ว
+        });
+        if (!report.ok)
+            return null;
+        const changes = (report.steps ?? []).reduce((n, s) => n + (s.applied?.length ?? 0), 0);
+        return changes > 0 ? `auto-maintain: จัดระเบียบ memory + vault (${changes} รายการ)` : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * distill บทสนทนา → durable auto-memory (knowledge ที่ compound ข้าม session). เรียกตอนจบ session
+ * (REPL exit) และตอนจบ turn (headless). best-effort, ไม่ throw. คืนจำนวน fact ที่เขียน.
+ */
+export async function autoDistillToMemory(messages) {
+    if (!Array.isArray(messages) || !messages.length)
+        return 0;
+    if (!(await autoMaintainEnabled()))
+        return 0;
+    try {
+        const { distilledFactsFromMessages } = await import('./session-distill.js');
+        const { appendMemory } = await import('./memory.js');
+        const facts = distilledFactsFromMessages(messages).slice(0, MAX_DISTILL_FACTS);
+        let written = 0;
+        for (const fact of facts) {
+            await appendMemory(fact).catch(() => { });
+            written += 1;
+        }
+        return written;
+    }
+    catch {
+        return 0;
+    }
+}

package/dist/bin.js

@@ -34,7 +34,7 @@ async function runHeadless(model, prompt, budgetUsd, maxSteps, json, history, pl
         process.stderr.write(`${DIM}⚠ fallback model ${fallbackModel} ไม่มี pricing → budget cap จะไม่ทำงานถ้า fallback ถูกใช้${RESET}\n`);
     }
     try {
-        const { cost, messages } = await runAgent({
+        const { cost, messages, text } = await runAgent({
             model,
             fallbackModel,
             prompt,
@@ -65,22 +65,41 @@ async function runHeadless(model, prompt, budgetUsd, maxSteps, json, history, pl
         }
         // จำ session ไว้ทำงานต่อได้ (sanook --continue "...") — แก้ concern AI ลืมว่าทำถึงไหน
         const now = new Date().toISOString();
-        await saveSession({ id: newSessionId(), created: now, updated: now, model, cwd: process.cwd(), messages });
-        // auto-worklog เข้า second-brain (ถ้าตั้ง brainPath) — "vault จำว่าวันนี้ทำอะไร"
-        const { getBrainPath, appendBrainWorklog } = await import('./memory.js');
+        const headlessSessionId = newSessionId();
+        await saveSession({ id: headlessSessionId, created: now, updated: now, model, cwd: process.cwd(), messages });
+        // auto-worklog (ย่อ) + บทสนทนาเต็ม (ถ้าเปิด brainTranscript) เข้า second-brain
+        const { getBrainPath, appendBrainWorklog, appendBrainTranscript } = await import('./memory.js');
         const brain = await getBrainPath();
         if (brain) {
             await appendBrainWorklog(brain, { prompt, summary: cost.summary(), model, today: now.slice(0, 10) }).catch(() => { });
+            await appendBrainTranscript(brain, {
+                sessionId: headlessSessionId,
+                prompt,
+                answer: text,
+                model,
+                createdIso: now,
+            }).catch(() => { });
+        }
+        // self-improvement: งานเดิมที่สั่งซ้ำถึง threshold → สร้าง skill อัตโนมัติ + แจ้งใน stderr
+        try {
+            const { maybeAutoSkill } = await import('./self-improve.js');
+            const { defaultSkillSynthesizer } = await import('./self-improve-synth.js');
+            const { loadSkills, saveSkill } = await import('./skills.js');
+            const existing = new Set((await loadSkills()).map((s) => s.name));
+            const auto = await maybeAutoSkill(prompt, { synthesize: defaultSkillSynthesizer(model), saveSkill, existingSkillNames: existing });
+            if (auto.created && auto.announcement)
+                process.stderr.write(`${auto.announcement}\n`);
+        }
+        catch {
+            /* best-effort */
         }
-        // opt-in (experimental, default OFF): auto-distill durable decisions/gotchas/preferences from this
-        // session into the compounding memory store so the self-retrieving brain surfaces them next time.
-        // Off by default per experiment H5 — extraction is high-precision (~0.88) but end-to-end recall is
-        // gated by retrieval quality (semantic helps). Enable with SANOOK_AUTO_DISTILL=1.
-        if (envFlag('SANOOK_AUTO_DISTILL')) {
-            const { distilledFactsFromMessages } = await import('./session-distill.js');
-            const { appendMemory } = await import('./memory.js');
-            for (const fact of distilledFactsFromMessages(messages))
-                await appendMemory(fact).catch(() => { });
+        // auto-distill durable decisions/gotchas/preferences from this turn into the compounding memory store
+        // so the self-retrieving brain surfaces them next time. Default ON via autoMaintain (gating + cap live
+        // in auto-maintain.ts); legacy SANOOK_AUTO_DISTILL still forces it on. Best-effort.
+        {
+            const { autoDistillToMemory, autoMaintainEnabled } = await import('./auto-maintain.js');
+            if (envFlag('SANOOK_AUTO_DISTILL') || (await autoMaintainEnabled()))
+                await autoDistillToMemory(messages);
         }
     }
     catch (err) {
@@ -129,9 +148,11 @@ usage:
   ${BRAND.cliName} setup [section]      setup wizard (model | gateway | tools | agent | brain)
   ${BRAND.cliName} dashboard [--port]   Sanook Dashboard (local web admin UI)
   ${BRAND.cliName} model                choose provider + model
+  ${BRAND.cliName} persona              ตอบคำถาม persona → AI เข้าใจคุณ (เก็บลง memory + second-brain)
   ${BRAND.cliName} --json "<task>"     headless, JSONL output (for CI/scripts)
   ${BRAND.cliName} sessions             list/resume-audit saved conversation sessions
   ${BRAND.cliName} insights             local usage/session insights
+  ${BRAND.cliName} usage [daily|...]    token/cost ledger (ccusage-style)
   ${BRAND.cliName} dump [--show-keys]   support snapshot (secrets redacted)
   ${BRAND.cliName} prompt-size [--json]  inspect prompt/context budget without calling a model
   ${BRAND.cliName} runtimes [--json]     inspect optional Python/Rust runtime surface
@@ -215,7 +236,7 @@ config & mcp:
   ${BRAND.cliName} runtimes [--json]               ดู Python/Rust optional runtime + บทบาทใน Sanook
   ${BRAND.cliName} web status [--json]             ดู web-search/fetch readiness และ grounding policy
   ${BRAND.cliName} tools                          ดู tool surface ที่ agent ใช้ได้
-  ${BRAND.cliName} config [get|set <k> <v>]       ดู/แก้ ${appHomePath('config.json')} (model/budgetUsd/permissionMode/cacheTtl/compaction/contextCompression/thinking/embeddingModel)
+  ${BRAND.cliName} config [get|set <k> <v>]       ดู/แก้ ${appHomePath('config.json')} (model/fallbackModel/budgetUsd/maxSteps/permissionMode/brainPath/brainTranscript/autoMaintain/cacheTtl/compaction/contextCompression/thinking/summaryModel/embeddingModel/personality)
   ${BRAND.cliName} mcp [search|info|install|test|doctor|enable|disable|preset|list|add|remove]   จัดการ MCP servers
   ${BRAND.cliName} trust [status|add|remove]      อนุญาต/ยกเลิก project .sanook mcp/hooks/skills/commands
 
@@ -308,6 +329,16 @@ async function runDashboard(args = []) {
     process.on('SIGINT', shutdown);
     process.on('SIGTERM', shutdown);
 }
+async function runPersona(args = []) {
+    if (args[0] === '-h' || args[0] === '--help') {
+        console.log(`ใช้: ${BRAND.cliName} persona`);
+        console.log('ตอบคำถามสั้นๆ เพื่อบอก AI ว่าคุณเป็นใคร + อยากให้ทำงานยังไง');
+        console.log('— บันทึกลง auto-memory (protected) และโปรไฟล์ใน second-brain vault');
+        return;
+    }
+    const { startPersonaSetup } = await import('./ui/render.js');
+    await startPersonaSetup();
+}
 async function runTools(_args = []) {
     const { tools } = await import('./tools/index.js');
     const names = Object.keys(tools).sort();
@@ -526,12 +557,15 @@ async function runAgentSetupSummary() {
     console.log(`  maxSteps:       ${cfg.maxSteps}`);
     console.log(`  budgetUsd:      ${cfg.budgetUsd ?? '(not set)'}`);
     console.log(`  brainPath:      ${cfg.brainPath ?? '(not set)'}`);
+    console.log(`  brainTranscript:${cfg.brainTranscript ? ' on' : ' off'}`);
+    console.log(`  autoMaintain:   ${cfg.autoMaintain === false ? 'off' : 'on'} (consolidate+distill อัตโนมัติ)`);
     console.log(`  insights:       ${BRAND.cliName} insights [--days N]`);
     console.log('\nแก้ค่าได้ด้วย:');
     console.log(`  ${BRAND.cliName} config set personality concise`);
     console.log(`  ${BRAND.cliName} config set permissionMode ask`);
     console.log(`  ${BRAND.cliName} config set budgetUsd 0.25`);
     console.log(`  ${BRAND.cliName} config set fallbackModel haiku`);
+    console.log(`  ${BRAND.cliName} config set brainTranscript on`);
 }
 async function runGatewayDoctor() {
     const { checkGateway, formatGatewayDoctorReport } = await import('./gateway/doctor.js');
@@ -2317,6 +2351,17 @@ async function runSessions(args) {
     console.error(`ไม่รู้จัก: sessions ${action}\n${sessionUsage()}`);
     process.exit(1);
 }
+async function runUsage(args) {
+    const { parseUsageArgs, renderUsageReport, usageHelpText } = await import('./usage-cli.js');
+    const parsed = parseUsageArgs(args);
+    if (!parsed) {
+        console.log(usageHelpText());
+        if (args.length && !args.includes('-h') && !args.includes('--help'))
+            process.exit(2);
+        return;
+    }
+    console.log(await renderUsageReport(parsed));
+}
 async function runInsights(args) {
     const { parseInsightsArgs } = await import('./insights-args.js');
     const parsed = parseInsightsArgs(args);
@@ -3424,6 +3469,8 @@ async function runConfig(args) {
         'maxSteps',
         'permissionMode',
         'brainPath',
+        'brainTranscript',
+        'autoMaintain',
         'pricing',
         'cacheTtl',
         'compaction',
@@ -3481,6 +3528,17 @@ async function runConfig(args) {
             const { expandHome } = await import('./brain.js');
             value = resolve(expandHome(raw.trim()));
         }
+        else if (key === 'brainTranscript' || key === 'autoMaintain') {
+            const v = raw.trim().toLowerCase();
+            if (['on', 'true', '1', 'yes'].includes(v))
+                value = true;
+            else if (['off', 'false', '0', 'no'].includes(v))
+                value = false;
+            else {
+                console.error(`${key} ต้องเป็น on/off, true/false หรือ yes/no`);
+                process.exit(1);
+            }
+        }
         else if (key === 'thinking') {
             // เก็บเป็น number (budget) หรือ boolean ให้ตรง ConfigSchema (ไม่เก็บ string)
             value = parseThinkingConfigValue(raw);
@@ -4084,6 +4142,8 @@ async function main() {
         return runAuth(argv.slice(1));
     if (argv[0] === 'sessions' || argv[0] === 'session')
         return runSessions(argv.slice(1));
+    if (argv[0] === 'usage')
+        return runUsage(argv.slice(1));
     if (argv[0] === 'insights')
         return runInsights(argv.slice(1));
     if (argv[0] === 'memory' && ['log', 'stats', undefined].includes(argv[1]))
@@ -4097,6 +4157,8 @@ async function main() {
     if (argv[0] === 'dashboard' && (argv.length === 1 || !argv[1].startsWith('-') || argv[1] === '--port')) {
         return runDashboard(argv.slice(1));
     }
+    if (argv[0] === 'persona' && (argv.length === 1 || argv[1].startsWith('-')))
+        return runPersona(argv.slice(1));
     if (argv[0] === 'web' && ['status', 'doctor', 'fetch', 'search', 'setup', undefined].includes(argv[1]))
         return runWeb(argv.slice(1));
     if (argv[0] === 'tools' && (argv.length === 1 || argv[1].startsWith('--')))
@@ -4136,7 +4198,7 @@ async function main() {
     // A management command word whose subcommand didn't match any route above → don't silently
     // fall through and run it as an LLM task (costly + confusing). These words intentionally
     // require a valid subcommand; an NL prompt starting with one can still be quoted as a single arg.
-    const MANAGEMENT_WORDS = new Set(['config', 'mcp', 'brain', 'web', 'trust', 'cron', 'skill', 'init', 'dashboard']);
+    const MANAGEMENT_WORDS = new Set(['config', 'mcp', 'brain', 'web', 'trust', 'cron', 'skill', 'init', 'dashboard', 'persona']);
     if (argv[0] && MANAGEMENT_WORDS.has(argv[0]) && argv[1] && !argv[1].startsWith('-')) {
         console.error(`${BRAND.cliName}: ไม่รู้จัก subcommand "${argv[0]} ${argv[1]}" — ดูวิธีใช้: ${BRAND.cliName} --help`);
         process.exit(1);

package/dist/brain-final.js

@@ -212,12 +212,13 @@ function instantiateTemplate(raw, options) {
     const titleTask = options.task;
     let content = raw
         .replaceAll('YYYY-MM-DD', options.today)
-        .replaceAll('<task/topic>', titleTask)
+        .replaceAll('<task/topic>', () => titleTask)
         .replace('tags: [template, final-gate, verification, dod]', 'tags: [final-gate, verification, dod]')
         .replace('tags: [template, final-gate, verification, lite]', 'tags: [final-gate, verification, lite]')
         .replace('parent: "[[Templates/_Index]]"', 'parent: "[[Sessions/_Index]]"')
         .replace('up:: [[Templates/_Index]]', 'up:: [[Sessions/_Index]]')
-        .replace('<paste owner request or goal text here>', options.task);
+        // replacer functions throughout — `$`-sequences in the user task/title must be written literally
+        .replace('<paste owner request or goal text here>', () => options.task);
     if (options.fromDiff)
         content = injectDiffEvidence(content, options.diffFiles);
     return content;
@@ -234,7 +235,9 @@ function injectDiffEvidence(content, diffFiles) {
 function replaceFilesChangedRows(content, fileRows) {
     const fullPattern = /(Files changed:\n\n\| File\/path \| Change summary \| Evidence \|\n\|---\|---\|---\|\n)\| `(?:<path>|<file>)` \|  \|  \|/;
     const litePattern = /(Changed files:\n\n\| File \| Change summary \| Evidence \|\n\|---\|---\|---\|\n)\| `(?:<path>|<file>)` \|  \|  \|/;
-    return content.replace(fullPattern, `$1${fileRows}`).replace(litePattern, `$1${fileRows}`);
+    // replacer functions keep the $1 backreference (the captured header) while writing fileRows
+    // literally — a changed file path can legitimately contain a `$`, which a string replacement would mangle.
+    return content.replace(fullPattern, (_m, p1) => `${p1}${fileRows}`).replace(litePattern, (_m, p1) => `${p1}${fileRows}`);
 }
 async function readTemplate(brainPath, template) {
     const vaultTemplate = join(brainPath, 'Templates', template);
@@ -284,7 +287,8 @@ async function maybeAppendSessionIndex(brainPath, relPath, task) {
         return false;
     const line = `- ${link} — final gate: ${task}`;
     const marker = '\nup:: [[Home]]';
-    const next = content.includes(marker) ? content.replace(marker, `\n${line}\n${marker}`) : `${content.trimEnd()}\n${line}\n`;
+    // replacer function so `$`-sequences in the task text aren't interpreted as String.replace patterns
+    const next = content.includes(marker) ? content.replace(marker, () => `\n${line}\n${marker}`) : `${content.trimEnd()}\n${line}\n`;
     await writeFile(indexPath, next, 'utf8');
     return true;
 }

package/dist/brain-link.js

@@ -0,0 +1,73 @@
+import { readFile, stat, writeFile } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { BRAND } from './brand.js';
+import { scaffoldProjectWorkspace } from './project-scaffold.js';
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Wire a freshly scaffolded vault to the current repo: Projects/<slug>/ + SANOOK.md memory stub. */
+export async function linkBrainToProject(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const brainPath = options.brainPath;
+    const title = options.title?.trim() || basename(cwd) || 'Project';
+    const today = options.today ?? new Date().toISOString().slice(0, 10);
+    const warnings = [];
+    const scaffold = await scaffoldProjectWorkspace({
+        brainPath,
+        title,
+        repoPath: cwd,
+        today,
+    });
+    if (!scaffold.ok && scaffold.skipped.length) {
+        warnings.push(...scaffold.warnings);
+    }
+    else if (scaffold.warnings.length) {
+        warnings.push(...scaffold.warnings);
+    }
+    const memoryFile = join(cwd, BRAND.memoryFileName);
+    let memoryCreated = false;
+    if (!(await exists(memoryFile))) {
+        const body = [
+            `# ${BRAND.productName} project memory`,
+            '',
+            `> Linked to second-brain vault: \`${brainPath}\``,
+            scaffold.ok || scaffold.slug ? `> Project workspace: \`Projects/${scaffold.slug}/\`` : '',
+            '',
+            '## Conventions',
+            '',
+            '- Decisions, gotchas, and preferences discovered in this repo belong here or in the vault.',
+            `- Session summaries are auto-written to \`Sessions/\` in the vault on exit (Ctrl+C / /quit).`,
+            '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+        await writeFile(memoryFile, `${body}\n`, 'utf8');
+        memoryCreated = true;
+    }
+    else {
+        try {
+            const current = await readFile(memoryFile, 'utf8');
+            if (!current.includes(brainPath)) {
+                await writeFile(memoryFile, `${current.trimEnd()}\n\n<!-- ${BRAND.productName} -->\nsecond-brain: ${brainPath}\nproject: Projects/${scaffold.slug}/\n`, 'utf8');
+            }
+        }
+        catch {
+            warnings.push(`Could not update existing ${BRAND.memoryFileName}`);
+        }
+    }
+    return {
+        ok: scaffold.ok || scaffold.skipped.length > 0,
+        brainPath,
+        projectSlug: scaffold.slug,
+        projectRelDir: scaffold.relDir,
+        memoryFile,
+        memoryCreated,
+        warnings,
+    };
+}

package/dist/brain-new.js

@@ -173,7 +173,8 @@ export function instantiateNoteTemplate(raw, options) {
     let content = raw.replaceAll('YYYY-MM-DD', options.today).replaceAll('{{DATE}}', options.today);
     const config = BRAIN_NOTE_TYPES[options.type];
     for (const placeholder of config.titlePlaceholders) {
-        content = content.replaceAll(placeholder, options.title);
+        // replacer function so `$`-sequences in the note title are written literally
+        content = content.replaceAll(placeholder, () => options.title);
     }
     content = content.replace(/^# .+$/m, (heading) => {
         if (heading.includes(options.title))
@@ -192,16 +193,18 @@ export function instantiateNoteTemplate(raw, options) {
             return `# ${options.title}`;
         return heading;
     });
+    // replacer functions throughout — the parent path is user-derived (--output), so `$`-sequences in it
+    // must be written literally, not interpreted as String.replace patterns.
     const parentValue = `"[[${options.parent}]]"`;
     if (/^parent:/m.test(content)) {
-        content = content.replace(/^parent:.*$/m, `parent: ${parentValue}`);
+        content = content.replace(/^parent:.*$/m, () => `parent: ${parentValue}`);
     }
     else if (/^---[\s\S]*?---/m.test(content)) {
-        content = content.replace(/^---\n/m, `---\nparent: ${parentValue}\n`);
+        content = content.replace(/^---\n/m, () => `---\nparent: ${parentValue}\n`);
     }
     const upLink = `up:: [[${options.parent}]]`;
     if (content.includes('up:: [['))
-        content = content.replace(/^up:: \[\[[^\]]+\]\]\s*$/m, upLink);
+        content = content.replace(/^up:: \[\[[^\]]+\]\]\s*$/m, () => upLink);
     else
         content = `${content.trimEnd()}\n\n${upLink}\n`;
     if (options.type === 'golden-case')
@@ -359,7 +362,8 @@ async function maybeAppendDestinationIndex(brainPath, indexRel, noteRel, title,
         return false;
     const line = `- ${link} — ${type}: ${title}`;
     const marker = '\nup:: [[Home]]';
-    const next = content.includes(marker) ? content.replace(marker, `\n${line}\n${marker}`) : `${content.trimEnd()}\n${line}\n`;
+    // replacer function so `$`-sequences in the note title aren't interpreted as String.replace patterns
+    const next = content.includes(marker) ? content.replace(marker, () => `\n${line}\n${marker}`) : `${content.trimEnd()}\n${line}\n`;
     await writeFile(indexPath, next, 'utf8');
     return true;
 }

package/dist/brain-repair.js

@@ -56,8 +56,9 @@ export function applyPurposeFix(content) {
     if (/^>\s+/m.test(content))
         return content;
     const match = content.match(/^---[\s\S]*?---\n?/);
+    // replacer function so `$`-sequences in the matched frontmatter are written literally
     if (match)
-        return content.replace(match[0], `${match[0]}${PURPOSE_PLACEHOLDER}`);
+        return content.replace(match[0], () => `${match[0]}${PURPOSE_PLACEHOLDER}`);
     return `${PURPOSE_PLACEHOLDER}${content}`;
 }
 export function applyParentFix(content, relPath) {
@@ -68,7 +69,8 @@ export function applyParentFix(content, relPath) {
     const match = content.match(/^---\n([\s\S]*?)---\n/);
     if (!match)
         return `---\n${parentLine}\n---\n\n${content}`;
-    return content.replace(/^---\n/, `---\n${parentLine}\n`);
+    // replacer function so `$`-sequences in the inferred parent path aren't interpreted as replace patterns
+    return content.replace(/^---\n/, () => `---\n${parentLine}\n`);
 }
 export function applyUpLinkFix(content, relPath) {
     if (content.includes('up:: [['))
@@ -111,11 +113,12 @@ export function applyContextPackIndexFix(indexContent, packName, packContent) {
     const description = extractBlockquotePurpose(packContent) || 'context pack';
     const line = `- ${link} — ${description}`;
     const marker = '\n## Use Rule';
+    // replacer functions so `$`-sequences in the pack description aren't interpreted as replace patterns
     if (indexContent.includes(marker))
-        return indexContent.replace(marker, `\n${line}\n${marker}`);
+        return indexContent.replace(marker, () => `\n${line}\n${marker}`);
     const upMarker = '\nup:: [[Shared/_Index]]';
     if (indexContent.includes(upMarker))
-        return indexContent.replace(upMarker, `\n${line}\n${upMarker}`);
+        return indexContent.replace(upMarker, () => `\n${line}\n${upMarker}`);
     return `${indexContent.trimEnd()}\n${line}\n`;
 }
 export async function collectRepairActions(brainPath, expectedFolders = FOLDERS.map((folder) => folder.dir)) {

package/dist/brand.js

@@ -24,6 +24,10 @@ export const BRAND_ENV = {
     disablePersistence: 'SANOOK_DISABLE_PERSISTENCE',
     disableUpdateCheck: 'SANOOK_DISABLE_UPDATE_CHECK',
     disableWorklog: 'SANOOK_DISABLE_WORKLOG',
+    disableUsageLedger: 'SANOOK_DISABLE_USAGE',
+    brainTranscript: 'SANOOK_BRAIN_TRANSCRIPT',
+    disableSelfImprove: 'SANOOK_DISABLE_SELF_IMPROVE',
+    selfImproveThreshold: 'SANOOK_SELF_IMPROVE_THRESHOLD',
     trustProject: 'SANOOK_TRUST_PROJECT',
 };
 export function appHomePath(...parts) {
@@ -45,3 +49,20 @@ export function persistenceEnabled() {
 export function worklogEnabled() {
     return !envFlag(BRAND_ENV.disableWorklog);
 }
+export function usageLedgerEnabled() {
+    return persistenceEnabled() && !envFlag(BRAND_ENV.disableUsageLedger);
+}
+/** env-level force for full-transcript-to-vault; config.brainTranscript is the persistent toggle */
+export function brainTranscriptEnvForced() {
+    return envFlag(BRAND_ENV.brainTranscript);
+}
+/** self-improvement (auto-skill จากงานที่ทำซ้ำ) — เปิด default, ปิดด้วย SANOOK_DISABLE_SELF_IMPROVE=1 */
+export function selfImproveEnabled() {
+    return persistenceEnabled() && !envFlag(BRAND_ENV.disableSelfImprove);
+}
+/** จำนวนครั้งที่งานคล้ายกันต้องเกิดก่อน auto-สร้าง skill (default 3) — override ด้วย env */
+export function selfImproveThreshold() {
+    const raw = process.env[BRAND_ENV.selfImproveThreshold]?.trim();
+    const n = raw ? Number(raw) : NaN;
+    return Number.isInteger(n) && n >= 2 ? n : 3;
+}

package/dist/commands.js

@@ -15,6 +15,7 @@ export const HELP_TEXT = `คำสั่ง:
   /model [spec]    ดู/เปลี่ยน model — /model เปิด picker 2 ขั้น (provider → model)
   /setup           ดูขั้นตอน setup wizard (model · agent · tools · gateway · brain)
   /dashboard       เปิด Sanook Dashboard (local web UI)
+  /persona         ตั้งค่า persona (ใครคุณเป็น + อยากให้ AI ทำงานยังไง)
   /personality [name]
                    ดู/ตั้ง personality overlay
   /details [thinking|tools] [hidden|collapsed|expanded]
@@ -206,6 +207,8 @@ export function parseCommand(input, ctx) {
                 handled: true,
                 message: `Sanook Dashboard — รัน: ${BRAND.cliName} dashboard\n  แล้วเปิด http://127.0.0.1:9119 (Chat · Files · Logs · Cron · Channels)`,
             };
+        case 'persona':
+            return { handled: true, action: 'personaSetup', message: 'เปิด persona wizard…' };
         case 'personality': {
             const raw = args.join(' ').trim();
             if (!raw)
@@ -282,7 +285,10 @@ export function parseCommand(input, ctx) {
             return { handled: true, action: 'rewind' };
         case 'cost':
         case 'usage':
-            return { handled: true, message: ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)' };
+            return {
+                handled: true,
+                message: `${ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)'}\n→ ${BRAND.cliName} usage daily`,
+            };
         case 'insights': {
             const parsed = parseInsightsArgs(args);
             if (parsed === null)