neurain 0.1.0-alpha.1 → 0.1.0-alpha.3

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 ## Unreleased
 
+- No unreleased changes recorded.
+
+## 0.1.0-alpha.3
+
+- Destination resolver (`resolve_target.mjs`): `capture` and `compile` now derive one canonical target path from area, write intent, and sensitivity instead of leaving placement to the caller. Private, multi-area, and decision-required items still gate on the `<N>건 저장 진행` confirmation and are never auto-filed.
+
+- Janitor (`neurain tidy`): read-only detection of provably-junk residue only (empty Obsidian `Untitled*.canvas/.base`, zero-byte daily notes, stray empty top-level directories); quarantine is recoverable (30-day trash). Registered areas, archives, and structural directories are never touched.
+- Auto-filer (`neurain file`): finds loose durable markdown outside any canonical home and, gated by confirmation, relocates it recoverably and secret-gated; also surfaces read-only `raw/_inbox` routing proposals. Registered area roots and root-contract files are excluded.
+- Structure audit (`neurain structure-audit`): advisory flags for area-adapter gaps, the `output/` vs `outputs/` split, and `sources_map` drift; composed into `lint`. Never writes and never fails a build.
+- New-user organize (`neurain organize`): turns an unknown folder into a searchable area. Reuses the adopt scan, decides a per-file disposition, and on a gated apply scaffolds the area in copy mode (originals are never moved or deleted) and reindexes; hash-keyed receipt with `--rollback`. Secrets and already-structured KBs are protected.
+- Organize and adopt preserve non-ASCII (for example Korean) folder names as area slugs.
+
+## 0.1.0-alpha.2
+
+- Documentation currency gate: README and development-status version strings are asserted against package.json in readiness; volatile metric snapshots de-hardcoded (verified green in CI, not pinned in docs).
+
+
+## 0.1.0-alpha.1
+
+- Capture: file/asset capture + R2/R4/R6 enrichment (overlap candidates, numeric conflicts, sha256 duplicate detection) ported to the engine.
+- Memory-write: completed the generic ledger-primitive set (appendLine/enqueue/setQueueStatus/appendBlock/writeFileGuarded) so a consumer can forward every fact/task primitive to the engine.
+- Release automation: tag-triggered npm publish via Trusted Publishing (OIDC), a push-CI gate (fast readiness + `npm publish --dry-run`), and a prerelease-never-`latest` dist-tag guard.
 - Expanded the recall markdown corpus to the general area knowledge class (`10_areas/<area>/**`, hubs, area registry), with config-extensible include/exclude (`recall.include`/`recall.exclude`).
 - Added label-based privacy gating (`labels.mjs`): per-file frontmatter `sensitivity`, area baseline from `_area.md`, and boundary-aware path markers exclude private content at index time. Fixes a substring marker that could exclude a whole legitimate folder.
 - Added a routed lexical recall branch (`recall_lexical.mjs`): BM25 + structural/layer/entity/domain/fact-ledger boosts, unioned ahead of exact-token and semantic in hybrid search. Auto-enabled when a search index registry has areas or `--area` is set; off by default on a bare vault.

package/README.md

@@ -126,7 +126,7 @@ The canonical product development snapshot is maintained in:
 - `docs/development-status.en.md`
 - `docs/development-status.kr.md`
 
-As of 2026-06-09 KST, the package is a publish-ready alpha for private beta or alpha user tests. It is not public SaaS GA. The current verified gates are `npm test` 37/37, `node scripts/readiness.mjs --json` score 100, and `npm run readiness -- --json` score 100.
+The package is a publish-ready alpha for private beta or alpha user tests, not public SaaS GA. All gates (`npm test`, the readiness leakage/secret/pack/tarball-install checks, and `npm audit`) run green in CI on every release — see `.github/workflows/release.yml`. The live score is `node scripts/readiness.mjs --json`.
 
 Watch reports are also read-only. They do not start a daemon and do not write durable knowledge. They observe recent text files, event journal entries, recap hints, and lesson candidates so a future review worker can decide what deserves attention.
 
