agentlas 1.0.43 → 1.0.45

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 1.0.45 — 2026-08-11
+
+The command surface was rebuilt from one catalog, and failures stopped printing JSON.
+
+- **Commands.** The same list used to be maintained by hand in four places, and they
+  disagreed: an English screen advertised a Korean argument hint, one feature was sold
+  twice under two names, and a de-duplication pass then hid `/switch`, `/list` and
+  `/exit` entirely. There is now a single catalog. Aliases are a field on a command,
+  never a row of their own, so a duplicate can no longer appear or be silently dropped.
+- **Help.** `/help` is grouped and short — 25 lines in the terminal instead of 133 —
+  ordered by what a new user needs first. `help all` lists everything; `help <command>`
+  answers about that one command instead of dumping the whole list. The CLI, the classic
+  REPL and the interactive shell now call the same renderer, so they cannot drift apart.
+- **Removed.** `journal` reported success for runs that did not exist and read the wrong
+  folder; `career-graph`'s read commands silently created project state; `plugins` was a
+  second name for `plugin`. All three now stop with the exact replacement command instead
+  of leaking into a paid model turn.
+- **Failures.** A failed staffing run used to print a machine code followed by a raw JSON
+  object, with the one useful sentence — run `agentlas login` — buried inside it and cut
+  mid-escape by two stacked truncations. The sentence now comes first and the code last;
+  no JSON reaches a human. Sign-in expiry is relayed intact instead of being re-wrapped.
+- **Shell layout.** Output now stays above the input box instead of below it,
+  the box shows what to type, the whole terminal width is used, blank lines survive,
+  and `/permission` `/model` `/runtime` `/effort` work where they were only autocompleted.
+
+## 1.0.44 — 2026-08-11
+
+Turn the interactive shell on once and keep it.
+
+- `/shell on` saves the choice, so plain `agentlas` opens the interactive shell
+  from then on; `/shell off` returns to the classic REPL. Both shells accept the
+  command, so you can always get back out.
+- `AGENTLAS_TUI=1` still works and takes precedence for a single run.
+
 ## 1.0.43 — 2026-08-11
 
 Zero runtime dependencies. The renderer now lives in this repository.

package/engine/agentlas-workforce.cjs

