agentlas 1.0.41 → 1.0.42

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.0.42 — 2026-08-11
+
+Projects, automations and firms reach the interactive shell; the shell is
+enabled with `AGENTLAS_TUI=1`.
+
+- `/projects` — every connected project with chat/task counts, and a clear
+  marker for the one this folder belongs to (or an explicit warning when the
+  folder is not connected).
+- `/automations` — the full list with schedule, next run, run count and failure
+  count; `/automations <name>` opens the detail view with recent run outcomes
+  and the exact commands to run or toggle it.
+- `/firms` — teams with member counts; `/firms <slug>` shows the roster.
+- Table layout no longer inflates narrow status columns when a row overflows
+  the terminal width.
+- The shell is now enabled with `AGENTLAS_TUI=1`. Renderer internals are an
+  implementation detail and no longer appear in commands, environment
+  variables, or on screen.
+
 ## 1.0.41 — 2026-08-11
 
 Desktop surfaces, measured against the desktop inventory and rebuilt for the terminal.
@@ -16,28 +34,27 @@ Desktop surfaces, measured against the desktop inventory and rebuilt for the ter
 - `/settings` — language, permission, active runtime, installed CLIs, and the
   resolved orchestrator/worker model roles; names what remains Desktop-only
   instead of implying parity.
-- Those five honest stops now point at the pi shell instead of claiming the
+- Those five honest stops now point at the interactive shell instead of claiming the
   surface is unreachable from the terminal.
 
 ## 1.0.40 — 2026-08-11
 
-Desktop surfaces reach the pi shell: dashboard and graph view.
+Desktop surfaces reach the interactive shell: dashboard and graph view.
 
-- `/dashboard` (pi shell): agents/firms/telegram badges + automations panel
+- `/dashboard` (interactive shell): agents/firms/telegram badges + automations panel
   (enabled state, last run) from the local store — first of the thirteen
   Desktop-only honest stops to be lifted.
-- `/graph show <name>` (pi shell): the automation graph renders as Unicode
+- `/graph show <name>` (interactive shell): the automation graph renders as Unicode
   box art (grok-mermaid) — condition branches, loop-back edges, and Korean
   labels align correctly. No canvas emulation; editing stays declarative.
-- First-run onboarding now runs before the pi shell starts (sequential
-  readline → pi-tui, no stdin contention), so `AGENTLAS_TUI=pi` works for
+- First-run onboarding now runs before the interactive shell starts (sequential, no stdin contention), so `AGENTLAS_TUI=1` works for
   brand-new installs too.
 
 ## 1.0.39 — 2026-08-11
 
-pi-tui shell increment 2 + architecture mirror sync.
+Interactive shell increment 2 + architecture mirror sync.
 