@@ -159,7 +159,7 @@ For multi-area vaults, preview commands do not scan every area by default. Use `
 See also:
 
 - `docs/knowledge-os.en.md`
-- `docs/self-improve-90-roadmap.en.md`
+- `docs/self-improvement-90-roadmap.en.md`
 - `docs/connect-runtime.en.md`
 
 ## Existing Folder Adoption
@@ -176,6 +176,22 @@ Neurain scans first and recommends one of three modes:
 
 Writes require an explicit confirmation phrase shown by the scan.
 
+## Keeping the Vault Tidy
+
+Neurain keeps a working vault organized through read-only detection plus gated, recoverable writes. Nothing here moves or deletes a file without an explicit confirmation phrase, and registered areas, archives, and root-contract files are never touched.
+
+```bash
+npx neurain tidy ~/NeurainDemo                 # report provably-junk residue (read-only)
+npx neurain structure-audit ~/NeurainDemo      # advisory structure flags (read-only)
+npx neurain file ~/NeurainDemo                 # propose homes for loose docs (read-only)
+npx neurain organize ~/SomeUnknownFolder --dry-run   # turn an unknown folder into a searchable area
+```
+
+- `tidy` detects only provably-junk residue (empty Obsidian `Untitled*` canvas/base files, zero-byte daily notes, stray empty top-level directories) and quarantines recoverably.
+- `structure-audit` is advisory only: it flags area-adapter gaps, the `output/` vs `outputs/` split, and `sources_map` drift, and never fails a build.
+- `file` relocates loose durable markdown into its canonical home behind a confirmation gate, and surfaces `raw/_inbox` routing proposals.
+- `organize` turns an unknown folder into a searchable area in copy mode (originals are never moved or deleted), with a hash-keyed receipt and `--rollback`. Secrets and already-structured knowledge bases are protected.
+
 ## MCP
 
 The alpha MCP server is stdio-only:
@@ -188,7 +204,7 @@ It exposes read/capture/scan/preview tools only. It does not silently compile, p
 
 ## Status
 
-This is `0.1.0-alpha.0`. It is not a public SaaS GA release. The alpha exists to prove installability, local-first onboarding, Codex, Claude, Gemini, and Runtime connectivity, plus safety receipts.
+This is `0.1.0-alpha.3`. It is not a public SaaS GA release. The alpha exists to prove installability, local-first onboarding, Codex, Claude, Gemini, and Runtime connectivity, plus safety receipts.
 
 Alpha publish command:
 

package/docs/connect-runtime.en.md

@@ -45,7 +45,7 @@ Safety boundary:
 - Durable Neurain writes still require explicit CLI confirmation.
 - The alpha snippet does not support paths containing newline or control bytes.
 - Scheduler access is read-only and cannot install background jobs or start daemons.
-- Scheduler eval access is read-only and checks trigger precision, trigger recall, no-recursion, private-boundary handling, case-file size limits, and target-root non-write snapshots.
+- Scheduler eval access is read-only and checks trigger precision, trigger recall, no-recursion, private-boundary handling, case-file size limits, temp cleanup, and target-root non-write snapshots.
 - Lifecycle access is read-only through MCP. The runtime can inspect session lineage, while deeper lifecycle event emission uses the separate host-proxy contract below.
 
 ## Lifecycle Boundary

package/docs/connect-runtime.kr.md

@@ -45,7 +45,7 @@ Safety boundary:
 - Durable Neurain write는 여전히 explicit CLI confirmation이 필요합니다.
 - Alpha snippet은 newline 또는 control byte가 포함된 path를 지원하지 않습니다.
 - Scheduler access는 read-only이며 background job을 설치하거나 daemon을 시작할 수 없습니다.
-- Scheduler eval access도 read-only이며 trigger precision, trigger recall, no-recursion, private-boundary handling, case-file size limit, target-root non-write snapshot을 확인합니다.
+- Scheduler eval access도 read-only이며 trigger precision, trigger recall, no-recursion, private-boundary handling, case-file size limit, temp cleanup, target-root non-write snapshot을 확인합니다.
 - Lifecycle access는 MCP에서 read-only입니다. Runtime은 session lineage를 읽을 수 있고, 더 깊은 lifecycle event emission은 아래 host-proxy contract를 사용합니다.
 
 ## Lifecycle Boundary

package/docs/development-status.en.md

@@ -1,9 +1,9 @@
 # Development Status
 
 Version: v0.1
-Last updated: 2026-06-09 KST
-Package: `neurain@0.1.0-alpha.0`
-Latest documented commit: `3496262 Add E24 onboarding and Gemini MCP connector`
+Last updated: 2026-06-19 KST
+Package: `neurain@0.1.0-alpha.3`
+Latest documented commit: `f3d3849 docs: document auto-organization wave (E27) for alpha.3`
 
 This document is the canonical product development snapshot for the public package. It tracks what is shipped, what has evidence, and what must not be claimed yet.
 
@@ -11,16 +11,9 @@ This document is the canonical product development snapshot for the public packa
 
 Neurain is a publish-ready alpha CLI and MCP package. It is ready for private beta or alpha user tests, not public SaaS GA.
 
-Current verified score:
+Current verification: every gate runs green in CI on each release — `npm test`, the full `npm run readiness` suite (leakage/secret scan, `npm audit`, `npm pack --dry-run`, and a temporary tarball-install smoke), and `node scripts/readiness.mjs --json` for the live score. See `.github/workflows/release.yml`.
 
-| Gate | Result |
-|---|---:|
-| `npm test` | 37/37 pass |
-| `node scripts/readiness.mjs --json` | `ok:true`, score `100`, 35 checks |
-| `npm run readiness -- --json` | `ok:true`, score `100` |
-| `npm audit` | 0 vulnerabilities |
-| `npm pack --dry-run` | pass |
-| Temporary tarball install smoke | pass |
+Volatile metrics (exact test counts, readiness scores, check counts) are intentionally NOT pinned in this document — they are verified green in CI, not hand-copied, so this snapshot cannot silently drift from the suite.
 
 ## Shipped Development
 
@@ -28,6 +21,7 @@ Current verified score:
 
 - Starter vault initialization with `neurain init`.
 - Existing folder adoption scan, apply, receipt, and rollback.
+- Unified `reindex` (register areas + per-area index refresh + recall rebuild in one pass; curated indexes are never auto-overwritten); `adopt --apply` auto-reindexes so an adopted folder is registered and searchable in one command.
 - Local doctor, search, capabilities, recap, and wrap preview.
 - Event journal add/list/verify with explicit confirmation.
 - Lesson list, candidates, eval, promotion, and rollback.
@@ -97,7 +91,7 @@ Status: shipped as publish-ready alpha.
 - README, quickstart, safety, privacy, support, pricing, troubleshooting, and release checklist exist.
 - CI workflow, issue templates, PR template, license, and security doc exist.
 - Full readiness verifies npm audit, pack dry-run, and temporary tarball install smoke.
-- Honest scope: npm publish or package name reservation still requires an explicit release action.
+- Status: npm publish is done. `neurain@0.1.0-alpha.3` is published under the `alpha` tag and the package name is secured.
 
 ### E26: Thin MCP Connector
 
@@ -110,6 +104,18 @@ Status: shipped.
 - MCP server exposes bounded alpha tools for status, search, scan, recall, eval, live-case scaffold, lesson preview, scheduler preview, lifecycle report/eval, and wrap preview.
 - MCP does not expose silent durable wiki writes, lifecycle emit, daemon run/stop, curator write, recall rebuild write, or lesson promotion.
 
+### E27: Auto-Organization System
+
+Status: shipped.
+
+- CLI: `neurain tidy`, `neurain file`, `neurain structure-audit`, `neurain organize`.
+- Destination resolver: `capture` and `compile` derive one canonical target path from area, write intent, and sensitivity. Private, multi-area, and decision-required items still gate on the `<N>건 저장 진행` confirmation and are never auto-filed.
+- Janitor (`tidy`) detects provably-junk residue only (empty Obsidian canvas/base files, zero-byte daily notes, stray empty top-level directories). Read-only; quarantine is recoverable. Registered areas, archives, and structural directories are never touched.
+- Auto-filer (`file`) relocates loose durable markdown into its canonical home behind a confirmation gate, recoverably and secret-gated, and surfaces read-only `raw/_inbox` routing proposals.
+- Structure audit (`structure-audit`) is advisory: it flags area-adapter gaps, the `output/` vs `outputs/` split, and `sources_map` drift, and composes into `lint` without ever writing or failing a build.
+- New-user organize (`organize`) turns an unknown folder into a searchable area in copy mode (originals are never moved or deleted), with a hash-keyed receipt and `--rollback`. Secrets and already-structured KBs are protected. Non-ASCII (for example Korean) folder names are preserved as area slugs.
+- Honest scope: these are vault-hygiene helpers. Detection is read-only and every relocation is gated and recoverable; Neurain does not autonomously reorganize a user's folder.
+
 ## Current Connector Truth Table
 
 | Host | MCP connection | Lifecycle hook preview | Notes |
@@ -125,7 +131,6 @@ Status: shipped.
 - Non-developer GUI.
 - Hosted control plane.
 - Public Trust Center and status page.
-- npm publish or package name reservation.
 - Public GitHub publication if the repo is intentionally kept private during beta.
 
 ## Documentation Maintenance Rule

package/docs/development-status.kr.md

@@ -1,9 +1,9 @@
 # 개발 진행 상태
 
 Version: v0.1
-Last updated: 2026-06-09 KST
-Package: `neurain@0.1.0-alpha.0`
-Latest documented commit: `3496262 Add E24 onboarding and Gemini MCP connector`
+Last updated: 2026-06-19 KST
+Package: `neurain@0.1.0-alpha.3`
+Latest documented commit: `f3d3849 docs: document auto-organization wave (E27) for alpha.3`
 
 이 문서는 public package 기준의 canonical 개발 상태 스냅샷입니다. 무엇이 shipped인지, 어떤 증거가 있는지, 아직 주장하면 안 되는 것이 무엇인지 함께 기록합니다.
 
@@ -11,16 +11,9 @@ Latest documented commit: `3496262 Add E24 onboarding and Gemini MCP connector`
 
 Neurain은 publish-ready alpha CLI 및 MCP package입니다. private beta 또는 alpha user test에는 들어갈 수 있지만 public SaaS GA는 아닙니다.
 
-현재 검증된 상태:
+현재 검증: 매 릴리스마다 모든 게이트가 CI에서 green으로 통과합니다 — `npm test`, 전체 `npm run readiness`(leakage/secret 스캔, `npm audit`, `npm pack --dry-run`, 임시 tarball-install smoke), 라이브 점수는 `node scripts/readiness.mjs --json`. `.github/workflows/release.yml` 참조.
 
-| Gate | Result |
-|---|---:|
-| `npm test` | 37/37 pass |
-| `node scripts/readiness.mjs --json` | `ok:true`, score `100`, 35 checks |
-| `npm run readiness -- --json` | `ok:true`, score `100` |
-| `npm audit` | 0 vulnerabilities |
-| `npm pack --dry-run` | pass |
-| Temporary tarball install smoke | pass |
+휘발성 지표(정확한 테스트 수·readiness 점수·check 수)는 의도적으로 이 문서에 박지 않습니다 — CI에서 green으로 검증되며 손으로 복사하지 않으므로, 이 스냅샷이 suite와 조용히 어긋나지 않습니다.
 
 ## shipped 개발 범위
 
@@ -28,6 +21,7 @@ Neurain은 publish-ready alpha CLI 및 MCP package입니다. private beta 또는
 
 - `neurain init` starter vault initialization.
 - 기존 폴더 adoption scan, apply, receipt, rollback.
+- 통합 `reindex`(영역 등록 + per-area 색인 새로고침 + recall rebuild를 한 번에; 큐레이티드 색인은 자동 덮어쓰기 안 함); `adopt --apply`가 자동 reindex하여 채택한 폴더가 한 명령으로 등록·검색 가능.
 - local doctor, search, capabilities, recap, wrap preview.
 - 명시적 confirmation이 필요한 event journal add/list/verify.
 - lesson list, candidates, eval, promotion, rollback.
@@ -97,7 +91,7 @@ Status: publish-ready alpha로 shipped.
 - README, quickstart, safety, privacy, support, pricing, troubleshooting, release checklist가 존재합니다.
 - CI workflow, issue template, PR template, license, security doc이 존재합니다.
 - full readiness가 npm audit, pack dry-run, temporary tarball install smoke를 검증합니다.
-- 정직한 범위: npm publish 또는 package name reservation은 별도 release action이 필요합니다.
+- 상태: npm publish 완료. `neurain@0.1.0-alpha.3`가 `alpha` 태그로 발행됐고 패키지 이름도 선점됨.
 
 ### E26: Thin MCP Connector
 
@@ -110,6 +104,18 @@ Status: shipped.
 - MCP server는 status, search, scan, recall, eval, live-case scaffold, lesson preview, scheduler preview, lifecycle report/eval, wrap preview용 bounded alpha tool을 노출합니다.
 - MCP는 silent durable wiki write, lifecycle emit, daemon run/stop, curator write, recall rebuild write, lesson promotion을 노출하지 않습니다.
 
+### E27: 자동 정리 시스템
+
+Status: shipped.
+
+- CLI: `neurain tidy`, `neurain file`, `neurain structure-audit`, `neurain organize`.
+- 목적지 리졸버: `capture`·`compile`이 영역·쓰기의도·민감도로부터 단일 canonical 목적지 경로를 도출합니다. private·다중영역·결정필요 항목은 여전히 `<N>건 저장 진행` 확인을 거치며 절대 자동 파일링되지 않습니다.
+- Janitor(`tidy`)는 증명 가능한 잔여물만 탐지합니다(빈 Obsidian canvas/base 파일, 0바이트 데일리노트, 빈 최상위 디렉터리). 읽기전용이고 격리는 복구 가능하며, 등록된 영역·아카이브·구조 디렉터리는 건드리지 않습니다.
+- Auto-filer(`file`)는 떠도는 durable 마크다운을 확인 게이트 뒤에서 복구 가능·시크릿 게이트로 canonical 위치로 옮기고, `raw/_inbox` 라우팅 제안을 읽기전용으로 보여줍니다.
+- 구조 점검(`structure-audit`)은 권고용입니다: 영역 어댑터 결손, `output/` 대 `outputs/` 분리, `sources_map` 드리프트를 표시하고 `lint`에 합성되며, 쓰기나 빌드 실패를 일으키지 않습니다.
+- 신규 사용자 organize(`organize`)는 미지의 폴더를 검색 가능한 영역으로 COPY 모드로 전환합니다(원본은 절대 이동·삭제 안 함). 해시 키 receipt + `--rollback`. 시크릿과 이미 구조화된 KB는 보호됩니다. 비ASCII(예: 한글) 폴더명은 영역 슬러그로 보존됩니다.
+- 정직한 범위: 이들은 vault 위생 도구입니다. 탐지는 읽기전용이고 모든 재배치는 게이트·복구 가능하며, Neurain이 사용자 폴더를 자율적으로 재편하지 않습니다.
+
 ## 현재 connector truth table
 
 | Host | MCP connection | Lifecycle hook preview | Notes |
@@ -125,7 +131,6 @@ Status: shipped.
 - non-developer GUI.
 - hosted control plane.
 - public Trust Center 및 status page.
-- npm publish 또는 package name reservation.
 - beta 동안 repo를 private으로 유지한다면 public GitHub publication.
 
 ## 문서 유지관리 규칙

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neurain",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "Local-first Neurain Knowledge OS CLI and MCP connector.",
   "type": "module",
   "license": "Apache-2.0",
@@ -27,7 +27,10 @@
   "scripts": {
     "test": "node --test",
     "pack:dry-run": "npm pack --dry-run",
-    "readiness": "node scripts/readiness.mjs --full"
+    "readiness": "node scripts/readiness.mjs --full",
+    "docs:check": "node scripts/sync-docs.mjs --check",
+    "docs:fix": "node scripts/sync-docs.mjs --write",
+    "version": "node scripts/sync-docs.mjs --write && git add -u README.md CHANGELOG.md docs/development-status.en.md docs/development-status.kr.md"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.5"

package/src/cli.mjs

@@ -36,7 +36,12 @@ import { labelCommand } from './core/label.mjs';
 import { orphansCommand } from './core/orphans.mjs';
 import { hubsCommand } from './core/hubs.mjs';
 import { areaIndexCommand } from './core/area_index.mjs';
+import { reindexCommand } from './core/reindex.mjs';
 import { lintCommand } from './core/lint.mjs';
+import { tidyCommand } from './core/tidy.mjs';
+import { structureAuditCommand } from './core/structure_audit.mjs';
+import { fileCommand } from './core/file_loose.mjs';
+import { organizeCommand } from './core/organize.mjs';
 import { sessionPulseCommand } from './core/session_pulse.mjs';
 import { syncCommand } from './core/sync.mjs';
 import { healthCommand } from './core/health.mjs';
@@ -81,6 +86,7 @@ export async function runCli(argv) {
   if (command === 'curator') return render(await curatorCommand(args));
   if (command === 'daemon') return render(await daemonCommand(args));
   if (command === 'recall') return render(await recallCommand(args));
+  if (command === 'reindex') return render(await reindexCommand(args));
   if (command === 'status') return render(await statusCommand(args));
   if (command === 'digest') return render(await digestCommand(args));
   if (command === 'queue') return render(await queueCommand(args));
@@ -103,6 +109,10 @@ export async function runCli(argv) {
   if (command === 'hubs') return render(await hubsCommand(args));
   if (command === 'area-index') return render(await areaIndexCommand(args));
   if (command === 'lint') return render(await lintCommand(args));
+  if (command === 'tidy') return render(await tidyCommand(args));
+  if (command === 'structure-audit') return render(await structureAuditCommand(args));
+  if (command === 'file') return render(await fileCommand(args));
+  if (command === 'organize') return render(await organizeCommand(args));
   if (command === 'session-pulse') return render(await sessionPulseCommand(args));
   if (command === 'sync') return render(await syncCommand(args));
   if (command === 'health') return render(await healthCommand(args));
@@ -180,8 +190,11 @@ function helpText() {
 Usage:
   neurain init <folder> [--area general] [--lang ko|en] [--dry-run]
   neurain onboard <folder> [--lang ko|en] [--host codex|claude|gemini|runtime] [--json]
-  neurain adopt <folder> [--dry-run] [--apply --confirm "<N>건 저장 진행"]
+  neurain adopt <folder> [--dry-run] [--apply --confirm "<N>건 저장 진행"] [--no-reindex]
   neurain adopt --rollback <receipt> [--root <folder>]
+  neurain organize <folder> [--apply --confirm "<N>건 저장 진행"] [--allow-secret] [--no-reindex] [--json]
+  neurain organize --rollback <receipt> --root <folder> [--json]
+  neurain reindex <folder> [--dry-run] [--json]
   neurain doctor <folder> [--json]
   neurain search <folder> <query> [--top 10] [--json]
   neurain journal list <folder> [--type type] [--top 20] [--json]
@@ -237,6 +250,9 @@ Usage:
   neurain hubs <folder> [--check | --apply] [--area name] [--json]
   neurain area-index <folder> [--build area | --refresh area | --register-curated area [--sensitivity private] | --detect [--fix] [--restamp-curated]] [--force] [--dry-run] [--json]
   neurain lint <folder> [--json]
+  neurain tidy <folder> [--json]
+  neurain structure-audit <folder> [--json]
+  neurain file <folder> [--apply --confirm "<N>건 저장 진행"] [--allow-secret] [--json]
   neurain session-pulse <folder> --session-id id --summary "..." [--focus t] [--next t] [--max-notes 8] [--no-area-brief] [--queue ...] [--now ts] [--dry-run] [--allow-secret] [--json]
   neurain sync <folder> --session-id id [--summary "..."] [--level light|standard|full] [--no-pulse] [--no-area-brief] [--queue ...] [--now ts] [--dry-run] [--json]
   neurain health <folder> [--fix] [--now ts] [--json]

package/src/core/adopt.mjs

@@ -1,8 +1,10 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { absPath, compactStamp, ensureDir, exists, generatedPath, isTextFile, relPath, safeResolve, sha256, slug, timestamp, writeFileNoOverwrite } from './fs.mjs';
+import { absPath, compactStamp, ensureDir, exists, generatedPath, isTextFile, relPath, safeResolve, sha256, timestamp, writeFileNoOverwrite } from './fs.mjs';
 import { inferSensitivityFromPath, secretLike } from './safety.mjs';
+import { reindexCommand } from './reindex.mjs';
+import { slugify } from './envelope.mjs';
 
 const maxFileBytes = 20 * 1024 * 1024;
 const maxFiles = 5000;
@@ -17,6 +19,17 @@ export async function adoptCommand(args) {
       throw new Error(`Apply requires --confirm "${expected}".`);
     }
     scan.apply = applyAdoption(scan, { root: target });
+    // Once the adapters land, register the area and rebuild search in one pass so the
+    // adopted folder is immediately searchable. Best-effort: a reindex hiccup must
+    // never fail the adoption itself, and --no-reindex opts out.
+    if (scan.apply?.ok && !args['no-reindex']) {
+      try {
+        const r = await reindexCommand({ _: [target], json: true });
+        scan.reindex = r.payload || null;
+      } catch (error) {
+        scan.reindex = { ok: false, error: String((error && error.message) || error) };
+      }
+    }
   }
   if (args.json) return { json: true, payload: scan };
   return {
@@ -32,6 +45,7 @@ export async function adoptCommand(args) {
       `- Risks: ${scan.summary.risk_count}`,
       `- Confirmation required: ${scan.confirmation_required}`,
       scan.apply ? `- Apply receipt: ${scan.apply.receipt_path}` : '',
+      scan.reindex ? `- Reindex: ${scan.reindex.ok ? 'registered + searchable' : 'skipped (' + (scan.reindex.error || 'n/a') + ')'}` : '',
     ].filter(Boolean).join('\n'),
   };
 }
@@ -106,7 +120,10 @@ export function scanAdoption(root, { dryRun = true } = {}) {
     : generatedRatio > 0.35
       ? 'hybrid'
       : 'in-place';
-  const areaSlug = slug(path.basename(root), 'adopted-area');
+  // Hangul-preserving slug so a Korean folder name (e.g. 내폴더) becomes the area
+  // name `_내폴더` instead of being stripped to the generic `_adopted-area`. Area
+  // ids flow through `[^/]+` matchers and dir-listing discovery, so non-ASCII is safe.
+  const areaSlug = slugify(path.basename(root), 'adopted-area');
   const fingerprint = sha256(Buffer.from(files.map((file) => `${file.rel}:${file.sha256}`).sort().join('\n')));
   const required = [
     `10_areas/_${areaSlug}/_area.md`,

package/src/core/area_index.mjs

@@ -130,9 +130,15 @@ function highConfidenceEntities(ctx, area, relFiles) {
     byCanonical.set(low, cur);
   }
 
+  // The recall resolver (recall_intel.resolveAreaPath) reads `source_docs` and always
+  // resolves them against `${area_root}/`, so emit AREA-relative paths under that key.
+  // Evidence outside the area (raw inbox, wiki/entities hubs) can never resolve under
+  // area_root and is hard-excluded from the recall corpus anyway, so drop it here.
+  const areaPrefix = `${ctx.areasDir}/${area}/`;
+  const toAreaRel = (rel) => (rel.startsWith(areaPrefix) ? rel.slice(areaPrefix.length) : null);
   return [...byCanonical.values()]
     .filter((e) => e.confidence === 'high' || e.count >= 2)
-    .map((e) => ({ id: `entity:${area}:${slug(e.canonical)}`, type: e.type, canonical: e.canonical, aliases: [...e.aliases], confidence: e.confidence, evidence_docs: [...e.evidence].slice(0, 5) }));
+    .map((e) => ({ id: `entity:${area}:${slug(e.canonical)}`, type: e.type, canonical: e.canonical, aliases: [...e.aliases], confidence: e.confidence, source_docs: [...e.evidence].map(toAreaRel).filter(Boolean).slice(0, 5) }));
 }
 
 function keywordsFromFolder(name) {
@@ -143,7 +149,7 @@ function domainsFromFolders(ctx, area) {
   if (!fs.existsSync(dir)) return [];
   return fs.readdirSync(dir, { withFileTypes: true })
     .filter((d) => d.isDirectory() && !/^(search-index|_trash|_archive|node_modules)/.test(d.name) && !d.name.startsWith('.'))
-    .map((d) => ({ id: `domain:${area}:${slug(d.name)}`, label: d.name, keywords: keywordsFromFolder(d.name), boost_paths: [`${ctx.areasDir}/${area}/${d.name}`] }))
+    .map((d) => ({ id: `domain:${area}:${slug(d.name)}`, label: d.name, keywords: keywordsFromFolder(d.name), boost_paths: [d.name] }))
     .filter((d) => d.keywords.length);
 }
 
@@ -154,11 +160,23 @@ function saveRegistry(ctx, reg) {
   atomicWriteJson(path.join(ctx.root, ctx.registryPath), reg);
 }
 
+function hasCuratedSource(ctx, area) {
+  const dir = `${ctx.areasDir}/${area}/search-index`;
+  const ents = readJsonSafe(path.join(ctx.root, `${dir}/entities.json`), null);
+  const doms = readJsonSafe(path.join(ctx.root, `${dir}/domain-routing.json`), null);
+  return Array.isArray(ents) && ents.length > 0 && Array.isArray(doms);
+}
+
 function buildArea(ctx, area, { force = false } = {}) {
   const reg = loadRegistry(ctx);
   const existing = reg.areas?.[area];
   if (existing?.curated) return { ok: false, area, error: 'curated index, refusing to overwrite (use the curated source)' };
   if (existing && !force) return { ok: false, area, error: 'already registered; pass --force to rebuild a generated index' };
+  // An unregistered area may still carry hand-written index files on disk; never
+  // clobber them on an unforced build (register them as curated instead).
+  if (!existing && !force && hasCuratedSource(ctx, area)) {
+    return { ok: false, area, error: 'existing index files present; use --register-curated to keep them, or --force to overwrite' };
+  }
 
   const relFiles = areaFiles(ctx, area);
   const entities = highConfidenceEntities(ctx, area, relFiles);
@@ -175,7 +193,9 @@ function buildArea(ctx, area, { force = false } = {}) {
     });
     reg.areas = reg.areas || {};
     const previous = reg.areas[area] || {};
-    reg.areas[area] = { ...previous, area_root: `${ctx.areasDir}/${area}`, index_dir: 'search-index', entities: 'entities.json', domain_routing: 'domain-routing.json', generated: true, signature: sig, path_map: previous.path_map || [] };
+    // generated and curated are mutually exclusive registry states; assert curated:false
+    // so a (re)generated index can never keep a stale curated flag from a prior pass.
+    reg.areas[area] = { ...previous, area_root: `${ctx.areasDir}/${area}`, index_dir: 'search-index', entities: 'entities.json', domain_routing: 'domain-routing.json', generated: true, curated: false, signature: sig, path_map: previous.path_map || [] };
     saveRegistry(ctx, reg);
   }
   return { ok: true, area, entities: entities.length, domains: domains.length, scanned: relFiles.length, signature: sig.slice(0, 12), dry_run: ctx.dryRun };
@@ -199,7 +219,9 @@ function registerCurated(ctx, area, { sensitivity } = {}) {
     const reg = loadRegistry(ctx);
     reg.areas = reg.areas || {};
     const previous = reg.areas[area] || {};
-    reg.areas[area] = { ...previous, area_root: `${ctx.areasDir}/${area}`, index_dir: 'search-index', entities: 'entities.json', domain_routing: 'domain-routing.json', curated: true, ...(sensitivity ? { sensitivity } : {}), signature: sig, path_map: previous.path_map || [] };
+    // Clear any stale generated flag: register-curated must leave a clean curated-only
+    // state (the previous spread would otherwise preserve generated:true and contradict).
+    reg.areas[area] = { ...previous, area_root: `${ctx.areasDir}/${area}`, index_dir: 'search-index', entities: 'entities.json', domain_routing: 'domain-routing.json', curated: true, generated: false, ...(sensitivity ? { sensitivity } : {}), signature: sig, path_map: previous.path_map || [] };
     saveRegistry(ctx, reg);
   }
   return { ok: true, area, mode: 'register-curated', entities: entities.length, domains: domains.length, scanned: relFiles.length, signature: sig.slice(0, 12), sensitivity: sensitivity || null, dry_run: ctx.dryRun };
@@ -237,7 +259,12 @@ function autoTidy(ctx, restampCurated) {
   const { missing, stale_curated, stale_generated } = detect(ctx);
   const reg = loadRegistry(ctx);
   const built = []; const refreshed = []; const restamped_curated = [];
-  for (const area of missing) if (buildArea(ctx, area, {}).ok) built.push(area);
+  for (const area of missing) {
+    // Preserve hand-written index files (register as curated) rather than overwrite
+    // them with a generated starter; only truly empty/absent indexes are built.
+    if (hasCuratedSource(ctx, area)) { if (registerCurated(ctx, area, {}).ok) restamped_curated.push(area); }
+    else if (buildArea(ctx, area, {}).ok) built.push(area);
+  }
   for (const area of stale_generated) if (refresh(ctx, area).ok) refreshed.push(area);
   if (restampCurated) {
     for (const area of stale_curated) {

package/src/core/capture_durable.mjs

@@ -18,6 +18,7 @@ import path from 'node:path';
 import { absPath, ensureDir, timestamp } from './fs.mjs';
 import { vaultConfig } from './config.mjs';
 import { firstLineTitle, inferFlushLevelFromEnvelope, inferTargetLayerFromIntent } from './classify.mjs';
+import { resolveCanonicalPath } from './resolve_target.mjs';
 import { folderForSourceType, makeEnvelope, readArgInput, renderCaptureMarkdown, slugify } from './envelope.mjs';
 import { withFileLock, atomicWriteJson } from './durable.mjs';
 import { stageAndPromote } from './stage.mjs';
@@ -151,7 +152,7 @@ export async function captureCommand(args) {
     const { envelope, assetPath, numericConflicts } = buildFullEnvelope(`raw-${timestamp().slice(0, 10).replace(/-/g, '')}-DRYRUN`, 'planned');
     const flushLevel = args['flush-level'] || inferFlushLevelFromEnvelope(envelope);
     const targetLayer = args['target-layer'] || inferTargetLayerFromIntent(envelope.write_intent);
-    const queueItem = buildQueueItem(envelope, { sourceId: envelope.source_id, rawPath: envelope.raw_path, assetPath, title, numericConflictCount: numericConflicts.length, session, sessionId, flushLevel, targetLayer, targetPath: args['target-path'] || '', conflictPolicy: args['conflict-policy'] || 'queue_first', handoffPath: handoffPathFor(vaultCfg, sessionId, session) });
+    const queueItem = buildQueueItem(envelope, { sourceId: envelope.source_id, rawPath: envelope.raw_path, assetPath, title, numericConflictCount: numericConflicts.length, session, sessionId, flushLevel, targetLayer, targetPath: args['target-path'] || resolveCanonicalPath(root, vaultCfg, { area_candidates: envelope.area_candidates, write_intent: envelope.write_intent, sensitivity: envelope.sensitivity, title: envelope.title, target_layer: targetLayer, requires_user_decision: envelope.requires_user_decision }).target_path, conflictPolicy: args['conflict-policy'] || 'queue_first', handoffPath: handoffPathFor(vaultCfg, sessionId, session) });
     return done(args, {
       ok: true, command: 'capture', durable_write: false, dry_run: true,
       envelope, queue_item: queueItem, duplicate_of: duplicateOf || undefined,
@@ -202,7 +203,7 @@ export async function captureCommand(args) {
 
     const flushLevel = args['flush-level'] || inferFlushLevelFromEnvelope(envelope);
     const targetLayer = args['target-layer'] || inferTargetLayerFromIntent(envelope.write_intent);
-    const queueItem = buildQueueItem(envelope, { sourceId, rawPath, assetPath, title, numericConflictCount: numericConflicts.length, session, sessionId, flushLevel, targetLayer, targetPath: args['target-path'] || '', conflictPolicy: args['conflict-policy'] || 'queue_first', handoffPath: handoffPathFor(vaultCfg, sessionId, session) });
+    const queueItem = buildQueueItem(envelope, { sourceId, rawPath, assetPath, title, numericConflictCount: numericConflicts.length, session, sessionId, flushLevel, targetLayer, targetPath: args['target-path'] || resolveCanonicalPath(root, vaultCfg, { area_candidates: envelope.area_candidates, write_intent: envelope.write_intent, sensitivity: envelope.sensitivity, title: envelope.title, target_layer: targetLayer, requires_user_decision: envelope.requires_user_decision }).target_path, conflictPolicy: args['conflict-policy'] || 'queue_first', handoffPath: handoffPathFor(vaultCfg, sessionId, session) });
     fs.appendFileSync(queueAbs, `${JSON.stringify(queueItem)}\n`); // direct: already holding the queue lock
     const pendingCount = pendingCountForSession(root, vaultCfg, sessionId); // after append
     return { refused: false, sourceId, envelope, rawPath, assetPath, pendingCount };

package/src/core/compile_desk.mjs

@@ -8,6 +8,7 @@
 import path from 'node:path';
 import { absPath, timestamp } from './fs.mjs';
 import { vaultConfig } from './config.mjs';
+import { resolveCanonicalPath } from './resolve_target.mjs';
 import { readJsonSafe, readJsonl } from './vault_state.mjs';
 
 function manifestEntries(value) {
@@ -51,13 +52,29 @@ function reviewReasons(item) {
   return [...new Set(reasons)];
 }
 
-function summarizeQueueItem(item, reasons = []) {
+function summarizeQueueItem(item, reasons = [], ctx = null) {
+  // Fill the canonical destination the pipeline historically left blank: when the
+  // queue row carries no explicit target_path, derive it deterministically from
+  // area + write_intent + sensitivity so every candidate shows a real save target
+  // instead of an empty string (the wiki/area/output drift fix). ctx carries the
+  // root + vaultCfg needed to build the path; without it we keep the old behavior.
+  let targetPath = item.target_path || '';
+  if (!targetPath && ctx && ctx.root && ctx.vaultCfg) {
+    targetPath = resolveCanonicalPath(ctx.root, ctx.vaultCfg, {
+      area_candidates: item.area_candidates,
+      write_intent: item.write_intent,
+      sensitivity: item.sensitivity,
+      title: item.title,
+      target_layer: item.target_layer,
+      requires_user_decision: item.requires_user_decision,
+    }).target_path;
+  }
   return {
     source_id: item.source_id || '',
     title: item.title || '',
     raw_path: item.raw_path || '',
     target_layer: item.target_layer || inferTargetLayer(item),
-    target_path: item.target_path || '',
+    target_path: targetPath,
     sensitivity: item.sensitivity || 'internal',
     flush_level: item.flush_level || inferFlushLevel(item),
     reasons,
@@ -127,13 +144,13 @@ function summarizeManifestTarget(entry, selectedBy) {
   };
 }
 
-function selectTarget(query, value, queueItems, rawDir) {
+function selectTarget(query, value, queueItems, rawDir, ctx = null) {
   const lower = String(query || '').toLowerCase();
   const sourceIdMatch = String(query || '').match(/\b(?:raw-\d{8}-\d{3}|clipper-\d{8}-\d{6})\b/);
   if (sourceIdMatch) {
     const sourceId = sourceIdMatch[0];
     const queueMatch = queueItems.find((item) => item.source_id === sourceId);
-    if (queueMatch) return { kind: 'queue_item', ...summarizeQueueItem(queueMatch, reviewReasons(queueMatch)) };
+    if (queueMatch) return { kind: 'queue_item', ...summarizeQueueItem(queueMatch, reviewReasons(queueMatch), ctx) };
     const manifestMatch = manifestEntries(value).find((entry) => entry.source_id === sourceId);
     if (manifestMatch) return summarizeManifestTarget(manifestMatch, 'source_id');
   }
@@ -156,10 +173,10 @@ function selectTarget(query, value, queueItems, rawDir) {
   return null;
 }
 
-function selectAutoTarget({ safe: safeItems, needsConfirmation: confirmationItems, manifest: value, sessionId: targetSessionId }) {
+function selectAutoTarget({ safe: safeItems, needsConfirmation: confirmationItems, manifest: value, sessionId: targetSessionId, ctx = null }) {
   if (safeItems.length > 0) {
     const item = safeItems[0];
-    return { auto_selected: true, selected_by: 'safe_queue', kind: 'queue_item', ...summarizeQueueItem(item, []) };
+    return { auto_selected: true, selected_by: 'safe_queue', kind: 'queue_item', ...summarizeQueueItem(item, [], ctx) };
   }
   if (confirmationItems.length > 0) return null;
 
@@ -217,7 +234,7 @@ export async function compileCommand(args) {
   const needsConfirmation = pending
     .filter((item) => reviewReasons(item).length > 0)
     .map((item) => {
-      const s = summarizeQueueItem(item, reviewReasons(item));
+      const s = summarizeQueueItem(item, reviewReasons(item), { root, vaultCfg });
       // Never expose a private item's file paths in output (R3-#1).
       if (s.sensitivity === 'private') { s.raw_path = '[redacted:private]'; s.target_path = ''; }
       return s;
@@ -236,10 +253,10 @@ export async function compileCommand(args) {
   const wantAuto = Boolean(args.auto);
   const deskOnly = Boolean(args.desk || args['no-auto-select']) || wantList || (!detail && !wantAuto);
   const selected = detail
-    ? selectTarget(detail, manifest, pending, rawDir)
+    ? selectTarget(detail, manifest, pending, rawDir, { root, vaultCfg })
     : deskOnly
       ? null
-      : selectAutoTarget({ safe, needsConfirmation, manifest, sessionId });
+      : selectAutoTarget({ safe, needsConfirmation, manifest, sessionId, ctx: { root, vaultCfg } });
   const mode = selected
     ? (selected.auto_selected ? 'auto_selected_compile_plan' : 'selected_compile_plan')
     : deskOnly
@@ -267,7 +284,7 @@ export async function compileCommand(args) {
       pending_count: pending.length,
       safe_count: safe.length,
       needs_confirmation_count: needsConfirmation.length,
-      safe: safe.slice(0, top).map((item) => summarizeQueueItem(item, [])),
+      safe: safe.slice(0, top).map((item) => summarizeQueueItem(item, [], { root, vaultCfg })),
       needs_confirmation: needsConfirmation.slice(0, top),
     },
     source_digest: {