sanook-cli 0.4.0

package/dist/bin.js

@@ -0,0 +1,461 @@
+#!/usr/bin/env node
+import { runAgent } from './loop.js';
+import { redactKey } from './providers/keys.js';
+import { loadConfig, isFirstRun, loadKeysIntoEnv } from './config.js';
+import { saveSession, latestSession, newSessionId } from './session.js';
+import { closeMcp } from './mcp.js';
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+function parseArgs(argv) {
+    let model;
+    let budget;
+    let json = false;
+    let planMode = false;
+    let yes = false;
+    const rest = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--model' || a === '-m')
+            model = argv[++i];
+        else if (a === '--budget' || a === '-b')
+            budget = Number.parseFloat(argv[++i] ?? '');
+        else if (a === '--json')
+            json = true;
+        else if (a === '--plan')
+            planMode = true;
+        else if (a === '--yes' || a === '-y')
+            yes = true;
+        else if (a === '-p' || a === '--print' || a === '-c' || a === '--continue') {
+            /* -p headless flag · -c/--continue resume (handled in main) */
+        }
+        else
+            rest.push(a);
+    }
+    return { model, budget, json, prompt: rest.join(' ').trim(), planMode, yes };
+}
+async function runHeadless(model, prompt, budgetUsd, maxSteps, json, history, planMode = false, permissionMode = 'auto') {
+    const controller = new AbortController();
+    process.on('SIGINT', () => {
+        controller.abort();
+        process.exit(130);
+    });
+    try {
+        const { cost, messages } = await runAgent({
+            model,
+            prompt,
+            history,
+            budgetUsd,
+            maxSteps,
+            planMode,
+            permissionMode, // headless ไม่มี approve → ask-mode = ปฏิเสธ mutate (ต้อง --yes)
+            signal: controller.signal,
+            onEvent: (e) => {
+                if (json) {
+                    process.stdout.write(`${JSON.stringify(e)}\n`);
+                    return;
+                }
+                if (e.type === 'text')
+                    process.stdout.write(e.text ?? '');
+                else if (e.type === 'tool-call')
+                    process.stdout.write(`\n${DIM}→ ${e.tool}${RESET}\n`);
+            },
+        });
+        if (!json)
+            process.stdout.write(`\n${DIM}${cost.summary()}${RESET}\n`);
+        // จำ session ไว้ทำงานต่อได้ (sanook --continue "...") — แก้ concern AI ลืมว่าทำถึงไหน
+        const now = new Date().toISOString();
+        await saveSession({ id: newSessionId(), created: now, updated: now, model, cwd: process.cwd(), messages });
+    }
+    catch (err) {
+        const msg = redactKey(err.message);
+        if (json)
+            process.stdout.write(`${JSON.stringify({ type: 'error', message: msg })}\n`);
+        else
+            console.error(`\nERROR: ${msg}`);
+        process.exit(1);
+    }
+}
+// อ่านจาก package.json (single source of truth) — กัน version constant drift
+const VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+const HELP = `Sanook — a terminal AI coding agent (BYOK)
+
+usage:
+  sanook "<task>"            run one task (headless)
+  sanook                     interactive REPL
+  sanook --json "<task>"     headless, JSONL output (for CI/scripts)
+
+gateway (อยู่ยาว 24/7 — HTTP loopback + cron):
+  sanook serve [--port 8787]            เปิด gateway (OpenAI-compat /v1/chat/completions + scheduler)
+  sanook cron add "<when>" "<task>"     ตั้งงานล่วงหน้า (when: "every 30m" | "09:00" | ISO | now)
+  sanook cron list                      ดู task ทั้งหมด
+  sanook cron rm <id>                   ลบ task
+
+skills (69 built-in + ติดตั้งเพิ่มได้):
+  sanook skill list                     ดู skill ทั้งหมด
+  sanook skill add <user/repo|url|path> ติดตั้ง skill จาก GitHub / URL / local
+  sanook skill remove <name>            ลบ skill ที่ติดตั้ง
+  sanook models [provider]              ดู/verify model id (เทียบ provider จริงถ้ามี key)
+
+second brain (Obsidian workspace สำหรับจัดเก็บงาน + ความจำ AI):
+  sanook brain init [path]              สร้างโครงสร้าง second-brain ที่ path (ไม่ใส่ = ถาม)
+
+config & mcp:
+  sanook config [get|set <k> <v>]       ดู/แก้ ~/.sanook/config.json (model/budgetUsd/permissionMode)
+  sanook mcp [list|add <name> <cmd> …|remove <name>]   จัดการ MCP servers
+
+flags:
+  -m, --model <spec>   sonnet/opus/haiku/fable · gpt/codex · gemini · grok · deepseek · mistral · groq · ollama/lmstudio
+                       or "provider:model-id" (e.g. openai:gpt-5-codex, groq:fast, google:gemini-2.5-flash)
+  -b, --budget <usd>   stop when estimated cost exceeds this
+  -c, --continue       resume the latest session (จำว่าทำถึงไหน → ทำต่อ)
+      --plan           plan mode — สำรวจ+วางแผนเท่านั้น ไม่แก้ไฟล์ (read-only)
+  -y, --yes            อนุมัติ tool อัตโนมัติ (ข้าม ask-mode permission)
+      --json           machine-readable JSONL output
+  -v, --version
+  -h, --help
+
+env (BYOK — direct API key only):
+  ANTHROPIC_API_KEY / GOOGLE_GENERATIVE_AI_API_KEY / OPENAI_API_KEY`;
+/** sanook serve [--port N] [--model spec] — เปิด gateway (HTTP loopback + cron scheduler) อยู่ยาว */
+async function runServe(args) {
+    const portIdx = args.indexOf('--port');
+    const port = portIdx !== -1 ? Number(args[portIdx + 1]) : 8787;
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        console.error(`port ไม่ถูกต้อง: ${args[portIdx + 1]}`);
+        process.exit(1);
+    }
+    const mIdx = args.findIndex((a) => a === '--model' || a === '-m');
+    const config = await loadConfig({ model: mIdx !== -1 ? args[mIdx + 1] : undefined });
+    const { startGateway } = await import('./gateway/serve.js');
+    process.stdout.write(`${DIM}Sanook gateway — model: ${config.model}${RESET}\n`);
+    const stop = await startGateway({
+        port,
+        model: config.model,
+        budgetUsd: config.budgetUsd,
+        onLog: (m) => process.stdout.write(`${DIM}[gateway] ${m}${RESET}\n`),
+    });
+    const shutdown = () => {
+        stop();
+        process.stdout.write('\n[gateway] หยุดแล้ว\n');
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    // server + scheduler interval ถือ event loop ไว้ → process อยู่ยาวจนกด Ctrl-C
+}
+/** sanook cron add "<when>" "<task>" | cron list | cron rm <id> */
+async function runCron(args) {
+    const [action, ...rest] = args;
+    const { listTasks, enqueueTask, removeTask } = await import('./gateway/ledger.js');
+    if (action === 'add') {
+        const schedule = rest[0];
+        const spec = rest.slice(1).join(' ').trim();
+        if (!schedule || !spec) {
+            console.error('ใช้: sanook cron add "<when>" "<task>"   (when: "every 30m" | "09:00" | ISO | now)');
+            console.error('หมายเหตุ: when ที่มีช่องว่างต้องครอบ quote เช่น "every 30m"');
+            process.exit(1);
+        }
+        const { parseSchedule } = await import('./gateway/schedule.js');
+        const sched = parseSchedule(schedule, Date.now());
+        if (!sched) {
+            console.error(`schedule ไม่ถูกต้อง: "${schedule}" — ลอง "every 30m", "09:00", ISO, หรือ "now"`);
+            if (rest.length > 1 && /^(every|\d)/.test(schedule)) {
+                console.error('(ดูเหมือนลืมครอบ quote — when ที่มีช่องว่างต้องเป็น "every 30m" ทั้งก้อน)');
+            }
+            process.exit(1);
+        }
+        const task = await enqueueTask({
+            kind: sched.recurring ? 'cron' : 'once',
+            spec,
+            schedule: sched.recurring ? sched.normalized : undefined,
+            runAt: sched.runAt,
+        });
+        const when = new Date(task.runAt).toLocaleString();
+        console.log(`เพิ่ม task ${task.id} — รัน ${when}${sched.recurring ? ` แล้วทุก ${sched.normalized}` : ''}`);
+        return;
+    }
+    if (action === 'rm' || action === 'remove') {
+        if (!rest[0]) {
+            console.error('ใช้: sanook cron rm <id>');
+            process.exit(1);
+        }
+        const ok = await removeTask(rest[0]);
+        console.log(ok ? `ลบ task ${rest[0]} แล้ว` : `ไม่เจอ task ${rest[0]}`);
+        return;
+    }
+    if (action === 'list' || action === undefined) {
+        const tasks = await listTasks();
+        if (!tasks.length) {
+            console.log('ยังไม่มี task — เพิ่มด้วย: sanook cron add "every 1h" "เช็คข่าว AI"');
+            return;
+        }
+        for (const t of tasks) {
+            const next = new Date(t.runAt).toLocaleString();
+            console.log(`${t.id}  [${t.status}]  ${t.schedule ?? 'once'}  next:${next}  → ${t.spec.slice(0, 50)}`);
+        }
+        return;
+    }
+    console.error(`ไม่รู้จัก: cron ${action} — ใช้ add / list / rm`);
+    process.exit(1);
+}
+/** sanook skill list | add <source> | remove <name> */
+async function runSkill(args) {
+    const [action, ...rest] = args;
+    if (action === 'add') {
+        const source = rest[0];
+        if (!source) {
+            console.error('ใช้: sanook skill add <github "user/repo" | URL ของ SKILL.md | local path>');
+            process.exit(1);
+        }
+        console.error(`${DIM}⚠ skill = instruction ที่ AI จะทำตาม — ติดตั้งจาก source ที่เชื่อถือเท่านั้น${RESET}`);
+        const { installSkill } = await import('./skill-install.js');
+        try {
+            const installed = await installSkill(source, (m) => process.stderr.write(`${DIM}${m}${RESET}\n`));
+            console.log(`ติดตั้ง ${installed.length} skill: ${installed.map((s) => s.name).join(', ')}`);
+        }
+        catch (e) {
+            console.error(`ติดตั้งไม่สำเร็จ: ${redactKey(e.message)}`);
+            process.exit(1);
+        }
+        return;
+    }
+    if (action === 'remove' || action === 'rm') {
+        if (!rest[0]) {
+            console.error('ใช้: sanook skill remove <name>');
+            process.exit(1);
+        }
+        const { removeInstalledSkill } = await import('./skill-install.js');
+        const ok = await removeInstalledSkill(rest[0]);
+        console.log(ok ? `ลบ skill ${rest[0]} แล้ว` : `ไม่เจอ skill ${rest[0]} ที่ติดตั้งไว้ (bundled ลบไม่ได้)`);
+        return;
+    }
+    // list (default)
+    const { loadSkills } = await import('./skills.js');
+    const skills = await loadSkills();
+    console.log(`${skills.length} skills:`);
+    for (const s of skills) {
+        const d = s.description.length > 72 ? `${s.description.slice(0, 72)}…` : s.description;
+        console.log(`  ${s.name}  —  ${d}`);
+    }
+}
+/** sanook models [provider] — ดู models + verify กับ provider จริง (flag id ที่ stale) */
+async function runModels(args) {
+    const { PROVIDERS } = await import('./providers/registry.js');
+    const provider = args[0];
+    if (!provider) {
+        console.log(`providers: ${Object.keys(PROVIDERS).join(' ')}`);
+        console.log('ใช้: sanook models <provider>  (ใส่ API key ใน env เพื่อ verify กับของจริง)');
+        return;
+    }
+    const cfg = PROVIDERS[provider];
+    if (!cfg) {
+        console.error(`ไม่รู้จัก provider "${provider}" — มี: ${Object.keys(PROVIDERS).join(' ')}`);
+        process.exit(1);
+    }
+    console.log(`${cfg.label} — curated (registry):`);
+    for (const [alias, id] of Object.entries(cfg.models))
+        console.log(`  ${alias.padEnd(10)} → ${id}`);
+    if (cfg.kind === 'delegate') {
+        console.log('\n(delegate provider — ไม่มี /models endpoint; ใช้ curated id ด้านบน)');
+        return;
+    }
+    const { resolveKeyFromEnv } = await import('./providers/keys.js');
+    const key = resolveKeyFromEnv(cfg.envVar, cfg.envFallbacks);
+    if (!key && cfg.requiresKey) {
+        console.log(`\n(ใส่ ${cfg.envVar} เพื่อ verify model id กับ provider จริง)`);
+        return;
+    }
+    const { listRemoteModels } = await import('./providers/models.js');
+    const live = await listRemoteModels(cfg, key ?? cfg.localPlaceholderKey);
+    if (!live.length) {
+        console.log('\n(ดึง live models ไม่ได้ — endpoint/key)');
+        return;
+    }
+    console.log(`\nlive (${live.length} จาก provider):`);
+    console.log(`  ${live.slice(0, 30).join('\n  ')}${live.length > 30 ? '\n  …' : ''}`);
+    const liveSet = new Set(live);
+    const stale = [...new Set(Object.values(cfg.models))].filter((id) => !liveSet.has(id));
+    if (stale.length)
+        console.log(`\n⚠ id ใน registry ที่ provider ไม่มีแล้ว (อาจ stale): ${stale.join(', ')}`);
+    else
+        console.log('\n✓ ทุก curated id มีใน provider');
+}
+/** sanook brain init [path] — scaffold second-brain workspace (interactive ถ้าไม่ใส่ path) */
+async function runBrain(args) {
+    if (args[0] !== 'init') {
+        console.log(`ใช้: sanook brain init [path]   สร้างโครงสร้าง second-brain (Obsidian vault)
+  ไม่ใส่ path → wizard ถาม path + ตัวตน
+  -y, --yes  ใช้ค่า default ทั้งหมด (ต้องระบุ path)`);
+        return;
+    }
+    const rest = args.slice(1);
+    const yes = rest.includes('-y') || rest.includes('--yes');
+    const pathArg = rest.find((a) => !a.startsWith('-'));
+    // interactive: ไม่มี path และไม่ --yes → render BrainWizard
+    if (!pathArg && !yes) {
+        const { startBrainSetup } = await import('./ui/render.js');
+        await startBrainSetup();
+        return;
+    }
+    const { scaffoldBrain, BRAIN_DEFAULTS, expandHome, wireBrainMcp } = await import('./brain.js');
+    const target = expandHome(pathArg ?? join(homedir(), 'Documents', BRAIN_DEFAULTS.vaultName));
+    const today = new Date().toISOString().slice(0, 10);
+    try {
+        const res = await scaffoldBrain(target, { ...BRAIN_DEFAULTS, today });
+        const { saveBrainPath } = await import('./config.js');
+        await saveBrainPath(target);
+        const wired = await wireBrainMcp(target).catch(() => 'skip');
+        console.log(`✅ second-brain — ${target}`);
+        console.log(`   สร้าง ${res.created.length} ไฟล์/โฟลเดอร์ · ข้าม ${res.skipped.length} (มีอยู่แล้ว ไม่ทับ)`);
+        console.log(`   ${wired === 'added' ? 'wire filesystem MCP เข้า vault แล้ว' : 'MCP: มี server เดิม (ไม่ทับ)'}`);
+        console.log(`   เปิดใน Obsidian: Open folder as vault → ${target}`);
+    }
+    catch (e) {
+        console.error(`สร้างไม่สำเร็จ: ${e.message}`);
+        process.exit(1);
+    }
+}
+/** อ่าน stdin จนจบ (เมื่อถูก pipe เข้ามา เช่น `git diff | sanook "review"`) */
+async function readStdin() {
+    const chunks = [];
+    for await (const c of process.stdin)
+        chunks.push(c);
+    return Buffer.concat(chunks).toString('utf8');
+}
+/** sanook config [get <k> | set <k> <v>] — ดู/แก้ ~/.sanook/config.json โดยไม่ต้องแก้มือ */
+async function runConfig(args) {
+    const { readGlobalConfigRaw, patchGlobalConfig } = await import('./config.js');
+    const [action, key, ...rest] = args;
+    const ALLOWED = ['model', 'budgetUsd', 'permissionMode', 'brainPath'];
+    if (action === 'set') {
+        if (!key || rest.length === 0) {
+            console.error(`ใช้: sanook config set <key> <value>   (key: ${ALLOWED.join(' | ')})`);
+            process.exit(1);
+        }
+        if (!ALLOWED.includes(key)) {
+            console.error(`ตั้งได้เฉพาะ: ${ALLOWED.join(', ')}`);
+            process.exit(1);
+        }
+        const raw = rest.join(' ');
+        await patchGlobalConfig({ [key]: key === 'budgetUsd' ? Number(raw) : raw });
+        console.log(`ตั้ง ${key} = ${raw}`);
+        return;
+    }
+    if (action === 'get') {
+        const cfg = await readGlobalConfigRaw();
+        console.log(cfg[key] ?? '(ไม่ได้ตั้ง)');
+        return;
+    }
+    console.log(`~/.sanook/config.json:\n${JSON.stringify(await readGlobalConfigRaw(), null, 2)}`);
+}
+/** sanook mcp [list | add <name> <command> [args...] | remove <name>] — จัดการ ~/.sanook/mcp.json */
+async function runMcp(args) {
+    const mcpPath = join(homedir(), '.sanook', 'mcp.json');
+    let cfg = { mcpServers: {} };
+    try {
+        const parsed = JSON.parse(await readFile(mcpPath, 'utf8'));
+        cfg = { mcpServers: parsed.mcpServers ?? {} };
+    }
+    catch {
+        /* ยังไม่มีไฟล์ */
+    }
+    const write = async () => {
+        await mkdir(dirname(mcpPath), { recursive: true });
+        await writeFile(mcpPath, `${JSON.stringify(cfg, null, 2)}\n`);
+    };
+    const [action, name, command, ...cmdArgs] = args;
+    if (action === 'add') {
+        if (!name || !command) {
+            console.error('ใช้: sanook mcp add <name> <command> [args...]   (เช่น: mcp add fs npx -y @modelcontextprotocol/server-filesystem /path)');
+            process.exit(1);
+        }
+        cfg.mcpServers[name] = { command, args: cmdArgs };
+        await write();
+        console.log(`เพิ่ม MCP server "${name}"`);
+        return;
+    }
+    if (action === 'remove' || action === 'rm') {
+        if (name && cfg.mcpServers[name]) {
+            delete cfg.mcpServers[name];
+            await write();
+            console.log(`ลบ MCP server "${name}" แล้ว`);
+        }
+        else
+            console.log(`ไม่เจอ MCP server "${name ?? ''}"`);
+        return;
+    }
+    const names = Object.keys(cfg.mcpServers);
+    if (!names.length) {
+        console.log('ยังไม่มี MCP server — เพิ่ม: sanook mcp add <name> <command> [args...]');
+        return;
+    }
+    console.log(`${names.length} MCP servers:`);
+    for (const n of names)
+        console.log(`  ${n}  —  ${cfg.mcpServers[n].command} ${(cfg.mcpServers[n].args ?? []).join(' ')}`);
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    if (argv.includes('-v') || argv.includes('--version')) {
+        console.log(VERSION);
+        return;
+    }
+    if (argv.includes('-h') || argv.includes('--help')) {
+        console.log(HELP);
+        return;
+    }
+    // โหลด API key จาก ~/.sanook/auth.json เข้า env (ไม่ override env ที่ตั้งไว้แล้ว)
+    await loadKeysIntoEnv();
+    process.on('exit', closeMcp); // ปิด MCP server (kill child) ตอนจบ
+    // subcommands: serve · cron — match เฉพาะรูปแบบที่ถูกต้อง กัน prompt unquoted ("serve coffee") misfire
+    if (argv[0] === 'serve' && (argv.length === 1 || argv[1].startsWith('--')))
+        return runServe(argv.slice(1));
+    if (argv[0] === 'cron' && ['add', 'list', 'rm', 'remove', undefined].includes(argv[1])) {
+        return runCron(argv.slice(1));
+    }
+    if (argv[0] === 'skill' && ['list', 'add', 'remove', 'rm', undefined].includes(argv[1])) {
+        return runSkill(argv.slice(1));
+    }
+    if (argv[0] === 'models')
+        return runModels(argv.slice(1));
+    if (argv[0] === 'brain' && ['init', undefined].includes(argv[1]))
+        return runBrain(argv.slice(1));
+    if (argv[0] === 'config' && ['get', 'set', 'list', undefined].includes(argv[1]))
+        return runConfig(argv.slice(1));
+    if (argv[0] === 'mcp' && ['add', 'list', 'remove', 'rm', undefined].includes(argv[1]))
+        return runMcp(argv.slice(1));
+    const { model, budget, json, prompt: argPrompt, planMode, yes } = parseArgs(argv);
+    const budgetUsd = Number.isFinite(budget) ? budget : undefined;
+    // stdin piping: `git diff | sanook "review this"` → ผนวก stdin เข้า prompt (headless/CI)
+    const piped = process.stdin.isTTY ? '' : (await readStdin()).trim();
+    const prompt = piped ? `${argPrompt}\n\n<stdin>\n${piped}\n</stdin>`.trim() : argPrompt;
+    if (prompt) {
+        const config = await loadConfig({ model, budgetUsd });
+        // --continue / -c → โหลด session ล่าสุดมาต่อ (จำว่าทำถึงไหน)
+        const history = argv.includes('--continue') || argv.includes('-c') ? (await latestSession())?.messages : undefined;
+        await runHeadless(config.model, prompt, config.budgetUsd, config.maxSteps, json, history, planMode, yes ? 'auto' : config.permissionMode);
+        return;
+    }
+    // interactive — ครั้งแรก (ยังไม่มี config) → setup wizard ก่อนเข้า REPL
+    if (await isFirstRun()) {
+        const { startSetup } = await import('./ui/render.js');
+        await startSetup();
+    }
+    const config = await loadConfig({ model, budgetUsd });
+    // --continue / -c → โหลด conversation ล่าสุดเข้า REPL (เดิม resume ได้แค่ headless)
+    const initialHistory = argv.includes('--continue') || argv.includes('-c') ? (await latestSession())?.messages : undefined;
+    const { startRepl } = await import('./ui/render.js');
+    startRepl({
+        initialModel: config.model,
+        budgetUsd: config.budgetUsd,
+        permissionMode: yes ? 'auto' : config.permissionMode,
+        initialHistory,
+    });
+}
+main().catch((err) => {
+    console.error(redactKey(err.message ?? String(err)));
+    process.exit(1);
+});

