sanook-cli 0.4.0 → 0.5.0

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.0",
   "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"
   ],

package/scripts/postinstall.mjs

@@ -0,0 +1,33 @@
+// postinstall — ชี้ทางให้ผู้ใช้พิมพ์คำสั่งที่ "ใช้ได้จริง" ทันทีหลัง `npm i`
+// ปัญหาที่แก้: `npm i sanook-cli` (ไม่มี -g) = ลง local ไม่เข้า PATH → พิมพ์ `sanook` แล้วไม่เจอ
+// กฎเหล็ก: ห้าม postinstall ทำให้การติดตั้งล้มเหลว (ครอบ try/catch, ออก 0 เสมอ)
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+try {
+  const isGlobal = process.env.npm_config_global === 'true';
+  const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+  const initCwd = process.env.INIT_CWD ? resolve(process.env.INIT_CWD) : '';
+
+  // เงียบเมื่อ: dev ในรีโปตัวเอง (INIT_CWD === pkgRoot) หรือ CI (กัน log รก)
+  const selfInstall = initCwd && initCwd === pkgRoot;
+  if (selfInstall || (process.env.CI && !isGlobal)) process.exit(0);
+
+  const tty = process.stdout.isTTY;
+  const paint = (code, s) => (tty ? `\x1b[${code}m${s}\x1b[0m` : s);
+  const cyan = (s) => paint('36', s);
+  const dim = (s) => paint('2', s);
+  const bold = (s) => paint('1', s);
+
+  if (isGlobal) {
+    console.log(`\n${bold('✅ sanook-cli พร้อมใช้')} — พิมพ์ ${cyan('sanook')} เพื่อเริ่ม`);
+    console.log(dim('   ยังพิมพ์ "sanook" ไม่เจอ? ปิด-เปิด terminal ใหม่ · ตรวจ: ') + cyan('npx sanook doctor') + '\n');
+  } else {
+    console.log(`\n${bold('sanook-cli ลงแบบ local แล้ว')} — คำสั่ง ${cyan('sanook')} ยัง${bold('ไม่')}อยู่ใน PATH`);
+    console.log(`  ${dim('• รันเลยตอนนี้:')}            ${cyan('npx sanook')}`);
+    console.log(`  ${dim('• ลงให้พิมพ์ sanook ตรงๆ:')}  ${cyan('npm install -g sanook-cli')}`);
+    console.log(`  ${dim('• ตรวจ/แก้ PATH:')}           ${cyan('npx sanook doctor')}\n`);
+  }
+} catch {
+  // ห้ามทำให้ install ล้ม — เงียบไว้
+}

package/second-brain/.agents/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, -agents]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+---
+
+# .agents
+
+> agent-specific assets (skills/workflows) ของ vault นี้
+
+## ใส่ที่นี่
+skill + workflow guide ที่ agent ใช้
+
+## ไม่ใส่ที่นี่
+โน้ตงาน (→ปลายทางปกติ)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[.agents/_Index]]"` และท้ายไฟล์ `up:: [[.agents/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Home]]

package/second-brain/.agents/skills/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, skills]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[.agents/_Index]]"
+---
+
+# skills
+
+> skill folders (SKILL.md) ที่ agent โหลด on-demand
+
+## ใส่ที่นี่
+SKILL.md ต่อ skill
+
+## ไม่ใส่ที่นี่
+prose how-to (→Runbooks)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[.agents/skills/_Index]]"` และท้ายไฟล์ `up:: [[.agents/skills/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[.agents/_Index]]

package/second-brain/.agents/workflows/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, workflows]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[.agents/_Index]]"
+---
+
+# workflows
+
+> workflow guide (multi-step orchestration)
+
+## ใส่ที่นี่
+workflow ที่ทำซ้ำได้
+
+## ไม่ใส่ที่นี่
+one-off task
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[.agents/workflows/_Index]]"` และท้ายไฟล์ `up:: [[.agents/workflows/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[.agents/_Index]]

package/second-brain/AGENTS.md

@@ -7,10 +7,10 @@
 
 ## 🔴 Red Lines
 1. อ่าน `Shared/AI-Context-Index.md` ก่อนตอบ (vault = source of truth)
-2. verify ก่อนอ้าง ไม่แน่ใจบอกตรงๆ ห้ามแต่ง
-3. ถามก่อนรัน destructive (`rm -rf` / `reset --hard` / `push --force` / drop data)
-4. ห้ามเขียน secret ลงไฟล์ → `<secret:VAR>`
-5. ห้ามลบ durable note โดยไม่ถาม
+2. ก่อนสร้าง/ย้ายโน้ต อ่าน `Vault Structure Map.md` + `_Index.md` ของโฟลเดอร์ปลายทาง แล้วทำตาม AI Routing Contract
+3. verify ก่อนอ้าง ไม่แน่ใจบอกตรงๆ ห้ามแต่ง
+4. ถามก่อนรัน destructive (`rm -rf` / `reset --hard` / `push --force` / drop data)
+5. ห้ามเขียน secret ลงไฟล์ → `<secret:VAR>` · ห้ามลบ durable note โดยไม่ถาม
 
 ## Multi-agent
 หลาย agent ทำงาน vault เดียว → อ่าน `Shared/Coordination/` ก่อนแตะ · เขียน session log หลังทำ (§2 ใน `CLAUDE.md`)

