neurain 0.1.0-alpha.2 → 0.1.0-alpha.4

package/CHANGELOG.md

@@ -4,6 +4,21 @@
 
 - No unreleased changes recorded.
 
+## 0.1.0-alpha.4
+
+- Performance: lazy dynamic-import CLI dispatch. Each command now imports only its own `core/*.mjs` module on demand instead of loading all ~54 command modules on every invocation. Engine subprocess latency drops ~60-75ms across the board (`tidy` 150->90ms, `structure-audit` 120->60ms, `--help`/`--version` 50ms), with no change to the command surface or behavior (npm test 153/153; reviewed).
+
+
+## 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).

package/README.md

@@ -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.2`. 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.4`. 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/development-status.en.md

@@ -1,9 +1,9 @@
 # Development Status
 
 Version: v0.1
-Last updated: 2026-06-14 KST
-Package: `neurain@0.1.0-alpha.2`
-Latest documented commit: `66016ba docs(dev-status): note unified reindex + adopt auto-reindex in the command surface`
+Last updated: 2026-06-19 KST
+Package: `neurain@0.1.0-alpha.4`
+Latest documented commit: `53aba29 perf(cli): lazy dynamic-import dispatch (load only the dispatched command)`
 
 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.
 
@@ -91,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
 
@@ -104,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 |
@@ -119,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-14 KST
-Package: `neurain@0.1.0-alpha.2`
-Latest documented commit: `66016ba docs(dev-status): note unified reindex + adopt auto-reindex in the command surface`
+Last updated: 2026-06-19 KST
+Package: `neurain@0.1.0-alpha.4`
+Latest documented commit: `53aba29 perf(cli): lazy dynamic-import dispatch (load only the dispatched command)`
 
 이 문서는 public package 기준의 canonical 개발 상태 스냅샷입니다. 무엇이 shipped인지, 어떤 증거가 있는지, 아직 주장하면 안 되는 것이 무엇인지 함께 기록합니다.
 
@@ -91,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
 
@@ -104,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 |
@@ -119,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.2",
+  "version": "0.1.0-alpha.4",
   "description": "Local-first Neurain Knowledge OS CLI and MCP connector.",
   "type": "module",
   "license": "Apache-2.0",

package/src/cli.mjs

@@ -1,56 +1,62 @@
 import { spawnSync } from 'node:child_process';
 import path from 'node:path';
