sanook-cli 0.5.2 → 0.5.7

package/dist/clipboard.js

@@ -0,0 +1,65 @@
+import { spawn } from 'node:child_process';
+const OSC52_MAX_CHARS = 100_000;
+function powershellSetClipboardScript(text) {
+    const b64 = Buffer.from(text, 'utf8').toString('base64');
+    return `Set-Clipboard -Value ([System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${b64}')))`;
+}
+function clipboardWriteCommands(platform, env) {
+    if (platform === 'darwin')
+        return [{ args: [], command: 'pbcopy', stdin: true }];
+    if (platform === 'win32')
+        return [{ args: ['-NoProfile', '-NonInteractive'], command: 'powershell', stdin: false }];
+    const commands = [];
+    if (env.WSL_INTEROP || env.WSL_DISTRO_NAME) {
+        commands.push({ args: ['-NoProfile', '-NonInteractive'], command: 'powershell.exe', stdin: false });
+    }
+    if (env.WAYLAND_DISPLAY)
+        commands.push({ args: ['--type', 'text/plain'], command: 'wl-copy', stdin: true });
+    commands.push({ args: ['-selection', 'clipboard', '-in'], command: 'xclip', stdin: true });
+    commands.push({ args: ['--clipboard', '--input'], command: 'xsel', stdin: true });
+    return commands;
+}
+function runClipboardCommand(command, text, start) {
+    return new Promise((resolve) => {
+        const args = command.stdin ? command.args : [...command.args, '-Command', powershellSetClipboardScript(text)];
+        let child;
+        try {
+            child = start(command.command, args, { stdio: command.stdin ? ['pipe', 'ignore', 'ignore'] : ['ignore', 'ignore', 'ignore'], windowsHide: true });
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        child.once('error', () => resolve(false));
+        child.once('close', (code) => resolve(code === 0));
+        if (command.stdin)
+            child.stdin?.end(text);
+    });
+}
+export async function writeSystemClipboard(text, options = {}) {
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? process.platform;
+    const start = options.spawn ?? spawn;
+    for (const command of clipboardWriteCommands(platform, env)) {
+        if (await runClipboardCommand(command, text, start))
+            return command.command;
+    }
+    return null;
+}
+export function osc52Sequence(text) {
+    const safe = text.length > OSC52_MAX_CHARS ? text.slice(0, OSC52_MAX_CHARS) : text;
+    return `\u001b]52;c;${Buffer.from(safe, 'utf8').toString('base64')}\u0007`;
+}
+export async function copyTextToClipboard(text, options = {}) {
+    const payload = text.trimEnd();
+    if (!payload.trim())
+        throw new Error('ไม่มีข้อความให้ copy');
+    const backend = await writeSystemClipboard(payload, options);
+    if (backend)
+        return { detail: backend, method: 'system' };
+    if (options.writeOsc52) {
+        options.writeOsc52(osc52Sequence(payload));
+        return { detail: 'OSC52', method: 'osc52' };
+    }
+    throw new Error('ไม่พบ clipboard backend และไม่มี OSC52 output');
+}

package/dist/commands.js

@@ -6,16 +6,25 @@ import { parseFrontmatter } from './skills.js';
 import { projectConfigPathIfTrusted } from './trust.js';
 import { normalizePersonalityName, personalityListText } from './personality.js';
 import { parseInsightsArgs } from './insights-args.js';
-const HELP_TEXT = `คำสั่ง:
+import { formatHotkeys } from './hotkeys.js';
+import { formatToolCatalog } from './tool-catalog.js';
+export const HELP_TEXT = `คำสั่ง:
   /help            แสดงคำสั่งทั้งหมด
   /new, /reset      เริ่มบทสนทนาใหม่
   /status          ดูสถานะ session ปัจจุบัน
-  /model [spec]    ดู/เปลี่ยน model (เช่น /model opus, /model openai:gpt-5)
+  /model [spec]    ดู/เปลี่ยน model — /model เปิด picker 2 ขั้น (provider → model)
+  /setup           ดูขั้นตอน setup wizard (model · agent · tools · gateway · brain)
+  /dashboard       เปิด Sanook Dashboard (local web UI)
   /personality [name]
                    ดู/ตั้ง personality overlay
+  /details [thinking|tools] [hidden|collapsed|expanded]
+                   คุมแผง thinking/tool trail แบบ Hermes-style
   /platforms       ดู providers + messaging platforms ที่รองรับ
   /tools           ดู tools ที่ agent ใช้ได้
-  /skills          ดูจำนวน skills (จัดการ: ${BRAND.cliName} skill list)
+  /mcp             เปิด MCP Hub overlay
+  /skills          เปิด Skills Hub overlay (จัดการ: ${BRAND.cliName} skill list)
+  /sessions        เปิด Session Switcher overlay · /trail พับ/ขยาย tool trail
+  /tasks           ดู background sub-agents (task_spawn)
   /diff            ดู git diff (สิ่งที่ agent แก้ในรอบนี้)
   /retry           รัน prompt ล่าสุดอีกครั้ง
   /stop            หยุด turn ที่กำลังรัน
@@ -24,6 +33,8 @@ const HELP_TEXT = `คำสั่ง:
   /cost, /usage     ดู token + cost รอบล่าสุด
   /insights [--days N] [--all]
                    ดู usage/session insights ในเครื่อง
+  /hotkeys         เปิด overlay คีย์ลัดใน REPL
+  /copy [last]     copy คำตอบ assistant ล่าสุดไป clipboard/OSC52
   ↑/↓ ประวัติ · @ไฟล์ แนบ context/รูป · \\ ลงท้าย = บรรทัดใหม่
   /clear           ล้าง conversation (เริ่มใหม่)
   /compact, /compress
@@ -37,14 +48,6 @@ const HELP_TEXT = `คำสั่ง:
 custom commands:
   ~/.sanook/commands/<name>.md และ .sanook/commands/<name>.md (project ต้อง trust ก่อน)
   args: ใช้ $ARGUMENTS หรือ {{ args }}; ถ้าไม่มี placeholder จะ append args ต่อท้าย`;
-const TOOLS_LIST = [
-    '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 task_parallel task_spawn task_collect task_cancel task_status   ← sub-agent (ขนาน/background)',
-    'diagnostics   ← type error/lint จาก language server (LSP)',
-].join('\n  ');
 const MESSAGING_PLATFORMS = [
     'telegram',
     'discord',
@@ -167,16 +170,42 @@ export function parseCommand(input, ctx) {
             return { handled: true, action: 'clear', message: 'ล้าง conversation แล้ว' };
         case 'status':
             return { handled: true, message: statusMenu(ctx) };
+        case 'hotkeys':
+            return { handled: true, action: 'hotkeys', message: formatHotkeys() };
         case 'compact':
         case 'compress':
             return { handled: true, action: 'compact', message: 'บีบ context แล้ว' };
+        case 'copy': {
+            const target = args[0]?.toLowerCase();
+            if (!target || target === 'last' || target === 'assistant')
+                return { handled: true, action: 'copyLast' };
+            return { handled: true, message: 'ใช้ /copy หรือ /copy last' };
+        }
         case 'quit':
         case 'exit':
             return { handled: true, action: 'quit' };
         case 'model':
             if (!args[0])
-                return { handled: true, message: modelMenu(ctx.model) };
+                return { handled: true, action: 'modelPicker', message: modelMenu(ctx.model) };
             return modelChange(args[0]);
+        case 'setup':
+            return {
+                handled: true,
+                message: [
+                    `${BRAND.productName} setup (Hermes-style sections):`,
+                    `  1. ${BRAND.cliName} setup model     — provider + model wizard`,
+                    `  2. ${BRAND.cliName} setup agent     — permissionMode, budget, personality`,
+                    `  3. ${BRAND.cliName} setup tools     — built-in tools + MCP`,
+                    `  4. ${BRAND.cliName} setup gateway   — Telegram/Discord/Slack/…`,
+                    `  5. ${BRAND.cliName} setup brain     — second-brain vault`,
+                    `  หรือรัน ${BRAND.cliName} ครั้งแรก → wizard 10 ขั้น (ภาษา → … → gateway → brain)`,
+                ].join('\n'),
+            };
+        case 'dashboard':
+            return {
+                handled: true,
+                message: `Sanook Dashboard — รัน: ${BRAND.cliName} dashboard\n  แล้วเปิด http://127.0.0.1:9119 (Chat · Files · Logs · Cron · Channels)`,
+            };
         case 'personality': {
             const raw = args.join(' ').trim();
             if (!raw)
@@ -192,11 +221,55 @@ export function parseCommand(input, ctx) {
             };
         }
         case 'tools':