@@ -2916,6 +2916,12 @@ const TRANSIENT_MODEL_ERROR_RE = /Connection closed mid-response|"terminal_reaso
       try {
         runtimeContext = await D.loadWorkforceGoalRuntime(cwd, ctx.goalId || null);
       } catch (error) {
+        /*
+         * 저자·호스트가 이미 한 문장으로 쓴 안내(로그인 필요, 정직 정지)는 그대로 올린다.
+         * 여기서 다시 감싸면 code/honestStop 이 떨어져 나가고, 유일하게 실행 가능한
+         * 문장이 JSON 의 cause 키 밑으로 들어가 사용자에게 blob 으로 보인다(실사고).
+         */
+        if (error && (error.honestStop || error.code)) throw error;
         fail(
           "workforce_goal_runtime_unavailable",
           "the active account/project Workforce binding could not be inspected",
@@ -3291,6 +3297,12 @@ const TRANSIENT_MODEL_ERROR_RE = /Connection closed mid-response|"terminal_reaso
           hostRuntime: identity.runtimeId,
         });
       } catch (error) {
+        /*
+         * 저자·호스트가 이미 한 문장으로 쓴 안내(로그인 필요, 정직 정지)는 그대로 올린다.
+         * 여기서 다시 감싸면 code/honestStop 이 떨어져 나가고, 유일하게 실행 가능한
+         * 문장이 JSON 의 cause 키 밑으로 들어가 사용자에게 blob 으로 보인다(실사고).
+         */
+        if (error && (error.honestStop || error.code)) throw error;
         fail(
           "workforce_goal_binding_failed",
           "prepared execution was blocked because the durable goal binding could not be committed",
@@ -4552,14 +4564,22 @@ const TRANSIENT_MODEL_ERROR_RE = /Connection closed mid-response|"terminal_reaso
         const otherDetails = details && typeof details === "object" && !Array.isArray(details)
           ? Object.fromEntries(Object.entries(details).filter(([key]) => key !== "issues"))
           : details;
-        const detailText = otherDetails && (typeof otherDetails !== "object" || Object.keys(otherDetails).length)
-          ? ` — ${JSON.stringify(otherDetails).slice(0, 1_200)}`
-          : "";
-        ui.error(`${receipt.failure.code}: ${receipt.failure.message}${detailText}`, { reveal: true });
+        // otherDetails 는 사람 줄에 쓰지 않는다 — 영수증에 그대로 남는다.
+        void otherDetails;
+        /*
+         * 사람이 읽는 줄에 JSON 을 찍지 않는다(2026-08-11 오너 지적). 예전에는
+         * `code: message — {"cause":"…"}` 형태로 나가서, 유일하게 실행 가능한 문장
+         * ("agentlas login")이 JSON 안에 묻히고 두 번의 절단(1200자→800자)에 걸려
+         * 이스케이프 중간에서 잘렸다. 지금은 문장이 먼저, 기계 코드는 맨 끝 한 줄.
+         */
+        const failureError = receipt.failure.error;
+        if (failureError && (failureError.honestStop || failureError.code)) ui.error(failureError);
+        else ui.error(String(receipt.failure.message || ""), { reveal: true });
         if (issues) {
-          for (const issue of issues.slice(0, 16)) ui.error(`  - ${String(issue).slice(0, 400)}`, { reveal: true });
-          if (issues.length > 16) ui.error(`  … ${issues.length - 16} more issues in the persisted receipt`, { reveal: true });
+          for (const issue of issues.slice(0, 16)) ui.line(ui.c.dim(`  · ${String(issue).slice(0, 400)}`));
+          if (issues.length > 16) ui.line(ui.c.dim(`  · … ${issues.length - 16} more in the persisted receipt`));
         }
+        ui.line(ui.c.faint(`  ${receipt.failure.code}`));
         // 실패한 실행이야말로 토큰이 어디로 갔는지 알아야 하는 순간이다. issues 유무와
         // 무관하게 낸다 — 첫 배선이 이 블록 안에 들어가는 바람에 issues 없는 실패에서는
         // 장부가 통째로 사라졌다.

package/engine/commands/help.cjs

@@ -1,164 +1,45 @@
 "use strict";
-/* help / usage — v2 명령 표면. 재구축이 진행되며 이 표가 곧 진실이다. */
-
-const HELP = `agentlas — the operating system for agents, in your terminal
-
-  agentlas                 open the terminal (REPL)
-  agentlas "<task>"        run once with this project's controller
-  graph new "<what you want run for you>"   build an automation by talking it through
-
-PROJECT WORK
-  run [agent] [prompt]     project-first one-shot; exact agent is an explicit advanced override
-  firm <firm> [task]       delegate to a CEO (--runtime · --model · --effort)
-
-AGENTS & HUB
-  search "<what you need>" discover agents in the Hub
-  install <slug>           install an agent from the Hub
-  plugin add <slug> · plugin list      Hub plugins (MCP servers)
-  build "<request>"        build an installable agent locally (auto-installs)
-  upload <path>            save owner-private in Agent Cloud (--visibility marketplace to publish)
-  import <path> · cd · native prepare  local folder agents
-  list                     installed agents/companies + orchestrator/worker runtimes
-  roles [set <role> <rt>]  show or set orchestrator/worker model roles
-  experience <sub>         portable Experience: list|inspect|validate|save|publish|status|export|unpublish
-  variant resolve --base-release <id>   local variant selection (variant help)
-
-EXECUTE
-  storm <goal>             Goal+UltraCode harness: plan → allocate → execute → verify  [--research]
-  swarm <goal>             emergent agent swarm  [--parallel N]
-  workforce | network <request>   Agent Workforce Ontology route (public Hub menu)
-  hep-network "<request>"  staff across Local + owner Cloud + public Hub (local Core federation)
-  hep-local | hep-cloud | hep-hub "<request>"   same, restricted to one source scope
-  call "a,b" "<ctx>" · browser <url|status|sites|login> · route "<req>" [--json] · research <sub>
-
-KNOWLEDGE
-  memory import · evolve   memory & prompt-evolution proposals
-  ontology · career-graph  project knowledge & source routing
-  journal <sub>            Stormbreaker run journal
-  project <sub>            connect this folder + set an ordered team, standalone
-                           (status · init · use <agent> · team <agent>…)
-  context <sub>            dependency map: refresh|locate|refs|slice|impact|verify
-
-ACCOUNT & OPS
-  login | logout | whoami  Agentlas Cloud sign-in (browser flow)
-  cloud <sub>              cloud assets: save|publish|package|list|restore|field-test
-  automation <sub>         list|add|on|off|remove|run <id>|runs|daemon
-  graph <sub>              new "<what you want>"|list|show|run <name>|export|inspect|install
-  creds <sub> · env        credentials and shared env keys
-  usage · telegram · mcp   local usage · telegram bindings · MCP servers (mcp probe <id>)
-  multimodal               image/video/audio provider settings
-  doctor · setup · update  health check · first-run wizard · npm update check
-  oberon | film <sub>      AI film render (scaffold|render|list|open)
-  hep <sub…> · netadmin    Hephaestus passthrough · local agent network
-  version · help
-
-IN-REPL (agentlas → interactive, Orca multi-session)
-  /sessions · /tree · /s <n> | /switch <n> · /kill <n> · /rm <n>
-  /runtime <kind> · /model <id> · /effort <level> · /permission <level>   (applies to new sessions)
-  every command above also works as a slash command (/graph, /search, /automation, …) — /help lists them all
-  typing during a running turn queues steering; ctrl-c interrupts the turn
-
-Options: -p|--print · --runtime claude-code|codex|gemini · --model <exact-id> ·
-         --effort none|minimal|low|medium|high|xhigh|max ·
-         --tier economy|balanced|frontier (requires --model) ·
-         --permission read|write|full
-`;
-
 /*
- * 한국어판 — 2026-08-05 감사 결함 F: ko 세션에서 /help 본문이 전부 영어였다.
- * 명령 이름·플래그는 원문(입력 어휘) 유지, 설명만 국문. HELP(영문)와 줄 구조를
- * 맞춰 둔다 — runForCommand는 두 판 모두에서 같은 규칙으로 행을 찾는다.
+ * commands/help — 정본은 ui/commands-catalog.cjs 하나다(2026-08-11 재작성).
+ *
+ * 이 파일에는 EN 61줄 + KO 133줄의 손유지 블록 두 벌이 있었다. 팔레트와 어긋나
+ * 같은 명령이 표면마다 다른 인자·설명을 광고했고(`search "<what you need>"` vs
+ * `"<필요한 것>"`), `agentlas help doctor` 는 인자를 무시하고 전체를 쏟아냈다.
+ * 이제 CLI·기본 REPL·새 셸이 같은 renderHelp 를 부른다 — 다시 갈라질 수 없다.
  */
-const HELP_KO = `agentlas — 터미널 속 에이전트 운영체제
-
-  agentlas                 터미널(REPL) 열기
-  agentlas "<작업>"        이 프로젝트의 컨트롤러로 1회 실행
-  graph new "<대신 시킬 일>"   대화로 설명하면 자동화를 만들어 줍니다
-
-PROJECT WORK
-  run [agent] [prompt]     프로젝트 우선 1회 실행; 특정 에이전트 지정은 명시적 고급 경로
-  firm <firm> [task]       회사 CEO에게 위임 (--runtime · --model · --effort)
-
-AGENTS & HUB
-  search "<필요한 것>"     Hub에서 에이전트 찾기
-  install <slug>           Hub 에이전트 설치
-  plugin add <slug> · plugin list      Hub 플러그인 (MCP 서버)
-  build "<요청>"           에이전트를 로컬에서 만들고 바로 설치
-  upload <path>            Agent Cloud에 소유자 비공개 저장 (--visibility marketplace 로 발행)
-  import <path> · cd · native prepare  로컬 폴더 에이전트
-  list                     설치 에이전트/회사 + 오케스트레이터·워커 런타임
-  roles [set <role> <rt>]  오케스트레이터·워커 모델 역할 조회/설정
-  experience <sub>         이동식 Experience: list|inspect|validate|save|publish|status|export|unpublish
-  variant resolve --base-release <id>   로컬 변형 선택 (variant help)
-
-EXECUTE
-  storm <goal>             Goal+UltraCode 하니스: 계획 → 배정 → 실행 → 검증  [--research]
-  swarm <goal>             창발형 에이전트 스웜  [--parallel N]
-  workforce | network <request>   Agent Workforce Ontology 편성 (공개 Hub 메뉴)
-  hep-network "<request>"  로컬+오너 클라우드+공개 Hub 연합 편성 (로컬 Core 연합)
-  hep-local | hep-cloud | hep-hub "<request>"   같은 편성, 한 소스 스코프로 제한
-  call "a,b" "<ctx>" · browser <url|status|sites|login> · route "<req>" [--json] · research <sub>
-
-KNOWLEDGE
-  memory import · evolve   메모리·프롬프트 진화 제안
-  ontology · career-graph  프로젝트 지식·소스 라우팅
-  journal <sub>            Stormbreaker 런 저널
-  project <sub>            이 폴더를 프로젝트로 연결 + 순서 팀 편성 (독립)
-                           (status · init · use <에이전트> · team <에이전트>…)
-  context <sub>            의존성 지도: refresh|locate|refs|slice|impact|verify
-
-ACCOUNT & OPS
-  login | logout | whoami  Agentlas Cloud 로그인 (브라우저 플로)
-  cloud <sub>              클라우드 자산: save|publish|package|list|restore|field-test
-  automation <sub>         list|add|on|off|remove|run <id>|runs|daemon
-  graph <sub>              new "<시킬 일>"|list|show|run <이름>|export|inspect|install
-  creds <sub> · env        자격증명·공유 env 키 (creds list 로 확인)
-  usage · telegram · mcp   로컬 사용량 · 텔레그램 연결 · MCP 서버 (mcp probe <id>)
-  multimodal               이미지/영상/음성 제공자 설정
-  doctor · setup · update  건강 점검 · 첫 실행 마법사 · npm 업데이트 확인
-  oberon | film <sub>      AI 필름 렌더 (scaffold|render|list|open)
-  hep <sub…> · netadmin    Hephaestus 패스스루 · 로컬 에이전트 네트워크
-  version · help
-
-IN-REPL (agentlas → 대화형, Orca 다중 세션)
-  /sessions · /tree · /s <n> | /switch <n> · /kill <n> · /rm <n>
-  /runtime <kind> · /model <id> · /effort <level> · /permission <level>   (새 세션부터 적용)
-  위의 모든 명령은 슬래시 명령(/graph, /search, /automation, …)으로도 됩니다 — 전체 목록은 /help
-  실행 중 입력하면 조종 큐에 쌓이고, ctrl-c 로 턴을 중단합니다
-
-Options: -p|--print · --runtime claude-code|codex|gemini · --model <exact-id> ·
-         --effort none|minimal|low|medium|high|xhigh|max ·
-         --tier economy|balanced|frontier (--model 필요) ·
-         --permission read|write|full
-`;
-
-function helpText(ctx) {
-  return ctx && ctx.lang === "ko" ? HELP_KO : HELP;
-}
-
-function run(ctx) {
-  ctx.out(helpText(ctx).trimEnd());
+const catalog = require("../ui/commands-catalog.cjs");
+
+function run(ctx, args = []) {
+  const first = String((args && args[0]) || "").trim();
+  const all = first.toLowerCase() === "all";
+  const name = !all && first && !first.startsWith("-") ? first : null;
+  if (name) return runForCommand(ctx, name);
+  ctx.out(catalog.renderHelp({ lang: ctx.lang, surface: "cli", all }));
   return 0;
 }
 
 function runForCommand(ctx, command) {
-  const name = String(command || "").trim();
-  const rows = helpText(ctx).split("\n")
-    .map((line) => line.trim())
-    .filter((line) => line && !line.endsWith(":"))
-    .filter((line) => {
-      const commandColumn = line.split(/\s{2,}/, 1)[0];
-      return commandColumn
-        .split(/\s*·\s*|\s*\|\s*/)
-        .some((entry) => entry === name || entry.startsWith(`${name} `));
-    });
-  ctx.out(`Usage: agentlas ${name} [options]`);
-  if (rows.length > 0) {
-    for (const row of rows) ctx.out(`  ${row}`);
-  } else {
-    ctx.out(`  See "agentlas help" for the full command list.`);
+  const name = String(command || "").trim().replace(/^\//, "");
+  const entry = catalog.byName(name);
+  const ko = ctx && ctx.lang === "ko";
+  if (!entry) {
+    // 없는 이름을 지어내지 않는다 — 전체 목록으로 보낸다.
+    ctx.out(`Usage: agentlas ${name}`);
+    ctx.out(ko ? '  전체 목록: agentlas help all' : '  Full list: agentlas help all');
+    return 0;
+  }
+  const replOnly = !entry.surfaces.includes("cli");
+  ctx.out(`Usage: agentlas ${catalog.usageFor(entry, ctx.lang)}`);
+  ctx.out(`  ${catalog.descFor(entry, ctx.lang)}`);
+  if (entry.aliases && entry.aliases.length) {
+    ctx.out(ko ? `  다른 이름: ${entry.aliases.join(", ")}` : `  Also: ${entry.aliases.join(", ")}`);
+  }
+  if (replOnly) {
+    ctx.out(ko
+      ? `  이 명령은 터미널 안에서 씁니다: agentlas 를 실행한 뒤 /${entry.name}`
+      : `  This one runs inside the terminal: start agentlas, then /${entry.name}`);
   }
   return 0;
 }
 
-module.exports = { run, runForCommand, HELP, HELP_KO };
+module.exports = { run, runForCommand };

package/engine/commands/index.cjs

@@ -10,8 +10,9 @@ const path = require("node:path");
 
 // 각 명령 파일은 { run(ctx, args) } 를 export한다. ctx는 엔진이 만든 얕은 DI 객체.
 const COMMANDS = {
+  // 정본 이름은 agents. list 는 별칭으로 영구 호출 가능(스크립트·게이트 사용).
+  agents: () => require("./list.cjs"),
   version: () => require("./version.cjs"),
-  list: () => require("./list.cjs"),
   graph: () => require("./graph.cjs"),
   doctor: () => require("./doctor.cjs"),
   mcp: () => require("./mcp.cjs"),
@@ -31,14 +32,11 @@ const COMMANDS = {
   cd: () => require("./cd.cjs"),
   install: () => require("./install.cjs"),
   plugin: () => require("./plugin.cjs"),
-  plugins: () => require("./plugin.cjs"),
   automation: () => require("./automation.cjs"),
   native: () => require("./native.cjs"),
   multimodal: () => require("./multimodal.cjs"),
   document: () => require("./document.cjs"),
   workforce: () => require("./workforce.cjs"),
-  network: () => require("./workforce.cjs"),
-  taskforce: () => require("./workforce.cjs"),
   // 소스 스코프 편성 4종 — 2026-08-05 네이티브 배선(경위는 workforce.cjs 참조).
   // 별칭이 아니라 1급인 이유는 여전하다: 별칭은 스코프를 전달하지 못한다.
   "hep-network": () => require("./hep-network.cjs"),
@@ -46,7 +44,6 @@ const COMMANDS = {
   "hep-cloud": () => require("./hep-cloud.cjs"),
   "hep-hub": () => require("./hep-hub.cjs"),
   oberon: () => require("./oberon.cjs"),
-  film: () => require("./film.cjs"),
   experience: () => require("./experience.cjs"),
   memory: () => require("./memory.cjs"),
   evolve: () => require("./evolve.cjs"),
@@ -60,7 +57,6 @@ const COMMANDS = {
   route: () => require("./route.cjs"),
   research: () => require("./research.cjs"),
   netadmin: () => require("./netadmin.cjs"),
-  journal: () => require("./journal.cjs"),
   cloud: () => require("./cloud.cjs"),
   upload: () => require("./upload.cjs"),
   storm: () => require("./storm.cjs"),
@@ -68,7 +64,6 @@ const COMMANDS = {
   project: () => require("./project.cjs"),
   context: () => require("./context.cjs"),
   ontology: () => require("./ontology.cjs"),
-  "career-graph": () => require("./career-graph.cjs"),
   creds: () => require("./creds.cjs"),
   billing: () => require("./billing.cjs"),
   uninstall: () => require("./uninstall.cjs"),
@@ -139,6 +134,30 @@ const COMMAND_ALIASES = {
   "hep-storm": "storm",
   "hep-browser": "browser",
   "hep-connect": "connect",
+  // 2026-08-11: 같은 기능을 두 이름으로 광고하던 것을 별칭으로 접었다.
+  list: "agents",
+  network: "workforce",
+  taskforce: "workforce",
+  film: "oberon",
+};
+
+/*
+ * 제거된 명령 — 이름을 그냥 없애면 인자와 함께 프롬프트로 새어 유료 턴이 된다
+ * (아래 marketplace 사고 주석과 같은 계열). 착지 안내를 두고 arity 무관하게 잡는다.
+ */
+const REMOVED_COMMANDS = {
+  journal: {
+    en: "`journal` was removed — it reported \"ok\" for runs that do not exist and read the wrong folder.\nExperts: agentlas hep stormbreaker journal --run-id <id> --journal <path>",
+    ko: "`journal` 은 제거됐습니다 — 없는 실행에도 \"ok\" 를 답했고 다른 폴더를 봤습니다.\n전문가용: agentlas hep stormbreaker journal --run-id <id> --journal <path>",
+  },
+  "career-graph": {
+    en: "`career-graph` was removed — its read commands silently created project state.\nSources: agentlas ontology   ·   Index: hephaestus career-graph ingest --project .",
+    ko: "`career-graph` 는 제거됐습니다 — 조회 명령이 말없이 프로젝트 상태를 만들었습니다.\n소스: agentlas ontology   ·   색인: hephaestus career-graph ingest --project .",
+  },
+  plugins: {
+    en: "Use: agentlas plugin list",
+    ko: "이렇게 쓰세요: agentlas plugin list",
+  },
 };
 
 function resolveCommandName(cmd) {
@@ -189,6 +208,10 @@ function dispatch(ctx, argv) {
   // 낙하 가드부터 만들 것: 상위 오타 가드는 한 단어 전용이라 인자가 붙은
   // 삭제 이름은 프롬프트로 흘러 에이전트를 기동한다(실측·토큰 소모).
 
+  if (REMOVED_COMMANDS[cmd]) {
+    ctx.err(REMOVED_COMMANDS[cmd][ctx.lang === "ko" ? "ko" : "en"]);
+    return 1;
+  }
   if (DESKTOP_ONLY_SURFACES[cmd]) {
     const asTask = [rawCmd, ...rest].join(" ");
     ctx.err(`${DESKTOP_ONLY_SURFACES[cmd]}\nIt was not run as a prompt — rerun with quotes if you meant a task: agentlas "${asTask}"`);
@@ -207,4 +230,4 @@ function dispatch(ctx, argv) {
   return undefined; // 알 수 없는 토큰 — 엔진이 에이전트 이름/프롬프트로 해석 시도
 }
 
-module.exports = { dispatch, COMMANDS, COMMAND_ALIASES, resolveCommandName, SELF_HELP_COMMANDS, NOT_YET_PORTED, GUARDED_NO_ARG, DESKTOP_ONLY_SURFACES };
+module.exports = { dispatch, COMMANDS, COMMAND_ALIASES, resolveCommandName, SELF_HELP_COMMANDS, NOT_YET_PORTED, GUARDED_NO_ARG, DESKTOP_ONLY_SURFACES, REMOVED_COMMANDS };

package/engine/ui/commands-catalog.cjs

@@ -0,0 +1,217 @@
+"use strict";
+/*
+ * ui/commands-catalog — 명령 정본 한 벌 (2026-08-11 전면 재작성).
+ *
+ * 배경: 같은 목록이 네 곳에 손으로 유지되고 있었다 — palette.SLASH_COMMANDS(71행),
+ * help.HELP(EN 61줄), help.HELP_KO(133줄), shell.toSlashCommands(파생). 넷이 서로
+ * 어긋난 것이 결함 대부분의 기계적 원인이었다:
+ *   · 영문 화면에 한글 인자 힌트(`/graph [run <이름>]`)
+ *   · 같은 기능이 서로 다른 설명으로 두 줄(`search "<what you need>"` vs `"<필요한 것>"`)
+ *   · renderPalette 가 설명 텍스트로 중복 제거 → `/switch` `/list` `/exit` 가 조용히 사라짐
+ *   · /help 가 표면마다 61 / 133 / 67줄
+ *
+ * 그래서 정본을 하나로 합치고, 별칭은 **행이 아니라 필드**로 둔다. 별칭이 행이 아니면
+ * 중복 설명 자체가 생기지 않으므로 위 dedup 이 필요 없어지고, 숨김 사고가 구조적으로 막힌다.
+ *
+ * 불변식(게이트 test/command-surface-contract.cjs 가 잠근다):
+ *  - COMMANDS 키 ↔ 카탈로그 행 1:1. 예외는 surfaces:["repl"] (셸 switch 가 직접 처리).
+ *  - args 는 ASCII 정본. 한국어는 argsKo 로만 — 언어 혼재 금지.
+ *  - tier "core" 만 기본 /help 에 나온다. 나머지는 /help all. 단 Tab 완성은 전부 된다
+ *    (완성에서 숨기는 것이 바로 `/switch` 결함이었다).
+ */
+
+const { visWidth } = require("./width.cjs");
+
+const GROUPS = [
+  { key: "start", ko: "시작", en: "Start here" },
+  { key: "work", ko: "일 시키기", en: "Do work" },
+  { key: "agents", ko: "에이전트", en: "Agents" },
+  { key: "automate", ko: "자동화", en: "Automate" },
+  { key: "session", ko: "세션 (셸 안에서만)", en: "Sessions (in-shell only)" },
+  { key: "settings", ko: "설정 (셸 안에서만)", en: "Settings (in-shell only)" },
+  { key: "account", ko: "계정·자산", en: "Account & assets" },
+  { key: "knowledge", ko: "프로젝트 지식", en: "Project knowledge" },
+  { key: "advanced", ko: "고급", en: "Advanced" },
+];
+
+const CLI = ["cli"];
+const BOTH = ["cli", "repl"];
+const REPL = ["repl"];
+
+/* eslint-disable max-len */
+const CATALOG = [
+  // ── 1 start ───────────────────────────────────────────────────────────────
+  { name: "setup", group: "start", tier: "core", surfaces: CLI, args: "", ko: "첫 실행 마법사 — 언어·런타임·권한", en: "First-run wizard — language, runtime, permission" },
+  { name: "doctor", group: "start", tier: "core", surfaces: BOTH, args: "[--json]", ko: "설치 상태 점검", en: "Check this installation" },
+  { name: "login", group: "start", tier: "core", surfaces: BOTH, args: "[--force]", ko: "Agentlas 로그인 (--force 로 계정 전환)", en: "Sign in to Agentlas (--force switches account)" },
+  { name: "help", group: "start", tier: "core", surfaces: BOTH, args: "[all|<command>]", argsKo: "[all|<명령>]", ko: "명령 보기 (all = 전체 목록)", en: "Show commands (all = the full list)" },
+
+  // ── 2 work ────────────────────────────────────────────────────────────────
+  { name: "run", group: "work", tier: "core", surfaces: CLI, args: '[agent] "<task>"', argsKo: '[에이전트] "<작업>"', ko: "이 프로젝트 컨트롤러로 1회 실행", en: "Run once with this project's controller" },
+  { name: "project", group: "work", tier: "core", surfaces: BOTH, args: "[status|use <agent>]", argsKo: "[status|use <에이전트>]", ko: "이 폴더를 프로젝트로 연결", en: "Connect this folder to a project" },
+  { name: "storm", group: "work", tier: "core", surfaces: BOTH, args: '"<goal>"', argsKo: '"<목표>"', ko: "목표 하나를 계획→실행→검증까지", en: "Drive one goal: plan, execute, verify" },
+  { name: "workforce", group: "work", tier: "core", surfaces: BOTH, aliases: ["network", "taskforce"], args: '"<request>"', argsKo: '"<요청>"', ko: "여러 에이전트를 편성해 실행 (공개 Hub)", en: "Staff several agents and run (public Hub)" },
+  { name: "call", group: "work", tier: "core", surfaces: BOTH, aliases: ["hep-call"], args: '"a,b" "<context>"', argsKo: '"a,b" "<맥락>"', ko: "이름을 아는 에이전트를 직접 호출", en: "Call agents you name" },
+
+  // ── 3 agents ──────────────────────────────────────────────────────────────
+  { name: "agents", group: "agents", tier: "core", surfaces: BOTH, aliases: ["list"], args: "[--json]", ko: "설치된 에이전트·팀", en: "Installed agents and teams" },
+  { name: "search", group: "agents", tier: "core", surfaces: BOTH, aliases: ["hep-search"], args: '"<what you need>"', argsKo: '"<필요한 것>"', ko: "Hub에서 에이전트 찾기", en: "Find agents in the Hub" },
+  { name: "install", group: "agents", tier: "core", surfaces: BOTH, args: "<slug>", ko: "Hub 에이전트 설치", en: "Install an agent from the Hub" },
+  { name: "build", group: "agents", tier: "core", surfaces: BOTH, aliases: ["hep-build"], args: '"<the agent you want>"', argsKo: '"<원하는 에이전트>"', ko: "에이전트를 여기서 만들어 바로 설치 (쓰기 권한)", en: "Build an agent here and install it (runs with write permission)" },
+  { name: "roles", group: "agents", tier: "core", surfaces: BOTH, args: "[set <role> <runtime>]", argsKo: "[set <역할> <런타임>]", ko: "오케스트레이터·워커 모델 지정", en: "Set the orchestrator and worker models" },
+
+  // ── 4 automate ────────────────────────────────────────────────────────────
+  { name: "automation", group: "automate", tier: "core", surfaces: BOTH, args: "[list|add|on|off|run]", ko: "예약 실행", en: "Scheduled runs" },
+  { name: "graph", group: "automate", tier: "core", surfaces: BOTH, args: "[list|show|run <name>]", argsKo: "[list|show|run <이름>]", ko: "저장된 자동화 그래프", en: "Saved automation graphs" },
+
+  // ── 5 session (셸 전용) ───────────────────────────────────────────────────
+  { name: "sessions", group: "session", tier: "core", surfaces: REPL, aliases: ["tree"], args: "", ko: "지금 도는 세션 목록", en: "Sessions running now" },
+  { name: "s", group: "session", tier: "core", surfaces: REPL, aliases: ["switch"], args: "<n>", ko: "그 세션으로 전환", en: "Switch to that session" },
+  { name: "kill", group: "session", tier: "core", surfaces: REPL, args: "<n>", ko: "그 세션의 턴 중단", en: "Interrupt that session's turn" },
+  { name: "rm", group: "session", tier: "core", surfaces: REPL, args: "<n>", ko: "그 세션 닫기", en: "Close that session" },
+  { name: "quit", group: "session", tier: "core", surfaces: REPL, aliases: ["exit"], args: "", ko: "종료", en: "Quit" },
+
+  // ── 6 settings (셸 전용 · 전부 세션 한정, 영구 경로를 설명에 못박는다) ────
+  { name: "permission", group: "settings", tier: "core", surfaces: REPL, args: "read|write|full", ko: "이 셸의 새 세션 권한 (영구: agentlas setup)", en: "Permission for new sessions here (persist: agentlas setup)" },
+  { name: "model", group: "settings", tier: "core", surfaces: REPL, args: "<id|default>", ko: "이 셸의 새 세션 모델 (영구: agentlas roles set)", en: "Model for new sessions here (persist: agentlas roles set)" },
+  { name: "runtime", group: "settings", tier: "core", surfaces: REPL, args: "<kind>", ko: "이 셸의 새 세션 런타임 (영구: agentlas roles set)", en: "Runtime for new sessions here (persist: agentlas roles set)" },
+  { name: "effort", group: "settings", tier: "core", surfaces: REPL, args: "<level>", ko: "이 셸의 새 세션 추론 강도 (영구: agentlas roles set --effort)", en: "Reasoning effort for new sessions here (persist: agentlas roles set --effort)" },
+  { name: "shell", group: "settings", tier: "core", surfaces: REPL, args: "on|off", ko: "새 대화형 셸 켜기/끄기", en: "Turn the new interactive shell on or off" },
+
+  // ── 7 account ─────────────────────────────────────────────────────────────
+  { name: "whoami", group: "account", tier: "more", surfaces: BOTH, args: "", ko: "로그인 계정 확인", en: "Show the signed-in account" },
+  { name: "logout", group: "account", tier: "more", surfaces: BOTH, args: "", ko: "로그아웃", en: "Sign out" },
+  { name: "billing", group: "account", tier: "more", surfaces: BOTH, args: "", ko: "크레딧 잔액 (구독·대여 수익)", en: "Credit balances (subscription and rental earnings)" },
+  { name: "usage", group: "account", tier: "more", surfaces: BOTH, args: "", ko: "이 설치의 사용 현황", en: "Local usage on this install" },
+  { name: "cloud", group: "account", tier: "more", surfaces: BOTH, args: "<save|publish|list|...>", ko: "Agent Cloud 자산", en: "Agent Cloud assets" },
+  { name: "upload", group: "account", tier: "more", surfaces: BOTH, aliases: ["hep-upload"], args: "<path> [--visibility ...]", argsKo: "<경로> [--visibility ...]", ko: "기본은 비공개 저장, --visibility marketplace 로 공개 발행", en: "Owner-private by default; --visibility marketplace publishes" },
+  { name: "uninstall", group: "account", tier: "more", surfaces: BOTH, args: "<slug> [--yes]", ko: "에이전트 삭제 (대화 기록도 함께 지워짐)", en: "Delete an agent (its chats are deleted too)" },
+  { name: "update", group: "account", tier: "more", surfaces: BOTH, args: "[--json]", ko: "npm 업데이트 확인", en: "Check for an npm update" },
+  { name: "version", group: "account", tier: "more", surfaces: BOTH, args: "", ko: "버전", en: "Version" },
+
+  // ── 8 knowledge ───────────────────────────────────────────────────────────
+  { name: "ontology", group: "knowledge", tier: "more", surfaces: BOTH, args: "[status|list|add <path>]", argsKo: "[status|list|add <경로>]", ko: "이 프로젝트가 읽을 지식 소스 등록", en: "Register the knowledge sources this project may read" },
+  { name: "context", group: "knowledge", tier: "more", surfaces: BOTH, args: "<locate|slice|impact|...>", ko: "코드 의존성 맵 (Agentlas OS Core 필요)", en: "Code dependency map (requires Agentlas OS Core)" },
+  { name: "memory", group: "knowledge", tier: "more", surfaces: BOTH, args: "<sub>", ko: "메모리", en: "Memory" },
+  { name: "experience", group: "knowledge", tier: "more", surfaces: BOTH, args: "<list|inspect|save|...>", ko: "이식 가능한 Experience", en: "Portable Experience" },
+  { name: "evolve", group: "knowledge", tier: "more", surfaces: BOTH, args: "", ko: "프롬프트 진화 제안", en: "Prompt-evolution proposals" },
+
+  // ── 9 advanced ────────────────────────────────────────────────────────────
+  { name: "route", group: "advanced", tier: "more", surfaces: BOTH, args: '"<request>"', argsKo: '"<요청>"', ko: "이 요청에 맞는 에이전트로 라우팅", en: "Route this request to the right agent" },
+  { name: "swarm", group: "advanced", tier: "more", surfaces: BOTH, args: '"<goal>" [--parallel N]', argsKo: '"<목표>" [--parallel N]', ko: "창발형 에이전트 스웜", en: "Emergent agent swarm" },
+  { name: "hep-network", group: "advanced", tier: "more", surfaces: BOTH, aliases: ["legacy-network"], args: '"<request>"', argsKo: '"<요청>"', ko: "로컬+오너 클라우드+공개 Hub 연합 편성 (로컬 Core 필요)", en: "Staff across Local + owner Cloud + public Hub (needs local Core)" },
+  { name: "hep-local", group: "advanced", tier: "more", surfaces: BOTH, args: '"<request>"', argsKo: '"<요청>"', ko: "등록된 로컬 에이전트만으로 편성 (로컬 Core 필요)", en: "Staff from registered Local agents only (needs local Core)" },
+  { name: "hep-cloud", group: "advanced", tier: "more", surfaces: BOTH, args: '"<request>"', argsKo: '"<요청>"', ko: "오너 Agent Cloud만으로 편성 (로그인·로컬 Core 필요)", en: "Staff from owner Agent Cloud only (needs sign-in + local Core)" },
+  { name: "hep-hub", group: "advanced", tier: "more", surfaces: BOTH, args: '"<request>"', argsKo: '"<요청>"', ko: "공개 Hub 에이전트만으로 편성 (로컬 Core 필요)", en: "Staff from public Hub agents only (needs local Core)" },
+  { name: "firm", group: "advanced", tier: "more", surfaces: CLI, args: "<firm> [task]", argsKo: "<회사> [작업]", ko: "회사 CEO에게 위임", en: "Delegate to a company CEO" },
+  { name: "import", group: "advanced", tier: "more", surfaces: BOTH, args: "<path>", argsKo: "<경로>", ko: "로컬 폴더 에이전트 가져오기", en: "Import a local folder agent" },
+  { name: "cd", group: "advanced", tier: "more", surfaces: BOTH, args: "<agent>", argsKo: "<에이전트>", ko: "그 에이전트의 폴더 경로를 출력", en: "Print that agent's folder path" },
+  { name: "native", group: "advanced", tier: "more", surfaces: BOTH, args: "prepare <agent>", argsKo: "prepare <에이전트>", ko: "네이티브 CLI 컨텍스트 생성", en: "Prepare native CLI context" },
+  { name: "mcp", group: "advanced", tier: "more", surfaces: BOTH, args: "[list|probe <id>]", ko: "MCP 서버", en: "MCP servers" },
+  { name: "plugin", group: "advanced", tier: "more", surfaces: BOTH, args: "<add <slug>|list|remove>", ko: "Hub 플러그인 (MCP 서버)", en: "Hub plugins (MCP servers)" },
+  { name: "creds", group: "advanced", tier: "more", surfaces: BOTH, args: "<list|save|file>", ko: "API 키 보관 (값은 절대 표시 안 함)", en: "API keys (values are never printed)" },
+  { name: "env", group: "advanced", tier: "more", surfaces: BOTH, args: "", ko: "공유 환경 변수 이름", en: "Shared env key names" },
+  { name: "multimodal", group: "advanced", tier: "more", surfaces: BOTH, args: "[set <kind> <provider>]", ko: "이미지·영상·음성 제공자", en: "Image, video and audio providers" },
+  { name: "telegram", group: "advanced", tier: "more", surfaces: BOTH, args: "[sub]", ko: "텔레그램 연결", en: "Telegram bindings" },
+  { name: "connect", group: "advanced", tier: "more", surfaces: BOTH, aliases: ["hep-connect"], args: "<target>", argsKo: "<대상>", ko: "에이전트·팀 연결", en: "Connect an agent or team" },
+  { name: "browser", group: "advanced", tier: "more", surfaces: BOTH, aliases: ["hep-browser"], args: "<url|status|sites|login>", ko: "브라우저 하드포인트", en: "Browser hardpoint" },
+  { name: "research", group: "advanced", tier: "more", surfaces: BOTH, args: "<sub>", ko: "리서치", en: "Research" },
+  { name: "document", group: "advanced", tier: "more", surfaces: BOTH, args: "pdf <html|url>", ko: "문서 PDF 내보내기", en: "Export a document to PDF" },
+  { name: "oberon", group: "advanced", tier: "more", surfaces: BOTH, aliases: ["film"], args: "<scaffold|render|list|open>", ko: "AI 필름 렌더", en: "AI film render" },
+  { name: "variant", group: "advanced", tier: "more", surfaces: BOTH, args: "resolve --base-release", ko: "로컬 변형 선택", en: "Local variant selection" },
+  { name: "netadmin", group: "advanced", tier: "more", surfaces: BOTH, args: "<init|status|reindex|...>", ko: "로컬 에이전트 네트워크 관리", en: "Local agent network administration" },
+  { name: "hep", group: "advanced", tier: "more", surfaces: BOTH, aliases: ["hep-storm"], args: "<sub...>", ko: "Hephaestus 패스스루 (전문가용)", en: "Hephaestus passthrough (expert)" },
+];
+/* eslint-enable max-len */
+
+const BY_NAME = new Map();
+const ALIAS_TO_NAME = new Map();
+for (const entry of CATALOG) {
+  BY_NAME.set(entry.name, entry);
+  for (const alias of entry.aliases || []) ALIAS_TO_NAME.set(alias, entry.name);
+}
+
+function byName(name) {
+  const key = String(name || "").replace(/^\//, "");
+  return BY_NAME.get(key) || BY_NAME.get(ALIAS_TO_NAME.get(key)) || null;
+}
+function aliasMap() { return Object.fromEntries(ALIAS_TO_NAME); }
+function argsFor(entry, lang) { return (lang === "ko" && entry.argsKo) || entry.args || ""; }
+function descFor(entry, lang) { return lang === "ko" ? entry.ko : entry.en; }
+function usageFor(entry, lang) {
+  const args = argsFor(entry, lang);
+  return entry.name + (args ? " " + args : "");
+}
+function forSurface(surface) { return CATALOG.filter((e) => e.surfaces.includes(surface)); }
+
+const padVis = (text, width) => text + " ".repeat(Math.max(0, width - visWidth(text)));
+
+/*
+ * 정렬은 visWidth 로 잰다 — String.length 로 재면 한글 한 글자를 1칸으로 세어
+ * 설명 열이 어긋난다(현행 palette.cjs 의 결함).
+ */
+function renderHelp(options = {}) {
+  const lang = options.lang === "ko" ? "ko" : "en";
+  const surface = options.surface === "repl" ? "repl" : "cli";
+  const all = options.all === true;
+  const ko = lang === "ko";
+  const rows = forSurface(surface).filter((e) => all || e.tier === "core");
+  if (!rows.length) return "";
+  /*
+   * 머리말은 명령표가 아니라 "이게 무엇이고 어떻게 시작하나"다. 예전 HELP_KO 가
+   * 들고 있던 제품 한 줄(터미널 속 에이전트 운영체제)을 여기로 옮겼다 —
+   * 그 문장이 사라지면 첫 화면이 명령 나열로만 시작한다.
+   */
+  const head = [];
+  {
+    let version = "";
+    try { version = require("../agentlas-banner.cjs").readVersion(); } catch { version = ""; }
+    head.push(`agentlas${version ? " " + version : ""} — ${ko ? "터미널 속 에이전트 운영체제" : "the agent operating system in your terminal"}`);
+    head.push("");
+    if (surface === "cli") {
+      head.push(ko ? '  agentlas                     셸 열기' : '  agentlas                     open the shell');
+      head.push(ko ? '  agentlas "<하고 싶은 일>"     한 번 실행' : '  agentlas "<what you want>"   run once');
+    }
+    head.push(ko
+      ? "  셸 안에서는 그냥 문장을 치면 실행됩니다 · / 를 누르면 명령이 뜹니다"
+      : "  In the shell, plain words run a task · press / for commands");
+  }
+  // 셸에서 셸 전용 명령은 슬래시를 붙여 보여준다 — 그게 실제로 치는 문자열이다.
+  const label = (e) => (surface === "repl" && e.surfaces.length === 1 ? "/" : "") + usageFor(e, lang);
+  /*
+   * 라벨 열에 상한을 둔다. 상한이 없으면 가장 긴 한 줄(automation 의 서브명령 나열)이
+   * 전체 열을 밀어 80칸 터미널에서 설명이 통째로 줄바꿈되고, 이어지는 줄은 들여쓰기를
+   * 잃는다. 상한을 넘는 소수 행만 자기 열을 넘어가고 나머지는 정렬을 지킨다.
+   */
+  const LABEL_CAP = 34;
+  const width = Math.min(LABEL_CAP, Math.max(...rows.map((e) => visWidth(label(e)))));
+  const out = head.slice();
+  for (const group of GROUPS) {
+    const inGroup = rows.filter((e) => e.group === group.key);
+    if (!inGroup.length) continue;
+    out.push("", ko ? group.ko : group.en);
+    for (const e of inGroup) {
+      const text = label(e);
+      // 상한을 넘는 라벨은 정렬을 포기하되 설명과 붙지는 않게 최소 두 칸을 보장한다.
+      const gap = visWidth(text) >= width ? "  " : " ".repeat(width + 2 - visWidth(text));
+      out.push(`  ${text}${gap}${descFor(e, lang)}`);
+    }
+  }
+  if (!all) {
+    const hidden = forSurface(surface).length - rows.length;
+    if (hidden > 0) {
+      out.push("", ko
+        ? `  나머지 ${hidden}개 명령: ${surface === "repl" ? "/help all" : "agentlas help all"}`
+        : `  ${hidden} more: ${surface === "repl" ? "/help all" : "agentlas help all"}`);
+    }
+  } else {
+    const withAliases = CATALOG.filter((e) => (e.aliases || []).length);
+    if (withAliases.length) {
+      out.push("", ko ? "  같은 명령의 다른 이름" : "  Other names for the same command");
+      out.push("  " + withAliases.map((e) => `${e.name} (= ${e.aliases.join(", ")})`).join(" · "));
+    }
+  }
+  return out.join("\n").replace(/^\n/, "");
+}
+
+module.exports = { GROUPS, CATALOG, byName, aliasMap, argsFor, descFor, usageFor, forSurface, renderHelp };

package/engine/ui/palette.cjs

@@ -11,89 +11,21 @@
 const { completePath, isAbsolutePathTask } = require("../agentlas-input.cjs");
 
 // command, 인자 힌트, 한 줄 설명 — /help 팔레트와 Tab 완성이 같은 정본을 쓴다.
-const SLASH_COMMANDS = [
-  { command: "/help", args: "", ko: "명령·단축키 보기", en: "Show commands and shortcuts" },
-  { command: "/sessions", args: "", ko: "세션 표", en: "Session table" },
-  { command: "/tree", args: "", ko: "세션 트리", en: "Session tree" },
-  { command: "/s", args: "<n>", ko: "활성 세션 전환", en: "Switch active session" },
-  { command: "/switch", args: "<n>", ko: "활성 세션 전환", en: "Switch active session" },
-  { command: "/kill", args: "<n>", ko: "실행 중 턴 중단", en: "Interrupt a running turn" },
-  { command: "/rm", args: "<n>", ko: "세션 제거", en: "Remove a session" },
-  { command: "/agents", args: "", ko: "설치 에이전트 목록", en: "List installed agents" },
-  { command: "/list", args: "", ko: "설치 에이전트 목록", en: "List installed agents" },
-  { command: "/graph", args: "[run <이름>]", ko: "저장된 자동화 그래프", en: "Saved automation graphs" },
-  { command: "/mcp", args: "", ko: "MCP 서버 목록", en: "MCP servers" },
-  { command: "/doctor", args: "", ko: "런타임·데이터 점검", en: "Health check" },
-  { command: "/runtime", args: "<kind>", ko: "새 세션 런타임 지정", en: "Set runtime for new sessions" },
-  { command: "/model", args: "<id|default>", ko: "새 세션 모델 지정", en: "Set model for new sessions" },
-  { command: "/effort", args: "<level|none>", ko: "새 세션 추론 강도 지정", en: "Set effort for new sessions" },
-  { command: "/permission", args: "<level>", ko: "새 세션 권한 지정", en: "Set permission for new sessions" },
-  { command: "/login", args: "", ko: "Agentlas Cloud 로그인", en: "Sign in to Agentlas Cloud" },
-  { command: "/whoami", args: "", ko: "로그인 상태", en: "Signed-in account" },
-  { command: "/search", args: "\"<what you need>\"", ko: "Hub 에이전트 검색", en: "Search Hub agents" },
-  { command: "/install", args: "<slug>", ko: "Hub 에이전트 설치", en: "Install a Hub agent" },
-  { command: "/usage", args: "", ko: "로컬 사용 현황", en: "Local usage" },
-  { command: "/billing", args: "", ko: "크레딧 잔액", en: "Credit balance" },
-  { command: "/automation", args: "[sub]", ko: "자동화", en: "Automations" },
-  { command: "/storm", args: "<goal>", ko: "Goal+UltraCode 하니스", en: "Goal+UltraCode harness" },
-  { command: "/swarm", args: "<goal>", ko: "에이전트 스웜", en: "Agent swarm" },
-  { command: "/network", args: "<request>", ko: "Workforce 라우트", en: "Workforce route" },
-  { command: "/workforce", args: "<request>", ko: "Workforce 라우트", en: "Workforce route" },
-  { command: "/taskforce", args: "<request>", ko: "임시 태스크포스 편성", en: "Assemble a task force" },
-  // 소스 스코프 편성 4종 — 2026-08-05 같은 날 삭제 후 네이티브 배선으로 복원.
-  // 이전에는 외부 CLI 스텁(exit 3)이라 죽은 메뉴였다. 지금은 이 터미널의 편성
-  // 루프가 직접 돌고 로컬 Agentlas-OS Core가 선언된 스코프의 메뉴를 연합한다.
-  // 팔레트 문구가 곧 사용자에게 하는 약속이다 — 스코프를 문장에 적는다.
-  { command: "/hep-network", args: "\"<request>\"", ko: "로컬+오너 클라우드+공개 Hub 연합 편성", en: "Staff across Local + owner Cloud + public Hub" },
-  { command: "/hep-local", args: "\"<request>\"", ko: "등록된 로컬 에이전트만으로 편성", en: "Staff from registered Local agents only" },
-  { command: "/hep-cloud", args: "\"<request>\"", ko: "오너 Agent Cloud만으로 편성", en: "Staff from owner Agent Cloud only" },
-  { command: "/hep-hub", args: "\"<request>\"", ko: "공개 Hub 에이전트만으로 편성", en: "Staff from public Hub agents only" },
-  { command: "/build", args: "\"<request>\"", ko: "에이전트·팀 제작/수리/패키징", en: "Build, repair or package an agent or team" },
-  { command: "/call", args: "\"a,b\" \"<ctx>\"", ko: "지정 에이전트 호출", en: "Call named agents" },
-  { command: "/route", args: "\"<req>\"", ko: "최적 에이전트 라우팅", en: "Route to the best agent" },
-  { command: "/browser", args: "[sub]", ko: "브라우저 하드포인트", en: "Browser hardpoint" },
-  { command: "/connect", args: "<target>", ko: "에이전트·팀 연결", en: "Connect an agent or team" },
-  { command: "/research", args: "<sub>", ko: "리서치", en: "Research" },
-  { command: "/upload", args: "<path>", ko: "Agent Cloud에 저장·발행", en: "Save to Agent Cloud or publish" },
-  { command: "/cloud", args: "<sub>", ko: "클라우드 자산 관리", en: "Cloud assets" },
-  { command: "/import", args: "<path>", ko: "로컬 폴더 에이전트 가져오기", en: "Import a local folder agent" },
-  { command: "/cd", args: "[path]", ko: "작업 폴더 이동", en: "Change working folder" },
-  { command: "/native", args: "prepare <agent>", ko: "네이티브 CLI 컨텍스트 생성", en: "Prepare native CLI context" },
-  { command: "/plugin", args: "<sub>", ko: "Hub 플러그인(MCP)", en: "Hub plugins (MCP servers)" },
-  { command: "/plugins", args: "", ko: "설치된 플러그인", en: "Installed plugins" },
-  { command: "/experience", args: "<sub>", ko: "이식 가능한 Experience", en: "Portable Experience" },
-  { command: "/variant", args: "resolve", ko: "로컬 변형 선택", en: "Local variant selection" },
-  { command: "/memory", args: "<sub>", ko: "메모리", en: "Memory" },
-  { command: "/evolve", args: "", ko: "프롬프트 진화 제안", en: "Prompt-evolution proposals" },
-  // 데스크탑의 `ontology` 는 Core 의 지식·메모리 **런타임**(임베딩 포함)이고, 터미널의
-  // 이것은 **이 프로젝트의 지식 소스 등록부**다. 서로 다른 것이 같은 이름을 쓰고 있어
-  // (감사 D6) 라벨이라도 정확해야 한다 — 명령 이름은 사용자 습관과 스크립트가 걸려
-  // 있어 바꾸지 않는다. Core 의 지식 런타임은 터미널에 아직 미노출이다(결함 아님).
-  { command: "/ontology", args: "", ko: "프로젝트 지식 소스 등록", en: "Project knowledge sources" },
-  { command: "/career-graph", args: "", ko: "소스 라우팅 그래프", en: "Source routing graph" },
-  { command: "/journal", args: "<sub>", ko: "Stormbreaker 실행 일지", en: "Stormbreaker run journal" },
-  { command: "/project", args: "[status|init]", ko: ".agentlas 프로젝트 상태", en: "Private project state" },
-  { command: "/context", args: "<sub>", ko: "의존성 맵", en: "Dependency map" },
-  { command: "/creds", args: "<sub>", ko: "자격증명", en: "Credentials" },
-  { command: "/env", args: "", ko: "공유 환경 키", en: "Shared env keys" },
-  { command: "/multimodal", args: "", ko: "이미지·영상·음성 설정", en: "Image/video/audio providers" },
-  { command: "/document", args: "pdf <html|url>", ko: "문서 PDF 내보내기", en: "Export a document to PDF" },
-  { command: "/roles", args: "[set <role> <runtime>]", ko: "오케스트레이터·워커 모델 역할 조회/설정", en: "Show or set orchestrator/worker model roles" },
-  { command: "/telegram", args: "[sub]", ko: "텔레그램 연결", en: "Telegram bindings" },
-  { command: "/oberon", args: "[sub]", ko: "AI 필름", en: "AI film" },
-  { command: "/film", args: "<sub>", ko: "필름 렌더", en: "Film render" },
-  { command: "/hep", args: "<sub…>", ko: "Hephaestus 패스스루", en: "Hephaestus passthrough" },
-  // "네트워크"만 쓰면 WiFi·LAN 관리로 읽힌다. 이 명령이 다루는 것은 로컬
-  // 에이전트 네트워크(init|status|reindex|bench|add-source)다.
-  { command: "/netadmin", args: "[sub]", ko: "로컬 에이전트 네트워크 관리", en: "Local agent network" },
-  { command: "/update", args: "", ko: "npm 업데이트 확인", en: "npm update check" },
-  { command: "/version", args: "", ko: "버전", en: "Version" },
-  { command: "/logout", args: "", ko: "로그아웃", en: "Sign out" },
-  // 대화가 있으면 --yes 없이는 거절한다(챗/메시지 CASCADE 삭제) — 팔레트에도 노출.
-  { command: "/uninstall", args: "<slug> [--yes]", ko: "에이전트 제거", en: "Uninstall an agent" },
-  { command: "/quit", args: "", ko: "종료", en: "Quit" },
-  { command: "/exit", args: "", ko: "종료", en: "Quit" },
-];
+const catalog = require("./commands-catalog.cjs");
+
+/*
+ * 정본은 ui/commands-catalog.cjs 하나다(2026-08-11). 여기 있던 71행 리터럴은
+ * help.cjs 의 EN/KO 블록과 어긋나 언어 혼재·중복 숨김을 만들었다.
+ */
+const SLASH_COMMANDS = catalog.forSurface("repl").map((entry) => ({
+  command: "/" + entry.name,
+  args: entry.args || "",
+  argsKo: entry.argsKo,
+  ko: entry.ko,
+  en: entry.en,
+  group: entry.group,
+  tier: entry.tier,
+}));
 
 const SLASH_NAMES = SLASH_COMMANDS.map((c) => c.command);
 const RUNTIME_KINDS = ["claude-code", "codex", "gemini"];
@@ -156,9 +88,9 @@ function suggestions(line, limit = 12, lang = "en") {
   const rows = SLASH_COMMANDS.map((entry) => ({
     command: entry.command,
     description: ko ? entry.ko : entry.en,
-    usage: entry.command + (entry.args ? " " + entry.args : ""),
+    usage: "/" + catalog.usageFor(catalog.byName(entry.command) || entry, lang),
     detail: "",
-    category: "",
+    category: entry.group || "",
     examples: [],
   }));
   const q = value.toLowerCase();
@@ -172,14 +104,13 @@ function suggestions(line, limit = 12, lang = "en") {
   return starts.concat(contains).slice(0, limit);
 }
 
-/** /help 팔레트 렌더 — Tab 완성과 같은 정본에서 나온다. */
-function renderPalette(lang) {
-  const ko = lang === "ko";
-  const width = Math.max(...SLASH_COMMANDS.map((c) => (c.command + " " + c.args).length));
-  return SLASH_COMMANDS
-    .filter((c, i, all) => all.findIndex((x) => (ko ? x.ko : x.en) === (ko ? c.ko : c.en)) === i)
-    .map((c) => `  ${(c.command + (c.args ? " " + c.args : "")).padEnd(width + 2)}${ko ? c.ko : c.en}`)
-    .join("\n");
+/*
+ * /help 팔레트 — CLI 와 완전히 같은 렌더러를 쓴다. 예전엔 여기서 설명 텍스트로
+ * 중복 제거를 해서 `/switch` `/list` `/exit` 가 조용히 사라졌다. 별칭이 필드가 된
+ * 지금은 중복 자체가 없으므로 그 필터도 없다.
+ */
+function renderPalette(lang, opts = {}) {
+  return catalog.renderHelp({ lang, surface: "repl", all: opts.all === true });
 }
 
 module.exports = { SLASH_COMMANDS, SLASH_NAMES, makeCompleter, renderPalette, suggestions };

package/engine/ui/repl.cjs

@@ -125,11 +125,17 @@ async function startRepl(ctx, opts = {}) {
   }
 
   /*
-   * 대화형 셸 opt-in (D3 Phase 2): AGENTLAS_TUI=1 + TTY.
-   * 온보딩 마법사(위 readline 블록)가 먼저 끝난 뒤 진입한다 — 순차 실행이라
-   * stdin 경합이 없고, 첫 실행 사용자도 새 셸을 쓸 수 있다(증분 2c).
+   * 대화형 셸 (D3 Phase 2~3). 온보딩 마법사(위 readline 블록)가 먼저 끝난 뒤
+   * 진입한다 — 순차 실행이라 stdin 경합이 없다.
+   *
+   * 선택 순서: 환경변수 > 저장된 설정. 환경변수는 그 실행에만, prefs.shell 은
+   * 영속이다(/shell on 으로 저장). 매번 환경변수를 치게 만들면 아무도 안 쓴다.
    */
-  if (/^(1|true|on)$/i.test(String(process.env.AGENTLAS_TUI || "")) && process.stdin.isTTY) {
+  const shellEnv = String(process.env.AGENTLAS_TUI || "").trim();
+  const shellChoice = shellEnv
+    ? /^(1|true|on)$/i.test(shellEnv)
+    : (ctx.prefs && ctx.prefs.shell) === "interactive";
+  if (shellChoice && process.stdin.isTTY) {
     return require("./shell.cjs").startShell(ctx, opts);
   }
   const orch = new Orchestrator({ db, lang: ctx.lang });
@@ -677,17 +683,34 @@ function handleSlash(ctx, cmdline, api) {
   switch (cmd) {
     case "quit": case "exit": return "quit";
     case "help": {
-      require("../commands/help.cjs").run(ctx, rest);
-      ctx.out("");
-      ctx.out(ui.c.bold(en ? "Project Work runs" : "프로젝트 Work 실행"));
-      // 팔레트는 Tab 완성과 같은 정본(ui/palette)에서 렌더한다 — 목록 드리프트 금지.
-      ctx.out(require("./palette.cjs").renderPalette(ctx.lang));
+      // CLI 와 같은 렌더러 한 번. 예전엔 CLI 61줄 + 팔레트 67줄 + 트레일러 = 133줄이었다.
+      ctx.out(require("./palette.cjs").renderPalette(ctx.lang, { all: String(rest[0] || "") === "all" }));
       ctx.out("");
       ctx.out(ctx.uiInstance.c.dim(en
-        ? "Tab completes commands, agent names and session keys · ↑/↓ history · typing during a run queues steering · ctrl-c interrupts"
-        : "Tab: 명령·에이전트·세션키 완성 · ↑/↓ 히스토리 · 실행 중 입력은 스티어링 큐 · ctrl-c 턴 중단"));
-      // 배너가 광고하는 Shift-Tab 은 여기에도 적힌다 — 문구와 구현은 한 곳에서 움직인다.
-      ctx.out(ctx.uiInstance.c.dim(`Shift-Tab: ${i18n.t(ctx.lang, "help.shiftTab")}`));
+        ? "Tab completes commands · ↑/↓ history · Shift-Tab cycles permission · ctrl-c interrupts a turn"
+        : "Tab: 명령 완성 · ↑/↓ 히스토리 · Shift-Tab 권한 순환 · ctrl-c 턴 중단"));
+      return;
+    }
+    case "shell": {
+      /*
+       * 새 대화형 셸 켜기/끄기. 저장하고 재실행을 안내한다 — 프로세스 중간에
+       * stdin 소유권을 바꾸면 지금 도는 readline 과 경합한다(실사고 계열).
+       */
+      const want = String(rest[0] || "").toLowerCase();
+      if (!["on", "off"].includes(want)) {
+        const now = (ctx.prefs && ctx.prefs.shell) === "interactive";
+        ui.line(ui.c.dim(`Usage: /shell on|off   (${en ? "currently" : "현재"}: ${now ? "on" : "off"})`));
+        return;
+      }
+      const config = require("../agentlas-config.cjs");
+      const { userDataDir } = require("../core/paths.cjs");
+      config.updatePrefs(userDataDir(), { shell: want === "on" ? "interactive" : "classic" });
+      if (ctx.prefs) ctx.prefs.shell = want === "on" ? "interactive" : "classic";
+      ui.line(ui.c.dim(want === "on"
+        ? (en ? "Interactive shell enabled — restart agentlas to enter it (/shell off to revert)."
+              : "대화형 셸을 켰습니다 — agentlas 를 다시 실행하면 그 화면으로 들어갑니다 (/shell off 로 되돌림).")
+        : (en ? "Interactive shell disabled — restart agentlas for the classic REPL."
+              : "대화형 셸을 껐습니다 — agentlas 를 다시 실행하면 기본 REPL 입니다.")));
       return;
     }
     case "agents": case "list": require("../commands/list.cjs").run(ctx, rest); return;

package/engine/ui/shell.cjs

@@ -47,9 +47,21 @@ function loadRenderer() {
 
 /* Ui 를 상속해 write 초크포인트만 렌더러로 돌린다. */
 class ShellUi extends Ui {
+  /*
+   * 실터미널 대신 dummy 스트림 — 놓친 직접 out.write 가 프레임을 찢는 대신 소멸한다.
+   * 단 columns 는 살려야 한다: Ui 의 줄바꿈·표·구분선이 전부 this.out.columns 를 읽는데
+   * PassThrough 에는 그 속성이 없어 전부 80/100 에 고정돼 있었다(폭 넓은 터미널에서
+   * 화면 절반만 쓰던 원인). 렌더러의 실제 폭을 게터로 물린다.
+   */
+  static _sinkFor(tui) {
+    const sink = new PassThrough();
+    Object.defineProperty(sink, "columns", {
+      get() { return (tui.terminal && tui.terminal.columns) || 80; },
+    });
+    return sink;
+  }
   constructor(opts, pi, tui, transcript) {
-    // 실터미널 대신 dummy 스트림 — 놓친 직접 out.write 가 프레임을 찢는 대신 소멸한다.
-    super({ ...opts, stream: new PassThrough(), color: true });
+    super({ ...opts, stream: ShellUi._sinkFor(tui), color: true });
     this._pi = pi;
     this._tui = tui;
     this._transcript = transcript;
@@ -59,7 +71,12 @@ class ShellUi extends Ui {
     this._loader = null;
   }
   _appendText(text) {
-    this._transcript.addChild(new this._pi.Text(String(text), 1, 0));
+    /*
+     * 벤더 Text.render 는 공백만 있는 줄에 [] 를 돌려준다 — screens.cjs 의 ui.line("")
+     * 22곳이 전부 조용히 사라져 화면이 한 덩어리로 붙어 있었다. 빈 줄은 Spacer 로.
+     */
+    const value = String(text);
+    this._transcript.addChild(value.trim() === "" ? new this._pi.Spacer(1) : new this._pi.Text(value, 1, 0));
     this._tui.requestRender();
   }
   write(s) {
@@ -101,7 +118,7 @@ class ShellUi extends Ui {
     this.stopSpinner();
     this.ensureNl();
     this._mdText = "";
-    this._md = new this._pi.Markdown("", 3, 0, this._mdTheme());
+    this._md = new this._pi.Markdown("", 1, 0, this._mdTheme());
     this._transcript.addChild(this._md);
     this._streaming = true;
   }
@@ -171,7 +188,16 @@ async function startShell(ctx, opts = {}) {
 
   const terminal = new pi.ProcessTerminal();
   const tui = new pi.TuiMainScreen(terminal);
-  const ui = new ShellUi({ lang: ctx.lang }, pi, tui, tui);
+  /*
+   * Container.render 는 삽입 순서로 그린다. 예전엔 헤더 3줄 뒤에 Editor 를 넣어서
+   * 입력면이 4번째 줄에 영구 고정됐고, 이후 모든 출력이 그 아래로 흘러 입력 상자가
+   * 화면 한가운데 박혔다. 위=트랜스크립트 / 아래=입력면 두 칸으로 나눈다.
+   */
+  const transcript = new pi.Container();
+  const bottom = new pi.Container();
+  tui.addChild(transcript);
+  tui.addChild(bottom);
+  const ui = new ShellUi({ lang: ctx.lang }, pi, tui, transcript);
 
   // ctx 초크포인트 재지정 — 55파일의 ctx.out 직출력이 전부 프레임 안으로 들어온다.
   const shellCtx = {
@@ -227,7 +253,26 @@ async function startShell(ctx, opts = {}) {
       description: ui.c.dim, scrollInfo: ui.c.faint, noMatch: ui.c.dim,
     },
   };
-  const editor = new pi.Editor(tui, editorTheme, { autocompleteMaxVisible: 8 });
+  /*
+   * 빈 입력 상자가 "구분선 사이의 빈 칸"으로 보이던 문제(오너 지적). 렌더러의 Editor 는
+   * placeholder 를 지원하지 않으므로, 비어 있을 때만 첫 내용 줄 뒤에 힌트를 덧붙인다.
+   * 커서는 그 줄에 이미 그려져 있으므로 교체가 아니라 append 여야 안전하다.
+   */
+  class ShellEditor extends pi.Editor {
+    render(width) {
+      const lines = super.render(width);
+      if (this.getText() === "" && lines.length >= 3) {
+        const hint = ui.c.faint(en
+          ? "type a task  ·  / for commands"
+          : "할 일을 문장으로  ·  / 명령");
+        // 에디터가 줄을 폭까지 공백으로 채운다 — 그대로 덧붙이면 힌트가 오른쪽 끝으로 밀린다.
+        // 꼬리 공백만 걷어내고 커서 바로 뒤에 붙인다(ANSI 리셋은 보존).
+        lines[1] = lines[1].replace(/[ \t]+(\u001b\[0m)?$/, "$1") + " " + hint;
+      }
+      return lines;
+    }
+  }
+  const editor = new ShellEditor(tui, editorTheme, { autocompleteMaxVisible: 8, paddingX: 1 });
   editor.setAutocompleteProvider(new pi.CombinedAutocompleteProvider(toSlashCommands(ctx.lang), process.cwd()));
 
   // ── 히스토리 디스크 영속 (증분 2) — cli-history.json v2 계약을 그대로 재사용 ──
@@ -253,11 +298,16 @@ async function startShell(ctx, opts = {}) {
   const commands = require("../commands/index.cjs");
   const handleSlash = async (cmdline) => {
     const raw = cmdline.split(/\s+/)[0] || "";
-    const rest = cmdline.slice(raw.length).trim().split(/\s+/).filter(Boolean);
+    // 팔레트가 따옴표 인자를 가르치므로 REPL 과 같은 토크나이저를 쓴다.
+    const rest = require("../agentlas-input.cjs").tokenizeCommandLine(cmdline).slice(1);
     const cmd = commands.resolveCommandName(raw);
     if (cmd === "quit" || cmd === "exit") return "quit";
     if (cmd === "help") {
-      ui.line(palette.renderPalette(ctx.lang));
+      ui.line(palette.renderPalette(ctx.lang, { all: String(rest[0] || "") === "all" }));
+      ui.line("");
+      ui.line(ui.c.dim(en
+        ? "Tab completes commands · ↑/↓ history · Shift-Tab cycles permission · Esc interrupts a turn"
+        : "Tab: 명령 완성 · ↑/↓ 히스토리 · Shift-Tab 권한 순환 · Esc 턴 중단"));
       return;
     }
     // 그래프 보기 (Phase 4) — 캔버스를 흉내내지 않는다: mermaid → 유니코드 박스 아트.
@@ -275,7 +325,8 @@ async function startShell(ctx, opts = {}) {
             lines.push(n.type === "condition" ? `  ${n.id}{${label}}` : `  ${n.id}[${label}]`);
           }
           for (const e of g.edges || []) {
-            const lbl = e.sourceHandle === "true" ? "|참|" : e.sourceHandle === "false" ? "|거짓|" : "";
+            const lbl = e.sourceHandle === "true" ? (en ? "|yes|" : "|참|")
+              : e.sourceHandle === "false" ? (en ? "|no|" : "|거짓|") : "";
             lines.push(`  ${e.source} -->${lbl} ${e.target}`);
           }
           const { render, toAnsi } = require("../vendor/mermaid/index.js");
@@ -288,6 +339,46 @@ async function startShell(ctx, opts = {}) {
         } catch { /* 렌더 실패 → 아래 클래식 폴스루가 텍스트로 보여준다 */ }
       }
     }
+    /*
+     * 세션 설정 4종. 자동완성은 되는데 처리 case 가 없어 "여기서는 아직 안 됩니다"만
+     * 답하던 죽은 광고였다(신설 게이트가 잡았다). 기본 REPL 과 같은 의미로 배선하고,
+     * 영구 저장 경로를 같은 줄에서 알려준다 — 이 값들은 이 셸 한정이다.
+     */
+    if (cmd === "permission" || cmd === "model" || cmd === "runtime" || cmd === "effort") {
+      const value = String(rest[0] || "").trim();
+      const entry = require("./commands-catalog.cjs").byName(cmd);
+      if (!value) {
+        ui.line(ui.c.dim(`Usage: /${cmd} ${entry ? entry.args : ""}`));
+        return;
+      }
+      if (cmd === "permission") {
+        const next = permissions.normalize(value);
+        if (!next) { ui.line(ui.c.dim("Usage: /permission read|write|full")); return; }
+        permission = next;
+        ui.line(ui.c.dim(`permission: ${next}  ·  ${en ? "persist: agentlas setup" : "영구 저장: agentlas setup"}`));
+        return;
+      }
+      if (cmd === "model") opts.model = value === "default" ? null : value;
+      else if (cmd === "runtime") opts.runtime = value;
+      else opts.effort = value;
+      ui.line(ui.c.dim(`${cmd}: ${value}  ·  ${en
+        ? "applies to new sessions here (persist: agentlas roles set)"
+        : "이 셸의 새 세션부터 (영구 저장: agentlas roles set)"}`));
+      return;
+    }
+    // 셸 끄기 — 여기서도 되돌아갈 수 있어야 한다(들어와서 못 나가면 갇힌다)
+    if (cmd === "shell") {
+      const want = String(rest[0] || "").toLowerCase();
+      if (!["on", "off"].includes(want)) { ui.line(ui.c.dim(en ? "Usage: /shell on|off" : "사용법: /shell on|off")); return; }
+      const config = require("../agentlas-config.cjs");
+      const { userDataDir } = require("../core/paths.cjs");
+      config.updatePrefs(userDataDir(), { shell: want === "on" ? "interactive" : "classic" });
+      ui.line(ui.c.dim(want === "on"
+        ? (en ? "Already here." : "이미 이 셸입니다.")
+        : (en ? "Interactive shell disabled — restart agentlas for the classic REPL."
+              : "대화형 셸을 껐습니다 — agentlas 를 다시 실행하면 기본 REPL 입니다.")));
+      return;
+    }
     // 데스크탑 대응 화면 (Phase 3) — 정직 정지였던 표면들을 실물로 대체
     {
       const screens = require("./screens.cjs");
@@ -373,7 +464,7 @@ async function startShell(ctx, opts = {}) {
       }
     })();
   };
-  tui.addChild(editor);
+  bottom.addChild(editor);
   tui.setFocus(editor);
 
   const shutdown = (code) => {

package/engine/workforce/deps.cjs

@@ -296,7 +296,13 @@ function coreHarness() {
 
 async function workforceAccountContext() {
   const cookie = await hubClient.cloudSessionCookie();
-  if (!cookie) throw new Error("Agentlas sign-in is required for cross-session Workforce continuity.");
+  // 가장 흔한 로그아웃 경로 — 마커가 없으면 표시 경계가 삼켜 "복구 중" 한 줄이 된다.
+  if (!cookie) {
+    throw Object.assign(
+      new Error("Agentlas sign-in required — run `agentlas login`, then retry."),
+      { code: "auth_required", honestStop: true },
+    );
+  }
   const webBase = (process.env.AGENTLAS_WEB_BASE_URL || "https://agentlas.cloud").replace(/\/$/, "");
   const mcpBase = (process.env.AGENTLAS_MCP_BASE_URL || `${webBase}/api/mcp/v1`).replace(/\/$/, "");
   const response = await hubClient.fetchHub(mcpBase, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "1.0.43",
+  "version": "1.0.45",
   "description": "Agentlas project terminal — run project controllers and task-scoped agent teams from the terminal. Standalone: no desktop app process required.",
   "bin": {
     "agentlas": "bin/agentlas.cjs"