sanook-cli 0.4.0 → 0.5.1

package/dist/ui/render.js

@@ -1,32 +1,72 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useState } from 'react';
 import { render } from 'ink';
 import { App } from './app.js';
 import { SetupWizard } from './setup.js';
 import { BrainWizard } from './brain-wizard.js';
 import { saveKey, saveGlobalConfig, saveBrainPath } from '../config.js';
-export function startRepl(props) {
-    render(_jsx(App, { ...props }));
-}
-/** render first-run wizard → save key+config → (ถ้าเลือก) ต่อ BrainWizard สร้าง second-brain → resolve */
-export function startSetup() {
-    return new Promise((resolve) => {
-        let unmount = () => { };
+/**
+ * Root — โฮสต์ setup wizard → brain wizard → REPL ใน **Ink render เดียว**
+ *
+ * ก่อนหน้านี้แยกเป็น render(SetupWizard) → unmount → render(App) = 2 Ink instances ต่อกัน
+ * พอ instance แรก unmount, stdin raw-mode/keypress listener ไม่ reattach กับ instance ที่ 2
+ * → พิมพ์ในช่องแชทไม่ได้. รวมเป็น tree เดียว (React สลับ component ภายใน) stdin ต่อเนื่องไม่หลุด.
+ */
+export function Root({ needsSetup, appProps }) {
+    const [phase, setPhase] = useState(needsSetup ? 'setup' : 'app');
+    const [model, setModel] = useState(appProps.initialModel);
+    const [brainNote, setBrainNote] = useState(undefined);
+    if (phase === 'setup') {
         const onComplete = (r) => {
             void (async () => {
                 if (r.key)
                     await saveKey(r.envVar, r.key);
                 await saveGlobalConfig({ model: r.model, provider: r.provider });
-                unmount();
-                if (r.createBrain)
-                    await startBrainSetup(); // ถาม identity + path จริง แล้ว scaffold
-                resolve(r);
+                setModel(r.model);
+                setPhase(r.createBrain ? 'brain' : 'app');
             })();
         };
-        const instance = render(_jsx(SetupWizard, { onComplete: onComplete }));
-        unmount = instance.unmount;
-    });
+        return _jsx(SetupWizard, { onComplete: onComplete });
+    }
+    if (phase === 'brain') {
+        const onComplete = (a) => {
+            void (async () => {
+                const { scaffoldBrain, BRAIN_DEFAULTS, expandHome, wireBrainMcp } = await import('../brain.js');
+                const today = new Date().toISOString().slice(0, 10);
+                const target = expandHome(a.path);
+                try {
+                    const res = await scaffoldBrain(target, {
+                        ...BRAIN_DEFAULTS,
+                        ownerName: a.ownerName,
+                        aiName: a.aiName,
+                        autonomy: a.autonomy,
+                        today,
+                    });
+                    await saveBrainPath(target);
+                    const wired = await wireBrainMcp(target).catch(() => 'skip');
+                    setBrainNote(`✅ second-brain — ${target} · สร้าง ${res.created.length} ไฟล์ · ` +
+                        `${wired === 'added' ? 'wire filesystem MCP เข้า vault แล้ว' : 'MCP เดิมอยู่แล้ว (ไม่ทับ)'} · เปิดใน Obsidian: Open folder as vault`);
+                }
+                catch (e) {
+                    setBrainNote(`⚠ สร้าง second-brain ไม่สำเร็จ: ${e.message} — ลองใหม่ด้วย ${'`'}sanook brain init${'`'}`);
+                }
+                setPhase('app');
+            })();
+        };
+        return _jsx(BrainWizard, { onComplete: onComplete });
+    }
+    // App mount สดตอน phase = 'app' → useState(initialModel) หยิบ model ที่เลือกจาก wizard ถูกต้อง
+    return _jsx(App, { ...appProps, initialModel: model, initialNote: brainNote ?? appProps.initialNote });
+}
+/** เปิดแอป: wizard (ถ้า first-run) → REPL — Ink render ครั้งเดียว (fix: พิมพ์ในช่องแชทไม่ได้) */
+export function startApp(props) {
+    render(_jsx(Root, { ...props }));
+}
+/** เปิด REPL ตรงๆ (ไม่ผ่าน wizard) — เก็บไว้เผื่อ caller อื่น */
+export function startRepl(appProps) {
+    render(_jsx(App, { ...appProps }));
 }
-/** standalone / first-run brain: ถาม path + ตัวตน → scaffold (personalized) + auto-wire filesystem MCP */
+/** standalone `sanook brain init` (interactive): ถาม path + ตัวตน → scaffold + wire MCP — single render, จบแล้ว process ออก */
 export function startBrainSetup() {
     return new Promise((resolve) => {
         let unmount = () => { };

package/dist/ui/setup.js

@@ -1,10 +1,29 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { useState, useEffect } from 'react';
-import { Box, Text } from 'ink';
+import { Box, Text, useInput } from 'ink';
 import { Select, PasswordInput } from '@inkjs/ui';
-import { PROVIDERS } from '../providers/registry.js';
+import { PROVIDERS, consoleUrl } from '../providers/registry.js';
+import { resolveKeyFromEnv, assertDirectApiKey } from '../providers/keys.js';
 import { listRemoteModels, mergeModelOptions } from '../providers/models.js';
-/** first-run setup wizard: เลือก provider → ใส่ API key → เลือก model → เสนอสร้าง second-brain */
+import { detectCodex } from '../providers/codex.js';
+import { BRAND } from '../brand.js';
+// จัดลำดับ provider ในเมนู: cloud ยอดนิยม → cloud อื่น → local → ChatGPT-plan (codex) ท้ายสุด
+const PROVIDER_ORDER = ['anthropic', 'openai', 'google', 'deepseek', 'xai', 'mistral', 'groq', 'glm', 'minimax', 'ollama', 'lmstudio', 'codex'];
+/** label + hint ต่อ provider: เจอ key ใน env / local / ChatGPT-login / ต้องมี key — ให้เลือกง่ายขึ้น */
+export function providerOption(id) {
+    const p = PROVIDERS[id];
+    let hint;
+    if (p.kind === 'delegate')
+        hint = 'login ChatGPT · ไม่ใช้ API key';
+    else if (!p.requiresKey)
+        hint = 'local · ไม่ต้อง key';
+    else if (resolveKeyFromEnv(p.envVar, p.envFallbacks))
+        hint = '✓ เจอ key ใน env';
+    else
+        hint = 'ต้องมี API key';
+    return { label: `${p.label}  —  ${hint}`, value: p.id };
+}
+/** first-run setup wizard: เลือก provider → (codex login | API key) → เลือก model → เสนอสร้าง second-brain */
 export function SetupWizard({ onComplete }) {
     const [step, setStep] = useState('provider');
     const [provider, setProvider] = useState('');
@@ -12,8 +31,32 @@ export function SetupWizard({ onComplete }) {
     const [model, setModel] = useState('');
     const [remote, setRemote] = useState([]);
     const [loadingModels, setLoadingModels] = useState(false);
+    const [codexStatus, setCodexStatus] = useState(null);
+    const [recheck, setRecheck] = useState(0);
+    const [keyError, setKeyError] = useState('');
     const cfg = provider ? PROVIDERS[provider] : undefined;
-    const providerOptions = Object.values(PROVIDERS).map((p) => ({ label: p.label, value: p.id }));
+    const providerOptions = PROVIDER_ORDER.filter((id) => PROVIDERS[id]).map(providerOption);
+    // codex-auth: เช็ก codex CLI ติดตั้ง + login ChatGPT (re-run เมื่อกด "เช็กใหม่")
+    useEffect(() => {
+        if (step !== 'codex-auth')
+            return;
+        let alive = true;
+        setCodexStatus(null);
+        void detectCodex().then((s) => {
+            if (!alive)
+                return;
+            setCodexStatus(s);
+            if (s.installed && s.loggedIn) {
+                // login แล้ว → ใช้ default model ของ codex (ChatGPT-plan เลือก model เอง) ข้ามขั้นเลือก key/model
+                setModel(`codex:${PROVIDERS.codex.models.default}`);
+                setStep('brain-offer');
+            }
+        });
+        return () => {
+            alive = false;
+        };
+    }, [step, recheck]);
+    // ดึงรายชื่อ model จริงจาก provider (เฉพาะ provider แบบ SDK ที่ต้อง/ไม่ต้อง key)
     useEffect(() => {
         if (step !== 'model' || !cfg)
             return;
@@ -28,19 +71,61 @@ export function SetupWizard({ onComplete }) {
     }, [step, cfg, key]);
     const modelOptions = cfg ? mergeModelOptions(cfg, remote) : [];
     const finish = (createBrain) => onComplete({ provider, model, envVar: cfg?.envVar ?? '', key, createBrain });
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, marginY: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "\u2699  \u0E15\u0E31\u0E49\u0E07\u0E04\u0E48\u0E32 Sanook AI CLI (\u0E04\u0E23\u0E31\u0E49\u0E07\u0E41\u0E23\u0E01)" }), step === 'provider' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "1. \u0E40\u0E25\u0E37\u0E2D\u0E01 AI provider:" }), _jsx(Select, { options: providerOptions, onChange: (v) => {
+    const backToProvider = () => {
+        setProvider('');
+        setCodexStatus(null);
+        setKeyError('');
+        setKey('');
+        setStep('provider');
+    };
+    // Esc บนทุก step (ยกเว้น provider) = ย้อนกลับไปเลือก provider — กัน dead-end ตอนเลือกผิด
+    // หรือ codex detect ค้าง (step codex-auth ตอน pending ไม่มีปุ่มอื่น แต่ Esc ออกได้เสมอ)
+    useInput((_input, key) => {
+        if (key.escape && step !== 'provider')
+            backToProvider();
+    });
+    // ตรวจ API key ในขั้นใส่ key — ว่าง = ไม่ผ่าน, OAuth/format ผิด = บอก error (กัน setup จบทั้งที่ key ใช้ไม่ได้)
+    const submitKey = (raw) => {
+        const k = raw.trim();
+        if (!k) {
+            setKeyError('วาง API key ก่อนค่ะ (กด Enter ทั้งที่ว่างไม่ได้) · Esc = กลับไปเลือก provider');
+            return;
+        }
+        if (cfg) {
+            try {
+                assertDirectApiKey(cfg, k); // reject OAuth/subscription token + format ผิด (เหมือน runtime)
+            }
+            catch (e) {
+                setKeyError(e.message.split('\n')[0]);
+                return;
+            }
+        }
+        setKeyError('');
+        setKey(k);
+        setStep('model');
+    };
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, marginY: 1, children: [_jsxs(Text, { bold: true, color: "cyan", children: ["\u2699  \u0E15\u0E31\u0E49\u0E07\u0E04\u0E48\u0E32 ", BRAND.bannerTitle, " (\u0E04\u0E23\u0E31\u0E49\u0E07\u0E41\u0E23\u0E01)"] }), step === 'provider' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "1. \u0E40\u0E25\u0E37\u0E2D\u0E01 AI provider (\u2191\u2193 \u0E40\u0E25\u0E37\u0E2D\u0E01 \u00B7 Enter \u0E22\u0E37\u0E19\u0E22\u0E31\u0E19):" }), _jsx(Text, { color: "gray", children: "   cloud = \u0E43\u0E2A\u0E48 API key \u00B7 local = \u0E1F\u0E23\u0E35\u0E1A\u0E19\u0E40\u0E04\u0E23\u0E37\u0E48\u0E2D\u0E07 \u00B7 Codex = login \u0E14\u0E49\u0E27\u0E22 ChatGPT" }), _jsx(Select, { options: providerOptions, onChange: (v) => {
                             setProvider(v);
-                            setStep(PROVIDERS[v].requiresKey ? 'key' : 'model');
-                        } })] })), step === 'key' && cfg && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["2. \u0E27\u0E32\u0E07 API key \u0E02\u0E2D\u0E07 ", cfg.label, ":"] }), _jsx(Text, { color: "gray", children: "   (key \u0E15\u0E23\u0E07\u0E08\u0E32\u0E01 console \u0E02\u0E2D\u0E07\u0E04\u0E48\u0E32\u0E22 \u2014 \u0E2B\u0E49\u0E32\u0E21 OAuth/subscription token)" }), _jsx(PasswordInput, { placeholder: cfg.envVar, onSubmit: (v) => {
-                            setKey(v.trim());
-                            setStep('model');
-                        } })] })), step === 'model' &&
+                            const p = PROVIDERS[v];
+                            if (p.kind === 'delegate')
+                                setStep('codex-auth');
+                            else if (p.requiresKey)
+                                setStep('key');
+                            else
+                                setStep('model');
+                        } })] })), step === 'codex-auth' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "2. \u0E40\u0E0A\u0E37\u0E48\u0E2D\u0E21 OpenAI Codex (\u0E43\u0E0A\u0E49\u0E42\u0E04\u0E27\u0E15\u0E49\u0E32 ChatGPT plan \u2014 \u0E44\u0E21\u0E48\u0E15\u0E49\u0E2D\u0E07\u0E21\u0E35 API key):" }), codexStatus === null ? (_jsx(Text, { color: "gray", children: "   \u0E01\u0E33\u0E25\u0E31\u0E07\u0E40\u0E0A\u0E47\u0E01 codex CLI + \u0E2A\u0E16\u0E32\u0E19\u0E30 login\u2026" })) : !codexStatus.installed ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "yellow", children: "   \u274C \u0E22\u0E31\u0E07\u0E44\u0E21\u0E48\u0E44\u0E14\u0E49\u0E15\u0E34\u0E14\u0E15\u0E31\u0E49\u0E07 codex CLI" }), _jsxs(Text, { children: ['   ', "\u0E15\u0E34\u0E14\u0E15\u0E31\u0E49\u0E07\u0E43\u0E19 terminal \u0E2D\u0E35\u0E01\u0E2B\u0E19\u0E49\u0E32\u0E15\u0E48\u0E32\u0E07: ", _jsx(Text, { color: "cyan", children: "npm i -g @openai/codex" })] }), _jsx(Select, { options: [
+                                    { label: 'เช็กใหม่ (ติดตั้งเสร็จแล้ว)', value: 'recheck' },
+                                    { label: '← กลับไปเลือก provider อื่น', value: 'back' },
+                                ], onChange: (v) => (v === 'recheck' ? setRecheck((n) => n + 1) : backToProvider()) })] })) : !codexStatus.loggedIn ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "yellow", children: "   \u26A0 \u0E15\u0E34\u0E14\u0E15\u0E31\u0E49\u0E07\u0E41\u0E25\u0E49\u0E27 \u0E41\u0E15\u0E48\u0E22\u0E31\u0E07\u0E44\u0E21\u0E48\u0E44\u0E14\u0E49 login ChatGPT" }), _jsxs(Text, { children: ['   ', "\u0E23\u0E31\u0E19\u0E43\u0E19 terminal \u0E2D\u0E35\u0E01\u0E2B\u0E19\u0E49\u0E32\u0E15\u0E48\u0E32\u0E07: ", _jsx(Text, { color: "cyan", children: "codex login" }), " ", _jsx(Text, { color: "gray", children: "(\u0E40\u0E1B\u0E34\u0E14 browser \u0E43\u0E2B\u0E49\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E14\u0E49\u0E27\u0E22\u0E1A\u0E31\u0E0D\u0E0A\u0E35 ChatGPT)" })] }), _jsx(Select, { options: [
+                                    { label: 'เช็กใหม่ (login เสร็จแล้ว)', value: 'recheck' },
+                                    { label: '← กลับไปเลือก provider อื่น', value: 'back' },
+                                ], onChange: (v) => (v === 'recheck' ? setRecheck((n) => n + 1) : backToProvider()) })] })) : (_jsx(Text, { color: "green", children: "   \u2705 login ChatGPT \u0E41\u0E25\u0E49\u0E27 \u2014 \u0E01\u0E33\u0E25\u0E31\u0E07\u0E44\u0E1B\u0E15\u0E48\u0E2D\u2026" }))] })), step === 'key' && cfg && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["2. \u0E27\u0E32\u0E07 API key \u0E02\u0E2D\u0E07 ", cfg.label, ": ", _jsx(Text, { color: "gray", children: "(Esc = \u0E01\u0E25\u0E31\u0E1A)" })] }), consoleUrl(provider) ? _jsxs(Text, { color: "cyan", children: ["   \u2192 \u0E40\u0E2D\u0E32 key \u0E17\u0E35\u0E48: ", consoleUrl(provider)] }) : null, cfg.keyExample ? _jsxs(Text, { color: "gray", children: ["   \u0E23\u0E39\u0E1B\u0E41\u0E1A\u0E1A key: ", cfg.keyExample] }) : null, _jsx(Text, { color: "gray", children: "   (API key \u0E15\u0E23\u0E07\u0E08\u0E32\u0E01 console \u2014 \u0E2B\u0E49\u0E32\u0E21 OAuth/subscription token \u00B7 key \u0E08\u0E30\u0E40\u0E01\u0E47\u0E1A\u0E41\u0E1A\u0E1A\u0E40\u0E02\u0E49\u0E32\u0E23\u0E2B\u0E31\u0E2A\u0E43\u0E19\u0E40\u0E04\u0E23\u0E37\u0E48\u0E2D\u0E07)" }), _jsx(PasswordInput, { placeholder: cfg.envVar, onSubmit: submitKey }), keyError ? _jsxs(Text, { color: "red", children: ["   \u2717 ", keyError] }) : null] })), step === 'model' &&
                 cfg &&
                 (loadingModels ? (_jsxs(Text, { color: "gray", children: ["   \u0E01\u0E33\u0E25\u0E31\u0E07\u0E14\u0E36\u0E07\u0E23\u0E32\u0E22\u0E0A\u0E37\u0E48\u0E2D model \u0E08\u0E32\u0E01 ", cfg.label, "\u2026"] })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["3. \u0E40\u0E25\u0E37\u0E2D\u0E01 model \u0E40\u0E23\u0E34\u0E48\u0E21\u0E15\u0E49\u0E19", remote.length ? _jsxs(Text, { color: "gray", children: [" (", modelOptions.length, " \u0E15\u0E31\u0E27\u0E08\u0E32\u0E01 provider + alias)"] }) : null, ":"] }), _jsx(Select, { options: modelOptions, onChange: (v) => {
                                 setModel(`${provider}:${v}`);
                                 setStep('brain-offer');
                             } })] }))), step === 'brain-offer' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "4. \u0E2A\u0E23\u0E49\u0E32\u0E07 \"second brain\" workspace (Obsidian) \u0E2A\u0E33\u0E2B\u0E23\u0E31\u0E1A\u0E08\u0E31\u0E14\u0E40\u0E01\u0E47\u0E1A\u0E07\u0E32\u0E19 + \u0E04\u0E27\u0E32\u0E21\u0E08\u0E33 AI?" }), _jsx(Select, { options: [
                             { label: 'สร้างเลย — ตอบไม่กี่ข้อ (ชื่อ + ที่เก็บ)', value: 'yes' },
-                            { label: 'ข้ามไปก่อน (สั่ง sanook brain init ทีหลังได้)', value: 'no' },
+                            { label: `ข้ามไปก่อน (สั่ง ${BRAND.cliName} brain init ทีหลังได้)`, value: 'no' },
                         ], onChange: (v) => finish(v === 'yes') })] }))] }));
 }

