agentlas 1.0.40 → 1.0.42

package/CHANGELOG.md

@@ -1,24 +1,60 @@
 # 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.
+
+- `/dashboard` now mirrors the desktop control panel: a **Needs attention**
+  section (waiting approvals and runs that stalled without a terminal state),
+  run activity that states failures out loud (e.g. "8/11 failed" rather than a
+  quiet list), automations with next-run times, most-used agents, and evolution
+  proposal counts.
+- `/library` — installed agents with role/kind, MCP server count, and pointers
+  to env, credentials, and plugins.
+- `/marketplace` (also `/bookmarks`) — Hub bookmarks and borrowed-agent careers
+  held locally, with search/install/credit pointers.
+- `/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 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 is Desktop-only — use: agentlas doctor · usage · list",
-  marketplace: "Marketplace browsing is Desktop-only — use: agentlas search \"<what you need>\"",
-  library: "Library is Desktop-only — use: agentlas list · env · mcp",
-  settings: "Settings UI is Desktop-only — use: agentlas setup · env · creds · multimodal · doctor",
+  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 are Desktop-only.",
+  bookmarks: "Hub bookmarks: run `AGENTLAS_TUI=1 agentlas` then /marketplace.",
   one: "Agentlas One is a separate Desktop/Mobile product surface.",
 };
 

package/engine/ui/palette.cjs

@@ -24,7 +24,6 @@ const SLASH_COMMANDS = [
   { 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: "/dashboard", args: "", ko: "관제 대시보드 (pi 셸)", en: "Dashboard (pi shell)" },
   { 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" },

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/screens.cjs

@@ -0,0 +1,354 @@
+"use strict";
+/*
+ * ui/screens — 데스크탑 화면의 터미널 대응물 (D3 Phase 3).
+ *
+ * 대조 원본: docs/2026-08-11-terminal-tui-overhaul/D1-데스크탑-기능-인벤토리.md
+ * 각 화면은 데스크탑이 IPC로 읽는 것과 같은 로컬 저장소를 직접 읽는다.
+ *
+ * 규칙:
+ *  - 없는 데이터를 지어내지 않는다. 표면이 데스크탑 전용이면 그렇게 말한다.
+ *  - 실패·미결은 눈에 띄게. "조용히 멈춘 실행"이 정상처럼 보이면 안 된다(D1 숨은 계약 2).
+ *  - 모든 화면은 ctx.out 이 아니라 ui 를 직접 받아 pi 프레임 안에 그린다.
+ */
+
+function table(ui, rows, opts = {}) {
+  // rows: [[col, col, …]] — 첫 행이 헤더. 폭은 CJK 셀 폭으로 계산한다.
+  const { visWidth, truncateWidth } = require("./width.cjs");
+  if (!rows.length) return;
+  const cols = rows[0].length;
+  const max = Number(opts.maxWidth) || 78;
+  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]);
+      return text + " ".repeat(Math.max(0, widths[i] - visWidth(text)));
+    }).join("  ");
+    ui.line(index === 0 && opts.header !== false ? ui.c.dim(line) : "  " + line);
+  });
+}
+
+function count(db, sql, fallback = 0) {
+  try { return db.prepare(sql).get()?.n ?? fallback; } catch { return fallback; }
+}
+function rows(db, sql, args = []) {
+  try { return db.prepare(sql).all(...args); } catch { return []; }
+}
+const shortTs = (v) => (v ? String(v).replace("T", " ").slice(0, 16) : "");
+
+/* ── /dashboard — 데스크탑 dashboard 의 관제 패널 집합 ── */
+function dashboard(ui, db, en) {
+  const chip = (paint, s) => paint(` ${s} `);
+  const local = count(db, "SELECT COUNT(*) n FROM installed_agents WHERE COALESCE(builtin,0)=0 AND COALESCE(visibility,'')!='background'");
+  const builtin = count(db, "SELECT COUNT(*) n FROM installed_agents WHERE COALESCE(builtin,0)=1");
+  const firms = count(db, "SELECT COUNT(*) n FROM firms");
+  const marks = count(db, "SELECT COUNT(*) n FROM hub_agent_bookmarks");
+  const borrowed = count(db, "SELECT COUNT(*) n FROM borrowed_agent_careers");
+
+  ui.ensureNl();
+  ui.line(ui.c.bold(en ? "Dashboard" : "대시보드"));
+  ui.line(`  ${chip(ui.c.inverse, `${en ? "agents" : "에이전트"} ${local}`)} ${chip(ui.c.dim, `builtin ${builtin}`)} ${chip(ui.c.inverse, `${en ? "firms" : "회사"} ${firms}`)} ${chip(ui.c.dim, `${en ? "bookmarks" : "북마크"} ${marks}`)} ${chip(ui.c.dim, `${en ? "borrowed" : "대여"} ${borrowed}`)}`);
+
+  // ── 확인 필요 (D1 숨은 계약 2: 없으면 실행이 조용히 멈춘 채 정상처럼 보인다) ──
+  const pending = count(db, "SELECT COUNT(*) n FROM automation_node_approvals WHERE decision NOT IN ('approved','rejected')");
+  const stalled = rows(db,
+    `SELECT r.id, a.name, r.status, r.last_activity_at
+       FROM automation_runs r LEFT JOIN automations a ON a.id = r.automation_id
+      WHERE r.status NOT IN ('ok','error','cancelled') ORDER BY COALESCE(r.last_activity_at,'') DESC LIMIT 5`);
+  ui.line("");
+  ui.line(ui.c.bold(en ? "Needs attention" : "확인 필요"));
+  if (!pending && !stalled.length) {
+    ui.line(ui.c.dim(en ? "  none — nothing is waiting on you" : "  없음 — 당신을 기다리는 실행이 없습니다"));
+  } else {
+    if (pending) ui.line(`  ${ui.c.amber("!")} ${en ? `${pending} approval(s) waiting` : `승인 대기 ${pending}건`}`);
+    for (const s of stalled) {
+      ui.line(`  ${ui.c.amber("!")} ${s.name || s.automation_id} ${ui.c.dim(`· ${s.status} · ${shortTs(s.last_activity_at)}`)}`);
+    }
+  }
+
+  // ── 실행 활동 — 실패를 숨기지 않는다 ──
+  const runAgg = rows(db, "SELECT status, COUNT(*) n FROM automation_runs GROUP BY status");
+  const recent = rows(db,
+    `SELECT r.status, r.started_at, a.name FROM automation_runs r
+       LEFT JOIN automations a ON a.id = r.automation_id
+      ORDER BY COALESCE(r.started_at,'') DESC LIMIT 5`);
+  if (runAgg.length) {
+    const failed = runAgg.find((r) => r.status === "error")?.n || 0;
+    const total = runAgg.reduce((a, b) => a + b.n, 0);
+    ui.line("");
+    ui.line(ui.c.bold(en ? "Run activity" : "실행 활동") + " " +
+      (failed ? ui.c.amber(en ? `${failed}/${total} failed` : `${total}건 중 ${failed}건 실패`) : ui.c.dim(`${total}`)));
+    for (const r of recent) {
+      const mark = r.status === "ok" ? ui.c.green("✓") : r.status === "error" ? ui.c.amber("✗") : ui.c.dim("·");
+      ui.line(`  ${mark} ${r.name || "—"} ${ui.c.dim(shortTs(r.started_at))}`);
+    }
+  }
+
+  // ── 자동화 ──
+  const autoTotal = db.prepare("SELECT COUNT(*) n, COALESCE(SUM(enabled),0) e FROM automations").get();
+  const autos = rows(db, "SELECT name, enabled, next_run_at FROM automations ORDER BY enabled DESC, COALESCE(next_run_at,'') LIMIT 5");
+  ui.line("");
+  ui.line(ui.c.bold(en ? `Automations ${autoTotal.e}/${autoTotal.n} on` : `자동화 ${autoTotal.e}/${autoTotal.n} 켜짐`));
+  for (const a of autos) {
+    ui.line(`  ${a.enabled ? ui.c.green("●") : ui.c.faint("○")} ${a.name}${a.next_run_at ? ui.c.dim(`  ·  ${en ? "next" : "다음"} ${shortTs(a.next_run_at)}`) : ""}`);
+  }
+  if (!autos.length) ui.line(ui.c.dim(en ? "  (none — /automation add)" : "  (없음 — /automation add)"));
+
+  // ── 사용량 상위 ──
+  const usage = rows(db, "SELECT agent_key, use_count, last_used_at FROM agent_usage ORDER BY use_count DESC LIMIT 5");
+  if (usage.length) {
+    ui.line("");
+    ui.line(ui.c.bold(en ? "Most used" : "많이 쓴 에이전트"));
+    table(ui, [[en ? "agent" : "에이전트", en ? "runs" : "실행", en ? "last" : "마지막"],
+      ...usage.map((u) => [u.agent_key, String(u.use_count), shortTs(u.last_used_at)])], { cap: [34, 6, 16] });
+  }
+
+  // ── 진화 제안 (승인형) ──
+  const props = rows(db, "SELECT status, COUNT(*) n FROM agent_evolution_proposals GROUP BY status");
+  if (props.length) {
+    ui.line("");
+    ui.line(ui.c.bold(en ? "Evolution proposals" : "진화 제안") + " " +
+      ui.c.dim(props.map((p) => `${p.status} ${p.n}`).join(" · ")));
+  }
+
+  ui.line("");
+  ui.line(ui.c.dim(en
+    ? "more: /library · /marketplace · /automation list · /usage · /sessions"
+    : "더 보기: /library · /marketplace · /automation list · /usage · /sessions"));
+}
+
+/* ── /library — 데스크탑 library/agents + env + mcps 를 한 화면으로 ── */
+function library(ui, db, en, ctx) {
+  ui.ensureNl();
+  ui.line(ui.c.bold(en ? "Library" : "라이브러리"));
+
+  const agents = rows(db,
+    `SELECT slug, COALESCE(local_display_name, name) nm, role, entity_kind, builtin, trust_grade
+       FROM installed_agents WHERE COALESCE(visibility,'')!='background'
+      ORDER BY COALESCE(builtin,0), slug LIMIT 12`);
+  const total = count(db, "SELECT COUNT(*) n FROM installed_agents WHERE COALESCE(visibility,'')!='background'");
+  ui.line("");
+  ui.line(ui.c.bold(en ? `Agents (${total})` : `에이전트 (${total})`));
+  table(ui, [[en ? "slug" : "슬러그", en ? "name" : "이름", en ? "role" : "역할", en ? "kind" : "종류"],
+    ...agents.map((a) => [a.slug, a.nm || "", a.role || "", a.builtin ? "builtin" : (a.entity_kind || "agent")])],
+    { cap: [26, 24, 12, 10] });
+  if (total > agents.length) ui.line(ui.c.dim(en ? `  … ${total - agents.length} more — /agents` : `  … ${total - agents.length}개 더 — /agents`));
+
+  const mcps = rows(db, "SELECT DISTINCT agent_id FROM agent_mcp_servers LIMIT 1");
+  const mcpCount = count(db, "SELECT COUNT(*) n FROM agent_mcp_servers");
+  ui.line("");
+  ui.line(ui.c.bold(en ? "MCP servers" : "MCP 서버") + " " + ui.c.dim(String(mcpCount)) +
+    ui.c.dim(mcps.length ? "  ·  /mcp" : en ? "  ·  none configured — /mcp" : "  ·  설정 없음 — /mcp"));
+
+  ui.line("");
+  ui.line(ui.c.dim(en
+    ? "env vars: /env  ·  credentials: /creds list  ·  plugins: /plugin list"
+    : "환경변수: /env  ·  자격증명: /creds list  ·  플러그인: /plugin list"));
+  void ctx;
+}
+
+/* ── /marketplace · /bookmarks — Hub 북마크(로컬)와 검색 안내 ── */
+function marketplace(ui, db, en) {
+  ui.ensureNl();
+  ui.line(ui.c.bold(en ? "Hub" : "Hub 마켓플레이스"));
+  const marks = rows(db,
+    "SELECT slug, entity_kind, bookmarked_at, sync_state FROM hub_agent_bookmarks ORDER BY COALESCE(bookmarked_at,'') DESC LIMIT 10");
+  const borrowed = rows(db,
+    "SELECT slug, COALESCE(name_ko, name_en) nm, use_count, last_used_at FROM borrowed_agent_careers ORDER BY COALESCE(last_used_at,'') DESC LIMIT 5");
+
+  ui.line("");
+  ui.line(ui.c.bold(en ? `Bookmarks (${marks.length})` : `북마크 (${marks.length})`));
+  if (marks.length) {
+    table(ui, [[en ? "slug" : "슬러그", en ? "kind" : "종류", en ? "saved" : "저장"],
+      ...marks.map((m) => [m.slug, m.entity_kind || "agent", shortTs(m.bookmarked_at)])], { cap: [34, 10, 16] });
+  } else {
+    ui.line(ui.c.dim(en ? "  none yet" : "  아직 없음"));
+  }
+
+  if (borrowed.length) {
+    ui.line("");
+    ui.line(ui.c.bold(en ? "Borrowed (Hub careers)" : "빌려 쓴 에이전트"));
+    table(ui, [[en ? "slug" : "슬러그", en ? "name" : "이름", en ? "runs" : "실행", en ? "last" : "마지막"],
+      ...borrowed.map((b) => [b.slug, b.nm || "", String(b.use_count || 0), shortTs(b.last_used_at)])],
+      { cap: [26, 22, 6, 16] });
+  }
+
+  ui.line("");
+  ui.line(ui.c.dim(en
+    ? 'search: /search "<what you need>"  ·  install: /install <slug>  ·  credits: /billing'
+    : '검색: /search "<필요한 것>"  ·  설치: /install <slug>  ·  크레딧: /billing'));
+}
+
+/* ── /settings — 데스크탑 settings 의 터미널 관측 (변경은 기존 명령으로) ── */
+function settings(ui, db, en, ctx) {
+  const { activeRuntimeRow, listAvailableCliRuntimes } = require("../runtimes/detect.cjs");
+  const { resolvedModelRole } = require("../runtimes/roles.cjs");
+  const prefs = ctx.prefs || {};
+  ui.ensureNl();
+  ui.line(ui.c.bold(en ? "Settings" : "설정"));
+
+  const active = (() => { try { return activeRuntimeRow(db); } catch { return null; } })();
+  const clis = (() => { try { return listAvailableCliRuntimes(); } catch { return []; } })();
+  const orch = (() => { try { return resolvedModelRole(db, "orchestrator"); } catch { return null; } })();
+  const worker = (() => { try { return resolvedModelRole(db, "worker"); } catch { return null; } })();
+  const describe = (sel) => (sel ? `${sel.kind === "byok" ? sel.backend || "byok" : sel.kind}${sel.model ? `/${sel.model}` : ""}` : en ? "not set" : "미설정");
+
+  table(ui, [
+    [en ? "setting" : "항목", en ? "value" : "값"],
+    [en ? "language" : "언어", prefs.language || ctx.lang || "en"],
+    [en ? "permission" : "권한", prefs.permission || "write"],
+    [en ? "active runtime" : "활성 런타임", active ? active.kind : (prefs.runtime || (en ? "auto" : "자동"))],
+    [en ? "installed CLIs" : "설치된 CLI", clis.map((c) => c.kind).join(", ") || (en ? "none" : "없음")],
+    ["orchestrator", describe(orch)],
+    ["worker", describe(worker)],
+  ], { cap: [18, 52] });
+
+  ui.line("");
+  ui.line(ui.c.dim(en
+    ? "change: /setup (wizard) · /runtime · /model · /effort · /permission · roles set · creds · env"
+    : "변경: /setup (마법사) · /runtime · /model · /effort · /permission · roles set · creds · env"));
+  ui.line(ui.c.dim(en
+    ? "Desktop-only here: theme, mobile pairing QR, auto-update, multimodal providers"
+    : "여기서 불가(데스크탑 전용): 테마, 모바일 페어링 QR, 자동 업데이트, 멀티모달 프로바이더"));
+}
+
+/* ── /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 });
@@ -127,23 +129,43 @@ class PiUi extends Ui {
   }
 }
 
+/*
+ * 셸 전용 화면 (D3 Phase 3). 공용 팔레트(ui/palette)에는 넣지 않는다 —
+ * 그 정본은 기본 REPL 이 실제로 처리하는 명령만 광고해야 하고,
+ * palette-command-coverage-contract 가 그 계약을 잠근다.
+ */
+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 가 관리하므로 벗긴다.
-  return palette.SLASH_COMMANDS.map((cmd) => ({
+  // 팔레트 정본 → 렌더러 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 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 = {
@@ -185,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 종료"));
@@ -260,33 +282,21 @@ async function startPiShell(ctx, opts = {}) {
         } catch { /* 렌더 실패 → 아래 클래식 폴스루가 텍스트로 보여준다 */ }
       }
     }
-    // 대시보드 (Phase 3-2) — 데스크탑 정직 정지 13종 중 첫 해제. 로컬 DB 직조회.
-    if (cmd === "dashboard") {
-      const chip = (paint, s) => paint(` ${s} `);
-      const agents = db.prepare(
-        "SELECT COALESCE(NULLIF(entity_kind,''),'agent') k, builtin, COUNT(*) n FROM installed_agents WHERE COALESCE(visibility,'')!='background' GROUP BY k, builtin").all();
-      const firms = db.prepare("SELECT COUNT(*) n FROM firms").get().n;
-      const autos = db.prepare(
-        "SELECT name, enabled, last_run_at FROM automations ORDER BY COALESCE(last_run_at,'') DESC LIMIT 5").all();
-      const autoTotal = db.prepare("SELECT COUNT(*) n, SUM(enabled) e FROM automations").get();
-      const tg = db.prepare("SELECT COUNT(*) n FROM telegram_bindings").get().n;
-      ui.ensureNl();
-      ui.line(ui.c.bold(en ? "Dashboard" : "대시보드"));
-      const local = agents.filter(a => !a.builtin).reduce((s, a) => s + a.n, 0);
-      const builtin = agents.filter(a => a.builtin).reduce((s, a) => s + a.n, 0);
-      ui.line(`  ${chip(ui.c.inverse, en ? `agents ${local}` : `에이전트 ${local}`)} ${chip(ui.c.dim, `builtin ${builtin}`)} ${chip(ui.c.inverse, en ? `firms ${firms}` : `회사 ${firms}`)} ${chip(ui.c.dim, `telegram ${tg}`)}`);
-      ui.line("");
-      ui.line(ui.c.bold(en ? `Automations ${autoTotal.e || 0}/${autoTotal.n} on` : `자동화 ${autoTotal.e || 0}/${autoTotal.n} 켜짐`));
-      for (const a of autos) {
-        const st = a.enabled ? ui.c.green("●") : ui.c.faint("○");
-        ui.line(`  ${st} ${a.name}${a.last_run_at ? ui.c.dim(`  ·  ${String(a.last_run_at).slice(0, 16)}`) : ""}`);
-      }
-      if (!autos.length) ui.line(ui.c.dim(en ? "  (none — /automation add)" : "  (없음 — /automation add)"));
-      ui.line("");
-      ui.line(ui.c.dim(en
-        ? "details: /agents · /automation list · /usage · /sessions"
-        : "자세히: /agents · /automation list · /usage · /sessions"));
-      return;
+    // 데스크탑 대응 화면 (Phase 3) — 정직 정지였던 표면들을 실물로 대체
+    {
+      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,
+      };
+      // 인자 있는 화면(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") {
@@ -317,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;
@@ -367,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 });
@@ -397,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.40",
+  "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"