sanook-cli 0.4.0 → 0.5.0

package/dist/brain.js

@@ -1,7 +1,8 @@
-import { readFile, writeFile, mkdir, readdir, stat } from 'node:fs/promises';
+import { chmod, readFile, writeFile, mkdir, readdir, stat } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { appHomePath } from './brand.js';
 /** ขยาย ~ ขึ้นต้น path เป็น home dir */
 export function expandHome(p) {
     return p === '~' || p.startsWith('~/') ? join(homedir(), p.slice(1)) : p;
@@ -18,54 +19,67 @@ export const BRAIN_DEFAULTS = {
     vaultName: 'Second Brain',
     autonomy: 'ask-on-risk',
 };
-/**
- * โฟลเดอร์ทั้งหมด + บทบาท (จาก GEMINI.md §B.0 Folder Role Table) → generate _Index.md ให้ทุกอัน
- * top-level parent = Home · Shared/<x> parent = Shared/_Index (Shared เองชี้ Home)
- */
-// ⚠ sync กับ second-brain/Vault Structure Map.md — แก้ role/โฟลเดอร์ ต้องแก้ทั้งสองที่ (มี test กัน drift)
 export const FOLDERS = [
-    // Core (MVV)
-    { dir: 'Projects', role: 'workspace ของงานจริง — 1 โฟลเดอร์ = 1 โปรเจค (overview/context/current-state)' },
-    { dir: 'Sessions', role: 'flat chronological log ของงาน + checkpoint (YYYY-MM-DD-<topic>.md)' },
-    { dir: 'Intake', role: 'จุดรับของใหม่เข้า vault (raw input + task framing) ก่อนกระจายเข้าปลายทาง' },
-    { dir: 'Intake/_Quarantine', role: 'external content (web/paste) ที่ยัง untrusted — scan injection ก่อน promote (ดู Runbooks/ingest-quarantine)' },
-    { dir: 'Intake/Raw Sources', role: 'ต้นฉบับ external ที่ผ่าน scan แล้ว — immutable read-only, source:: ชี้มาที่นี่ได้' },
-    { dir: 'Skills', role: 'reusable unit ที่ executable + ผ่าน verification command — ไม่ใช่ prose (นั่นคือ Runbooks) ดู Shared/Rules/skills-admission' },
-    { dir: 'Runbooks', role: 'prose how-to ที่อ่านแล้วทำตามเอง (setup/deploy/maintain) — ไม่ใช่ runnable unit (นั่นคือ Skills)' },
-    { dir: 'Templates', role: 'แม่แบบโน้ต — instantiate จากที่นี่ตอนสร้างโน้ตใหม่' },
-    { dir: 'Bugs', role: 'bug report reproducible ลงวันที่ ไม่ลบ — project bug ก็มาที่นี่ (global, flat) + link กลับ project' },
-    { dir: 'Handoffs', role: 'เอกสารส่งมอบงานค้าง 1 ชิ้น (state + next steps) — snapshot ครั้งเดียว ไม่ใช่ live coordination' },
-    // Direction
-    { dir: 'Goals', role: 'north-star + objective รายไตรมาส/ปี (finite, มีวันจบ) — ไม่เก็บ live status (นั่นคือ Operating-State)' },
-    { dir: 'Areas', role: 'PARA — โดเมนงานต่อเนื่องที่ไม่มีวันจบ (brand/trading/content...)' },
-    // Knowledge pipeline
-    { dir: 'Research', role: 'finding ที่อิงแหล่งภายนอก (มี source::) + market scan + reference synthesis' },
-    { dir: 'Learning', role: 'knowledge ที่ตัวเองกลั่น/deep-dive ตาม topic (ไม่มี external source) — curated MOC' },
-    { dir: 'Distillations', role: 'หลักการ evergreen ที่กลั่นนิ่งแล้ว (เห็น ≥3 ครั้ง) — atomic' },
-    { dir: 'Retrospectives', role: 'reflection หลังงาน (event-triggered: what worked/failed)' },
-    { dir: 'Reviews', role: 'review ตาม cadence (time-triggered: weekly/monthly) + vault health' },
-    { dir: 'Traces', role: 'exploration/reasoning chain ยาว (คำถามใหญ่เกินโน้ตเดียว)' },
-    { dir: 'Prompts', role: 'prompt text/template ที่หยิบมารันได้ทันที (input ให้ LLM)' },
-    { dir: 'Acceptance', role: 'golden input→expected-output fixtures ที่ใช้ตัดสิน done/not-done — ไม่ใช่ checklist, ไม่ใช่ runner (นั่นคือ Evals)' },
-    { dir: 'Checklists', role: 'preflight/postflight gate (ticklist ก่อน-หลังลงมือ) — ไม่เก็บ expected output' },
-    // Frontier loops
-    { dir: 'Playbooks', role: 'กลยุทธ์/ลำดับการตัดสินใจที่ปรับดีขึ้นจากผลจริง (how-to-decide) — ไม่ใช่ prompt text, ไม่ใช่ runnable unit' },
-    { dir: 'Evals', role: 'quality loop ที่รัน Acceptance/golden-set แล้ว error-analysis + self-eval (runner + ผล, ไม่เก็บ case เอง)' },
-    { dir: 'Entities', role: 'canonical page ต่อ entity/person/org/concept (LLM-wiki, bi-temporal)' },
-    // Shared (สมองกลาง) — Shared/_Index เองชี้ Home
-    { dir: 'Shared', role: 'สมองกลาง: memory + rules + coordination (เข้าผ่าน AI-Context-Index)' },
-    { dir: 'Shared/Operating-State', role: 'live status/metrics ตอนนี้ (current-state + health/queue)' },
-    { dir: 'Shared/User-Memory', role: 'สิ่งที่ AI เรียนรู้เกี่ยวกับเจ้าของระหว่างทำงาน — preference/response-example (mutable)' },
-    { dir: 'Shared/Decision-Memory', role: 'การตัดสินใจที่ AI บันทึก locked (latest-wins + supersedes)' },
-    { dir: 'Shared/Memory-Inbox', role: 'candidate durable memory ที่ยังไม่ชัด/ขัดกัน — รอ promote (เคลียร์ทุก weekly)' },
-    { dir: 'Shared/Rules', role: 'กฎ operating always-on (memory/frontmatter/context-assembly/graph)' },
-    { dir: 'Shared/Tech-Standards', role: 'มาตรฐานเทคนิค (MCP/stack/DoD/verification)' },
-    { dir: 'Shared/Core-Facts', role: 'ground truth ที่เจ้าของเขียนเอง — read-only, AI ไม่ supersede/ไม่แก้' },
-    { dir: 'Shared/Coordination', role: 'live coordination ของหลาย agent พร้อมกัน (NOW.md baton + task-board + registry) — ไม่ใช่เอกสารส่งมอบ (นั่นคือ Handoffs)' },
-    { dir: 'Shared/Working-Memory', role: 'scratchpad ระหว่าง 1 task — ลบทิ้งได้หลังจบ ไม่มีวัน promote' },
-    { dir: 'Shared/User-Persona', role: 'identity profile ที่เปลี่ยนน้อยมาก (บทบาท/ค่านิยม/ภาษา/timezone) — human-owned, read-only' },
-    { dir: 'Shared/Provenance', role: 'lineage ledger — ทุก claim ชี้ source:: ได้ (ingest-log)' },
-    { dir: 'Shared/Archive', role: 'cold storage — โน้ตที่ stale/retired ออกจาก retrieval (ไม่ลบ)' },
+    // ── Core (MVV) ──
+    { dir: 'Projects', role: 'workspace ของงานจริง — 1 โฟลเดอร์ = 1 โปรเจค', put: 'deliverable + overview/context/current-state ของ project', avoid: 'ความรู้ทั่วไป (→Learning) · log งาน (→Sessions)' },
+    { dir: 'Sessions', role: 'flat chronological log ของงาน (YYYY-MM-DD-<topic>.md)', put: 'session log 7 หัวข้อ + checkpoint', avoid: 'code/config · subfolder (Sessions = flat เสมอ)' },
+    { dir: 'Intake', role: 'จุดรับของใหม่เข้า vault ก่อนกระจายเข้าปลายทาง', put: 'task framing + raw input ที่รอจัด', avoid: 'durable knowledge (จัดเข้าปลายทางก่อน)' },
+    { dir: 'Intake/_Quarantine', role: 'external content (web/paste) ที่ยัง untrusted', put: 'web clip/paste/email ก่อน scan injection (ดู Runbooks/ingest-quarantine)', avoid: 'content ที่ scan ผ่านแล้ว (→Raw Sources)' },
+    { dir: 'Intake/Raw Sources', role: 'ต้นฉบับ external ที่ผ่าน scan แล้ว — immutable read-only', put: 'original หลัง scan · source:: ชี้มาที่นี่ได้', avoid: 'โน้ตที่ derived/สรุปแล้ว' },
+    { dir: 'Skills', role: 'reusable unit ที่ executable + ผ่าน verification command', put: 'script/command ที่รัน test ผ่าน (ดู Shared/Rules/skills-admission)', avoid: 'prose how-to (→Runbooks) · unverified (→Memory-Inbox)' },
+    { dir: 'Runbooks', role: 'prose how-to ที่อ่านแล้วทำตามเอง', put: 'ขั้นตอน setup/deploy/maintain + loop driver', avoid: 'runnable unit (→Skills)' },
+    { dir: 'Templates', role: 'แม่แบบโน้ต — instantiate จากที่นี่', put: 'template ไว้ instantiate (session/bug/handoff/project)', avoid: 'โน้ตจริง' },
+    { dir: 'Bugs', role: 'bug report reproducible ลงวันที่ ไม่ลบ', put: 'bug report (global flat) + link กลับ project · system/OS → Bugs/System-OS/', avoid: 'bug ที่ reproduce ไม่ได้' },
+    { dir: 'Bugs/System-OS', role: 'bug report ระดับระบบ/OS/toolchain ที่ไม่ผูกกับ project เดียว', put: 'OS, shell, package manager, permission, filesystem, or app-runtime bugs', avoid: 'bug ของ project เฉพาะ (→Bugs หรือ Projects/<proj>/Bugs)' },
+    { dir: 'Handoffs', role: 'เอกสารส่งมอบงานค้าง 1 ชิ้น (snapshot)', put: 'state + next steps ส่งต่อ agent/session', avoid: 'live coordination (→Shared/Coordination)' },
+    // ── Direction ──
+    { dir: 'Goals', role: 'north-star + objective รายไตรมาส/ปี (finite, มีวันจบ)', put: 'objective + track progress', avoid: 'live status (→Operating-State) · โดเมนต่อเนื่อง (→Areas)' },
+    { dir: 'Areas', role: 'PARA — โดเมนงานต่อเนื่องที่ไม่มีวันจบ', put: 'brand/trading/content/products ฯลฯ', avoid: 'งานที่มีวันจบ (→Projects/Goals)' },
+    // ── Knowledge pipeline ──
+    { dir: 'Research', role: 'finding ที่อิงแหล่งภายนอก (มี source::)', put: 'สรุปอิงแหล่ง + market scan + citation', avoid: 'ความรู้ที่กลั่นเอง (→Learning)' },
+    { dir: 'Learning', role: 'knowledge ที่ตัวเองกลั่น/deep-dive ตาม topic', put: 'topic MOC ที่ไม่มี external source', avoid: 'finding อิงแหล่ง (→Research)' },
+    { dir: 'Distillations', role: 'หลักการ evergreen ที่กลั่นนิ่งแล้ว (≥3 ครั้ง) — atomic', put: 'principle ที่ reusable + นิ่งแล้ว', avoid: 'สิ่งที่ยังปรับเปลี่ยน (→Playbooks)' },
+    { dir: 'Retrospectives', role: 'reflection หลังงาน (event-triggered)', put: 'what worked/failed หลังงานเสร็จ', avoid: 'review ตามรอบเวลา (→Reviews)' },
+    { dir: 'Reviews', role: 'review ตาม cadence (time-triggered)', put: 'weekly/monthly + vault health + consolidation trace', avoid: 'reflection รายงาน (→Retrospectives)' },
+    { dir: 'Traces', role: 'exploration/reasoning chain ยาว', put: 'การสืบสวนหลายขั้น (คำถามใหญ่เกินโน้ตเดียว)', avoid: 'คำตอบสั้น (→โน้ตปกติ)' },
+    { dir: 'Prompts', role: 'prompt text/template ที่หยิบมารันได้ทันที', put: 'prompt/execution standard ต่อ task-family', avoid: 'fixtures (→Acceptance) · tactic (→Playbooks)' },
+    { dir: 'Acceptance', role: 'golden input→expected-output fixtures', put: 'case ที่ใช้ตัดสิน done/not-done', avoid: 'gate ticklist (→Checklists) · runner (→Evals)' },
+    { dir: 'Checklists', role: 'preflight/postflight gate (ticklist)', put: 'ticklist ก่อน-หลังลงมือ ต่อ task-family', avoid: 'expected output (→Acceptance)' },
+    // ── Frontier loops (self-improving) ──
+    { dir: 'Playbooks', role: 'กลยุทธ์/ลำดับการตัดสินใจที่ปรับดีขึ้นจากผลจริง (ACE)', put: 'tactic/heuristic ที่ดีขึ้นจากผล (counter [H/W])', avoid: 'prompt text (→Prompts) · runnable (→Skills)' },
+    { dir: 'Evals', role: 'quality loop (runner + ผล) — error-analysis + self-eval', put: 'failure-taxonomy/self-eval-rubric/golden-set/correction-pairs/quality-ledger', avoid: 'golden case เอง (→Acceptance)' },
+    { dir: 'Entities', role: 'canonical page ต่อ entity/person/org/concept (LLM-wiki, bi-temporal)', put: 'หน้า canonical ของ entity ที่เจอ ≥2 sessions', avoid: 'event log (→Sessions)' },
+    // ── Shared (สมองกลาง) — Shared/_Index เองชี้ Home ──
+    { dir: 'Shared', role: 'สมองกลาง: memory + rules + coordination', put: 'เข้าผ่าน AI-Context-Index', avoid: 'โน้ตงานทั่วไป' },
+    { dir: 'Shared/Operating-State', role: 'live status/metrics ตอนนี้', put: 'current-state + health/queue + workbench', avoid: 'objective (→Goals)' },
+    { dir: 'Shared/User-Memory', role: 'สิ่งที่ AI เรียนรู้เกี่ยวกับเจ้าของ (mutable)', put: 'preference/response-example/signal', avoid: 'identity static (→User-Persona)' },
+    { dir: 'Shared/Decision-Memory', role: 'การตัดสินใจที่ AI บันทึก (latest-wins + supersedes)', put: 'decision locked + เหตุผล', avoid: 'ground truth คน (→Core-Facts)' },
+    { dir: 'Shared/Memory-Inbox', role: 'candidate durable memory ที่ยังไม่ชัด/ขัดกัน', put: 'observation รอ promote (เคลียร์ทุก weekly)', avoid: 'durable ที่ชัดแล้ว (→ปลายทาง)' },
+    { dir: 'Shared/Rules', role: 'กฎ operating always-on', put: 'memory-write-protocol/frontmatter/context-assembly/formatting/staleness', avoid: 'how-to ทำงาน (→Runbooks)' },
+    { dir: 'Shared/Tech-Standards', role: 'มาตรฐานเทคนิคกลาง', put: 'MCP/stack/DoD/verification rulebook', avoid: 'กฎ memory/format (→Rules)' },
+    { dir: 'Shared/Core-Facts', role: 'ground truth ที่เจ้าของเขียนเอง (read-only, invariant)', put: 'protected-facts ที่ AI ห้ามแก้/supersede', avoid: 'decision ที่ AI ตัด (→Decision-Memory)' },
+    { dir: 'Shared/Coordination', role: 'live coordination ของหลาย agent พร้อมกัน', put: 'NOW.md baton + task-board + agent-registry', avoid: 'เอกสารส่งมอบครั้งเดียว (→Handoffs)' },
+    { dir: 'Shared/Coordination/task-board', role: 'file-Kanban task cards สำหรับ multi-agent coordination', put: 'task file ต่อชิ้นงาน มี claimed_by/status/frontmatter', avoid: 'session narrative (→Sessions) · handoff snapshot (→Handoffs)' },
+    { dir: 'Shared/Working-Memory', role: 'scratchpad ระหว่าง 1 task (ลบทิ้งได้)', put: 'ของชั่วคราวระหว่างทำงาน', avoid: 'อะไรที่จะเก็บ (→Memory-Inbox)' },
+    { dir: 'Shared/User-Persona', role: 'identity profile ที่เปลี่ยนน้อยมาก (human-owned)', put: 'บทบาท/ค่านิยม/ภาษา/timezone (read-only)', avoid: 'สิ่งที่ AI เรียนรู้ (→User-Memory)' },
+    { dir: 'Shared/Provenance', role: 'lineage ledger — ทุก claim ชี้ source:: ได้', put: 'บรรทัด ingest ต่อแหล่ง (ingest-log)', avoid: 'โน้ต derived (ใส่ source:: แทน)' },
+    { dir: 'Shared/Archive', role: 'cold storage (ไม่ลบ)', put: 'โน้ต stale/retired ที่ออกจาก retrieval', avoid: 'ของที่ยังใช้' },
+    { dir: 'Shared/Scripts', role: 'automation maintenance (lint/graph audit/metrics)', put: 'สคริปต์ maintenance ที่รันจริง', avoid: 'one-off ที่ retired (→Scripts-Archive)' },
+    { dir: 'Shared/Scripts-Archive', role: 'สคริปต์ one-off ที่ retired', put: 'script เก่าเก็บเป็นประวัติ', avoid: 'script ที่ยังใช้ (→Scripts)' },
+    { dir: 'Shared/mcp-servers', role: 'vendored local MCP server bundle (code/README)', put: 'โค้ด/README ของ MCP server (config อยู่ Tech-Standards)', avoid: 'config การต่อ (→Tech-Standards/mcp.json)' },
+    { dir: 'Shared/Context-Packs', role: 'full-context bundle ต่อ domain/task-type', put: 'pack รวม context พร้อมโหลด', avoid: 'โน้ตเดี่ยว (→ปลายทางปกติ)' },
+    { dir: 'Shared/Context7-Docs', role: 'cached external lib doc (regenerable — gitignore)', put: 'cache ของ context7/lib doc', avoid: 'durable knowledge (→Learning/Research)' },
+    { dir: 'Shared/AI-Threads', role: 'saved AI reasoning/conversation trail (ไม่ใช่ source of truth)', put: 'thread ที่เก็บไว้ review/resume/promote', avoid: 'durable decision (promote → Decision-Memory)' },
+    { dir: 'Shared/Prompting', role: 'prompt-engineering pattern (style/structure)', put: 'pattern การเขียน prompt ที่ reuse', avoid: 'prompt asset ต่อ task (→Prompts)' },
+    { dir: 'Shared/Glossary', role: 'vocabulary กลาง (routes ไป category pages)', put: 'term + นิยาม กลาง', avoid: 'entity page (→Entities)' },
+    { dir: 'Shared/Assets', role: 'รูป/logo/binary ของ vault', put: 'image/logo/asset', avoid: 'โน้ต .md' },
+    // ── AI agent config / vendor exports ──
+    { dir: '.agents', role: 'agent-specific assets (skills/workflows) ของ vault นี้', put: 'skill + workflow guide ที่ agent ใช้', avoid: 'โน้ตงาน (→ปลายทางปกติ)' },
+    { dir: '.agents/skills', role: 'skill folders (SKILL.md) ที่ agent โหลด on-demand', put: 'SKILL.md ต่อ skill', avoid: 'prose how-to (→Runbooks)' },
+    { dir: '.agents/workflows', role: 'workflow guide (multi-step orchestration)', put: 'workflow ที่ทำซ้ำได้', avoid: 'one-off task' },
+    { dir: 'copilot', role: 'vendor export (conversation/custom-prompt/memory snapshot) — review/promote, ไม่ใช่ source of truth', put: 'export จาก Copilot ที่เก็บใน-vault', avoid: 'durable (promote เข้า durable layer)' },
+    // ── Optional / machine-local ที่ยังเกี่ยวกับ coding workflow ──
+    { dir: 'Tools', role: 'utility/tooling เฉพาะเครื่องหรือเฉพาะ vault', put: 'local helper, binary wrapper, one-off utility ที่ยังใช้อยู่', avoid: 'durable knowledge (→Learning/Runbooks) · verified executable skill (→Skills)' },
 ];
 /** แทน {{KEY}} ด้วยค่าจริงจาก config */
 export function substitute(text, cfg) {
@@ -82,11 +96,12 @@ export function substitute(text, cfg) {
     };
     return text.replace(/\{\{(\w+)\}\}/g, (whole, key) => (key in map ? map[key] : whole));
 }
-/** generate _Index.md ของโฟลเดอร์ — frontmatter + role + up:: (ตาม §18 / §B.3 rule 2-3) */
-function renderIndex(dir, role, cfg) {
-    const name = dir.split('/').pop() ?? dir;
+/** generate _Index.md ของโฟลเดอร์ — frontmatter + role + ใส่อะไร/ไม่ใส่อะไร + up:: (ตาม §18 / §B.3 rule 2-3) */
+function renderIndex(f, cfg) {
+    const name = f.dir.split('/').pop() ?? f.dir;
     // parent = _Index ของโฟลเดอร์แม่ (nested) หรือ Home (top-level)
-    const parent = dir.includes('/') ? `${dir.split('/').slice(0, -1).join('/')}/_Index` : 'Home';
+    const parent = f.dir.includes('/') ? `${f.dir.split('/').slice(0, -1).join('/')}/_Index` : 'Home';
+    const selfIndex = `${f.dir}/_Index`;
     const tag = name.toLowerCase().replace(/[^a-z0-9]+/g, '-');
     return `---
 tags: [index, moc, ${tag}]
@@ -98,7 +113,22 @@ parent: "[[${parent}]]"
 
 # ${name}
 
-> ${role}
+> ${f.role}
+
+## ใส่ที่นี่
+${f.put ?? '_(ดู role ด้านบน)_'}
+
+## ไม่ใส่ที่นี่
+${f.avoid ?? '_(—)_'}
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง \`parent: "[[${selfIndex}]]"\` และท้ายไฟล์ \`up:: [[${selfIndex}]]\`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
 
 _(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
 
@@ -146,13 +176,15 @@ async function walk(dir, base = dir) {
 export async function scaffoldBrain(targetPath, cfg) {
     const created = [];
     const skipped = [];
-    // 1) folders + generated _Index
-    for (const { dir, role } of FOLDERS) {
-        await mkdir(join(targetPath, dir), { recursive: true });
-        await writeIfMissing(join(targetPath, dir, '_Index.md'), renderIndex(dir, role, cfg), created, skipped);
+    // 1) folders + generated _Index (role + ใส่อะไร/ไม่ใส่อะไร)
+    for (const f of FOLDERS) {
+        await mkdir(join(targetPath, f.dir), { recursive: true });
+        await writeIfMissing(join(targetPath, f.dir, '_Index.md'), renderIndex(f, cfg), created, skipped);
     }
     // 2) rich seed files (substitute placeholders)
     for (const rel of await walk(TEMPLATE_DIR)) {
+        if (rel.split('/').pop() === '_Index.md')
+            continue; // generated จาก FOLDERS[] แล้ว ไม่ copy ซ้ำจาก template source
         const raw = await readFile(join(TEMPLATE_DIR, rel), 'utf8');
         await writeIfMissing(join(targetPath, rel), substitute(raw, cfg), created, skipped);
     }
@@ -165,7 +197,7 @@ export async function scaffoldBrain(targetPath, cfg) {
  * → agent อ่าน/เขียน vault ที่เพิ่ง scaffold ได้ทันที (ไม่ต้อง hand-author mcp.json)
  */
 export async function wireBrainMcp(vaultPath) {
-    const mcpPath = join(homedir(), '.sanook', 'mcp.json');
+    const mcpPath = appHomePath('mcp.json');
     let cfg = {};
     try {
         cfg = JSON.parse(await readFile(mcpPath, 'utf8'));
@@ -181,6 +213,7 @@ export async function wireBrainMcp(vaultPath) {
         args: ['-y', '@modelcontextprotocol/server-filesystem', vaultPath],
     };
     await mkdir(dirname(mcpPath), { recursive: true });
-    await writeFile(mcpPath, `${JSON.stringify(cfg, null, 2)}\n`);
+    await writeFile(mcpPath, `${JSON.stringify(cfg, null, 2)}\n`, { mode: 0o600 });
+    await chmod(mcpPath, 0o600).catch(() => { });
     return 'added';
 }

package/dist/brand.js

@@ -0,0 +1,47 @@
+import { homedir, tmpdir } from 'node:os';
+import { join } from 'node:path';
+export const BRAND = {
+    productName: 'Sanook',
+    agentName: 'Sanook',
+    cliName: 'sanook',
+    configDirName: '.sanook',
+    memoryFileName: 'SANOOK.md',
+    modelEnvVar: 'SANOOK_MODEL',
+    gatewayServiceName: 'sanook-gateway',
+    mcpClientName: 'sanook',
+    autoMemoryTitle: 'Sanook Auto-Memory',
+    undoStashMessage: 'sanook /undo',
+    bannerWide: 'Sanook AI',
+    bannerNarrow: 'Sanook',
+    bannerTitle: 'Sanook AI CLI',
+    skillTempPrefix: 'sanook-skill-',
+    evalTempPrefix: 'sanook-eval-',
+};
+export const BRAND_ENV = {
+    allowOutsideWorkspace: 'SANOOK_ALLOW_OUTSIDE_WORKSPACE',
+    gatewayAllowWrite: 'SANOOK_GATEWAY_ALLOW_WRITE',
+    hooksInheritEnv: 'SANOOK_HOOKS_INHERIT_ENV',
+    disablePersistence: 'SANOOK_DISABLE_PERSISTENCE',
+    disableUpdateCheck: 'SANOOK_DISABLE_UPDATE_CHECK',
+    disableWorklog: 'SANOOK_DISABLE_WORKLOG',
+    trustProject: 'SANOOK_TRUST_PROJECT',
+};
+export function appHomePath(...parts) {
+    return join(homedir(), BRAND.configDirName, ...parts);
+}
+export function appProjectPath(cwd, ...parts) {
+    return join(cwd, BRAND.configDirName, ...parts);
+}
+export function appTempPath(name) {
+    return join(tmpdir(), name);
+}
+export function envFlag(name) {
+    const v = process.env[name];
+    return v === '1' || v?.toLowerCase() === 'true' || v?.toLowerCase() === 'yes';
+}
+export function persistenceEnabled() {
+    return !envFlag(BRAND_ENV.disablePersistence);
+}
+export function worklogEnabled() {
+    return !envFlag(BRAND_ENV.disableWorklog);
+}

package/dist/checkpoint.js

@@ -0,0 +1,37 @@
+import { runGit, isGitRepo } from './git.js';
+/** snapshot working tree แบบไม่แตะอะไร (git stash create) — คืน ref หรือ null ถ้าไม่ใช่ git repo */
+export async function snapshotWorkTree(cwd = process.cwd()) {
+    if (!(await isGitRepo(cwd)))
+        return null;
+    try {
+        const sha = (await runGit(['stash', 'create'], cwd)).trim();
+        if (sha)
+            return sha;
+        // working tree clean → pin HEAD SHA จริง (ถ้าใช้ 'HEAD' lazy แล้ว HEAD ขยับ เช่นมี commit ระหว่างนั้น = restore ผิด)
+        const head = (await runGit(['rev-parse', 'HEAD'], cwd)).trim();
+        return head || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** restore tracked files กลับสู่ snapshot — stash ของปัจจุบันก่อน (recoverable) */
+export async function restoreWorkTree(ref, cwd = process.cwd()) {
+    if (!(await isGitRepo(cwd)))
+        return { ok: false, reason: 'ไม่ใช่ git repo' };
+    try {
+        // safety: เก็บสถานะปัจจุบันเข้า stash ก่อน (กู้คืนได้ด้วย git stash pop)
+        const current = (await runGit(['stash', 'create'], cwd)).trim();
+        let recovery;
+        if (current) {
+            await runGit(['stash', 'store', '-m', 'sanook /rewind backup', current], cwd);
+            recovery = 'git stash pop';
+        }
+        // restore: ให้ index + worktree ตรงกับ snapshot (ลบ tracked files ที่ถูกเพิ่มหลัง snapshot ด้วย)
+        await runGit(['restore', `--source=${ref}`, '--staged', '--worktree', '.'], cwd);
+        return { ok: true, recovery };
+    }
+    catch (e) {
+        return { ok: false, reason: e.message };
+    }
+}

package/dist/commands.js

@@ -1,19 +1,46 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
 import { PROVIDERS, parseSpec } from './providers/registry.js';
+import { appHomePath, BRAND } from './brand.js';
+import { parseFrontmatter } from './skills.js';
+import { projectConfigPathIfTrusted } from './trust.js';
 const HELP_TEXT = `คำสั่ง:
   /help            แสดงคำสั่งทั้งหมด
   /model [spec]    ดู/เปลี่ยน model (เช่น /model opus, /model openai:gpt-5)
   /tools           ดู tools ที่ agent ใช้ได้
-  /skills          ดูจำนวน skills (จัดการ: sanook skill list)
+  /skills          ดูจำนวน skills (จัดการ: ${BRAND.cliName} skill list)
+  /diff            ดู git diff (สิ่งที่ agent แก้ในรอบนี้)
+  /undo            stash การแก้ไฟล์ล่าสุด (กู้คืนด้วย git stash pop)
+  /rewind          ย้อนกลับ 1 turn (คืนไฟล์ git + ตัดบทสนทนา, recoverable)
   /cost            ดู token + cost รอบล่าสุด
+  ↑/↓ ประวัติ · @ไฟล์ แนบ context/รูป · \\ ลงท้าย = บรรทัดใหม่
   /clear           ล้าง conversation (เริ่มใหม่)
-  /compact         บีบ context
-  /quit            ออก`;
+  /compact         บีบ context (truncate · หรือ summarize ถ้าตั้ง compaction)
+  /quit            ออก
+
+นอก REPL (พิมพ์ใน shell):
+  ${BRAND.cliName} search "<q>" · index · brain init · serve · mcp serve · config set <k> <v>
+  ดูทั้งหมด: ${BRAND.cliName} --help
+
+custom commands:
+  ~/.sanook/commands/<name>.md และ .sanook/commands/<name>.md (project ต้อง trust ก่อน)`;
 const TOOLS_LIST = [
-    'read_file write_file edit_file list_dir glob grep run_bash',
+    'read_file (offset/limit) write_file edit_file (replace_all) list_dir glob grep run_bash',
     'git_status git_diff git_log git_commit',
     'remember recall · skill find_skills create_skill',
-    'schedule_task list_scheduled cancel_scheduled · task',
+    'schedule_task list_scheduled cancel_scheduled',
+    'task task_parallel task_spawn task_collect task_cancel task_status   ← sub-agent (ขนาน/background)',
+    'diagnostics   ← type error/lint จาก language server (LSP)',
 ].join('\n  ');
+export function parseSlashInvocation(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith('/'))
+        return null;
+    const match = /^\/(\S+)(?:\s+([\s\S]*))?$/.exec(trimmed);
+    if (!match)
+        return null;
+    return { name: match[1].toLowerCase(), args: match[2] ?? '' };
+}
 /** /model (ไม่มี arg) — โชว์ model ปัจจุบัน + ตัวเลือกของ provider นั้น (alias จาก registry) */
 function modelMenu(current) {
     const { provider } = parseSpec(current);
@@ -57,10 +84,63 @@ export function parseCommand(input, ctx) {
         case 'tools':
             return { handled: true, message: `tools ที่ agent ใช้ได้ (+ MCP ที่ตั้งไว้):\n  ${TOOLS_LIST}` };
         case 'skills':
-            return { handled: true, message: 'skills โหลดจาก built-in + ~/.sanook/skills — จัดการด้วย "sanook skill list/add/remove"' };
+            return { handled: true, message: `skills โหลดจาก built-in + ${appHomePath('skills')} — จัดการด้วย "${BRAND.cliName} skill list/add/remove"` };
+        case 'diff':
+            return { handled: true, action: 'diff' };
+        case 'undo':
+            return { handled: true, action: 'undo' };
         case 'cost':
             return { handled: true, message: ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)' };
         default:
             return { handled: true, message: `ไม่รู้จักคำสั่ง /${cmd} — พิมพ์ /help` };
     }
 }
+// ── custom slash commands: .sanook/commands/<name>.md → /<name> ──────────────
+// ไฟล์ markdown (frontmatter optional) = prompt template ที่ส่งเข้า agent. $ARGUMENTS = ส่วนหลังชื่อคำสั่ง
+// (เลียน Claude Code .claude/commands) — global ~/.sanook/commands + project .sanook/commands (project ทับ)
+export const BUILTIN_COMMANDS = new Set([
+    'help', '?', 'clear', 'compact', 'quit', 'exit', 'model', 'tools', 'skills', 'diff', 'undo', 'rewind', 'cost',
+]);
+function isValidCommandName(name) {
+    return /^[a-z0-9][a-z0-9-]{0,40}$/.test(name);
+}
+/** scan custom commands จาก global + project (project override). ข้าม built-in ชื่อซ้ำ */
+export async function loadCustomCommands(cwd = process.cwd()) {
+    const out = new Map();
+    const dirs = [appHomePath('commands')];
+    const projectCommands = await projectConfigPathIfTrusted('commands', cwd);
+    if (projectCommands)
+        dirs.push(projectCommands);
+    for (const dir of dirs) {
+        let files;
+        try {
+            files = await readdir(dir);
+        }
+        catch {
+            continue; // ไม่มีโฟลเดอร์ = ข้าม
+        }
+        for (const f of files) {
+            if (!f.endsWith('.md'))
+                continue;
+            const name = f.slice(0, -3).toLowerCase();
+            if (!isValidCommandName(name) || BUILTIN_COMMANDS.has(name))
+                continue;
+            try {
+                const { meta, body } = parseFrontmatter(await readFile(join(dir, f), 'utf8'));
+                out.set(name, { name, description: meta.description ?? '', body: body.trim() });
+            }
+            catch {
+                // อ่านไม่ได้ = ข้าม
+            }
+        }
+    }
+    return out;
+}
+/** แทน $ARGUMENTS / {{args}} ด้วย args; ถ้า template ไม่มี placeholder ก็ append args ต่อท้าย */
+export function expandCustomCommand(cmd, args) {
+    const a = args.trim();
+    if (/\$ARGUMENTS|\{\{\s*args\s*\}\}/.test(cmd.body)) {
+        return cmd.body.replace(/\$ARGUMENTS|\{\{\s*args\s*\}\}/g, a);
+    }
+    return a ? `${cmd.body}\n\n${a}` : cmd.body;
+}

package/dist/compaction.js

@@ -67,11 +67,16 @@ export function estimateTokens(messages) {
 export function autoCompact(messages, tokenLimit, keepRecent = 20) {
     if (estimateTokens(messages) <= tokenLimit)
         return messages;
-    const pruned = pruneToolResults(messages, 2);
-    if (estimateTokens(pruned) <= tokenLimit)
-        return pruned;
+    // เก็บ system message ที่นำหน้า (cached preamble: SYSTEM/skills/brain/git) ไว้เสมอ — ห้ามตัดทิ้ง
+    const firstNon = messages.findIndex((m) => m.role !== 'system');
+    const lead = firstNon > 0 ? messages.slice(0, firstNon) : [];
+    const body = lead.length ? messages.slice(lead.length) : messages;
+    const withLead = (rest) => (lead.length ? [...lead, ...rest] : rest);
+    const pruned = pruneToolResults(body, 2);
+    if (estimateTokens(withLead(pruned)) <= tokenLimit)
+        return withLead(pruned);
     if (pruned.length <= keepRecent + 1)
-        return pruned;
+        return withLead(pruned);
     const firstUser = pruned.find((m) => m.role === 'user');
     let recent = pruned.slice(-keepRecent);
     // ตัด tool message ที่ค้างหัว — tool-result ที่ tool-call ถูกตัดไปแล้ว = orphan → API reject
@@ -81,5 +86,71 @@ export function autoCompact(messages, tokenLimit, keepRecent = 20) {
         role: 'user',
         content: '[บทสนทนาเก่าถูกตัดออกเพื่อประหยัด context — รายละเอียดดูได้จาก memory/session]',
     };
-    return firstUser && !recent.includes(firstUser) ? [firstUser, marker, ...recent] : [marker, ...recent];
+    const tail = firstUser && !recent.includes(firstUser) ? [firstUser, marker, ...recent] : [marker, ...recent];
+    return withLead(tail);
+}
+/** flatten messages → readable transcript (สำหรับให้ model ย่อ) — ตัด tool-result ยาวกัน prompt บวม */
+export function messagesToText(messages) {
+    const out = [];
+    for (const m of messages) {
+        if (typeof m.content === 'string') {
+            if (m.content.trim())
+                out.push(`${m.role}: ${m.content}`);
+        }
+        else if (Array.isArray(m.content)) {
+            for (const part of m.content) {
+                if (typeof part.text === 'string' && part.text.trim())
+                    out.push(`${m.role}: ${part.text}`);
+                else if (part.type === 'tool-call')
+                    out.push(`${m.role}: [call ${String(part.toolName ?? 'tool')}]`);
+                else if (part.type === 'tool-result' &&
+                    part.output?.type === 'text' &&
+                    typeof part.output.value === 'string') {
+                    out.push(`tool: ${truncateText(part.output.value)}`);
+                }
+            }
+        }
+    }
+    return out.join('\n');
+}
+/**
+ * compaction แบบ "ย่อ" (quality สูงกว่า truncate): เก็บ system lead + user แรก (intent) + N message ล่าสุด,
+ * ส่วนกลางถูก "ย่อ" ด้วย summarize() (cheap model) แทนการตัดทิ้ง → จำ context ได้ดีกว่าที่ budget เท่าเดิม.
+ * pure orchestration (inject summarize) → test ได้โดยไม่ต้องมี LLM. summarize ล้มเหลว → fallback autoCompact.
+ */
+export async function summarizeCompact(messages, tokenLimit, summarize, keepRecent = 20) {
+    if (estimateTokens(messages) <= tokenLimit)
+        return messages;
+    const firstNon = messages.findIndex((m) => m.role !== 'system');
+    const lead = firstNon > 0 ? messages.slice(0, firstNon) : [];
+    const body = lead.length ? messages.slice(lead.length) : messages;
+    const withLead = (rest) => (lead.length ? [...lead, ...rest] : rest);
+    const pruned = pruneToolResults(body, 2);
+    if (estimateTokens(withLead(pruned)) <= tokenLimit)
+        return withLead(pruned);
+    if (pruned.length <= keepRecent + 1)
+        return withLead(pruned);
+    const firstUser = pruned.find((m) => m.role === 'user');
+    let recent = pruned.slice(-keepRecent);
+    while (recent.length && recent[0].role === 'tool')
+        recent = recent.slice(1); // กัน orphan tool-result หัว window
+    const recentSet = new Set(recent);
+    const middle = pruned.filter((m) => m !== firstUser && !recentSet.has(m));
+    if (!middle.length)
+        return withLead(firstUser ? [firstUser, ...recent] : recent);
+    let summary;
+    try {
+        summary = (await summarize(messagesToText(middle))).trim();
+    }
+    catch {
+        return autoCompact(messages, tokenLimit, keepRecent); // ย่อไม่ได้ → กลับไป truncate (ไม่บล็อกงาน)
+    }
+    if (!summary)
+        return autoCompact(messages, tokenLimit, keepRecent);
+    const summaryMsg = {
+        role: 'user',
+        content: `[สรุปบทสนทนาก่อนหน้า (ย่อเพื่อประหยัด context)]\n${summary}`,
+    };
+    const tail = firstUser ? [firstUser, summaryMsg, ...recent] : [summaryMsg, ...recent];
+    return withLead(tail);
 }