-import { adoptCommand, rollbackAdoption, scanAdoption } from './core/adopt.mjs';
-import { answerCommand } from './core/answer_eval.mjs';
-import { connectCommand } from './core/connect.mjs';
-import { capabilitiesCommand } from './core/capabilities.mjs';
-import { curatorCommand } from './core/curator.mjs';
-import { daemonCommand } from './core/daemon.mjs';
-import { doctorCommand } from './core/doctor.mjs';
-import { initCommand } from './core/init.mjs';
-import { journalCommand } from './core/journal.mjs';
-import { lessonsCommand } from './core/lessons.mjs';
-import { lifecycleCommand } from './core/lifecycle.mjs';
-import { liveCasesCommand } from './core/live_cases.mjs';
-import { onboardCommand } from './core/onboard.mjs';
-import { recapCommand } from './core/recap.mjs';
-import { recallCommand } from './core/recall.mjs';
-import { reviewCommand } from './core/review_worker.mjs';
-import { statusCommand } from './core/status.mjs';
-import { digestCommand } from './core/digest.mjs';
-import { queueCommand } from './core/queue.mjs';
-import { reviewQueueCommand } from './core/review_queue.mjs';
-import { routeCommand } from './core/route.mjs';
-import { planWritebackCommand } from './core/plan_writeback.mjs';
-import { flushCommand, sessionFlushCommand } from './core/flush.mjs';
-import { compileCommand } from './core/compile_desk.mjs';
-import { planReceiptCommand } from './core/plan_receipt.mjs';
-import { sourceDigestCommand } from './core/source_digest_gen.mjs';
-import { stageCommand } from './core/stage.mjs';
-import { queueArchiveCommand } from './core/queue_archive.mjs';
-import { captureCommand } from './core/capture_durable.mjs';
-import { completeCommand } from './core/complete.mjs';
-import { linkCheckCommand } from './core/link_check.mjs';
-import { sessionLintCommand } from './core/session_lint.mjs';
-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 { sessionPulseCommand } from './core/session_pulse.mjs';
-import { syncCommand } from './core/sync.mjs';
-import { healthCommand } from './core/health.mjs';
-import { memoryCommand } from './core/memory.mjs';
-import { retentionCommand } from './core/retention.mjs';
-import { freezeCommand } from './core/freeze.mjs';
-import { memoryWriteCommand } from './core/memory_write_cli.mjs';
-import { backupCommand } from './core/backup.mjs';
-import { schedulerCommand } from './core/scheduler.mjs';
-import { searchCommand } from './core/search.mjs';
-import { watchCommand } from './core/watch.mjs';
-import { wrapCommand } from './core/wrap.mjs';
-import { startMcpServer } from './mcp/server.mjs';
+
+const COMMAND_HANDLERS = {
+  init: async (args) => (await import('./core/init.mjs')).initCommand(args),
+  onboard: async (args) => (await import('./core/onboard.mjs')).onboardCommand(args),
+  answer: async (args) => (await import('./core/answer_eval.mjs')).answerCommand(args),
+  doctor: async (args) => (await import('./core/doctor.mjs')).doctorCommand(args),
+  search: async (args) => (await import('./core/search.mjs')).searchCommand(args),
+  connect: async (args) => (await import('./core/connect.mjs')).connectCommand(args),
+  journal: async (args) => (await import('./core/journal.mjs')).journalCommand(args),
+  lifecycle: async (args) => (await import('./core/lifecycle.mjs')).lifecycleCommand(args),
+  'live-cases': async (args) => (await import('./core/live_cases.mjs')).liveCasesCommand(args),
+  lessons: async (args) => (await import('./core/lessons.mjs')).lessonsCommand(args),
+  curator: async (args) => (await import('./core/curator.mjs')).curatorCommand(args),
+  daemon: async (args) => (await import('./core/daemon.mjs')).daemonCommand(args),
+  recall: async (args) => (await import('./core/recall.mjs')).recallCommand(args),
+  reindex: async (args) => (await import('./core/reindex.mjs')).reindexCommand(args),
+  status: async (args) => (await import('./core/status.mjs')).statusCommand(args),
+  digest: async (args) => (await import('./core/digest.mjs')).digestCommand(args),
+  queue: async (args) => (await import('./core/queue.mjs')).queueCommand(args),
+  'review-queue': async (args) => (await import('./core/review_queue.mjs')).reviewQueueCommand(args),
+  route: async (args) => (await import('./core/route.mjs')).routeCommand(args),
+  'plan-writeback': async (args) => (await import('./core/plan_writeback.mjs')).planWritebackCommand(args),
+  flush: async (args) => (await import('./core/flush.mjs')).flushCommand(args),
+  'session-flush': async (args) => (await import('./core/flush.mjs')).sessionFlushCommand(args),
+  compile: async (args) => (await import('./core/compile_desk.mjs')).compileCommand(args),
+  'plan-receipt': async (args) => (await import('./core/plan_receipt.mjs')).planReceiptCommand(args),
+  'source-digest': async (args) => (await import('./core/source_digest_gen.mjs')).sourceDigestCommand(args),
+  stage: async (args) => (await import('./core/stage.mjs')).stageCommand(args),
+  'queue-archive': async (args) => (await import('./core/queue_archive.mjs')).queueArchiveCommand(args),
+  capture: async (args) => (await import('./core/capture_durable.mjs')).captureCommand(args),
+  complete: async (args) => (await import('./core/complete.mjs')).completeCommand(args),
+  'link-check': async (args) => (await import('./core/link_check.mjs')).linkCheckCommand(args),
+  'session-lint': async (args) => (await import('./core/session_lint.mjs')).sessionLintCommand(args),
+  label: async (args) => (await import('./core/label.mjs')).labelCommand(args),
+  orphans: async (args) => (await import('./core/orphans.mjs')).orphansCommand(args),
+  hubs: async (args) => (await import('./core/hubs.mjs')).hubsCommand(args),
+  'area-index': async (args) => (await import('./core/area_index.mjs')).areaIndexCommand(args),
+  lint: async (args) => (await import('./core/lint.mjs')).lintCommand(args),
+  tidy: async (args) => (await import('./core/tidy.mjs')).tidyCommand(args),
+  'structure-audit': async (args) => (await import('./core/structure_audit.mjs')).structureAuditCommand(args),
+  file: async (args) => (await import('./core/file_loose.mjs')).fileCommand(args),
+  organize: async (args) => (await import('./core/organize.mjs')).organizeCommand(args),
+  'session-pulse': async (args) => (await import('./core/session_pulse.mjs')).sessionPulseCommand(args),
+  sync: async (args) => (await import('./core/sync.mjs')).syncCommand(args),
+  health: async (args) => (await import('./core/health.mjs')).healthCommand(args),
+  memory: async (args) => (await import('./core/memory.mjs')).memoryCommand(args),
+  retention: async (args) => (await import('./core/retention.mjs')).retentionCommand(args),
+  freeze: async (args) => (await import('./core/freeze.mjs')).freezeCommand(args),
+  'memory-write': async (args) => (await import('./core/memory_write_cli.mjs')).memoryWriteCommand(args),
+  backup: async (args) => (await import('./core/backup.mjs')).backupCommand(args),
+  capabilities: async (args) => (await import('./core/capabilities.mjs')).capabilitiesCommand(args),
+  recap: async (args) => (await import('./core/recap.mjs')).recapCommand(args),
+  watch: async (args) => (await import('./core/watch.mjs')).watchCommand(args),
+  review: async (args) => (await import('./core/review_worker.mjs')).reviewCommand(args),
+  scheduler: async (args) => (await import('./core/scheduler.mjs')).schedulerCommand(args),
+  wrap: async (args) => (await import('./core/wrap.mjs')).wrapCommand(args),
+};
 
 export async function runCli(argv) {
   const [command, ...rest] = argv;
@@ -65,61 +71,17 @@ export async function runCli(argv) {
   }
 
   const args = parseArgs(rest);
-  if (command === 'init') return render(await initCommand(args));
-  if (command === 'onboard') return render(await onboardCommand(args));
   if (command === 'adopt') {
+    const { adoptCommand, rollbackAdoption } = await import('./core/adopt.mjs');
     if (args.rollback) return render(await rollbackAdoption(args));
     return render(await adoptCommand(args));
   }
-  if (command === 'answer') return render(await answerCommand(args));
-  if (command === 'doctor') return render(await doctorCommand(args));
-  if (command === 'search') return render(await searchCommand(args));
-  if (command === 'connect') return render(await connectCommand(args));
-  if (command === 'journal') return render(await journalCommand(args));
-  if (command === 'lifecycle') return render(await lifecycleCommand(args));
-  if (command === 'live-cases') return render(await liveCasesCommand(args));
-  if (command === 'lessons') return render(await lessonsCommand(args));
-  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));
-  if (command === 'review-queue') return render(await reviewQueueCommand(args));
-  if (command === 'route') return render(await routeCommand(args));
-  if (command === 'plan-writeback') return render(await planWritebackCommand(args));
-  if (command === 'flush') return render(await flushCommand(args));
-  if (command === 'session-flush') return render(await sessionFlushCommand(args));
-  if (command === 'compile') return render(await compileCommand(args));
-  if (command === 'plan-receipt') return render(await planReceiptCommand(args));
-  if (command === 'source-digest') return render(await sourceDigestCommand(args));
-  if (command === 'stage') return render(await stageCommand(args));
-  if (command === 'queue-archive') return render(await queueArchiveCommand(args));
-  if (command === 'capture') return render(await captureCommand(args));
-  if (command === 'complete') return render(await completeCommand(args));
-  if (command === 'link-check') return render(await linkCheckCommand(args));
-  if (command === 'session-lint') return render(await sessionLintCommand(args));
-  if (command === 'label') return render(await labelCommand(args));
-  if (command === 'orphans') return render(await orphansCommand(args));
-  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 === 'session-pulse') return render(await sessionPulseCommand(args));
-  if (command === 'sync') return render(await syncCommand(args));
-  if (command === 'health') return render(await healthCommand(args));
-  if (command === 'memory') return render(await memoryCommand(args));
-  if (command === 'retention') return render(await retentionCommand(args));
-  if (command === 'freeze') return render(await freezeCommand(args));
-  if (command === 'memory-write') return render(await memoryWriteCommand(args));
-  if (command === 'backup') return render(await backupCommand(args));
-  if (command === 'capabilities') return render(await capabilitiesCommand(args));
-  if (command === 'recap') return render(await recapCommand(args));
-  if (command === 'watch') return render(await watchCommand(args));
-  if (command === 'review') return render(await reviewCommand(args));
-  if (command === 'scheduler') return render(await schedulerCommand(args));
-  if (command === 'wrap') return render(await wrapCommand(args));
-  if (command === 'mcp') return startMcpServer(args);
+  const handler = COMMAND_HANDLERS[command];
+  if (handler) return render(await handler(args));
+  if (command === 'mcp') {
+    const { startMcpServer } = await import('./mcp/server.mjs');
+    return startMcpServer(args);
+  }
   if (command === 'selftest') return runSelftest();
 
   throw new Error(`Unknown command: ${command}\n\n${helpText()}`);
@@ -184,6 +146,8 @@ Usage:
   neurain onboard <folder> [--lang ko|en] [--host codex|claude|gemini|runtime] [--json]
   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]
@@ -240,6 +204,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,9 +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;
@@ -119,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/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: {