-            return { handled: true, message: `tools ที่ agent ใช้ได้ (+ MCP ที่ตั้งไว้):\n  ${TOOLS_LIST}` };
+            return { handled: true, action: 'toolsHub', message: `tools ที่ agent ใช้ได้ (+ MCP ที่ตั้งไว้):\n  ${formatToolCatalog()}` };
+        case 'trail': {
+            const rawMode = args[0]?.toLowerCase();
+            if (!rawMode)
+                return { handled: true, action: 'toolTrail', message: 'toggle tool trail view' };
+            if (['compact', 'collapse', 'collapsed', 'hide', 'summary'].includes(rawMode)) {
+                return { handled: true, action: 'toolTrail', message: 'tool trail → compact', toolTrailMode: 'compact' };
+            }
+            if (['expanded', 'expand', 'full', 'show'].includes(rawMode)) {
+                return { handled: true, action: 'toolTrail', message: 'tool trail → expanded', toolTrailMode: 'expanded' };
+            }
+            return { handled: true, message: 'ใช้ /trail, /trail compact, หรือ /trail expanded' };
+        }
+        case 'details': {
+            const section = args[0]?.toLowerCase();
+            const mode = args[1]?.toLowerCase();
+            const usage = 'ใช้ /details thinking|tools hidden|collapsed|expanded';
+            if (!section && !mode)
+                return { handled: true, message: usage };
+            if (section !== 'thinking' && section !== 'tools')
+                return { handled: true, message: usage };
+            if (mode !== 'hidden' && mode !== 'collapsed' && mode !== 'expanded')
+                return { handled: true, message: usage };
+            return {
+                handled: true,
+                action: 'details',
+                detailMode: mode,
+                detailSection: section,
+                message: `details ${section} → ${mode}`,
+            };
+        }
         case 'platforms':
             return { handled: true, message: platformMenu() };