package/dist/ui/useEditor.js

@@ -0,0 +1,83 @@
+import { useState, useRef } from 'react';
+export function useEditor(history) {
+    const [value, setValue] = useState('');
+    const [cursor, setCursor] = useState(0);
+    const histIndex = useRef(null); // null = กำลังแก้ draft (ไม่ได้อยู่ในประวัติ)
+    const draft = useRef('');
+    const set = (v, c = v.length) => {
+        setValue(v);
+        setCursor(Math.max(0, Math.min(c, v.length)));
+    };
+    const reset = () => {
+        histIndex.current = null;
+        set('');
+    };
+    const insert = (s) => set(value.slice(0, cursor) + s + value.slice(cursor), cursor + s.length);
+    const historyPrev = () => {
+        if (!history.length)
+            return;
+        if (histIndex.current === null) {
+            draft.current = value;
+            histIndex.current = history.length - 1;
+        }
+        else {
+            histIndex.current = Math.max(0, histIndex.current - 1);
+        }
+        set(history[histIndex.current]);
+    };
+    const historyNext = () => {
+        if (histIndex.current === null)
+            return;
+        if (histIndex.current >= history.length - 1) {
+            histIndex.current = null;
+            set(draft.current);
+        }
+        else {
+            histIndex.current += 1;
+            set(history[histIndex.current]);
+        }
+    };
+    const handleKey = (input, key) => {
+        if (key.return) {
+            // Alt/Option+Enter หรือบรรทัดลงท้าย "\" → ขึ้นบรรทัดใหม่ (multiline) ไม่ submit
+            if (key.meta)
+                return insert('\n'), 'handled';
+            if (value.slice(0, cursor).endsWith('\\'))
+                return set(value.slice(0, cursor - 1) + '\n' + value.slice(cursor), cursor), 'handled';
+            return 'submit';
+        }
+        if (key.upArrow)
+            return historyPrev(), 'handled';
+        if (key.downArrow)
+            return historyNext(), 'handled';
+        if (key.leftArrow)
+            return setCursor(Math.max(0, cursor - 1)), 'handled';
+        if (key.rightArrow)
+            return setCursor(Math.min(value.length, cursor + 1)), 'handled';
+        if (key.ctrl) {
+            switch (input) {
+                case 'a': return setCursor(0), 'handled';
+                case 'e': return setCursor(value.length), 'handled';
+                case 'u': return set(value.slice(cursor), 0), 'handled'; // ลบจากต้นบรรทัดถึง cursor
+                case 'k': return set(value.slice(0, cursor), cursor), 'handled'; // ลบจาก cursor ถึงท้าย
+                case 'w': { // ลบ word ก่อน cursor (รวมกรณีเหลือแต่ whitespace)
+                    const left = value.slice(0, cursor).replace(/\s+$|\s*\S+\s*$/, '');
+                    return set(left + value.slice(cursor), left.length), 'handled';
+                }
+                case 'c': return 'interrupt';
+                default: return 'handled';
+            }
+        }
+        if (key.backspace || key.delete) {
+            if (cursor === 0)
+                return 'handled';
+            return set(value.slice(0, cursor - 1) + value.slice(cursor), cursor - 1), 'handled';
+        }
+        if (input && !key.meta) {
+            histIndex.current = null; // เริ่มพิมพ์ = ออกจากโหมดดูประวัติ
+            return insert(input), 'handled';
+        }
+        return 'none';
+    };
+    return { value, cursor, setValue: (v) => set(v), reset, handleKey };
+}