package/second-brain/Acceptance/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, acceptance]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+---
+
+# Acceptance
+
+> golden input→expected-output fixtures
+
+## ใส่ที่นี่
+case ที่ใช้ตัดสิน done/not-done
+
+## ไม่ใส่ที่นี่
+gate ticklist (→Checklists) · runner (→Evals)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Acceptance/_Index]]"` และท้ายไฟล์ `up:: [[Acceptance/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Home]]

package/second-brain/Acceptance/golden-case-template.md

@@ -0,0 +1,39 @@
+---
+tags: [template, acceptance, golden-case]
+note_type: template
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Acceptance/_Index]]"
+---
+
+# Golden Case Template
+
+> ใช้สร้าง fixture ที่บอก input→expected output เพื่อพิสูจน์ว่า behavior ใดถือว่า done; ไม่ใช้เป็น checklist หรือ eval report
+
+## Task Family
+
+_(What behavior this case evaluates.)_
+
+## Input
+
+```text
+<input>
+```
+
+## Expected Output
+
+```text
+<expected>
+```
+
+## Pass Criteria
+
+- [ ] Correct result
+- [ ] No forbidden side effects
+- [ ] Matches owner-facing tone/format
+
+## Notes
+
+_(Known edge cases, source links, or fixture paths.)_
+
+up:: [[Acceptance/_Index]]

package/second-brain/Areas/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, areas]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+---
+
+# Areas
+
+> PARA — โดเมนงานต่อเนื่องที่ไม่มีวันจบ
+
+## ใส่ที่นี่
+brand/trading/content/products ฯลฯ
+
+## ไม่ใส่ที่นี่
+งานที่มีวันจบ (→Projects/Goals)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Areas/_Index]]"` และท้ายไฟล์ `up:: [[Areas/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Home]]

package/second-brain/Bugs/System-OS/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, system-os]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Bugs/_Index]]"
+---
+
+# System-OS
+
+> bug report ระดับระบบ/OS/toolchain ที่ไม่ผูกกับ project เดียว
+
+## ใส่ที่นี่
+OS, shell, package manager, permission, filesystem, or app-runtime bugs
+
+## ไม่ใส่ที่นี่
+bug ของ project เฉพาะ (→Bugs หรือ Projects/<proj>/Bugs)
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Bugs/System-OS/_Index]]"` และท้ายไฟล์ `up:: [[Bugs/System-OS/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Bugs/_Index]]

package/second-brain/Bugs/_Index.md

@@ -0,0 +1,30 @@
+---
+tags: [index, moc, bugs]
+note_type: moc
+created: {{DATE}}
+updated: {{DATE}}
+parent: "[[Home]]"
+---
+
+# Bugs
+
+> bug report reproducible ลงวันที่ ไม่ลบ
+
+## ใส่ที่นี่
+bug report (global flat) + link กลับ project · system/OS → Bugs/System-OS/
+
+## ไม่ใส่ที่นี่
+bug ที่ reproduce ไม่ได้
+
+## AI Routing Contract
+
+- ก่อนเขียน: เช็กว่าเนื้อหาตรง "ใส่ที่นี่" และไม่เข้า "ไม่ใส่ที่นี่"; ถ้าก้ำกึ่งอ่าน [[Vault Structure Map]] ก่อน
+- ก่อนสร้างไฟล์ใหม่: ค้นหาโน้ตเดิมในโฟลเดอร์นี้และโฟลเดอร์ใกล้เคียงก่อน เพื่อ merge/update แทน append ซ้ำ
+- เมื่อสร้างโน้ตในโฟลเดอร์นี้: ตั้ง `parent: "[[Bugs/_Index]]"` และท้ายไฟล์ `up:: [[Bugs/_Index]]`
+- หลังเขียน: เชื่อม link ไป source/project/session/decision ที่เกี่ยวข้อง และอัปเดต hub/index ถ้าโน้ตนี้ควรถูกค้นเจอในอนาคต
+
+> รายละเอียดทุกโฟลเดอร์ + decision rules → [[Vault Structure Map]]
+
+_(ยังว่าง — โน้ตในโฟลเดอร์นี้จะถูกลิงก์ที่นี่)_
+
+up:: [[Home]]