package/dist/brain.js

@@ -0,0 +1,186 @@
+import { 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';
+/** ขยาย ~ ขึ้นต้น path เป็น home dir */
+export function expandHome(p) {
+    return p === '~' || p.startsWith('~/') ? join(homedir(), p.slice(1)) : p;
+}
+// bundled rich templates (Home/USER/constitution/core memory/Templates) — sibling ของ skills/ ใน package
+// (ship ผ่าน package.json "files", ไม่ผ่าน tsc — เหมือน BUNDLED_SKILLS ใน skills.ts)
+const TEMPLATE_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'second-brain');
+export const BRAIN_DEFAULTS = {
+    ownerName: 'Owner',
+    aiName: 'ผู้ช่วย',
+    aiPronoun: 'เรา',
+    language: 'ไทย + tech-en',
+    tone: 'กระชับ ตรงประเด็น สุภาพ',
+    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 (ไม่ลบ)' },
+];
+/** แทน {{KEY}} ด้วยค่าจริงจาก config */
+export function substitute(text, cfg) {
+    const map = {
+        OWNER_NAME: cfg.ownerName,
+        OWNER_ADDRESS: cfg.ownerName,
+        AI_NAME: cfg.aiName,
+        AI_PRONOUN: cfg.aiPronoun,
+        LANGUAGE: cfg.language,
+        TONE: cfg.tone,
+        VAULT_NAME: cfg.vaultName,
+        AUTONOMY: cfg.autonomy,
+        DATE: cfg.today,
+    };
+    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;
+    // parent = _Index ของโฟลเดอร์แม่ (nested) หรือ Home (top-level)
+    const parent = dir.includes('/') ? `${dir.split('/').slice(0, -1).join('/')}/_Index` : 'Home';
+    const tag = name.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    return `---
+tags: [index, moc, ${tag}]
+note_type: moc
+created: ${cfg.today}
+updated: ${cfg.today}
+parent: "[[${parent}]]"
+---
+
+# ${name}
+
+> ${role}
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[${parent}]]
+`;
+}
+async function exists(p) {
+    try {
+        await stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** write ถ้ายังไม่มี (create-if-missing — §B.3 rule 1: ห้ามทับของเดิม) */
+async function writeIfMissing(path, content, created, skipped) {
+    await mkdir(dirname(path), { recursive: true });
+    if (await exists(path)) {
+        skipped.push(path);
+        return;
+    }
+    await writeFile(path, content, 'utf8');
+    created.push(path);
+}
+/** เดิน bundled template dir → คืน rel path ของไฟล์ทั้งหมด (ไม่มี dir → คืน []) */
+async function walk(dir, base = dir) {
+    const out = [];
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const e of entries) {
+        const full = join(dir, e.name);
+        if (e.isDirectory())
+            out.push(...(await walk(full, base)));
+        else
+            out.push(full.slice(base.length + 1));
+    }
+    return out;
+}
+/**
+ * สร้างโครง second-brain ที่ targetPath — create-if-missing เสมอ
+ * 1) ทุกโฟลเดอร์ใน FOLDERS + _Index.md (generated)
+ * 2) rich seed files จาก bundled second-brain/ (Home/USER/constitution/core memory/Templates) + substitute
+ * 3) .obsidian/app.json ว่าง (ให้ Obsidian จำเป็น vault)
+ */
+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);
+    }
+    // 2) rich seed files (substitute placeholders)
+    for (const rel of await walk(TEMPLATE_DIR)) {
+        const raw = await readFile(join(TEMPLATE_DIR, rel), 'utf8');
+        await writeIfMissing(join(targetPath, rel), substitute(raw, cfg), created, skipped);
+    }
+    // 3) make Obsidian recognise it as a vault
+    await writeIfMissing(join(targetPath, '.obsidian', 'app.json'), '{}\n', created, skipped);
+    return { created, skipped };
+}
+/**
+ * wire filesystem MCP server ชี้ไป vault ใน ~/.sanook/mcp.json (merge — ไม่ทับ server เดิม)
+ * → agent อ่าน/เขียน vault ที่เพิ่ง scaffold ได้ทันที (ไม่ต้อง hand-author mcp.json)
+ */
+export async function wireBrainMcp(vaultPath) {
+    const mcpPath = join(homedir(), '.sanook', 'mcp.json');
+    let cfg = {};
+    try {
+        cfg = JSON.parse(await readFile(mcpPath, 'utf8'));
+    }
+    catch {
+        /* ยังไม่มีไฟล์ */
+    }
+    cfg.mcpServers ??= {};
+    if (cfg.mcpServers['second-brain'])
+        return 'exists';
+    cfg.mcpServers['second-brain'] = {
+        command: 'npx',
+        args: ['-y', '@modelcontextprotocol/server-filesystem', vaultPath],
+    };
+    await mkdir(dirname(mcpPath), { recursive: true });
+    await writeFile(mcpPath, `${JSON.stringify(cfg, null, 2)}\n`);
+    return 'added';
+}