package/dist/update.js

@@ -0,0 +1,114 @@
+import { spawn } from 'node:child_process';
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+export const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+function packageUrl(registry, packageName) {
+    const base = registry.replace(/\/+$/, '') || DEFAULT_REGISTRY;
+    const encoded = encodeURIComponent(packageName).replace(/^%40/, '@');
+    return `${base}/${encoded}`;
+}
+function splitVersion(version) {
+    const [withoutBuild] = version.trim().replace(/^v/, '').split('+');
+    const [corePart, prereleasePart = ''] = withoutBuild.split('-', 2);
+    return {
+        core: corePart.split('.').map((part) => Number.parseInt(part, 10)).map((n) => (Number.isFinite(n) ? n : 0)),
+        prerelease: prereleasePart ? prereleasePart.split('.') : [],
+    };
+}
+function comparePrerelease(a, b) {
+    if (!a.length && !b.length)
+        return 0;
+    if (!a.length)
+        return 1;
+    if (!b.length)
+        return -1;
+    const len = Math.max(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        const pa = a[i];
+        const pb = b[i];
+        if (pa === undefined)
+            return -1;
+        if (pb === undefined)
+            return 1;
+        const na = /^\d+$/.test(pa) ? Number(pa) : Number.NaN;
+        const nb = /^\d+$/.test(pb) ? Number(pb) : Number.NaN;
+        if (Number.isFinite(na) && Number.isFinite(nb) && na !== nb)
+            return na > nb ? 1 : -1;
+        if (Number.isFinite(na) !== Number.isFinite(nb))
+            return Number.isFinite(na) ? -1 : 1;
+        if (pa !== pb)
+            return pa > pb ? 1 : -1;
+    }
+    return 0;
+}
+export function compareVersions(a, b) {
+    const va = splitVersion(a);
+    const vb = splitVersion(b);
+    const len = Math.max(va.core.length, vb.core.length, 3);
+    for (let i = 0; i < len; i++) {
+        const na = va.core[i] ?? 0;
+        const nb = vb.core[i] ?? 0;
+        if (na !== nb)
+            return na > nb ? 1 : -1;
+    }
+    return comparePrerelease(va.prerelease, vb.prerelease);
+}
+export function isNewerVersion(latest, current) {
+    return compareVersions(latest, current) > 0;
+}
+export function installCommand(packageName) {
+    return `npm install -g ${packageName}@latest`;
+}
+export function shouldCheckForUpdate(cache, nowMs = Date.now(), intervalMs = UPDATE_CHECK_INTERVAL_MS) {
+    if (!cache?.checkedAt)
+        return true;
+    const checkedAt = Date.parse(cache.checkedAt);
+    if (!Number.isFinite(checkedAt))
+        return true;
+    if (checkedAt > nowMs)
+        return true;
+    return nowMs - checkedAt >= intervalMs;
+}
+export async function fetchLatestVersion(meta, opts = {}) {
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), opts.timeoutMs ?? 8000);
+    try {
+        const res = await fetchImpl(packageUrl(opts.registry ?? process.env.npm_config_registry ?? DEFAULT_REGISTRY, meta.name), {
+            headers: { accept: 'application/vnd.npm.install-v1+json' },
+            signal: ctrl.signal,
+        });
+        if (!res.ok) {
+            throw new Error(`npm registry ตอบ ${res.status}${res.statusText ? ` ${res.statusText}` : ''}`);
+        }
+        const body = (await res.json());
+        const latest = body['dist-tags']?.latest;
+        if (!latest)
+            throw new Error('npm registry ไม่มี dist-tag "latest"');
+        return latest;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function checkForUpdate(meta, opts = {}) {
+    const latestVersion = await fetchLatestVersion(meta, opts);
+    return {
+        packageName: meta.name,
+        currentVersion: meta.version,
+        latestVersion,
+        isOutdated: isNewerVersion(latestVersion, meta.version),
+        installCommand: installCommand(meta.name),
+    };
+}
+export function installLatest(meta, opts = {}) {
+    const spawnImpl = opts.spawnImpl ?? spawn;
+    return new Promise((resolve, reject) => {
+        const child = spawnImpl('npm', ['install', '-g', `${meta.name}@latest`], {
+            stdio: 'inherit',
+            env: process.env,
+            shell: process.platform === 'win32', // Windows: npm = npm.cmd → spawn ตรงๆ ENOENT
+        });
+        child.once('error', reject);
+        child.once('close', (code) => resolve(code ?? 1));
+    });
+}

package/dist/worktree.js

@@ -0,0 +1,173 @@
+// ============================================================================
+// src/worktree.ts — throwaway git worktrees for ISOLATED parallel write agents.
+//
+// When several sub-agents edit files at once, they would clobber each other in
+// one working tree. This gives each one its own `git worktree` (detached at the
+// current HEAD), so their writes are physically isolated; afterwards each
+// worktree's diff is captured and applied back to the main tree sequentially.
+//
+// Reuses runGit()/isGitRepo() from src/git.ts (execFile, no shell). Everything is
+// best-effort + defensive: not a git repo → returns null (caller falls back to a
+// shared tree); a failed apply is reported, never thrown past the orchestrator.
+// ============================================================================
+import { mkdtemp, rm, writeFile, readFile, realpath } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { runGit, isGitRepo } from './git.js';
+/** repo root of `cwd` (the top-level working dir), or null if not a git repo. */
+export async function getRepoRoot(cwd = process.cwd()) {
+    if (!(await isGitRepo(cwd)))
+        return null;
+    try {
+        return (await runGit(['rev-parse', '--show-toplevel'], cwd)).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Create a detached worktree at the current HEAD of the repo containing `cwd`.
+ * Returns null if `cwd` is not in a git repo (caller should then run un-isolated).
+ */
+export async function createWorktree(cwd = process.cwd()) {
+    const repoRoot = await getRepoRoot(cwd);
+    if (!repoRoot)
+        return null;
+    try {
+        const baseRef = (await runGit(['rev-parse', 'HEAD'], repoRoot)).trim();
+        const tmpParent = await mkdtemp(join(tmpdir(), 'sanook-wt-'));
+        const path = join(tmpParent, `t-${randomUUID().slice(0, 8)}`); // must not pre-exist; git creates it
+        await runGit(['worktree', 'add', '--detach', path, baseRef], repoRoot);
+        const real = await realpath(path).catch(() => path);
+        return { path: real, baseRef, repoRoot, tmpParent };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Capture everything the sub-agent changed in its worktree as a unified diff
+ * (vs the base HEAD), including new/untracked files. Empty string = no changes.
+ */
+export async function captureDiff(wt) {
+    try {
+        await runGit(['add', '-A'], wt.path); // stage incl. untracked so they appear in the diff
+        return await runGit(['diff', '--cached', '--binary', wt.baseRef], wt.path);
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Apply a captured diff back into the main repo (at its root). Uses --3way so a
+ * clean patch lands and a conflicting one is reported rather than silently lost.
+ * Empty diff is a no-op success.
+ */
+export async function applyDiff(diff, repoRoot) {
+    if (!diff.trim())
+        return { ok: true };
+    const files = diffFiles(diff);
+    if (files.length) {
+        try {
+            await runGit(['diff', '--cached', '--quiet', '--', ...files], repoRoot);
+        }
+        catch {
+            return { ok: false, reason: 'touched files have staged changes; refusing to disturb the index' };
+        }
+    }
+    // Snapshot every touched file's exact pre-apply content (or absence). `git apply --3way`
+    // can leave conflict markers + unmerged index entries on failure, and across git versions
+    // `--check` doesn't always foresee a 3-way conflict — so on ANY failure we roll the working
+    // tree back to precisely this snapshot, preserving uncommitted changes that were already there.
+    const before = new Map();
+    await Promise.all(files.map(async (f) => {
+        before.set(f, await readFile(join(repoRoot, f)).catch(() => null));
+    }));
+    const patchFile = join(tmpdir(), `sanook-patch-${randomUUID().slice(0, 8)}.diff`);
+    try {
+        await writeFile(patchFile, diff, 'utf8');
+        await runGit(['apply', '--check', '--3way', '--whitespace=nowarn', patchFile], repoRoot); // fast reject
+        await runGit(['apply', '--3way', '--whitespace=nowarn', patchFile], repoRoot);
+        return { ok: true };
+    }
+    catch (e) {
+        // restore exact pre-apply content + clear any index/unmerged entries --3way may have created
+        await Promise.all([...before].map(async ([f, content]) => {
+            const abs = join(repoRoot, f);
+            if (content == null)
+                await rm(abs, { force: true }).catch(() => { });
+            else
+                await writeFile(abs, content).catch(() => { });
+        }));
+        if (files.length)
+            await runGit(['reset', '-q', '--', ...files], repoRoot).catch(() => { });
+        return { ok: false, reason: e.message.split('\n')[0] };
+    }
+    finally {
+        await rm(patchFile, { force: true }).catch(() => { });
+    }
+}
+/** Remove the worktree and its temp parent (best-effort; prunes git's bookkeeping). */
+export async function removeWorktree(wt) {
+    await runGit(['worktree', 'remove', '--force', wt.path], wt.repoRoot).catch(() => { });
+    await rm(wt.tmpParent, { recursive: true, force: true }).catch(() => { });
+    await runGit(['worktree', 'prune'], wt.repoRoot).catch(() => { });
+}
+/** changed file paths in a captured diff (for a human-readable summary). */
+export function diffFiles(diff) {
+    const files = new Set();
+    for (const m of diff.matchAll(/^diff --git a\/(.+?) b\/(.+)$/gm))
+        files.add(m[2]);
+    return [...files];
+}
+/**
+ * Run `work(task, cwd, i)` for each task in ITS OWN throwaway worktree (concurrently,
+ * via the injected `runConcurrently`), then capture+apply each worktree's diff back
+ * into the main tree sequentially. The work callback is injected so this whole
+ * lifecycle (create → isolate → merge → cleanup) unit-tests with no agent/network.
+ * Returns null if `root` is not a git repo or worktrees can't be created.
+ */
+export async function runInWorktrees(tasks, root, work, runConcurrently) {
+    if (!(await getRepoRoot(root)))
+        return null;
+    const wts = [];
+    for (let i = 0; i < tasks.length; i++) {
+        const wt = await createWorktree(root);
+        if (!wt) {
+            for (const w of wts)
+                await removeWorktree(w);
+            return null;
+        }
+        wts.push(wt);
+    }
+    let results;
+    try {
+        results = await runConcurrently(tasks.map((t, i) => () => work(t, wts[i].path, i)));
+    }
+    catch (e) {
+        for (const w of wts)
+            await removeWorktree(w);
+        throw e;
+    }
+    const out = [];
+    for (let i = 0; i < wts.length; i++) {
+        let merge;
+        try {
+            const diff = await captureDiff(wts[i]);
+            if (!diff.trim()) {
+                merge = { description: tasks[i].description, changed: [], applied: true };
+            }
+            else {
+                const changed = diffFiles(diff);
+                const res = await applyDiff(diff, root); // sequential → deterministic conflict handling
+                merge = { description: tasks[i].description, changed, applied: res.ok, reason: res.reason };
+            }
+        }
+        finally {
+            await removeWorktree(wts[i]);
+        }
+        out.push({ result: results[i], merge });
+    }
+    return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sanook-cli",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "A terminal AI coding agent — BYOK, 12 providers, MCP, cron gateway, skills, and git awareness. Built from scratch in TypeScript.",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
     "dist",
     "skills",
     "second-brain",
+    "scripts/postinstall.mjs",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
@@ -21,6 +22,7 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "eval": "tsx src/eval/run.ts",
+    "postinstall": "node scripts/postinstall.mjs",
     "prepublishOnly": "npm run build"
   },
   "engines": {
@@ -28,15 +30,19 @@
   },
   "keywords": [
     "ai",
-    "cli",
     "coding-agent",
-    "agent",
+    "ai-agent",
+    "cli",
     "llm",
     "terminal",
     "byok",
     "mcp",
-    "gateway",
-    "cron",
+    "second-brain",
+    "obsidian",
+    "cross-session-memory",
+    "claude-code-alternative",
+    "ai-coding",
+    "agent",
     "claude",
     "gemini"
   ],