+        case 'mcp':
+            return {
+                handled: true,
+                action: 'mcpHub',
+                message: `MCP servers — จัดการด้วย "${BRAND.cliName} mcp list/search/install/doctor"`,
+            };
         case 'skills':
-            return { handled: true, message: `skills โหลดจาก built-in + ${appHomePath('skills')} — จัดการด้วย "${BRAND.cliName} skill list/add/remove"` };
+            return {
+                handled: true,
+                action: 'skillsHub',
+                message: `skills โหลดจาก built-in + ${appHomePath('skills')} — จัดการด้วย "${BRAND.cliName} skill list/add/remove"`,
+            };
+        case 'sessions':
+            return { handled: true, action: 'sessionsHub', message: `saved sessions — จัดการด้วย "${BRAND.cliName} sessions"` };
+        case 'tasks':
+            return { handled: true, action: 'tasksHub', message: 'background tasks — จาก task_spawn (Enter ดูรายละเอียด)' };
         case 'diff':
             return { handled: true, action: 'diff' };
         case 'retry':
@@ -209,7 +282,10 @@ export function parseCommand(input, ctx) {
             return { handled: true, action: 'rewind' };
         case 'cost':
         case 'usage':
-            return { handled: true, message: ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)' };
+            return {
+                handled: true,
+                message: `${ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)'}\n→ ${BRAND.cliName} usage daily`,
+            };
         case 'insights': {
             const parsed = parseInsightsArgs(args);
             if (parsed === null)
@@ -230,15 +306,22 @@ export const BUILTIN_COMMANDS = new Set([
     'new',
     'reset',
     'status',
+    'hotkeys',
     'compact',
     'compress',
+    'copy',
     'quit',
     'exit',
     'model',
     'personality',
+    'details',
     'platforms',
+    'trail',
     'tools',
+    'mcp',
     'skills',
+    'sessions',
+    'tasks',
     'diff',
     'retry',
     'stop',

package/dist/config.js

@@ -4,9 +4,12 @@ import { join } from 'node:path';
 import { appHomePath, appProjectPath, BRAND } from './brand.js';
 import { projectRoot, projectTrustStatus } from './trust.js';
 import { registerPricing } from './cost.js';
-export const CONFIG_DIR = appHomePath();
-const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
-const AUTH_PATH = join(CONFIG_DIR, 'auth.json'); // API keys (chmod 0600)
+export function configHomeDir() {
+    return appHomePath();
+}
+function authPath() {
+    return join(configHomeDir(), 'auth.json');
+}
 const AUTH_ENV_VAR_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
 const RESERVED_AUTH_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 const PricingKeySchema = z.string().regex(/^[^:\s]+:\S+$/, 'key ต้องเป็น provider:model');
@@ -46,6 +49,8 @@ export const ConfigSchema = z.object({
     embeddingModel: z.string().optional().catch(undefined),
     // Hermes-style /personality overlay (stored as a small named prompt)
     personality: z.string().optional().catch(undefined),
+    /** UI + setup wizard language */
+    locale: z.enum(['en', 'th']).catch('th').default('th'),
 });
 const DEFAULT_THINKING_BUDGET = 4096;
 function normalizeThinkingBudget(value) {
@@ -99,10 +104,36 @@ export async function agentTuning() {
     const summaryModel = trimmedString(process.env.SANOOK_SUMMARY_MODEL) ?? trimmedString(raw.summaryModel);
     return { cacheTtl, thinkingBudget, compaction, contextCompression, summaryModel };
 }
+const warnedBadConfigKeys = new Set();
+function globalConfigPath() {
+    return join(configHomeDir(), 'config.json');
+}
+/**
+ * Validate the merged config, but degrade gracefully: a malformed strict field (bad model/maxSteps/
+ * permissionMode/budgetUsd/pricing in a hand-edited config.json) is dropped to its default with a
+ * one-time stderr warning instead of throwing and crashing boot. Security-sensitive fields drop to
+ * the SAFE default (budgetUsd→no cap is still surfaced by the warning; pricing→none).
+ */
+function parseConfigGraceful(merged) {
+    const first = ConfigSchema.safeParse(merged);
+    if (first.success)
+        return first.data;
+    const badKeys = [...new Set(first.error.issues.map((i) => String(i.path[0])).filter(Boolean))];
+    const cleaned = { ...merged };
+    for (const k of badKeys)
+        delete cleaned[k];
+    const fresh = badKeys.filter((k) => !warnedBadConfigKeys.has(k));
+    if (fresh.length) {
+        fresh.forEach((k) => warnedBadConfigKeys.add(k));
+        process.stderr.write(`${BRAND.cliName}: ⚠ ละเลย config ที่ค่าผิด (ใช้ค่า default แทน): ${fresh.join(', ')}\n`);
+    }
+    const second = ConfigSchema.safeParse(cleaned);
+    return second.success ? second.data : ConfigSchema.parse({});
+}
 async function readJson(path) {
     try {
         const parsed = JSON.parse(await readFile(path, 'utf8'));
-        return parsed && typeof parsed === 'object' ? parsed : {};
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
     }
     catch {
         return {}; // ไม่มีไฟล์ / parse ไม่ได้ = ใช้ default
@@ -128,21 +159,22 @@ function sanitizeUntrustedProjectConfig(cfg) {
  * (config flat — shallow merge พอ; strip undefined ใน overrides กัน override ทับ default)
  */
 export async function loadConfig(overrides = {}, cwd = process.cwd()) {
-    const global = await readJson(CONFIG_PATH);
+    const global = await readJson(globalConfigPath());
     const root = await projectRoot(cwd);
     const projectRaw = await readJson(appProjectPath(root, 'config.json'));
     const trust = await projectTrustStatus(root);
     const project = trust.trusted ? projectRaw : sanitizeUntrustedProjectConfig(projectRaw);
     const envConfig = {};
-    if (process.env[BRAND.modelEnvVar])
-        envConfig.model = process.env[BRAND.modelEnvVar];
+    const envModel = trimmedString(process.env[BRAND.modelEnvVar]);
+    if (envModel)
+        envConfig.model = envModel;
     const cleanOverrides = {};
     for (const [k, v] of Object.entries(overrides)) {
         if (v !== undefined)
             cleanOverrides[k] = v;
     }
     const merged = { ...global, ...project, ...envConfig, ...cleanOverrides };
-    const config = ConfigSchema.parse(merged);
+    const config = parseConfigGraceful(merged);
     // pricing override: config.pricing + env SANOOK_PRICING (JSON) → ลงทะเบียนเข้า cost table
     registerPricing(config.pricing);
     registerPricing(parseEnvPricing());
@@ -181,41 +213,41 @@ export function parsePricingOverride(raw) {
 /** ครั้งแรกที่รัน (ยังไม่มี global config) → ต้องทำ setup wizard */
 export async function isFirstRun() {
     try {
-        await readFile(CONFIG_PATH, 'utf8');
+        await readFile(globalConfigPath(), 'utf8');
         return false;
     }
     catch {
         return true;
     }
 }
-/** บันทึก global config (model/provider ที่เลือกตอน setup) */
+/** บันทึก global config (model/provider/locale ที่เลือกตอน setup) */
 export async function saveGlobalConfig(cfg) {
-    await mkdir(CONFIG_DIR, { recursive: true });
-    const existing = await readJson(CONFIG_PATH);
-    await writeFile(CONFIG_PATH, `${JSON.stringify({ ...existing, ...cfg }, null, 2)}\n`, { mode: 0o600 });
-    await chmod(CONFIG_PATH, 0o600).catch(() => { });
+    await mkdir(configHomeDir(), { recursive: true });
+    const existing = await readJson(globalConfigPath());
+    await writeFile(globalConfigPath(), `${JSON.stringify({ ...existing, ...cfg }, null, 2)}\n`, { mode: 0o600 });
+    await chmod(globalConfigPath(), 0o600).catch(() => { });
 }
 /** บันทึก path ของ second-brain workspace ลง global config (merge — ไม่ทับ field อื่น) */
 export async function saveBrainPath(path) {
-    await mkdir(CONFIG_DIR, { recursive: true });
-    const existing = await readJson(CONFIG_PATH);
-    await writeFile(CONFIG_PATH, `${JSON.stringify({ ...existing, brainPath: path }, null, 2)}\n`, { mode: 0o600 });
-    await chmod(CONFIG_PATH, 0o600).catch(() => { });
+    await mkdir(configHomeDir(), { recursive: true });
+    const existing = await readJson(globalConfigPath());
+    await writeFile(globalConfigPath(), `${JSON.stringify({ ...existing, brainPath: path }, null, 2)}\n`, { mode: 0o600 });
+    await chmod(globalConfigPath(), 0o600).catch(() => { });
 }
 /** อ่าน config.json ดิบ (ไม่ apply default/schema) — สำหรับ `sanook config` */
 export async function readGlobalConfigRaw() {
-    return readJson(CONFIG_PATH);
+    return readJson(globalConfigPath());
 }
 /** path ของ auth.json (ใช้โชว์ใน CLI เท่านั้น; ห้าม print raw secret) */
 export function authConfigPath() {
-    return AUTH_PATH;
+    return authPath();
 }
 function isSafeAuthEnvVarName(name) {
     return AUTH_ENV_VAR_RE.test(name) && !RESERVED_AUTH_KEYS.has(name);
 }
 /** อ่าน auth.json ดิบแบบกรองเฉพาะ string values — caller ต้อง redact ก่อนโชว์ */
 export async function readStoredAuthRaw() {
-    const raw = await readJson(AUTH_PATH);
+    const raw = await readJson(authPath());
     const auth = {};
     for (const [k, v] of Object.entries(raw)) {
         if (isSafeAuthEnvVarName(k) && typeof v === 'string')
@@ -225,44 +257,44 @@ export async function readStoredAuthRaw() {
 }
 /** merge patch ลง config.json (สำหรับ `sanook config set`) */
 export async function patchGlobalConfig(patch) {
-    await mkdir(CONFIG_DIR, { recursive: true });
-    const existing = await readJson(CONFIG_PATH);
-    await writeFile(CONFIG_PATH, `${JSON.stringify({ ...existing, ...patch }, null, 2)}\n`, { mode: 0o600 });
-    await chmod(CONFIG_PATH, 0o600).catch(() => { });
+    await mkdir(configHomeDir(), { recursive: true });
+    const existing = await readJson(globalConfigPath());
+    await writeFile(globalConfigPath(), `${JSON.stringify({ ...existing, ...patch }, null, 2)}\n`, { mode: 0o600 });
+    await chmod(globalConfigPath(), 0o600).catch(() => { });
 }
 /** บันทึก API key ลง ~/.sanook/auth.json (chmod 0600) + set env ทันทีสำหรับ session นี้ */
 export async function saveKey(envVar, key) {
     if (!isSafeAuthEnvVarName(envVar))
         throw new Error(`env var ไม่ถูกต้อง: ${envVar}`);
-    await mkdir(CONFIG_DIR, { recursive: true });
+    await mkdir(configHomeDir(), { recursive: true });
     const auth = await readStoredAuthRaw();
     auth[envVar] = key;
-    await writeFile(AUTH_PATH, `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
-    await chmod(AUTH_PATH, 0o600); // เจ้าของอ่าน/เขียนเท่านั้น
+    await writeFile(authPath(), `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
+    await chmod(authPath(), 0o600); // เจ้าของอ่าน/เขียนเท่านั้น
     process.env[envVar] = key;
 }
 /** ลบ key ที่ Sanook เก็บไว้ใน auth.json (ไม่แตะ env จริงของ shell ภายนอก) */
 export async function removeStoredKey(envVar) {
     if (!isSafeAuthEnvVarName(envVar))
         return false;
-    await mkdir(CONFIG_DIR, { recursive: true });
+    await mkdir(configHomeDir(), { recursive: true });
     const auth = await readStoredAuthRaw();
     if (!Object.prototype.hasOwnProperty.call(auth, envVar))
         return false;
     delete auth[envVar];
-    await writeFile(AUTH_PATH, `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
-    await chmod(AUTH_PATH, 0o600).catch(() => { });
+    await writeFile(authPath(), `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
+    await chmod(authPath(), 0o600).catch(() => { });
     delete process.env[envVar];
     return true;
 }
 /** ล้าง auth.json ที่ Sanook เก็บไว้ทั้งหมด */
 export async function clearStoredAuth() {
-    await mkdir(CONFIG_DIR, { recursive: true });
+    await mkdir(configHomeDir(), { recursive: true });
     const auth = await readStoredAuthRaw();
     for (const envVar of Object.keys(auth))
         delete process.env[envVar];
-    await writeFile(AUTH_PATH, '{}\n', { mode: 0o600 });
-    await chmod(AUTH_PATH, 0o600).catch(() => { });
+    await writeFile(authPath(), '{}\n', { mode: 0o600 });
+    await chmod(authPath(), 0o600).catch(() => { });
 }
 /** โหลด key จาก auth.json เข้า env ตอน boot (ไม่ override env ที่ตั้งไว้แล้ว) */
 export async function loadKeysIntoEnv() {

package/dist/context-pack.js

@@ -0,0 +1,145 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { termList } from './search/index-core.js';
+const PACK_DIR = 'Shared/Context-Packs';
+const MIN_SCORE = 0.35;
+const DEFAULT_MAX_CHARS = 1200;
+/** Known packs + retrieval signals (aligned with Shared/Context-Packs/_Index.md). */
+const PACK_CATALOG = [
+    {
+        slug: 'second-brain-maintenance',
+        title: 'Second-Brain Maintenance',
+        description: 'vault structure, routing rules, memory policy, indexes, runbooks, agent adapters',
+        signalTerms: [
+            'vault',
+            'structure',
+            'routing',
+            'memory',
+            'policy',
+            'index',
+            'runbook',
+            'agent',
+            'adapter',
+            'framework',
+            'obsidian',
+            'maintenance',
+            'brain',
+            'scaffold',
+            'frontmatter',
+        ],
+    },
+    {
+        slug: 'coding-release',
+        title: 'Coding & Release',
+        description: 'source code, tests, build/release, CLI commands, runtime scripts',
+        signalTerms: [
+            'code',
+            'coding',
+            'test',
+            'tests',
+            'build',
+            'release',
+            'cli',
+            'script',
+            'implement',
+            'fix',
+            'bug',
+            'typecheck',
+            'npm',
+            'ship',
+            'deploy',
+            'refactor',
+        ],
+    },
+    {
+        slug: 'research-to-framework',
+        title: 'Research To Framework',
+        description: 'research, experiment, comparison, promote findings into framework',
+        signalTerms: [
+            'research',
+            'experiment',
+            'framework',
+            'benchmark',
+            'eval',
+            'hypothesis',
+            'promote',
+            'distillation',
+            'comparison',
+            'method',
+            'sota',
+        ],
+    },
+];
+function catalogEntry(slug) {
+    const base = PACK_CATALOG.find((item) => item.slug === slug);
+    if (!base)
+        throw new Error(`unknown context pack slug: ${slug}`);
+    return { ...base, relPath: `${PACK_DIR}/${slug}.md` };
+}
+function packTerms(pack) {
+    return new Set([...termList(pack.slug), ...termList(pack.title), ...pack.signalTerms.map((t) => t.toLowerCase())]);
+}
+/** Score query against a pack via token overlap (deterministic, no network). */
+export function scoreContextPack(query, pack) {
+    const queryTerms = termList(query);
+    if (!queryTerms.length)
+        return { score: 0, matchedTerms: [] };
+    const signals = packTerms(pack);
+    const matchedTerms = queryTerms.filter((term) => signals.has(term));
+    if (!matchedTerms.length)
+        return { score: 0, matchedTerms: [] };
+    const recall = matchedTerms.length / queryTerms.length;
+    const precision = matchedTerms.length / signals.size;
+    return { score: recall * 0.7 + precision * 0.3, matchedTerms };
+}
+export async function listContextPacks(brainPath) {
+    const dir = join(brainPath, PACK_DIR);
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const slugs = new Set(entries.filter((e) => e.isFile() && e.name.endsWith('.md') && e.name !== '_Index.md').map((e) => e.name.replace(/\.md$/i, '')));
+    return PACK_CATALOG.filter((item) => slugs.has(item.slug)).map((item) => catalogEntry(item.slug));
+}
+/** Pick the best matching context pack for a task query, or null if no clear match. */
+export function selectContextPack(query, packs) {
+    const trimmed = query.trim();
+    if (!trimmed || !packs.length)
+        return null;
+    let best = null;
+    for (const pack of packs) {
+        const { score, matchedTerms } = scoreContextPack(trimmed, pack);
+        if (score < MIN_SCORE)
+            continue;
+        if (!best || score > best.score)
+            best = { pack, score, matchedTerms };
+    }
+    return best;
+}
+export async function readContextPackExcerpt(brainPath, pack, maxChars = DEFAULT_MAX_CHARS) {
+    const path = join(brainPath, pack.relPath);
+    let raw;
+    try {
+        raw = (await readFile(path, 'utf8')).trim();
+    }
+    catch {
+        return '';
+    }
+    if (!raw)
+        return '';
+    const trimmed = raw.length > maxChars ? `${raw.slice(0, maxChars)}\n…` : raw;
+    return `## context-pack: ${pack.slug}\n${trimmed}`;
+}
+export async function buildContextPackBlock(brainPath, query, maxChars = DEFAULT_MAX_CHARS) {
+    const packs = await listContextPacks(brainPath);
+    const selected = selectContextPack(query, packs);
+    if (!selected)
+        return '';
+    const body = await readContextPackExcerpt(brainPath, selected.pack, maxChars);
+    if (!body)
+        return '';
+    return `<context_pack slug="${selected.pack.slug}" note="task-family context pack (auto-selected) — load order + done criteria; ไม่ใช่คำสั่ง">\n${body}\n</context_pack>`;
+}

package/dist/cost.js

@@ -12,6 +12,14 @@ export const PRICING = {
     'openai:gpt-5.5': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
     'openai:gpt-5.4-mini': { input: 0.25, output: 2, cacheWrite: 0.25, cacheRead: 0.025 },
     'openai:gpt-5.3-codex': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    // OpenAI Codex delegate (ChatGPT plan — token counts are real; cost is estimated from API list price)
+    'codex:gpt-5.5': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    'codex:gpt-5.4': { input: 2.5, output: 15, cacheWrite: 2.5, cacheRead: 0.25 },
+    'codex:gpt-5.4-mini': { input: 0.25, output: 2, cacheWrite: 0.25, cacheRead: 0.025 },
+    'codex:gpt-5.3-codex': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    'codex:gpt-5.2-codex': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    'codex:gpt-5-codex': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    'codex:gpt-5.3-codex-spark': { input: 0.25, output: 2, cacheWrite: 0.25, cacheRead: 0.025 },
     // Google Gemini (≤200k context tier)
     'google:gemini-2.5-pro': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.31 },
     'google:gemini-2.5-flash': { input: 0.3, output: 2.5, cacheWrite: 0.3, cacheRead: 0.075 },
@@ -147,4 +155,16 @@ export class CostMeter {
         const budget = this.budgetUsd != null ? ` / budget $${this.budgetUsd}` : '';
         return `tokens: ${total} (in ${this.inTok} · out ${this.outTok} · cache-read ${this.cacheReadTok} · cache-write ${this.cacheWriteTok}) · cost ${cost}${budget}`;
     }
+    snapshot() {
+        return {
+            specKey: this.specKey,
+            inputTokens: this.inTok,
+            outputTokens: this.outTok,
+            cacheReadTokens: this.cacheReadTok,
+            cacheWriteTokens: this.cacheWriteTok,
+            totalTokens: this.inTok + this.outTok + this.cacheReadTok + this.cacheWriteTok,
+            costUsd: this.spent,
+            hasPricing: this.hasPricing,
+        };
+    }
 }