-- Experimental pi shell (`AGENTLAS_TUI=pi`): persisted history (cli-history.json
+- Experimental interactive shell (`AGENTLAS_TUI=1`): persisted history (cli-history.json
   v2 contract), Shift-Tab permission cycling (same two-step FULL arming state
   machine as the classic REPL), `!` shell passthrough (full-permission gate,
   secret masking), and `/s` `/switch` `/kill` `/rm` `/sessions` `/tree` session

package/engine/commands/index.cjs

@@ -93,13 +93,13 @@ const DESKTOP_ONLY_SURFACES = {
   trex: "T-rex slide studio is Desktop-only.",
   slides: "T-rex slide studio is Desktop-only.",
   prompts: "Prompt Store is Desktop-only.",
-  dashboard: "Dashboard: run `AGENTLAS_TUI=pi agentlas` then /dashboard — or: agentlas doctor · usage · list",
-  marketplace: "Hub view: run `AGENTLAS_TUI=pi agentlas` then /marketplace — or: agentlas search \"<what you need>\"",
-  library: "Library: run `AGENTLAS_TUI=pi agentlas` then /library — or: agentlas list · env · mcp",
-  settings: "Settings: run `AGENTLAS_TUI=pi agentlas` then /settings — change with: agentlas setup · env · creds · multimodal",
+  dashboard: "Dashboard: run `AGENTLAS_TUI=1 agentlas` then /dashboard — or: agentlas doctor · usage · list",
+  marketplace: "Hub view: run `AGENTLAS_TUI=1 agentlas` then /marketplace — or: agentlas search \"<what you need>\"",
+  library: "Library: run `AGENTLAS_TUI=1 agentlas` then /library — or: agentlas list · env · mcp",
+  settings: "Settings: run `AGENTLAS_TUI=1 agentlas` then /settings — change with: agentlas setup · env · creds · multimodal",
   apps: "Apps surface is Desktop-only.",
   quests: "Quests are Desktop-only.",
-  bookmarks: "Hub bookmarks: run `AGENTLAS_TUI=pi agentlas` then /marketplace.",
+  bookmarks: "Hub bookmarks: run `AGENTLAS_TUI=1 agentlas` then /marketplace.",
   one: "Agentlas One is a separate Desktop/Mobile product surface.",
 };
 

package/engine/ui/repl.cjs

@@ -125,12 +125,12 @@ async function startRepl(ctx, opts = {}) {
   }
 
   /*
-   * 실험 셸 opt-in (D3 Phase 2): AGENTLAS_TUI=pi + TTY.
+   * 대화형 셸 opt-in (D3 Phase 2): AGENTLAS_TUI=1 + TTY.
    * 온보딩 마법사(위 readline 블록)가 먼저 끝난 뒤 진입한다 — 순차 실행이라
-   * stdin 경합이 없고, 첫 실행 사용자도 pi 셸을 쓸 수 있다(증분 2c).
+   * stdin 경합이 없고, 첫 실행 사용자도 새 셸을 쓸 수 있다(증분 2c).
    */
-  if (process.env.AGENTLAS_TUI === "pi" && process.stdin.isTTY) {
-    return require("./pitui-shell.cjs").startPiShell(ctx, opts);
+  if (/^(1|true|on)$/i.test(String(process.env.AGENTLAS_TUI || "")) && process.stdin.isTTY) {
+    return require("./shell.cjs").startShell(ctx, opts);
   }
   const orch = new Orchestrator({ db, lang: ctx.lang });
   const renderer = new Renderer(ui);

package/engine/ui/{pitui-screens.cjs → screens.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * ui/pitui-screens — 데스크탑 화면의 터미널 대응물 (D3 Phase 3).
+ * ui/screens — 데스크탑 화면의 터미널 대응물 (D3 Phase 3).
  *
  * 대조 원본: docs/2026-08-11-terminal-tui-overhaul/D1-데스크탑-기능-인벤토리.md
  * 각 화면은 데스크탑이 IPC로 읽는 것과 같은 로컬 저장소를 직접 읽는다.
@@ -17,10 +17,24 @@ function table(ui, rows, opts = {}) {
   if (!rows.length) return;
   const cols = rows[0].length;
   const max = Number(opts.maxWidth) || 78;
-  const widths = Array.from({ length: cols }, (_, i) =>
-    Math.min(opts.cap?.[i] || 40, Math.max(...rows.map((r) => visWidth(String(r[i] ?? ""))))));
-  const total = widths.reduce((a, b) => a + b + 2, 0);
-  if (total > max && widths.length) widths[0] = Math.max(8, widths[0] - (total - max));
+  const widths = Array.from({ length: cols }, (_, i) => {
+    const cap = opts.cap?.[i];
+    return Math.min(Number.isFinite(cap) ? cap : 40, Math.max(...rows.map((r) => visWidth(String(r[i] ?? "")))));
+  });
+  /*
+   * 넘치면 "가장 넓은 열"을 깎는다. 예전엔 0번 열을 깎으면서 Math.max(8, …) 바닥을
+   * 뒀는데, 1칸짜리 상태 마커 열이 8칸으로 부풀어 표가 깨졌다(실측). 바닥은 4칸이고
+   * 이미 그보다 좁은 열은 건드리지 않는다.
+   */
+  let over = widths.reduce((a, b) => a + b + 2, 0) - max;
+  while (over > 0) {
+    let widest = -1;
+    widths.forEach((w, i) => { if (w > 4 && (widest < 0 || w > widths[widest])) widest = i; });
+    if (widest < 0) break;
+    const cut = Math.min(over, widths[widest] - 4);
+    widths[widest] -= cut;
+    over -= cut;
+  }
   rows.forEach((row, index) => {
     const line = row.map((cell, i) => {
       const text = truncateWidth(String(cell ?? ""), widths[i]);
@@ -214,4 +228,127 @@ function settings(ui, db, en, ctx) {
     : "여기서 불가(데스크탑 전용): 테마, 모바일 페어링 QR, 자동 업데이트, 멀티모달 프로바이더"));
 }
 
-module.exports = { dashboard, library, marketplace, settings, table };
+/* ── /projects — 데스크탑 workspace + project/detail ── */
+function projects(ui, db, en) {
+  const list = rows(db,
+    `SELECT p.id, p.name, p.folder_path, p.source_type,
+            (SELECT COUNT(*) FROM chats c WHERE c.project_id = p.id AND c.archived_at IS NULL) chats,
+            (SELECT COUNT(*) FROM tasks t WHERE t.project_id = p.id AND t.archived_at IS NULL) tasks,
+            p.updated_at
+       FROM projects p ORDER BY COALESCE(p.updated_at,'') DESC`);
+  ui.ensureNl();
+  ui.line(ui.c.bold(en ? `Projects (${list.length})` : `프로젝트 (${list.length})`));
+  const cwd = process.cwd();
+  if (list.length) {
+    table(ui, [[en ? "project" : "프로젝트", en ? "source" : "소스", en ? "chats" : "채팅", en ? "tasks" : "작업", en ? "updated" : "수정"],
+      ...list.map((p) => [
+        (p.folder_path && cwd.startsWith(p.folder_path) ? "▸ " : "  ") + (p.name || p.id),
+        p.source_type || "local", String(p.chats), String(p.tasks), shortTs(p.updated_at)])],
+      { cap: [30, 10, 6, 6, 16] });
+    const here = list.find((p) => p.folder_path && cwd.startsWith(p.folder_path));
+    ui.line("");
+    ui.line(here
+      ? ui.c.dim(en ? `▸ this folder is connected to "${here.name}"` : `▸ 이 폴더는 "${here.name}"에 연결돼 있습니다`)
+      : ui.c.amber(en ? "this folder is not connected — /project use <agent>" : "이 폴더는 연결 안 됨 — /project use <에이전트>"));
+  } else {
+    ui.line(ui.c.dim(en ? "  none — /project use <agent>" : "  없음 — /project use <에이전트>"));
+  }
+  ui.line(ui.c.dim(en
+    ? "detail: /project status  ·  team: /project team <agent>…  ·  timeline lives in the project store"
+    : "상세: /project status  ·  팀: /project team <에이전트>…  ·  타임라인은 프로젝트 저장소에"));
+}
+
+/* ── /automations — 데스크탑 automation 목록+상세 ── */
+function automations(ui, db, en, ctx, arg) {
+  const name = String(arg || "").trim();
+  if (name) {
+    const a = db.prepare("SELECT * FROM automations WHERE name = ? OR id = ?").get(name, name);
+    if (!a) { ui.line(ui.c.dim(en ? `no automation named "${name}"` : `"${name}" 자동화가 없습니다`)); return; }
+    ui.ensureNl();
+    ui.line(ui.c.bold(a.name) + " " + (a.enabled ? ui.c.green("● on") : ui.c.faint("○ off")));
+    table(ui, [
+      [en ? "field" : "항목", en ? "value" : "값"],
+      [en ? "schedule" : "일정", a.schedule || (a.trigger_type || "—")],
+      [en ? "next run" : "다음 실행", shortTs(a.next_run_at) || "—"],
+      [en ? "last run" : "마지막 실행", shortTs(a.last_run_at) || "—"],
+      [en ? "runs" : "실행 횟수", String(a.run_count || 0)],
+      [en ? "target" : "대상", `${a.target_type || "—"}${a.target_id ? `:${String(a.target_id).slice(0, 20)}` : ""}`],
+      [en ? "permission" : "권한", a.execution_permission || "—"],
+      [en ? "graph" : "그래프", a.graph_json ? (en ? `yes — /graph show ${a.name}` : `있음 — /graph show ${a.name}`) : (en ? "no" : "없음")],
+    ], { cap: [16, 54] });
+    const runs = rows(db,
+      "SELECT status, started_at FROM automation_runs WHERE automation_id = ? ORDER BY COALESCE(started_at,'') DESC LIMIT 6", [a.id]);
+    if (runs.length) {
+      ui.line("");
+      ui.line(ui.c.bold(en ? "Recent runs" : "최근 실행"));
+      for (const r of runs) {
+        const mark = r.status === "ok" ? ui.c.green("✓") : r.status === "error" ? ui.c.amber("✗") : ui.c.dim("·");
+        ui.line(`  ${mark} ${r.status} ${ui.c.dim(shortTs(r.started_at))}`);
+      }
+    }
+    ui.line("");
+    ui.line(ui.c.dim(en
+      ? `run now: /automation run ${a.name}  ·  toggle: /automation ${a.enabled ? "off" : "on"} ${a.name}`
+      : `지금 실행: /automation run ${a.name}  ·  ${a.enabled ? "끄기: /automation off" : "켜기: /automation on"} ${a.name}`));
+    return;
+  }
+  const list = rows(db,
+    `SELECT a.name, a.enabled, a.schedule, a.next_run_at, a.run_count,
+            (SELECT COUNT(*) FROM automation_runs r WHERE r.automation_id = a.id AND r.status='error') fails
+       FROM automations a ORDER BY a.enabled DESC, COALESCE(a.next_run_at,'')`);
+  ui.ensureNl();
+  ui.line(ui.c.bold(en ? `Automations (${list.length})` : `자동화 (${list.length})`));
+  if (!list.length) { ui.line(ui.c.dim(en ? "  none — /automation add" : "  없음 — /automation add")); return; }
+  table(ui, [[" ", en ? "name" : "이름", en ? "schedule" : "일정", en ? "next" : "다음", en ? "runs" : "실행", en ? "fails" : "실패"],
+    ...list.map((a) => [a.enabled ? "●" : "○", a.name, a.schedule || "—",
+      shortTs(a.next_run_at) || "—", String(a.run_count || 0), a.fails ? String(a.fails) : ""])],
+    { cap: [1, 30, 14, 16, 5, 5] });
+  ui.line("");
+  ui.line(ui.c.dim(en
+    ? "detail: /automations <name>  ·  graph: /graph show <name>  ·  add: /automation add"
+    : "상세: /automations <이름>  ·  그래프: /graph show <이름>  ·  추가: /automation add"));
+  void ctx;
+}
+
+/* ── /firms — 데스크탑 firm/detail (조직도) ── */
+function firms(ui, db, en, ctx, arg) {
+  const name = String(arg || "").trim();
+  if (name) {
+    const f = db.prepare("SELECT * FROM firms WHERE slug = ? OR name = ?").get(name, name);
+    if (!f) { ui.line(ui.c.dim(en ? `no firm named "${name}"` : `"${name}" 회사가 없습니다`)); return; }
+    ui.ensureNl();
+    ui.line(ui.c.bold(f.name || f.slug) + (f.tagline ? ui.c.dim(`  ·  ${f.tagline}`) : ""));
+    let org = null;
+    try { org = JSON.parse(f.org_chart_json || "null"); } catch { org = null; }
+    const members = rows(db,
+      "SELECT slug, COALESCE(local_display_name, name) nm, role FROM installed_agents WHERE parent_team_id = ? ORDER BY role, slug", [f.id]);
+    if (members.length) {
+      ui.line("");
+      ui.line(ui.c.bold(en ? `Roster (${members.length})` : `구성원 (${members.length})`));
+      table(ui, [[en ? "slug" : "슬러그", en ? "name" : "이름", en ? "role" : "역할"],
+        ...members.map((m) => [m.slug, m.nm || "", m.role || ""])], { cap: [30, 26, 14] });
+    } else if (org) {
+      ui.line(ui.c.dim(en ? "  roster is declared in the org chart only" : "  로스터가 조직도 선언에만 있습니다"));
+    }
+    const chats = count(db, "SELECT COUNT(*) n FROM chats WHERE firm_id = ? AND archived_at IS NULL", );
+    void chats;
+    ui.line("");
+    ui.line(ui.c.dim(en ? `run: /firm ${f.slug} "<task>"` : `실행: /firm ${f.slug} "<할 일>"`));
+    return;
+  }
+  const list = rows(db,
+    `SELECT f.slug, f.name, f.tagline,
+            (SELECT COUNT(*) FROM installed_agents a WHERE a.parent_team_id = f.id) members
+       FROM firms f ORDER BY f.slug`);
+  ui.ensureNl();
+  ui.line(ui.c.bold(en ? `Firms (${list.length})` : `회사 (${list.length})`));
+  if (!list.length) { ui.line(ui.c.dim(en ? "  none" : "  없음")); return; }
+  table(ui, [[en ? "slug" : "슬러그", en ? "name" : "이름", en ? "members" : "구성원"],
+    ...list.map((f) => [f.slug, f.name || "", String(f.members)])], { cap: [30, 30, 8] });
+  ui.line("");
+  ui.line(ui.c.dim(en ? "detail: /firms <slug>" : "상세: /firms <슬러그>"));
+  void ctx;
+}
+
+module.exports = { dashboard, library, marketplace, settings, projects, automations, firms, table };
+

package/engine/ui/{pitui-shell.cjs → shell.cjs}

@@ -1,16 +1,18 @@
 "use strict";
 /*
- * ui/pitui-shell — pi-tui 기반 실험 셸 (D3 Phase 2 증분 1, 2026-08-11).
+ * ui/shell — Agentlas 대화형 셸 (D3 Phase 2~3, 2026-08-11).
  *
- * 켜는 법: AGENTLAS_TUI=pi agentlas   (TTY 필수 · 기본 REPL은 그대로 정본)
+ * 켜는 법: AGENTLAS_TUI=1 agentlas   (TTY 필수 · 기본 REPL은 그대로 정본)
+ *
+ * 렌더러 의존은 구현 세부다 — 사용자 문구·환경변수·명령 어디에도 상류 이름을 쓰지 않는다.
  *
  * 설계 (D2 위험 5의 해법이 이 파일의 구조다):
- *  - PiUi 는 기존 Ui 를 상속하되 write() 초크포인트만 pi-tui 트랜스크립트로 돌린다.
+ *  - PiUi 는 기존 Ui 를 상속하되 write() 초크포인트만 렌더러 트랜스크립트로 돌린다.
  *    line/_message/tool/rule 등 기존 메서드는 전부 write 로 수렴하므로 그대로 산다.
  *  - 스트리밍 3종은 Markdown 누적으로 교체 — 표·코드블록이 실시간 재렌더된다.
- *  - 스피너는 pi-tui Loader 로 교체 (기존 \r 기반 페인트는 dummy 스트림으로 무해화).
+ *  - 스피너는 렌더러 Loader 로 교체 (기존 \r 기반 페인트는 dummy 스트림으로 무해화).
  *  - ctx.out/err 55파일의 직출력은 shellCtx 재지정으로 전부 프레임 안에 들어온다.
- *  - 자동완성은 ui/palette 정본(SLASH_COMMANDS)을 pi-tui SlashCommand 로 변환 — 목록 드리프트 금지.
+ *  - 자동완성은 ui/palette 정본(SLASH_COMMANDS)을 렌더러 SlashCommand 로 변환 — 목록 드리프트 금지.
  *
  * 증분 1 범위 밖(기본 REPL로): Shift-Tab 권한 순환 · ! 셸 · 세션 전환(/s) ·
  * 히스토리 디스크 영속 · 스티어링 큐 표시. 이 항목들은 D3 Phase 2-2에서 이전한다.
@@ -25,20 +27,20 @@ const palette = require("./palette.cjs");
 const { readVersion } = require("../agentlas-banner.cjs");
 const { resolveProjectController, withProjectControllerContext } = require("../project/controller.cjs");
 
-function loadPiTui() {
+function loadRenderer() {
   try {
     // ESM 패키지 — Node >=20.19 의 require(esm). engines 가 이 최소선을 선언한다.
     return require("@earendil-works/pi-tui");
   } catch (cause) {
     throw Object.assign(
-      new Error("pi-tui shell needs Node >=20.19 (require(esm)). Run without AGENTLAS_TUI=pi, or upgrade Node."),
-      { code: "pitui_unavailable", cause },
+      new Error("The Agentlas shell needs Node >=20.19. Run without AGENTLAS_TUI=1, or upgrade Node."),
+      { code: "shell_unavailable", cause },
     );
   }
 }
 
-/* Ui 를 상속해 write 초크포인트만 pi-tui 로 돌린다. */
-class PiUi extends Ui {
+/* Ui 를 상속해 write 초크포인트만 렌더러로 돌린다. */
+class ShellUi extends Ui {
   constructor(opts, pi, tui, transcript) {
     // 실터미널 대신 dummy 스트림 — 놓친 직접 out.write 가 프레임을 찢는 대신 소멸한다.
     super({ ...opts, stream: new PassThrough(), color: true });
@@ -128,39 +130,42 @@ class PiUi extends Ui {
 }
 
 /*
- * pi 셸 전용 화면 (D3 Phase 3). 공용 팔레트(ui/palette)에는 넣지 않는다 —
+ * 셸 전용 화면 (D3 Phase 3). 공용 팔레트(ui/palette)에는 넣지 않는다 —
  * 그 정본은 기본 REPL 이 실제로 처리하는 명령만 광고해야 하고,
  * palette-command-coverage-contract 가 그 계약을 잠근다.
  */
-const PI_SCREENS = [
+const SHELL_SCREENS = [
   { name: "dashboard", ko: "관제 대시보드 — 확인 필요·실행 활동·자동화", en: "Dashboard — attention, run activity, automations" },
   { name: "library", ko: "라이브러리 — 에이전트·MCP", en: "Library — agents, MCP" },
   { name: "marketplace", ko: "Hub — 북마크·대여 현황", en: "Hub — bookmarks and borrows" },
   { name: "settings", ko: "설정 현황", en: "Settings overview" },
+  { name: "projects", ko: "프로젝트 목록 — 채팅·작업 수", en: "Projects — chats and tasks" },
+  { name: "automations", ko: "자동화 목록·상세 [이름]", en: "Automations list/detail [name]" },
+  { name: "firms", ko: "회사(팀) 목록·조직도 [슬러그]", en: "Firms and rosters [slug]" },
 ];
 
 function toSlashCommands(lang) {
-  // 팔레트 정본 → pi-tui SlashCommand. "/" 접두는 pi-tui 가 관리하므로 벗긴다.
+  // 팔레트 정본 → 렌더러 SlashCommand. "/" 접두는 렌더러가 관리하므로 벗긴다.
   const base = palette.SLASH_COMMANDS.map((cmd) => ({
     name: cmd.command.slice(1),
     description: lang === "ko" ? cmd.ko : cmd.en,
     argumentHint: cmd.args || undefined,
   }));
   const seen = new Set(base.map((c) => c.name));
-  for (const s of PI_SCREENS) {
+  for (const s of SHELL_SCREENS) {
     if (!seen.has(s.name)) base.push({ name: s.name, description: lang === "ko" ? s.ko : s.en });
   }
   return base;
 }
 
-async function startPiShell(ctx, opts = {}) {
-  const pi = loadPiTui();
+async function startShell(ctx, opts = {}) {
+  const pi = loadRenderer();
   const en = ctx.lang === "en";
   const db = ctx.db();
 
   const terminal = new pi.ProcessTerminal();
   const tui = new pi.TuiMainScreen(terminal);
-  const ui = new PiUi({ lang: ctx.lang }, pi, tui, tui);
+  const ui = new ShellUi({ lang: ctx.lang }, pi, tui, tui);
 
   // ctx 초크포인트 재지정 — 55파일의 ctx.out 직출력이 전부 프레임 안으로 들어온다.
   const shellCtx = {
@@ -202,7 +207,7 @@ async function startPiShell(ctx, opts = {}) {
   };
 
   // ── 헤더 ──
-  ui.line(`${ui.c.paw("▞▖")} ${ui.c.bold("AGENTLAS")} ${ui.c.dim(`${readVersion()} · pi-tui shell (experimental) · parallel ≤${maxParallel()}`)}`);
+  ui.line(`${ui.c.paw("▞▖")} ${ui.c.bold("AGENTLAS")} ${ui.c.dim(`${readVersion()} · parallel ≤${maxParallel()}`)}`);
   ui.line(ui.c.dim(en
     ? "plain words run a task · / commands · Esc interrupts · Ctrl+C quits"
     : "문장을 치면 실행 · / 명령 · Esc 중단 · Ctrl+C 종료"));
@@ -279,15 +284,19 @@ async function startPiShell(ctx, opts = {}) {
     }
     // 데스크탑 대응 화면 (Phase 3) — 정직 정지였던 표면들을 실물로 대체
     {
-      const screens = require("./pitui-screens.cjs");
+      const screens = require("./screens.cjs");
       const SCREEN = {
         dashboard: screens.dashboard,
         library: screens.library,
         marketplace: screens.marketplace,
         bookmarks: screens.marketplace,
         settings: screens.settings,
+        projects: screens.projects,
+        automations: screens.automations,
+        firms: screens.firms,
       };
-      if (SCREEN[cmd]) { SCREEN[cmd](ui, db, en, shellCtx); return; }
+      // 인자 있는 화면(automations/firms 상세)은 restStr 을 그대로 넘긴다.
+      if (SCREEN[cmd]) { SCREEN[cmd](ui, db, en, shellCtx, cmdline.slice(raw.length).trim()); return; }
     }
     // 세션 관찰/전환 (증분 2b) — 기본 REPL과 같은 orch/renderer 배선
     if (cmd === "sessions" || cmd === "tree") {
@@ -318,7 +327,7 @@ async function startPiShell(ctx, opts = {}) {
       ui.line(ui.c.dim(commands.DESKTOP_ONLY_SURFACES[cmd]));
       return;
     }
-    ui.line(ui.c.dim(en ? `not in the pi shell yet: /${cmd} — use the classic REPL` : `pi 셸에는 아직 없음: /${cmd} — 기본 REPL을 쓰세요`));
+    ui.line(ui.c.dim(en ? `not available here yet: /${cmd}` : `여기서는 아직 안 됩니다: /${cmd}`));
   };
 
   let busy = false;
@@ -368,7 +377,7 @@ async function startPiShell(ctx, opts = {}) {
   };
 
   tui.addInputListener((data) => {
-    // Shift-Tab 권한 순환 — pi-tui 가 raw mode 를 단독 소유하므로 readline 의
+    // Shift-Tab 권한 순환 — 렌더러가 raw mode 를 단독 소유하므로 readline 의
     // swallowCompletion 우회 없이 여기서 직접 소비한다 (D2 위험 2의 해소 형태).
     if (pi.matchesKey(data, "shift+tab")) {
       permShortcut.handleKey("", { name: "tab", shift: true });
@@ -398,8 +407,8 @@ async function startPiShell(ctx, opts = {}) {
   });
 
   tui.start();
-  // pi-tui 가 프로세스를 잡고 있는 동안 살아 있는 프라미스
+  // 렌더러가 프로세스를 잡고 있는 동안 살아 있는 프라미스
   return new Promise(() => {});
 }
 
-module.exports = { startPiShell };
+module.exports = { startShell };

package/engine/ui/width.cjs

@@ -3,7 +3,7 @@
  * ui/width: 터미널 셀 폭·그래핌 유틸 정본.
  * agentlas-composer.cjs(데드코드가 된 바텀 입력 박스)에서 2026-08-11 추출 — 함수는
  * 바이트 동일. 소비자: agentlas-ui / agentlas-banner / agentlas-onboard /
- * ui/repl / hephaestus/runtime. pi-tui 이행(D3 Phase 1-3) 정지작업.
+ * ui/repl / hephaestus/runtime. 셸 이행(D3 Phase 1-3) 정지작업.
  */
 const GRAPHEME_SEGMENTER = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 const MARK_RE = /\p{Mark}/u;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "1.0.41",
+  "version": "1.0.42",
   "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"